Tool overview
Что такое Валидатор сервера MCP?
Валидатор сервера MCP — инструмент, который помогает проверка JSON-конфигураций клиентов mcpServers.
Зачем использовать Валидатор сервера MCP?
Повышает читаемость и скорость работы, когда нужно проверка JSON-конфигураций клиентов mcpServers, без отправки данных на сервер.
Ключевые возможности
Конфиденциальность на стороне клиента, мгновенный результат и копирование в один клик. Проверка JSON-конфигураций клиентов mcpServers
Как использовать
Следуйте этим шагам, чтобы получить точные результаты с инструментом выше.
- Вставьте JSON-конфигурацию Cursor или Claude Desktop с объектом верхнего уровня mcpServers.
- Просмотрите отчёт: ошибки (блокирующие) и предупреждения (неблокирующие) с JSON Pointer путями.
- Исправьте транспорт: stdio нужен command (+ args); удалённому — валидный http/https url.
- Убедитесь, что env содержит только строки, а args — массив строк.
- По возможности удалите dual command+url и неизвестные ключи с предупреждениями.
- Повторяйте проверку, пока ok не станет true — одни предупреждения не проваливают, но это долг.
- Вставьте исправленный JSON обратно в конфиг клиента и перезагрузите MCP-серверы.
- Скопируйте отчёт в PR или CI-чеклист; секреты оставляйте плейсхолдерами.
Валидатор MCP — полное руководство и сценарии
Авторитетное руководство: ошибки и предупреждения, stdio и HTTP, сценарии Cursor и Claude Desktop, правила env-строк, исправления и гигиена секретов.
Руководство MCP Validator — начните здесь
Это руководство объясняет локальную проверку JSON-конфигурации mcpServers. Вставляйте данные без секретов и исправляйте проблемы до работы в Cursor или Claude Desktop.
Что делает MCP Validator
MCP Validator проверяет в браузере записи mcpServers, транспорты и типы JSON, находя конфигурации, которые клиент не сможет запустить.
Локальный отчёт с путями JSON и исправляемыми проблемами
- Локальный отчёт с путями JSON и исправляемыми проблемами
- Локальный отчёт с путями JSON и исправляемыми проблемами: mcpServers, command, args, url, env
- Локальный отчёт с путями JSON и исправляемыми проблемами: stdio, http, https
- Локальный отчёт с путями JSON и исправляемыми проблемами: JSON, ok
Используйте перед вставкой или публикацией MCP-конфигурации
- Используйте перед вставкой или публикацией MCP-конфигурации
- Используйте перед вставкой или публикацией MCP-конфигурации: Cursor mcp.json
- Используйте перед вставкой или публикацией MCP-конфигурации: Claude Desktop
- Используйте перед вставкой или публикацией MCP-конфигурации: CI / PR
Для создания схем или промптов используйте связанный инструмент
- Для создания схем или промптов используйте связанный инструмент
- Для создания схем или промптов используйте связанный инструмент: AI Agent Builder
- Для создания схем или промптов используйте связанный инструмент: JSON Schema
Ошибки и предупреждения — что блокирует вставку
Ошибка: конфигурация блокирует проверку
Справочник серьёзности
| Справочник серьёзности | Влияние на ok | Типичные причины |
|---|---|---|
| Ошибка: конфигурация блокирует проверку | Влияние на ok: ok = false | Типичные причины |
| Предупреждение: проверьте эту деталь до продакшена | Влияние на ok: ok | Типичные причины |
Предупреждение: проверьте эту деталь до продакшена
Пошагово: вставить, проверить, исправить, вставить обратно
Как помогает этот инструмент
- Вставьте JSON с mcpServers.
- Сначала исправьте ошибки.
- Проверьте command, args, url и env.
- Выберите один транспорт для сервера.
- Для удалённых серверов используйте http:// или https://.
- Преобразуйте значения env в строки.
- Повторяйте проверку, пока ok не станет true.
- Вставьте исправленный JSON в клиент.
Сценарий: исправить Cursor mcp.json до перезагрузки
Ошибка: конфигурация блокирует проверку Cursor mcp.json.
Как помогает этот инструмент
- Вставьте JSON с mcpServers.
- Сначала исправьте ошибки.
- Проверьте command, args, url и env.
- Выберите один транспорт для сервера.
Результат: ясная, проверенная и готовая к работе MCP-конфигурация.
Сценарий: удалённый MCP URL в Claude Desktop
Ошибка: конфигурация блокирует проверку Claude Desktop.
Как помогает этот инструмент
- Вставьте JSON с mcpServers.
- Сначала исправьте ошибки.
- Проверьте command, args, url и env.
- Выберите один транспорт для сервера.
Результат: ясная, проверенная и готовая к работе MCP-конфигурация.
Сценарий: проверить MCP-шаблоны в PR
Ошибка: конфигурация блокирует проверку CI / PR.
Как помогает этот инструмент
- Вставьте JSON с mcpServers.
- Сначала исправьте ошибки.
- Проверьте command, args, url и env.
- Выберите один транспорт для сервера.
Результат: ясная, проверенная и готовая к работе MCP-конфигурация.
Сценарий: гигиена секретов при отладке
Ошибка: конфигурация блокирует проверку env.
Как помогает этот инструмент
- Вставьте JSON с mcpServers.
- Сначала исправьте ошибки.
- Проверьте command, args, url и env.
- Выберите один транспорт для сервера.
Результат: ясная, проверенная и готовая к работе MCP-конфигурация.
Правила транспорта stdio и HTTP/HTTPS
Формы транспорта
Формы транспорта
| Формы транспорта | Обязательные поля | Примечания |
|---|---|---|
| stdio | command; args | Примечания |
| HTTP / HTTPS | url (http:// or https://) | Примечания |
Примечания: env, headers, disabled.
Значения env должны быть строками
env: Обязательные поля
- env: Обязательные поля
- Обязательные поля
- JSON
- mcpServers
Исправление: отсутствует command или url
Ошибка: конфигурация блокирует проверку: command or url.
Почему это происходит
Почему это происходит
Диагностика
Диагностика
Исправления
- Вставьте JSON с mcpServers.
- Сначала исправьте ошибки.
- Проверьте command, args, url и env.
Исправление: нестроковые значения env
Ошибка: конфигурация блокирует проверку: env.
Почему это происходит
Почему это происходит
Диагностика
Диагностика
Исправления
- Вставьте JSON с mcpServers.
- Сначала исправьте ошибки.
- Проверьте command, args, url и env.
Предупреждение: проверьте эту деталь до продакшена
Исправление: неверный корневой envelope
Ошибка: конфигурация блокирует проверку: mcpServers.
Почему это происходит
Почему это происходит
Диагностика
Диагностика
Исправления
- Вставьте JSON с mcpServers.
- Сначала исправьте ошибки.
- Проверьте command, args, url и env.
Лучшие практики валидации MCP
- Проверяйте до вставки в Cursor или Claude Desktop.
- Используйте command или url, но не оба.
- Храните args как массив строк.
- Храните env как строки.
- Используйте заполнители для секретов.
- Используйте абсолютные пути с минимальными правами.
- Повторяйте проверку после каждого изменения.
- Разбирайте предупреждения до продакшена.
Часто задаваемые вопросы
Развёрнутые ответы на типичные проблемы отладки и вопросы конфиденциальности данных.
Связанные инструменты
Ознакомьтесь с другими связанными утилитами, дополняющими этот инструмент.
Официальная документация и ссылки
Авторитетные спецификации и документация платформы для этой утилиты.