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

MCP подключает к Codex инструменты внешнего сервера. Skill задаёт порядок работы, а AGENTS.md — правила проекта; сами по себе они не устанавливают сервер и не дают доступ к аккаунтам. Пример организации правил — OSS Agent Playbook.

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

Публичный сервер OpenAI позволяет проверить MCP без рабочих данных:

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. Попросите агента найти и прочитать официальную страницу о MCP. Проверьте реальный вызов инструмента и ссылку на прочитанный источник: запись в списке ещё не означает рабочее подключение.

Выберите транспорт и доступ

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

Для записи создайте небольшой тестовый объект и прочитайте его обратно. Для публикации откройте конечный адрес и проверьте содержимое. Принятие запроса в очередь не подтверждает завершение.

Исправьте сбой

В отчёте оставьте операцию, ожидаемый и фактический результат, воспроизведение — без токенов и приватных ответов.

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