Codex .mcp.json: MCP OAuth и /app Desktop handoff

8 июня 2026 года OpenAI выпустила Codex rust-v0.138.0. Релиз примечателен не одной заголовочной функцией, а кластером операторских улучшений: более широкая поддержка скриптования, повышенная надёжность при флотовом развёртывании и устранение исторических «тихих» отказов, связанных с истёкшими учётными данными и некорректно разрешёнными корнями рабочих пространств.

Что изменилось

JSON-автоматизация плагинов — оператор plugin JSON API. Команды codex plugin add, codex plugin remove и marketplace-команды теперь принимают и возвращают структурированный --json-вывод. JSON plugin list включает marketplace-источник каждого плагина, а детальные payload плагинов теперь раскрывают дефолтные промпты, удалённые MCP-серверы и недоступные app-шаблоны. Для команд, управляющих конфигурацией плагинов Codex в масштабе флота, это делает автоматизацию через shell-скрипты или CI-инструменты полностью практичной без необходимости интерактивных TUI-сессий.

Команда /app — переход CLI в Desktop. Новая команда /app передаёт текущий CLI-поток в Codex Desktop на macOS и нативном Windows, сохраняя контекст сессии. Запуск рабочего пространства в Windows теперь может открываться сразу в Desktop вместо ожидания на ручном промпте. Это удобно для команд, которые инициируют сессии из CLI или через CI, но хотят, чтобы разработчики продолжали работу в более богатом Desktop UX.

Предобновление OAuth-учётных данных MCP. При запуске Codex теперь предобновляет истёкшие OAuth-учётные данные для MCP-серверов до начала сессии. Ранее MCP-сервер с устаревшим токеном отказывал при первом вызове инструмента — нередко посередине сессии — и требовал ручной повторной аутентификации. Предобновление при старте устраняет эту проблему: к моменту первого реального вызова инструмента учётные данные уже актуальны.

Исправление загрузки AGENTS.md для удалённых и симлинк-рабочих пространств. Загрузка инструкций рабочего пространства теперь корректна для удалённых репозиториев и симлинкованных корней. Ранее Codex мог подхватить неверный AGENTS.md или не найти его вовсе, когда корень рабочего пространства был симлинком или удалённым клонированным путём. Это исправление критично для команд с монорепозиториями, общими NFS/SMB-монтированиями или контейнерными volume-монтированиями, где симлинки повсеместны.

API потребления токенов аккаунта. App-server интеграции теперь могут читать потребление токенов на уровне аккаунта через API, что позволяет строить инструменты атрибуции затрат поверх app-server протокола Codex без обращения к отдельным endpoint-ам OpenAI API.

Улучшения запуска и надёжности. TUI-запуск теперь переиспользует результаты обнаружения плагинов и загружает только метаданные хуков на критическом пути, снижая задержку старта. Поддержка /usr/bin/bash и более короткие пути Linux proxy socket повышают совместимость в ограниченных средах. resume --last находит последнюю подходящую сессию через state DB, а не сканирует всю локальную историю, что ускоряет восстановление при большом объёме сессий. Обработка больших MCP/Ollama-стримов и длинных историй сообщений значительно ускорена.

Почему это важно для команд

Изменения в plugin JSON автоматизации наиболее важны для команд, управляющих Codex в масштабе. Если организация поддерживает стандартный набор плагинов для всего флота разработчиков, автоматизация состояния плагинов через codex plugin add --json и codex plugin list --json теперь вполне практична. Вывод можно передавать в скрипт валидации, сравнивать с desired-state манифестом или интегрировать в MDM/конфигурационные пайплайны.

Предобновление OAuth MCP устраняет класс отказов, особенно болезненный для длинных или необслуживаемых сессий Codex. OAuth-токены обычно истекают через час. Агент, выполняющий многочасовую задачу, мог столкнуться со stale-токеном на полпути, получить непонятную ошибку и оставить работу незавершённой. Предобновление при старте закрывает этот пробел для сессий, которые стартуют заново.

Исправление AGENTS.md напрямую затрагивает команды с контейнеризированными средами разработки, dev containers или монорепозиторными структурами. Неверно загруженный AGENTS.md означает, что агент получает неправильный системный промпт на всю сессию — и это почти невозможно диагностировать, так как старт выглядит нормально.

Угол маршрутизации и оператора

JSON-автоматизация плагинов и API потребления токенов вместе открывают важный паттерн для операторов routing layer: автоматизированный аудит сессий Codex. Оператор, запускающий несколько экземпляров Codex через общий routing gateway, теперь может скриптовать валидацию состояния плагинов и запросы токенного потребления на сессию без ручного осмотра. В сочетании с управленческими контролями оператора на уровне gateway это даёт инженерным командам два взаимодополняющих источника данных — routing-телеметрию уровня gateway и нативный токен-usage Codex — для атрибуции затрат и соответствия требованиям.

Исправление AGENTS.md также важно для операторов, доставляющих инструкции рабочего пространства через общие монтирования или контейнеризированные среды. Если флот подготавливает рабочие пространства Codex через контейнерные volume-монтирования с симлинкованными корнями, исправление гарантирует корректную загрузку fleet-wide AGENTS.md, где обычно прописаны routing gateway URL, конфигурация провайдера или командные разрешения для инструментов.

На что обратить внимание

Дорожная карта plugin JSON движется к полной машиночитаемости состояния плагинов — дефолтные промпты, удалённые MCP-серверы и app-шаблоны теперь видны в detail payload, что закладывает основу для инструментов управления конфигурацией. Если ваша организация поддерживает кастомные плагины Codex, сейчас лучший момент начать строить автоматизацию на основе JSON-вывода, пока схема не устоялась окончательно.

Предобновление MCP OAuth применяется только к OAuth-серверам (streamable HTTP). Команды со stdio-based MCP-серверами не затронуты этим изменением.

Для команд, маршрутизирующих Codex через прокси или промежуточный слой (например, TheRouter): openai_base_url по-прежнему является ключом, ограниченным на уровне проекта — его нельзя задать в проектном .codex/config.toml. Маршрутизация через кастомный base URL должна настраиваться на уровне пользователя или app-server, а не через проектные файлы.