Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие

Что такое MCP-сервер и зачем его подключать

MCP-сервер — это программа, которая по протоколу Model Context Protocol даёт агенту инструменты: запрос к базе, открыть страницу в браузере, создать issue на GitHub. Агент сам решает, когда вызвать инструмент, а клиент (Claude Code, Cursor и т. д.) спрашивает у вас разрешение.

Серверы бывают двух видов. stdio запускается локально как процесс: в конфиге команда и аргументы. HTTP (streamable HTTP) живёт по адресу: в конфиге URL и заголовки с токеном. Третий транспорт, SSE, в документации Claude Code помечен как устаревший.

Готовые серверы собраны в разделе MCP-серверы и подборке лучших MCP.

Команды и файлы по агентам

Сверено с официальной документацией 24.10.2026.

Первоисточники: Claude Code, Codex, Cursor, VS Code, Gemini CLI, Devin Desktop, Kiro, Zed.

Как добавить MCP-сервер в Claude Code

Локальный сервер (stdio). Всё после -- уходит в команду запуска:

claude mcp add --scope project --env API_KEY=... my-server -- npx -y <пакет-сервера>

Удалённый сервер по HTTP:

claude mcp add --transport http my-remote https://example.com/mcp --header "Authorization: Bearer ..."

Область задаёт --scope. По умолчанию local: сервер виден только вам и только в этом проекте, запись ложится в ~/.claude.json. user подключает его во всех проектах. project пишет в .mcp.json в корне репозитория, и этот файл коммитят, чтобы сервер получила вся команда. Готовую JSON-запись можно передать целиком через claude mcp add-json.

Вывод инструмента больше 10 000 токенов Claude Code помечает предупреждением, потолок по умолчанию 25 000 (переменная MAX_MCP_OUTPUT_TOKENS).

Пример JSON-конфига mcpServers

Так выглядит .mcp.json с одним локальным и одним удалённым сервером. Имена и пакет условные, это шаблон, а не рабочий сервер:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "<пакет-сервера>"],
      "env": { "API_KEY": "${API_KEY}" }
    },
    "my-remote": {
      "type": "http",
      "url": "https://example.com/mcp",
      "headers": { "Authorization": "Bearer ${MCP_TOKEN}" }
    }
  }
}

В Claude Code запись с url, но без type, считается ошибкой: её читают как stdio. Подстановка ${VAR} и ${VAR:-default} работает в command, args, env, url и headers, так что токены в репозиторий не попадают.

Где ломается перенос конфига между агентами

• VS Code ждёт ключ servers, а не mcpServers. Файл из Cursor он не прочитает. Портативный .mcp.json в корне воркспейса VS Code понимает только с экспериментальной настройкой chat.mcp.workspaceRootConfig.enabled.
• Codex хранит серверы в TOML: [mcp_servers.имя] с command и args или url и bearer_token_env_var. Таймаут старта по умолчанию 10 секунд, вызова инструмента 60.
• Gemini CLI: url означает SSE, а streamable HTTP задаётся полем httpUrl. У Claude Code это type: http плюс url.
• Devin Desktop берёт удалённый адрес из serverUrl и держит не больше 100 инструментов на все серверы вместе.
• Cursor подставляет переменные через ${env:NAME}, ${userHome}, ${workspaceFolder}. Синтаксис ${VAR} из Claude Code там не тот.
• Zed использует context_servers внутри своих настроек.

Если агентов два и больше, конфиг проще генерировать из одного источника: rulesync, ruler и block/ai-rules умеют писать MCP в нативные файлы каждого агента. Подробнее в гайде про форматы.

Безопасность: что проверить перед подключением

MCP-сервер исполняет код на вашей машине или ходит в ваши аккаунты с вашим токеном. Поэтому:

• проектные серверы из .mcp.json Claude Code в интерактивной сессии запускает только после вашего одобрения, не отключайте это ради удобства;
• в Cursor вызовы инструментов по умолчанию требуют подтверждения;
• в Gemini CLI поле trust: true снимает подтверждения целиком, ставьте его только своим серверам;
• токены держите в переменных окружения, а не в файле, который уходит в git.

Сервер с открытым кодом и живым репозиторием предсказуемее закрытого бинарника. В карточках каталога лицензия, звёзды и дата обновления стоят в паспорте.