~/tools / MCP Config Checker
MCP Config Checker — Проверка файла конфигурации MCP на ошибки
Проверьте файл конфигурации MCP-сервера (.mcp.json или claude_desktop_config.json) на ошибки: отсутствующий type, неверный ключ верхнего уровня, зарезервированные или недопустимые имена, относительные пути, незаданные переменные и секреты, записанные прямо в файл. Ничего не покидает ваш браузер.
Правила проверены по документации 2026-10-23.
Документация: Claude Code / Model Context Protocol / VS Code
Не проверяется: существует ли команда, устанавливается ли пакет, отвечает ли удалённый сервер, а также настройки, которые другие приложения читают по-своему.
Всё выполняется в вашем браузере. Конфигурация не загружается на сервер.
MCP-серверы настраиваются в JSON-файле, и небольшая ошибка может привести к тому, что сервер молча не появится. Запись сервера с url, но без type пропускается, файл с ключом servers из VS Code не читается ни Claude Code, ни Claude Desktop, а переменная окружения, которая не задана, передаётся как обычный текст. Инструмент читает вставленную вами конфигурацию и перечисляет, что по документации работать не будет, что стоит проверить и что является лишь заметкой. Он также предупреждает, если токен, похоже, записан прямо в файл, откуда он может попасть в систему контроля версий. Правила взяты из документации Claude Code, Model Context Protocol и VS Code и проверены на дату, указанную под инструментом.
Когда пригодится
- Выяснить, почему MCP-сервер не появляется после правки .mcp.json или claude_desktop_config.json
- Проверить конфигурацию, скопированную из README, прежде чем добавлять её в общий проект
- Заметить токены и пароли, записанные в файл конфигурации, до того как он попадёт в коммит
Как пользоваться
- Вставьте содержимое файла конфигурации MCP или загрузите пример.
- Прочитайте, какие серверы найдены и какого они вида, а затем список замечаний. «Исправить» означает, что по документации запись работать не будет, «Проверить» — что на неё стоит взглянуть, а «Заметка» — что это лишь информация.
- Отредактируйте файл, вставьте его снова и перезапустите приложение, которое его читает.
Вопросы
Какие файлы и приложения он охватывает?
Формат mcpServers, который используется в проектном файле .mcp.json в Claude Code и в claude_desktop_config.json в Claude Desktop. Другие приложения могут читать иные поля или другой ключ верхнего уровня, поэтому смотрите их собственную документацию. Например, VS Code использует ключ верхнего уровня servers.
В моей записи есть url, но нет type. Чем это плохо?
Claude Code читает запись без type как сервер stdio, поэтому запись с url, но без type — это ошибка конфигурации, и сервер пропускается. Добавьте type со значением http, sse или ws.
Что происходит с переменной вроде ${API_KEY}, если она не задана?
Claude Code раскрывает ${VAR} и ${VAR:-default} в command, args, env, url и headers. Если переменная не задана и значения по умолчанию нет, конфигурация всё равно загружается, Claude Code показывает предупреждение и использует текст ${VAR} как написано. Где это безопасно, добавьте значение по умолчанию через ${VAR:-default}.
Почему он предупреждает о токене в файле?
Токен, записанный прямо в файл конфигурации, может стать общедоступным, когда файл попадёт в коммит или будет отправлен кому-то. Проверка эвристическая: она опирается на известные форматы токенов и на имена вроде api-key, token и password, поэтому может пропустить секрет или отметить безобидное значение. Использование ${VAR} не даёт значению попасть в файл.
Запускает ли он сервер или проверяет соединение?
Нет. Он только читает текст. Он не может определить, существует ли команда, можно ли установить пакет и доступен ли удалённый сервер, поэтому после успешной проверки файла протестируйте сервер в самом приложении.
Отправляется ли моя конфигурация на сервер?
Нет. Проверка выполняется в вашем браузере.