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. Проверьте реальный вызов инструмента и ссылку на прочитанный источник: запись в списке ещё не означает рабочее подключение.
Выберите транспорт и доступ
- STDIO: Codex запускает локальный процесс. Проверьте исполняемый файл, аргументы, рабочий каталог, окружение и способ чтения логов.
- Streamable HTTP: проверьте адрес, TLS, авторизацию и разрешения. Если сервер поддерживает OAuth, используйте
codex mcp login <server-name>; bearer-токен можно получать из переменной окружения.
Начните с чтения и минимальных прав. Секреты храните вне примеров и Git. Уточните, на какой машине работает файловый инструмент и какой профиль использует браузерный: одинаковые пути и названия не гарантируют нужную среду.
Для записи создайте небольшой тестовый объект и прочитайте его обратно. Для публикации откройте конечный адрес и проверьте содержимое. Принятие запроса в очередь не подтверждает завершение.
Исправьте сбой
- Процесс не стартует: команда, зависимости, каталог и переменные окружения.
- 401/403: аккаунт, срок токена и права. Перезапуск не расширяет доступ.
- Таймаут: состояние сервера и его зависимостей; увеличивайте ожидание только с понятной причиной.
- Ответ есть, результата нет: перечитайте объект, проверьте среду и очередь обработки.
В отчёте оставьте операцию, ожидаемый и фактический результат, воспроизведение — без токенов и приватных ответов.
Синтаксис сверен на 2 ноября 2026 года: сервер документации OpenAI, MCP для Codex CLI, skills. Для установленной версии проверьте codex mcp --help.