Чтобы подключить MCP к локальному Codex, добавьте сервер командой codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp. Начнём с OpenAI Docs MCP, который даёт только чтение. Проверьте настройку через codex mcp list, активный сервер через /mcp, затем попросите Codex вызвать его инструмент и дать ссылку на найденную страницу.
Подключение может как читать, так и отправлять данные. Поэтому сначала выясняем, какая работа нужна. Читать базу знаний, предлагать обновления и принимать их - разные действия. Разберём, где ограничить каждое.
Зачем подключать MCP: сначала задача, потом инструмент
Наша задача - найти в справке OpenAI, где хранятся настройки MCP и как задать адрес HTTP-сервера. Docs MCP даёт поиск и содержимое страниц. Рабочую базу оставим в покое: проверяем чтение документации. У других серверов могут быть действия, которые меняют данные.
С общей базой знаний могут работать разные агенты, включая Codex. Мы просто указываем везде, где она лежит.
Для Claude Code есть отдельная инструкция по MCP. Его команды в Codex не переносите.
Если хотите обсудить подключение и права своего агента, приходите в канал:
Где вы запускаете Codex: терминал, редактор, приложение или облако
Локальные клиенты используют общие настройки одного Codex-хоста - машины, где работает Codex.
| Среда | Откуда настройки и где проверять | Граница |
|---|---|---|
| Codex CLI | ~/.codex/config.toml или проектный .codex/config.toml. Проверка: codex mcp list, затем /mcp внутри Codex | Проектный файл загружается только в доверенном проекте |
| Расширение Codex в редакторе | Шестерёнка → MCP servers. После изменения - Restart extension | .vscode/mcp.json из инструкции Docs MCP относится к GitHub Copilot |
| ChatGPT desktop app | Settings → MCP servers, после сохранения - Restart. Проверка через /mcp | Не переносите это меню на Codex App |
| Облачная задача | Проверяйте соединение и вход в самой задаче | Локальных настроек недостаточно для проверки облачного подключения |
Поле environment_id выбирает среду, но доступность сервера проверяйте вызовом. ChatGPT web локальные файлы Codex не читает. Дальше работаем в терминале.
Как подключить сервер: команда или config.toml - выберите одно
Codex уже должен запускаться. Работайте в своём проекте, чужие настройки ради проверки не меняйте.
Сначала откройте страницу разработчика сервера и сверьте способ подключения. Нужно устанавливать только из официальных источников. И что попалось, с интернета не хватать.
| Транспорт | Что задают в настройках |
|---|---|
| STDIO | Локальный процесс: поле command с командой запуска |
| Streamable HTTP | Адрес сервера: поле url |
Docs MCP работает по Streamable HTTP: https://developers.openai.com/mcp. Скачивать программу для этого сервера не нужно.
Добавьте подключение в обычном терминале:
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcpВместо команды можно отредактировать ~/.codex/config.toml:
[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"Если таблица уже есть, измените её. Весь файл не заменяйте.
Для отдельного проекта есть .codex/config.toml. Ради подключения не объявляйте незнакомый репозиторий доверенным.
Теперь проверьте запись:
codex mcp listНайдите openaiDeveloperDocs среди настроенных серверов. Регистр имени не меняйте.
Команда и TOML взяты из инструкции OpenAI.
Как проверить: настройка, активный сервер и вызов инструмента
Запишите дату проверки, версию клиента и ОС компьютера. При сбое будет с чем сравнить.
Откройте Codex в терминале и введите в его поле ввода:
/mcpНайдите активный openaiDeveloperDocs, посмотрите доступные инструменты в каталоге клиента. Подробности экрана зависят от версии и интерфейса.
Затем отправьте проверочный запрос:
Используй MCP-сервер openaiDeveloperDocs. Найди в официальной документации OpenAI, где хранится конфигурация MCP в Codex и как задаётся адрес HTTP-сервера. Вызови подходящий инструмент этого сервера, назови его и дай ответ со ссылкой на найденную страницу. Не меняй файлы и настройки. Если вызвать этот сервер не удалось, не заменяй вызов ответом из памяти или поиском в интернете.В действиях клиента найдите имя сервера и инструмента, отправленный запрос и результат. Имя инструмента смотрите в текущем каталоге.
Откройте ссылку и сверьте со страницей путь к файлу настроек и поле адреса HTTP-сервера.
| Что проверяем | Что должно быть видно |
|---|---|
| Настройка | openaiDeveloperDocs есть в codex mcp list |
| Подключение | Текущая сессия показывает активный сервер через /mcp |
| Вызов | Видны обращение к его инструменту, ответ и ссылка на найденную страницу |
Проверка пройдена, когда есть все 3 результата. Даже если агент пишет «вызвал» и даёт ссылку, найдите сам вызов в действиях клиента. По одному ответу нельзя заключить, что инструмент сработал.
Для первого теста менять AGENTS.md не нужно. После проверки можно добавить постоянное правило обращаться к Docs MCP. Как собрать общий файл инструкций, разобрал отдельно.
Нужен вход? Проверьте требования сервера, не отдавайте ключ в чат
На странице разработчика смотрите, откуда берётся сервер, какие инструменты он даёт и какой способ входа нужен. Для Docs MCP начните с опубликованной команды, без OAuth-входа «на всякий случай».
Для HTTP-серверов Codex поддерживает bearer token и OAuth. Если другой сервис поддерживает и требует OAuth, выполните:
codex mcp login <server-name>Подставьте имя этого сервера. Для openaiDeveloperDocs это не обязательный шаг. В расширении Codex и ChatGPT desktop app для OAuth используется Authenticate.
Если сервис принимает bearer token, в bearer_token_env_var укажите имя переменной окружения с токеном. env_http_headers связывает имена заголовков с именами переменных окружения. Статические http_headers содержат значения прямо в конфигурации - не считайте их хранилищем секретов.
Вход в Codex не доказывает, что есть доступ к нужной записи внешнего сервиса. Разрешения выбирайте по задаче и справке сервиса. Не открывайте все действия ради устранения ошибки.
Доступные в вашей версии команды смотрите в справке:
codex mcp --helpПароли, ключи API и значения переменных с секретами в чат не отправляйте. При разборе ошибки укажите способ входа, секреты из сообщения уберите.
Кстати, я снял полный гайд про связку для первого агента Hermes Agent, обязательно посмотрите.
Внутри - что такое MCP, какие права давать агенту и как не поставить вредный MCP. Посмотрите перед выбором подключения. Это пример на Hermes, не инструкция для Codex.
Как разделить чтение, изменение данных и подтверждение
А теперь представьте, что со вторым мозгом работает ваша команда.
Сотрудники подключаются через MCP, читают доступные им знания и разделы, могут предлагать обновления. А вы видите эти обновления и принимаете их.
В рабочем сервисе и Codex проверьте 3 уровня:
| Уровень | Что ограничивает | Чего не делает |
|---|---|---|
| Права пользователя или токена во внешней системе | Доступ к данным и действиям. Минимальные права задавайте по справке сервиса | Универсальной настройки прав любой CRM в Codex нет |
enabled_tools и disabled_tools в Codex | Доступные инструменты. Список запретов применяется после списка разрешений | Не отзывает права токена у сервиса |
| Подтверждение действия в Codex | default_tools_approval_mode, для отдельного инструмента - tools.<tool>.approval_mode | Не выдаёт и не отзывает серверные права |
Режим prompt запрашивает разрешение. Режим writes спрашивает подтверждение для инструментов без отметки read-only. Права записи в самом сервисе задаются отдельно.
Имена инструментов для списков берите из каталога сервера. Оставьте нужные для задачи и проверьте подтверждения.
Просьба «не меняй файлы и настройки» ограничивает поручение. Рабочую базу защищайте правами доступа в самой системе. Docs MCP не проверяет права в вашей CRM. Пробовать удаление ради проверки ограничений не нужно.
Если после подключения хотите собрать своего агента для рабочего проекта, посмотрите программу практикума СмыслоКода:
Не заработало: найдите, на каком месте остановились
После исправления повторите тот же запрос к openaiDeveloperDocs.
| Что видно | Следующая проверка | Когда продолжать |
|---|---|---|
В codex mcp list нет имени | Сверьте путь к файлу, заголовок [mcp_servers.openaiDeveloperDocs] и доверие проекту. Не добавляйте сервер повторно вслепую | Запись появилась в списке |
| Запись есть, активного сервера нет | Проверьте enabled, URL или команду запуска, настройки текущей машины. В редакторе - Restart extension, в ChatGPT desktop app - Restart | Клиент показывает активный сервер |
| Интерфейс просит вход или вызов сообщает об ошибке авторизации | Сверьте требования сервиса и способ получения учётных данных. Для требующего OAuth сервера выполните вход | После входа доступ проверен повторно |
| Подключение и инструменты есть, вызова нет | Проверьте списки разрешённых и запрещённых инструментов. Явно попросите обратиться к Docs MCP | В действиях клиента виден вызов |
| Инструмент вызван, но вернул ошибку или не ответил вовремя | Уберите секреты из текста ошибки. Проверьте соединение, требования сервера и вид таймаута | Повторный вызов дал результат со ссылкой |
startup_timeout_sec - время ожидания запуска сервера, по умолчанию 10 секунд. tool_timeout_sec - время выполнения инструмента, по умолчанию 60 секунд. Сначала выясните, какое ожидание закончилось. Не повышайте оба значения вслепую.
Для вызова нужно живое соединение с сервером, даже если каталог инструментов сохранился.
Если сам Codex не запускается, начните с проверки клиента.
Не используете MCP - отключите и повторите проверку
В существующей таблице openaiDeveloperDocs добавьте или измените поле enabled:
[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"
enabled = falseДругие настройки оставьте как есть. Не дописывайте дубликат таблицы.
Откройте новую сессию Codex в терминале. В редакторе выберите Restart extension, в ChatGPT desktop app - Restart. Снова посмотрите /mcp и отправьте тот же проверочный запрос.
Сервер больше не активен в текущей сессии, его MCP-инструмент не вызывается - значит, отключение сработало. Запись в настройках остаётся: enabled = false не удаляет конфигурацию.
Проверяйте состояние клиента и вызовы инструментов. Сам ответ агент может взять из памяти, старой переписки или интернета.
Для авторизованного рабочего сервиса отдельно отзовите доступ на его стороне по инструкции разработчика. Локальное enabled = false прав токена не меняет.
Вопросы и ответы
Частые вопросы
Какой доступ вы собираетесь дать Codex: чтение документации, работу с базой знаний или изменение рабочих данных? Напишите в комментариях в канале, где у вас проходит граница между чтением и изменением.
Источники
- OpenAI: Docs MCP - адрес, чтение документации, команда подключения и TOML.
- OpenAI: Model Context Protocol - клиенты Codex, проверка, вход, инструменты, подтверждения и отключение.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.
