Как подключить MCP-сервер: Claude, Cursor, Codex и ChatGPT

Чем локальный MCP-сервер отличается от удаленного?

До подключения посмотрите в README сервера, как он работает. От этого зависит, что писать в настройках.

• Локальный сервер (транспорт stdio) агент запускает сам как программу на вашем компьютере через npx, uvx, docker или по пути к файлу. В настройках указывают команду и аргументы.
• Удаленный сервер (транспорт Streamable HTTP) работает в сети по адресу вроде https://mcp.context7.com/mcp. В настройках указывают адрес, вход обычно идет через OAuth или ключ в заголовке.

Документация Claude Code называет транспорт SSE устаревшим и советует HTTP, если сервер его поддерживает. Многие серверы умеют оба режима. Например, у Context7 есть пакет @upstash/context7-mcp для локального запуска и адрес https://mcp.context7.com/mcp для удаленного. Этот сервер дальше служит примером во всех клиентах.

Если термин MCP пока новый, начните со статьи что такое MCP-сервер, в ней устройство протокола объяснено на примерах.

Как подключить MCP к Claude Code?

Команды ниже взяты из документации Claude Code. Локальный сервер добавляет команда claude mcp add context7 -- npx -y @upstash/context7-mcp. Двойной дефис отделяет параметры Claude Code от команды сервера, иначе флаги вроде -y CLI примет за свои.

Для удаленного сервера команда другая: claude mcp add --transport http context7 https://mcp.context7.com/mcp. Заголовок с ключом добавляют флагом --header "Authorization: Bearer ваш-токен", переменные окружения для локального сервера — флагом --env KEY=value.

У Claude Code три области хранения.

1. Local, по умолчанию. Сервер виден только вам и только в текущем проекте, запись лежит в ~/.claude.json.
2. Project, флаг --scope project. Запись попадает в .mcp.json в корне проекта, ее можно закоммитить для команды. Перед первым запуском такой сервер Claude Code просит одобрить.
3. User, флаг --scope user. Сервер доступен во всех ваших проектах.

Если у вас уже есть блок mcpServers из другого клиента, его переносят командой claude mcp add-json имя '{"command":"npx","args":["-y","@upstash/context7-mcp"]}'. Передавать нужно объект внутри mcpServers, без обертки. Ответ инструмента больше 10 000 токенов Claude Code помечает предупреждением, а по умолчанию обрезает вывод на 25 000 токенов. Предел поднимает переменная MAX_MCP_OUTPUT_TOKENS.

Как подключить MCP к Claude Desktop и claude.ai?

Здесь два разных механизма. Справка Anthropic разделяет их явно.

Удаленный сервер подключают как пользовательский коннектор. На тарифах Pro и Max откройте Customize, затем Connectors, кнопка «+ Add» и пункт Add custom connector. Вставьте адрес сервера и пройдите вход. Коннекторы доступны и на бесплатном тарифе, но там разрешен один пользовательский коннектор. В Team и Enterprise коннектор сначала добавляет владелец организации, потом каждый участник подключает его у себя. Такой коннектор работает и в приложении, и на claude.ai.

Локальный сервер работает только в Claude Desktop. Откройте меню Claude в строке меню системы (не настройки внутри окна), выберите Settings, вкладку Developer и кнопку Edit Config. Откроется claude_desktop_config.json: на macOS он лежит в ~/Library/Application Support/Claude/, на Windows в %APPDATA%\Claude\. Внутрь пишут блок {"mcpServers": {"context7": {"command": "npx", "args": ["-y", "@upstash/context7-mcp"]}}}. После сохранения приложение закрывают полностью и открывают снова, иначе новый сервер не загрузится.

Как подключить MCP к Cursor?

Cursor читает .cursor/mcp.json в проекте и ~/.cursor/mcp.json для всех проектов. Формат тот же, что у Claude Desktop. Верхний ключ mcpServers, внутри command, args и env для локального сервера или url и headers для удаленного.

Удаленный Context7 в Cursor записывается одной строкой {"mcpServers": {"context7": {"url": "https://mcp.context7.com/mcp"}}}. Ключи в файл открытым текстом писать необязательно: Cursor подставляет переменные окружения через ${env:ИМЯ} в полях command, args, env, url и headers.

Серверы из маркетплейса Cursor ставятся кнопкой Add to Cursor с входом через OAuth. Включать и выключать серверы можно в разделе Customize на боковой панели. Ошибки подключения видно в панели Output (Cmd+Shift+U на macOS), канал MCP Logs.

Как подключить MCP к Codex?

Codex CLI добавляет серверы командой codex mcp add context7 -- npx -y @upstash/context7-mcp. Переменные окружения передают флагом --env VAR=значение до двойного дефиса. Удаленный сервер добавляет codex mcp add context7 --url https://mcp.context7.com/mcp. Для серверов с OAuth есть codex mcp login имя.

Настройки хранятся в ~/.codex/config.toml, для доверенного проекта можно завести .codex/config.toml. Каждый сервер описывают таблицей [mcp_servers.имя] с полями command, args, env или url. Токен для удаленного сервера Codex берет из переменной, имя которой указывают в bearer_token_env_var. На запуск сервера по умолчанию дается 10 секунд (startup_timeout_sec), на вызов инструмента 60 секунд (tool_timeout_sec). Если сервер при первом запуске скачивает пакеты, поднимите startup_timeout_sec.

Внутри Codex список активных серверов показывает команда /mcp. Первые шаги в Codex разобраны в статье Codex CLI, скиллы и MCP.

Как подключить MCP к OpenCode?

В OpenCode серверы описывают в opencode.json под ключом mcp. Для локального сервера type равен local, а команда задается массивом "command": ["npx", "-y", "@upstash/context7-mcp"]. Переменные кладут в поле environment. Для удаленного сервера type равен remote, рядом url и при необходимости headers. Поле enabled позволяет выключить сервер, не удаляя запись.

Команды opencode mcp list и opencode mcp auth имя показывают статус серверов и проводят вход по OAuth. Таймаут по умолчанию 30 секунд. Подробнее об агенте в статье OpenCode.

Как подключить MCP к Gemini CLI?

Команда gemini mcp add по умолчанию пишет сервер в настройки проекта .gemini/settings.json, флаг -s user переносит его в ~/.gemini/settings.json. Удаленный сервер добавляет gemini mcp add --transport http context7 https://mcp.context7.com/mcp. Локальный по примеру из документации: gemini mcp add -e API_KEY=123 my-server /path/to/server arg1, где -e передает переменную окружения. Заголовки для HTTP задают флагом -H.

В файле настроек у Gemini CLI свое поле для HTTP httpUrl, поле url там означает SSE. Флаг --trust отключает подтверждение каждого вызова, включать его я бы не стал. На сайте Gemini CLI сказано, что 18 июня 2026 года для бесплатного тарифа и подписчиков Google One его заменил Antigravity CLI, поэтому сначала уточните, какой CLI у вас. Подробности в статье Gemini CLI.

Как подключить MCP в VS Code?

В VS Code сервер проще всего добавить командой MCP: Add Server из палитры команд. Мастер спросит тип (HTTP или stdio) и адрес либо команду. Формат VS Code отличается от остальных: верхний ключ называется servers, у каждой записи есть поле type со значением stdio или http.

Для секретов VS Code предлагает блок inputs. Значение запрашивается при первом запуске сервера и хранится в защищенном хранилище, в файл попадает только ссылка ${input:api-key}. Запускать, останавливать серверы и смотреть их журнал позволяет команда MCP: List Servers. Файл .vscode/mcp.json в проекте пока работает, но в новом мастере VS Code помечает его как устаревший и предлагает глобальный ~/.copilot/mcp-config.json.

Как подключить MCP к ChatGPT?

ChatGPT подключает только удаленные серверы. Документация OpenAI Apps SDK описывает путь через страницу chatgpt.com/plugins. Там нажимают кнопку «плюс», выбирают Add custom MCP server и вводят имя, описание и адрес сервера вместе с путем /mcp. Сервер должен быть доступен по публичному HTTPS или через Secure MCP Tunnel. После подтверждения предупреждения ChatGPT создает плагин, показывает найденные инструменты, а в новом чате плагин вызывают через @.

Доступ к функции зависит от тарифа и настроек рабочего пространства. По справке OpenAI полный режим с записью доступен в Business, Enterprise и Edu, в остальных тарифах набор возможностей меньше. Интерфейс ChatGPT обновляется часто, поэтому сверяйте названия пунктов с тем, что видите у себя. Локальный сервер с вашего компьютера ChatGPT напрямую не увидит.

Как подключить Figma MCP?

У Figma есть официальный удаленный сервер по адресу https://mcp.figma.com/mcp, в каталоге это Figma MCP Server. В Claude Code его добавляют командой claude mcp add --transport http figma https://mcp.figma.com/mcp, в Codex через --url, вход идет через OAuth. Режимы работы и ограничения разобраны в статье Figma MCP для агентов.

Как подключить MCP ко всем агентам одной командой?

Если агентов несколько, править конфиг каждого агента вручную долго. CLI SkillFoxx пишет запись сразу в нужные конфиги командой npx skillfoxx add mcp/context7 --agent claude-code,cursor,codex. Флаг --dry-run показывает план без изменений. Для Context7 он перечисляет .claude.json, .cursor/mcp.json, .codex/config.toml, конфиг OpenCode, .gemini/settings.json и mcp.json VS Code с ключом записи в каждом.

До установки CLI печатает уровень доступа и причины. Записи с широким доступом без явного согласия не ставятся, CLI просит запустить его в терминале или добавить --yes. Если у записи нет проверенного рецепта, CLI отправляет на карточку с ручной инструкцией. Подробнее в статье как поставить MCP и скиллы одной командой.

Как передать API-ключ и переменные окружения?

Каждый клиент умеет передавать переменные серверу, синтаксис разный.

• Claude Code принимает --env KEY=value в команде или поле env в .mcp.json.
• Codex берет --env KEY=value или таблицу [mcp_servers.имя.env], токен для HTTP читает из переменной в bearer_token_env_var.
• Cursor читает поле env и подставляет ${env:ИМЯ}.
• Gemini CLI понимает -e KEY=value и $ИМЯ в поле env.
• VS Code хранит секрет через блок inputs и ссылку ${input:id}.

Файл .mcp.json проекта обычно попадает в git. Ключ в нем открытым текстом увидит любой, у кого есть доступ к репозиторию, поэтому в общий файл кладите ссылку на переменную, а сам ключ держите в окружении.

Как проверить, что MCP-сервер подключился?

Самая подробная проверка у Claude Code. Команда claude mcp list показывает статус каждого сервера, например Connected, Needs authentication или Failed to connect с причиной. claude mcp get имя выводит детали одного сервера, а /mcp внутри сессии позволяет переподключить сервер и пройти вход.

В других клиентах статус показывают /mcp в Codex и Gemini CLI, opencode mcp list в OpenCode, MCP: List Servers в VS Code и канал MCP Logs в Cursor. Claude Desktop пишет журнал в ~/Library/Logs/Claude на macOS и %APPDATA%\Claude\logs на Windows: общий файл mcp.log и отдельный mcp-server-ИМЯ.log на каждый сервер.

Если клиент молчит, запустите сервер напрямую из терминала той же командой, что в конфиге. Ошибка запуска будет видна сразу. Для отладки протокола есть MCP Inspector: npx @modelcontextprotocol/inspector открывает в браузере панель, где можно вызвать любой инструмент сервера вручную.

Почему MCP-сервер не подключается?

Пять причин встречаются чаще других.

1. Нет Node.js или uv. Серверы на npx требуют Node.js, проверить можно командой node --version. Серверам на uvx нужен uv.
2. Клиент не находит npx или uvx. README сервера Blender MCP объясняет причину. Приложения, запущенные из Dock или меню «Пуск», не получают PATH вашего терминала, отсюда ошибка spawn uvx ENOENT. Решение: узнать полный путь командой which uvx (на Windows where uvx) и вписать его в command. На Windows еще помогает обертка "command": "cmd", "args": ["/c", "uvx", ...].
3. Сломанный JSON. Одна лишняя запятая, и файл не загрузится целиком, вместе с остальными серверами.
4. Относительные пути. Документация MCP требует абсолютные пути к папкам и файлам в аргументах, в JSON на Windows обратную косую черту удваивают, например C:\\Users\\имя\\Desktop.
5. Таймаут первого запуска. При первом npx -y пакет скачивается, и сервер может не уложиться в 10 секунд Codex. Поднимите startup_timeout_sec или для Claude Code задайте больший таймаут запуска в миллисекундах, например MCP_TIMEOUT=30000 claude для 30 секунд.

На Windows бывает ошибка ENOENT с ${APPDATA} в пути. Документация MCP советует добавить в env сервера полное значение APPDATA и проверить, что npm установлен глобально.

Какие права получает MCP-сервер?

Локальный сервер работает с правами вашей учетной записи и может делать с файлами все, что можете вы. Удаленный сервер получает те данные, которые агент ему передает, и доступ, который дает выданный ключ.

Поэтому начинайте с одного сервера на чтение, отдельного токена с узкими правами и тестовой копии базы. Подтверждение вызовов инструментов не выключайте, пока не убедились, что сервер делает то, что обещает. В карточках каталога у каждого сервера указан уровень доступа (минимальный, расширенный или широкий) с причинами, например «выполняет произвольный Python-код». Из популярных серверов с понятным назначением для старта подойдут Context7 для документации библиотек, Playwright MCP для браузера и Chrome DevTools MCP для отладки страниц.

Что дальше

Выберите один сервер под текущую задачу и подключите его к агенту, с которым работаете каждый день. Подборка проверенных серверов собрана в статье лучшие MCP-серверы, официальные эталонные реализации лежат в репозитории MCP Servers, а GitHub MCP Server пригодится, если агент работает с репозиториями. Если не знаете, с чего начать, опишите проект в подборе Foxx AI: он предложит серверы из каталога с командой установки.