Справочник по конфигурации MCP-клиентов
Каждый MCP-клиент читает конфигурацию серверов из своего файла, под своим ключом и иногда в собственном формате. В таблице указано, где её искать, какой формат использовать и поддерживается ли OAuth для удалённых серверов.
| Клиент | Файл конфигурации | Ключ верхнего уровня | Формат | OAuth для удалённых серверов | Добавление через CLI |
|---|---|---|---|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json | mcpServers | json | Да | Нет |
| Claude Code | .mcp.json | mcpServers | json | Да | Да |
| Cursor | .cursor/mcp.json | mcpServers | json | Да | Нет |
| VS Code (GitHub Copilot) | .vscode/mcp.json (key 'servers') or portable .mcp.json (key 'mcpServers') | servers | json | Да | Да |
| Windsurf / Devin Desktop | .devin/mcp_config.json (Devin CLI / Devin Local project scope) | mcpServers | json | Да | Да |
| Zed | ~/.config/zed/settings.json | context_servers | json | Да | Нет |
| OpenAI Codex CLI | .codex/config.toml (trusted projects only) | mcp_servers | toml | Да | Да |
| Gemini CLI | .gemini/settings.json | mcpServers | json | Да | Да |
| ChatGPT | Только через настройки | — | — | Да | Нет |
| OpenClaw | ~/.openclaw/openclaw.json | mcp.servers | json5 | Да | Да |
| Cline | ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json | mcpServers | json | Не документировано | Да |
| Continue | .continue/mcpServers/<name>.yaml (or drop a Claude/Cursor/Cline-style mcp.json into .continue/mcpServers/) | mcpServers | yaml | Не документировано | Нет |
| JetBrains AI Assistant | Только через настройки | mcpServers | json (pasted in UI) | Не документировано | Нет |
Различия, из-за которых конфигурация не работает
В VS Code используется ключ servers
В .vscode/mcp.json записи перечисляются под ключом servers, а не mcpServers. Поэтому конфигурация Cursor или Claude, вставленная без изменений, не загрузится. В новых переносимых конфигурационных файлах .mcp.json и ~/.copilot/mcp-config.json используется mcpServers.
В Gemini CLI нужен httpUrl, а не url
Gemini CLI выбирает транспорт по имени поля. httpUrl означает Streamable HTTP, url — устаревший транспорт SSE, а command — stdio. Для современного удалённого сервера нужен httpUrl.
По умолчанию OpenClaw и Cline используют SSE
Если не указать транспорт для удалённого сервера, оба клиента переключатся на устаревший SSE. В OpenClaw задайте transport значение streamable-http, а в Cline — type значение streamableHttp.
В Claude Code обязательно указывать type
В .mcp.json удалённая запись без type, но с url, считается ошибкой. Добавьте type http рядом с url; для записей stdio укажите type stdio.
В Codex используется TOML: отдельная таблица для каждого сервера
В Codex нет файла JSON. Для каждого сервера в config.toml создаётся отдельная таблица [mcp_servers.<name>], args задаётся как массив TOML, а env_vars передаёт секреты из окружения shell по имени.
Continue ожидает список YAML
В Continue параметр mcpServers — это список записей, каждая из которых содержит name, а не словарь с именами в качестве ключей. В начале каждого файла блока также должны быть указаны name, version и schema: v1.