index.htm

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

Собрано нейросетью по моей исходной мысли и правкам.

На этой странице

Настройка MCP в Codex начинается с конкретной операции: найти страницу документации, прочитать задачу, проверить состояние сервиса. Когда эта операция понятна, проще выбрать сервер, ограничить доступ и увидеть, что подключение действительно работает.

Полезно сразу разделить три результата: конфигурация сохранена, сервер доступен, нужная операция выполнена. У каждого своя проверка. Запись в списке серверов подтверждает только первый этап.

За что отвечают MCP, skills и инструкции проекта

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

Skill описывает повторяемый способ работы. В SKILL.md можно объяснить, когда искать документ, как выбрать нужный результат и чем подтвердить завершение. Skill может использовать MCP, обычные файлы или команды. Наличие инструкции само по себе не устанавливает сервер и не выдаёт доступ к аккаунту.

В AGENTS.md удобно хранить правила проекта: где находятся исходники, какой способ публикации принят, какие проверки нужны. Такая договорённость помогает сохранять один порядок работы при разных задачах. Практический пример организации этих правил — OSS Agent Playbook.

Первое подключение: сервер документации

Для первого опыта подходит публичный сервер документации OpenAI: на нём можно проверить поиск и чтение без доступа к рабочим данным. В терминале выполните:

codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
codex mcp list

Для ручной настройки эквивалентная запись в ~/.codex/config.toml выглядит так:

[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"

Выберите один способ добавления. Команда codex mcp get openaiDeveloperDocs помогает проверить сохранённую запись; её вывод стоит просматривать локально, особенно для других серверов с авторизацией.

После изменения конфигурации MCP запустите новую сессию CLI и откройте /mcp. Затем дайте проверяемое задание: «Найди в официальной документации Codex описание MCP и прочитай страницу. Верни ссылку и кратко укажи поддерживаемые транспорты». В результате должны быть реальный вызов инструмента и прочитанный источник.

Локальный процесс или HTTP

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

Streamable HTTP подключается к адресу сервиса. Здесь проверяют доступность адреса, TLS, авторизацию и разрешения. Сам факт использования HTTP ещё не определяет, какие файлы видит сервер: это зависит от его размещения и реализации инструмента.

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

Права и подтверждение результата

Начинайте с операции чтения и минимально необходимой области доступа. Секреты храните вне публикуемого примера и репозитория. Для HTTP конфигурация поддерживает получение bearer-токена из переменной окружения; если сервер использует OAuth, порядок входа определяется его поддержкой, а в CLI есть codex mcp login <server-name>.

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

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

Если подключение не работает

Разбирайте сбой по месту возникновения, меняя за один раз одну причину:

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

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

Можно ли использовать skill без MCP?

Да. Skill может задавать работу с Markdown, локальными файлами или доступными командами. MCP нужен, когда выбранный процесс использует инструменты MCP-сервера.

Почему codex mcp list видит сервер, а задача не выполняется?

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

Когда действительно нужен перезапуск Codex CLI?

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

Как понять, что настройка закончена?

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

Синтаксис и возможности сверены с документацией на 2 ноября 2026 года: официальный сервер документации OpenAI, документация MCP для Codex CLI, документация skills. Для установленной версии команды можно уточнить через codex mcp --help.