AI Agents

MCP Server Config Converter

Конвертировать mcp.json между схемами Claude Desktop, VS Code, Cursor и Warp, с маскировкой секретов.

Как это работает

MCP как протокол подключения внешних инструментов к AI-агентам вырос до сотни миллионов загрузок SDK в месяц и десятков тысяч публичных серверов, но у клиентов при этом нет единой схемы конфигурационного файла: Claude Desktop и Cursor используют корневой ключ mcpServers, VS Code — просто servers внутри объекта с обязательным полем type для каждого сервера, а Warp принимает как inline JSON, так и путь к файлу через отдельный CLI-флаг. Формальная стандартизация через SEP-2633 (mcp.json как единый клиентский формат) всё ещё в статусе черновика на середину 2026 года, так что на практике эти различия приходится преодолевать вручную. MCP Server Config Converter online переводит конфиг между четырьмя основными схемами клиентов.

Здесь стоит отдельно проговорить, почему копипаста в чат нейросети — особенно неудачная идея именно для этого файла: в mcp.json открытым текстом лежат команды запуска сторонних MCP-серверов вместе с переменными окружения, а в них сплошь и рядом — реальные API-ключи сервисов вроде Sentry, GitHub или внутренних корпоративных инструментов. Конвертер работает локально в браузере и дополнительно умеет маскировать значения env-переменных перед тем, как вы решите поделиться результатом с коллегой или приложить его к issue.

Инструмент нормализует три основных структурных различия: имя корневого ключа (mcpServers у Claude Desktop и Cursor против servers у VS Code), обязательность поля type ("stdio" или "http") в схеме VS Code, которое в остальных клиентах опционально или выводится по наличию command против url, и представление remote-серверов через url против локальных через связку command и args.

Частые вопросы

Чем отличается mcpServers в Claude Desktop от servers в VS Code?

Это разные имена одного и того же по смыслу корневого ключа объекта, у Claude Desktop и Cursor это mcpServers, а у VS Code — servers внутри специального объекта конфигурации, структура значений внутри при этом почти идентична.

Зачем в VS Code обязательно поле type, а в других клиентах нет?

VS Code явно требует указать транспорт (stdio для локального процесса или http/sse для удалённого сервера), в то время как Claude Desktop и Cursor чаще определяют это неявно по наличию поля command (локальный процесс) или url (удалённый сервер).

Насколько надёжна маскировка секретов в этом инструменте?

Как и в остальных инструментах сайта, маскировка рассчитана на визуальную демонстрацию структуры файла без раскрытия реальных значений, а не на криптографическую защиту — для по-настоящему публичного размещения стоит вообще убрать чувствительные значения, а не полагаться на частичное скрытие символов.

Работает ли конвертация для remote MCP-серверов через url, а не command?

Да, инструмент распознаёт оба варианта описания сервера — через локальный процесс с command и args, и через удалённый url — и переносит нужный вариант в целевую схему корректно.

Появится ли единый стандарт mcp.json, который отменит необходимость в конвертере?

Такое предложение, SEP-2633, действительно обсуждается сообществом MCP на середину 2026 года, но пока оно в статусе черновика без финального консенсуса, и даже после принятия существующим клиентам потребуется время на миграцию, так что конвертация между текущими схемами останется актуальной ещё какое-то время.