# MCP Inspector v2: перенести проверку инструментов из v1

Источник: https://modelium.tech/zhurnal/mcp-inspector-v2-perenesti-cli-proverku/

Если прежняя CLI-проверка MCP-сервера перестала работать после обновления Inspector, проверьте версию Node, расположение флага --cli и новый код завершения. В v2 --config читает существующий файл без правки, а --catalog позволяет редактировать список серверов. Сначала проверьте команды на учебном сервере с безвредным echo; успешный ответ не проверяет права вашего рабочего сервера.

После обновления MCP Inspector прежняя проверка сервера не показывает инструмент или стала завершаться ошибкой? MCP — способ дать программе список действий, например поиск по файлам. Inspector проверяет этот обмен **без языковой модели**; его CLI — вариант для запуска командой из терминала. Ниже вы сначала получите ответ от учебного сервера, а затем сможете проверить настройки своего. Это инженерная инструкция, **не** рецепт установки модели дома. [s1](#src-s1) [s2](#src-s2)

**Проверено 24 октября 2026 года:** Inspector 2.12.0 и официальный тестовый Everything 2.0.0 на Linux с Node 24.21.0; редакция получила `Echo: smoke24` и код выхода 0. Свой рабочий сервер, его токены, права пользователей и модель редакция не проверяла. Для Inspector v2 нужен Node 22.19.0+, а для выбранного учебного сервера — Node 24+; RAM/VRAM конкретной модели здесь не рассматриваются. [s1](#src-s1) [s4](#src-s4)

## Как проверить v2 на безвредном сервере?

- Откройте терминал в Linux или macOS и выполните `node -v`. Node.js запускает эти программы, а `npx` загружает и запускает пакеты из каталога npm. Если версия ниже 24, сначала установите поддерживаемую Node.js 24; **это требование учебного Everything**, а не общая граница Inspector. Для первой загрузки пакетов нужен интернет. Не запускайте для опыта неизвестный MCP-сервер с доступом к рабочим документам. [s1](#src-s1) [s4](#src-s4)

- Выполните `MCP_INSPECTOR_SECRET_STORE=memory npx --yes @modelcontextprotocol/inspector@2.12.0 --cli npx --yes @modelcontextprotocol/server-everything@2.0.0 --method tools/list --format json --connect-timeout 15000`. Ищите `echo` в `result.tools`: это **список**, а не доказательство вызова. `memory` не сохраняет секреты Inspector на диск; в этом учебном примере токены не нужны. У v2 `--format json` выдаёт объект с `result`; сообщения запуска сервера могут появиться отдельно в `stderr` — служебном потоке ошибок, который не входит в JSON. [s2](#src-s2) [s3](#src-s3) [s4](#src-s4)

- Вызовите только безопасный учебный инструмент: `MCP_INSPECTOR_SECRET_STORE=memory npx --yes @modelcontextprotocol/inspector@2.12.0 --cli npx --yes @modelcontextprotocol/server-everything@2.0.0 --method tools/call --tool-name echo --tool-args-json '{"message":"smoke24"}' --format json --connect-timeout 15000`. В `result.content` ожидайте `Echo: smoke24` и **код завершения 0**. Редакция получила именно такой ответ на своей Linux-фикстуре; это не обещание результата на любой ОС или чужом сервере. Не подставляйте в этот тест пароли или личные данные. [s2](#src-s2) [s4](#src-s4)

## Что заменить в прежней CLI-проверке?

Если у вас уже есть собственный файл MCP-серверов, оставьте его **на месте**: в v2 `--config` — чтение существующего файла без записи, а `--catalog` — список, который Inspector может менять. В проверочной команде убедитесь, что `--cli` стоит сразу после имени пакета; для конкретного сервера задайте `--server` и начните с `--method initialize`, который подключается, но не вызывает инструмент. Затем при необходимости выполните `tools/list`. Не применяйте вызов неизвестного рабочего инструмента только потому, что учебный `echo` удался. [s1](#src-s1) [s2](#src-s2) [s5](#src-s5)

Для автоматической проверки (CI) закрепите **точную версию**, как выше: неприкреплённый `npx @modelcontextprotocol/inspector` может получить иную версию. Используйте `--format json`, читайте `result` и сохраняйте код завершения. Раньше инструмент мог сообщить об ошибке, но сама программа проверки завершалась успешно (код 0); в v2 ответ с `isError: true` даёт **код 5**. Поэтому старый сценарий может впервые показать сбой — прочитайте ответ инструмента, прежде чем считать переход на v2 причиной. [s1](#src-s1) [s2](#src-s2)

На сервере без доступной системной ключницы Inspector по умолчанию может хранить токены в локальном `~/.mcp-inspector/secrets.json`. Для опыта выше выбран `MCP_INSPECTOR_SECRET_STORE=memory`; он не заменяет управление секретами вашего рабочего подключения. Полная проверка прав и отказа опасному вызову — **отдельный тест на изолированном стенде**, а не результат учебного `echo`. [s3](#src-s3) [s4](#src-s4)

Если нужен первый собственный безопасный инструмент, откройте [гайд по локальному MCP-серверу](/zhurnal/mcp-server-lokalno/); для рабочего доступа дополнительно изучите [проверку разрешений](/zhurnal/mcp-bezopasnost-instrumentov/). [s2](#src-s2)

## Источники

1. [MCP Inspector 2.12.0 — переход с v1 на v2](https://github.com/modelcontextprotocol/inspector/blob/0cac110a809e93753fa353810b9b4c91e89810fc/docs/v1-to-v2-migration.md) — получено 2026-10-24
2. [MCP Inspector — CLI smoke-testing](https://github.com/modelcontextprotocol/inspector/blob/0cac110a809e93753fa353810b9b4c91e89810fc/docs/cli-smoke-testing.md) — получено 2026-10-24
3. [MCP Inspector — хранение секретов](https://github.com/modelcontextprotocol/inspector/blob/0cac110a809e93753fa353810b9b4c91e89810fc/docs/secret-storage.md) — получено 2026-10-24
4. [Everything MCP Server 2.0.0 — учебный сервер](https://github.com/modelcontextprotocol/servers/blob/51b6382a3e827aceb6bce430b1208d69b93d95ea/src/everything/README.md) — получено 2026-10-24
5. [MCP Inspector — CLI reference](https://github.com/modelcontextprotocol/inspector/blob/0cac110a809e93753fa353810b9b4c91e89810fc/clients/cli/README.md) — получено 2026-10-24