Codex MCP: как подключить сервер и проверить инструменты в 2026

Codex MCP позволяет подключить к Codex внешние инструменты и источники данных: документацию, браузер, макеты или рабочие сервисы. Для большинства удобнее начать в десктопном приложении ChatGPT, добавить один доверенный сервер и проверить его через /mcp; CLI и ручная настройка нужны, если вы уже уверенно работаете в терминале.

Что именно даёт MCP в Codex

MCP, или Model Context Protocol, связывает модель с контекстом и действиями внешнего сервера. Сервер может отдавать ресурсы, готовые подсказки и инструменты, например чтение документации или работу с файлами. По официальной документации OpenAI, локальные клиенты Codex поддерживают серверы, запускаемые процессом STDIO, и удалённые серверы Streamable HTTP.

Важно различать подключение и результат. После добавления сервера Codex получает только те возможности, которые сервер объявил и которые разрешены настройками. Это не делает любой сервис автоматически надёжным и не отменяет проверку каждого действия.

• STDIO подходит для локального сервера, который запускается командой на вашем компьютере.
• Streamable HTTP подходит для сервера по сетевому адресу и может использовать OAuth или другой предусмотренный способ входа.
• Плагин в ChatGPT Work может давать удалённые MCP-инструменты, но веб-версия ChatGPT не читает локальный ~/.codex/config.toml.

Что подготовить до подключения

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

Перед добавлением запишите ожидаемый результат одной строкой. Пример: «сервер должен находить официальную документацию, но не менять файлы». Затем проверьте издателя, команду запуска или домен, список доступных инструментов и требуемые права. Не подключайте случайный пакет только потому, что его команда встретилась в чужой инструкции.

Правило минимальных прав: сначала разрешите только чтение и одну проверяемую задачу. Запись, отправку данных и внешние изменения включайте лишь после просмотра списка инструментов.

Как подключить MCP-сервер в приложении

В приложении откройте Settings, затем MCP servers и Add server. Укажите понятное имя, выберите STDIO или Streamable HTTP, вставьте команду запуска либо адрес, сохраните настройку и перезапустите приложение. Такой порядок прямо указан в руководстве OpenAI по MCP.

1. Добавьте один сервер, чтобы при ошибке было понятно, какую настройку проверять.
2. После перезапуска откройте список серверов и убедитесь, что нужный сервер включён.
3. Если требуется вход через OAuth, нажмите Authenticate и завершите вход на официальной странице сервиса.
4. В поле сообщения введите /mcp и проверьте, что сервер отображается подключённым.
5. Попросите Codex перечислить доступные инструменты, затем выполните безопасную операцию чтения.
6. Сравните результат с исходным источником: названием файла, заголовком документа или числом найденных объектов.

Проверка должна доказывать не только статус соединения. Сервер может быть виден, но не иметь нужного инструмента или доступа к данным. Рабочий критерий выглядит так: /mcp показывает сервер, нужный инструмент есть в списке, операция чтения возвращает ожидаемый объект, а лишних прав у сервера нет.

По теме: Разработка ИИ-агентов в 2026: архитектура, инструменты и с чего начать

Как подключить сервер через Codex CLI

CLI полезен, когда настройку нужно повторить или хранить на уровне проекта. OpenAI указывает, что приложение, Codex CLI и расширение IDE используют общую конфигурацию одного хоста. По умолчанию она находится в ~/.codex/config.toml; для доверенного проекта возможен файл .codex/config.toml. Подробнее о терминальном варианте есть в разборе команд Codex CLI.

codex mcp add context7 -- npx -y @upstash/context7-mcp
codex mcp list
codex mcp --help

Первая команда использует пример из официальной документации OpenAI, вторая показывает настроенные серверы, третья выводит доступные команды вашей установленной версии. Для сервера с OAuth применяется codex mcp login <server-name>. После добавления снова откройте Codex и проверьте сервер через /mcp.

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

Диагностика: сервер есть, но инструмент не работает

Идите от соединения к конкретному действию. Такой порядок не даёт маскировать проблему повторной установкой всего приложения.

1. Проверьте codex mcp list или /mcp: сервер должен быть включён, а не просто сохранён в файле.
2. Для STDIO запустите указанную команду отдельно и прочитайте ошибку запуска. Частые причины: пакет не установлен, команда недоступна или неверна рабочая папка.
3. Для Streamable HTTP проверьте адрес и завершён ли OAuth-вход. Не подменяйте сетевую ошибку повторным вводом данных доступа.
4. Убедитесь, что нужный инструмент не исключён списками enabled_tools и disabled_tools.
5. Повторите только безопасное чтение. Если чтение работает, а запись нет, проверьте режим подтверждений и права сервиса.
6. Отключите новый сервер и убедитесь, что остальная работа Codex восстановилась. Это отделяет ошибку MCP от проблемы самого проекта.

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

По теме: Лучшие ИИ-агенты 2026: рейтинг по задачам и ценам

Проверочный чек-лист перед рабочей задачей

• Издатель сервера и адрес документации подтверждены.
• Выбран подходящий транспорт: локальный процесс или удалённый адрес.
• Сервер виден в /mcp, а нужный инструмент присутствует в списке.
• Первая операция только читает данные и возвращает заранее известный результат.
• Разрешения ограничены задачей, опасные действия требуют подтверждения.
• Понятен способ отключить сервер и повторить работу без него.
• В проект не попали данные доступа и лишние локальные настройки.

MCP не нужен, если Codex уже видит все файлы проекта и задача выполняется встроенными средствами. Не добавляйте сервер ради самого подключения. Он оправдан, когда даёт конкретный недостающий источник или действие, которое можно ограничить и проверить.

Частые вопросы

MCP и плагин Codex это одно и то же?

Нет. MCP описывает способ подключения инструментов и контекста. Плагин может включать MCP-инструменты вместе с другими возможностями и правилами установки.

Нужно ли править config.toml вручную?

Нет. В приложении можно добавить сервер через Settings, а в терминале через codex mcp add. Ручная правка нужна для тонких параметров и проектной области.

Почему сервер виден, а нужного действия нет?

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

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

Не следует. Локальный сервер запускается с правами вашего клиента, а удалённый получает передаваемые ему данные. Используйте доверенного издателя и минимальные права.