~/guides/mcp-json-clients-comparison

AI Agents

mcp.json в Claude Desktop, VS Code, Cursor и Warp: одна идея, четыре немного разные схемы

Практическое сравнение схем конфигурации MCP-серверов между основными клиентами и типичные ошибки при переносе конфига между ними.

MCP как протокол подключения внешних инструментов к AI-агентам вырос за первую половину 2026 года до сотни миллионов загрузок SDK в месяц, но у клиентов до сих пор нет единой схемы конфигурационного файла. Формальный стандарт mcp.json (SEP-2633) на середину года всё ещё в статусе черновика, так что различия приходится сверять руками.

Базовое сравнение схем

Клиент Корневой ключ Обязательное поле type Формат remote-сервера
Claude Desktop mcpServers Нет, определяется неявно через url
Cursor mcpServers Нет через url
VS Code servers Да (stdio или http) через url + type: http
Warp mcpServers (через –mcp флаг) Нет через url

Пример конфига для Claude Desktop и Cursor

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.sentry.dev/mcp"],
      "env": { "SENTRY_TOKEN": "your-token-here" }
    }
  }
}

Тот же сервер в схеме VS Code

{
  "servers": {
    "sentry": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.sentry.dev/mcp"],
      "env": { "SENTRY_TOKEN": "your-token-here" }
    }
  }
}

Разница выглядит небольшой — переименованный корневой ключ и одно дополнительное поле — но именно на этом поле type спотыкается большинство при ручном переносе конфига между клиентами: VS Code явно требует его указать, а Claude Desktop и Cursor определяют транспорт неявно по наличию command (локальный процесс) или url (удалённый сервер).

Почему не стоит просто вставлять файл в чат ради конвертации

В mcp.json открытым текстом лежат команды запуска серверов вместе с переменными окружения, а в них сплошь и рядом настоящие API-ключи внешних сервисов — Sentry, GitHub, внутренних корпоративных инструментов. Передавать такой файл стороннему облачному сервису ради разовой конвертации формата — практика, которая создаёт новую точку утечки в момент решения совершенно другой задачи.

MCP Server Config Converter конвертирует между схемами локально в браузере и умеет маскировать значения env перед тем, как вы решите поделиться результатом с коллегой.

Итоговый чеклист

Корневой ключ mcpServers у Claude Desktop и Cursor становится servers у VS Code — это самое частое расхождение при ручном переносе.

VS Code явно требует поле type (stdio или http), остальные клиенты определяют транспорт неявно по структуре остальных полей.

Единый стандарт mcp.json (SEP-2633) обсуждается сообществом, но на середину 2026 года остаётся черновиком без финального консенсуса.