Скилловик

Практическая статья

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

Подключение MCP заканчивается не после добавления команды или URL, а после проверки обнаруженных функций, разрешений, тестового вызова и способа отключения.

Сервер соединён с двумя рабочими пространствами через проверочный шлюз и контроль разрешений

Как подключить MCP-сервер без лишнего риска?

Сначала выберите доверенный сервер и transport, затем добавьте его в локальную область одного тестового проекта. Секреты передавайте через переменные окружения или штатный OAuth, а не храните в общей конфигурации. После подключения откройте список серверов и tools, проверьте один читающий вызов, откажите лишним разрешениям и заранее запишите команду отключения.

Как выбрать transport?

Если поставщик даёт URL современного удалённого сервера, используйте HTTP. Если документация даёт локальную команду запуска, нужен stdio. Устаревший SSE стоит выбирать только при отсутствии поддерживаемого HTTP-варианта. Не угадывайте transport по названию пакета: возьмите точный пример из документации сервера и сверяйте его с текущей документацией клиента.

ВходTransportЧто проверить
HTTPS URLHTTPДомен, OAuth, политика данных и доступные функции
Команда и аргументыstdioПакет, версия, рабочая папка и переменные окружения
SSE URLSSEЕсть ли у поставщика поддерживаемая HTTP-замена

Какую область конфигурации выбрать?

Для первого теста используйте локальную область одного проекта. Общая проектная конфигурация удобна команде, но попадает в репозиторий и требует отдельной проверки перед распространением. Пользовательская область подключает сервер во всех проектах и увеличивает радиус ошибки. Названия областей и места хранения различаются между клиентами, поэтому сверяйте текущую документацию каждого продукта.

Если интеграция должна работать только в одном процессе, сначала определите область по принципу из статьи личный, проектный или plugin Agent Skill.

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

Claude Code поддерживает добавление удалённого HTTP-сервера и локального stdio-сервера через `claude mcp add`. Флаги transport, env, scope и header ставятся до имени сервера; для локальной команды используется разделитель `--`. После добавления проверьте `claude mcp list`, сведения о сервере и панель `/mcp`. Для OAuth завершите вход через штатный поток клиента.

Пример синтаксиса для удалённого сервера: `claude mcp add --transport http <имя> <https-url>`. Для локального: `claude mcp add --transport stdio <имя> -- <команда> <аргументы>`. Подставляйте только значения из документации выбранного сервера.

Как добавить сервер в Codex?

В Codex MCP-сервер можно добавить командой `codex mcp add` или через раздел `mcp_servers` в `config.toml`. CLI, IDE и приложение используют конфигурацию одного Codex-хоста. Для удалённого сервера задают URL, для stdio — команду и аргументы. После изменения перезапустите или обновите клиент и проверьте, что появился именно ожидаемый сервер.

Точный синтаксис и поддерживаемые поля меняются вместе с клиентом. Перед подключением откройте актуальную страницу MCP в документации Codex и не переносите конфигурацию Claude Code без проверки названий полей.

Можно ли подключить MCP-сервер к ChatGPT?

Да, но только в поддерживаемом режиме ChatGPT и только для удалённого MCP-сервера. На 11 сентября 2026 года полная поддержка MCP с действиями изменения доступна в бета-режиме для ChatGPT Business, Enterprise и Edu; условия и интерфейс могут меняться.

В ChatGPT подключение оформляется как приложение в developer mode: администратор или владелец рабочего пространства добавляет удалённый endpoint, выбирает аутентификацию, сканирует tools и тестирует черновик до публикации. Локальный сервер на компьютере напрямую не подключается; для приватной сети нужен поддерживаемый защищённый туннель.

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

Статус connected ещё не доказывает готовность. Сопоставьте обнаруженные tools, resources и prompts с документацией сервера. Затем выполните один читающий запрос на тестовых данных, проверьте входные параметры, фактический ответ и журнал. Ошибочный запрос должен завершаться понятной ошибкой, а сервер с заявленными tools, но пустым списком, нельзя считать настроенным.

  • Сервер отображается под ожидаемым именем.
  • Набор возможностей совпадает с документацией.
  • Тестовый вызов не запрашивает лишние права.
  • Ответ содержит ожидаемые данные и источник.
  • Ошибка сети или доступа не приводит к скрытому действию.

Полный приёмочный маршрут есть в статье как проверить MCP-сервер перед подключением.

Какие разрешения выдавать?

Начните с read-only доступа к минимальному набору тестовых данных. Разделите чтение и изменение, а для отправки, удаления, оплаты, публикации и изменения прав оставьте подтверждение человека непосредственно перед действием. Доверять нужно не только серверу: внешнее содержимое, полученное через него, остаётся недоверенным и не должно отменять правила клиента или проекта.

Для токенов, журналов и дочерних процессов используйте чек-лист секретов и разрешений в Agent Skills.

Как отключить сервер и откатить настройку?

До пилота сохраните исходную конфигурацию и узнайте команду удаления сервера. После теста удалите ненужную запись, отзовите OAuth-доступ или токен у поставщика и убедитесь, что tools исчезли из клиента. Если конфигурация общая, оформите изменение через ревью. Удаление строки без отзыва внешнего доступа может оставить действующий секрет.

Если нужна помощь с ограниченным тестом, выберите сервер в каталоге Скилловика и зафиксируйте сценарий, данные и допустимые действия.

Обсудить проверку подключения

Источники

  1. Model Context ProtocolOpenAI; проверено
  2. Connect Claude Code to tools via MCPAnthropic; проверено
  3. Understanding MCP serversModel Context Protocol; проверено
  4. Authorization Security ConsiderationsModel Context Protocol; проверено
  5. Developer mode and MCP apps in ChatGPTOpenAI Help Center; проверено