Codex Control Plane MCP — длинные задачи Codex Desktop
Codex Control Plane MCP
MCP-сервер ставит задачи Codex Desktop в очередь: клиент опрашивает статус, одобряет план и читает итоговый отчет
- 121 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Через сервер агент запускает Codex с правом записи в файлы проекта, режим `danger-full-access` тоже доступен
- Сервер локальный и без аутентификации: открытый в сеть, он отдаст управление Codex любому
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/codex-control-plane-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Через сервер агент запускает Codex с правом записи в файлы проекта, режим `danger-full-access` тоже доступен
- Сервер локальный и без аутентификации: открытый в сеть, он отдаст управление Codex любому
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер codex-control-plane-mcp управляет Codex Desktop через codex-app-server. Клиент отправляет задачу и сразу получает operationId или workflowId, а не держит MCP-вызов открытым часами. Дальше он опрашивает статус, отвечает на запросы одобрения и забирает итоговый отчет. Сервер берет на себя неудобные части: запуск app-server, создание потоков и ходов, защиту от дублей при повторной отправке (client_request_id), режим планирования Plan Mode. Состояние операций, рабочих процессов, хуков и диагностики хранится в локальной базе SQLite и переживает перезапуск. Среди инструментов codex_submit_task, codex_get_operation_status, codex_approve_plan, codex_execute_plan, codex_interrupt_turn и codex_health_summary. Есть проверка состояния и пробный запуск починки. Для нескольких клиентов предусмотрен отдельный рабочий процесс codex-control-plane-mcp-worker, который владеет очередью и блокировками.
Для кого. Тем, кто строит оркестратор поверх Codex Desktop на Windows (OpenClaw, Hermes или свой) и хочет отдавать ему многочасовые задачи.
Подходит, если
- Оркестратор запускает Codex на задачу в несколько часов, и нельзя держать MCP-вызов открытым
- Клиент повторяет запрос после тайм-аута, а второй ход Codex создавать не нужно
- Перед выполнением надо показать человеку план и дождаться одобрения
- Несколько агентов работают в одном проекте, и записи в файлы нужно разводить блокировками
Не подходит, если
- Достаточно один раз вызвать Codex: для коротких задач очередь и опрос только усложнят схему
- Платформа Linux или macOS: полноценно проверена только Windows, на остальных идут проверки протокола
- Сервер нужно открыть в сеть без аутентификации: он рассчитан на локальную доверенную среду
Пример запроса к агенту
Запусти в Codex Desktop задачу «обнови зависимости и прогони тесты» как фоновую операцию и сообщи, когда будет готов отчет.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Полностью проверена только связка Windows, Codex Desktop и codex-app-server, на Linux и macOS выполняются проверки протокола.
Сервер локальный: без аутентификации его нельзя выставлять в сеть. Для непроверенных репозиториев автор советует песочницу `read-only` и одобрение `on-request`.
Plan Mode повышает запрошенную `read-only` до `workspace-write` и пишет об этом в статусе. Одновременные ходы ограничены: по умолчанию не больше четырех активных ходов на весь сервер и одного хода на поток.
Как отключить. Удалите запись сервера из конфигурации MCP-клиента и остановите процесс codex-control-plane-mcp-worker, если он запущен. Локальную базу состояния можно удалить вручную.
Частые вопросы
Чем сервер лучше прямого вызова Codex?
Он делает задачу переживающей тайм-аут и перезапуск: вы получаете идентификатор операции, опрашиваете статус, а повторный запрос с тем же client_request_id не создает второй ход. Тонкая обертка этого не умеет.
Как поставить сервер?
Рекомендуемый путь — pipx install codex-control-plane-mcp, запасные uvx codex-control-plane-mcp и установка из GitHub через pip. Затем codex-control-plane-mcp-admin init создает конфиг, а в клиент добавляется команда codex-control-plane-mcp.
Работает ли сервер не на Windows?
Полноценно проверена только Windows. На Linux и macOS пока идут проверки на уровне протокола, поэтому рабочую нагрузку лучше запускать на Windows.
Что делает Plan Mode в этом сервере?
Клиент запускает рабочий процесс планирования, опрашивает его состояние, одобряет план вызовом codex_approve_plan и запускает выполнение через codex_execute_plan. Минимальная песочница в этом режиме — `workspace-write`.
Как быть, если клиентов несколько?
Запустите один процесс codex-control-plane-mcp-worker с переменной `CODEX_MCP_EXECUTION_MODE=worker`, а клиентам задайте режим `client`. Рабочий процесс владеет app-server, очередью и блокировками, клиенты только отправляют задачи и опрашивают статус.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыCodex MCP Server — Codex внутри Claude Code
Codex MCP Server
MCP-сервер передает задачи Codex CLI прямо из Claude Code: вопросы по коду, ревью изменений, веб-поиск и сессии с продолжением диалога
Локальный MCP-мост передает задания из чат-клиента в разрешенные проекты и показывает выполнение и согласования в рабочем окне.
MCP-сервер дает обычному чату ChatGPT локальный набор Codex: файлы, команды, Chrome и Edge, живой Excel
oh-my-codex
oh-my-codex (OMX)
Надстройка над Codex CLI: сквозной процесс от уточнения задачи до проверки, команды агентов, хуки, HUD и состояние в .omx/
MCP самохостной панели EmperorClaw: Claude Code и Codex читают знания компании, задачи и клиентов в выданной области доступа
Плагин синхронизирует Claude Code, Codex CLI и Antigravity в одном проекте и дает им передавать друг другу задачи.
Коротко о README
Сервер подан как надежный работник для Codex Desktop по контракту «отправить, опросить, одобрить, прочитать отчет». Отдельные разделы объясняют режим Plan Mode, рабочий процесс на нескольких клиентов, лимиты параллельных ходов и модель безопасности. Есть русская версия README.