Codex

Из этой страницы вы узнаете, как подключить MMW к Codex через файл config.toml, проверить подключение и при желании включить загрузку истории сессий Codex.

Что вы получите

• Инструменты remember, search, forget, validate_memory, gateway_call и mmw_sync_status в Codex.
• Загрузку истории сессий Codex — только после вашего явного согласия в терминале.
• Общую память с Claude Code, Cursor и claude.ai при том же ключе.

Что нужно

• API-ключ MMW (начинается с mmw_) — см. Быстрый старт.
• Codex с поддержкой MCP-серверов.
• Python 3.11+ и uv (команда uvx).

Где лежит конфигурация

macOS

~/.codex/config.toml

Linux

~/.codex/config.toml

Windows

%USERPROFILE%\.codex\config.toml

Подключение

1. Откройте config.toml (создайте, если его нет).

2. Добавьте секцию:

   ~/.codex/config.toml

   [mcp_servers.mmw]
   command = "uvx"
   args = ["--from", "https://app.mmwhub.ru/downloads/mmw-agent/mmw_agent-0.1.4-py3-none-any.whl", "mmw-agent"]
   env = { MMW_API_KEY = "mmw_ваш_ключ" }

3. Перезапустите Codex.

Заметка

Если ваша версия Codex поддерживает удалённые MCP-серверы по HTTP, можно подключиться и напрямую: адрес https://mcp.mmwhub.ru/mcp, заголовок Authorization: Bearer mmw_ваш_ключ. Имена параметров для этого зависят от версии Codex — смотрите её документацию. При прямом подключении нет mmw_sync_status и загрузки истории сессий.

Проверка

1. В интерфейсе Codex введите /mcp (или выполните codex mcp list в терминале — в версиях, где есть эта команда). Сервер mmw должен быть в списке с инструментами remember, search, forget, validate_memory, gateway_call, mmw_sync_status.

2. Попросите:

   Запомни в MMW: staging выкатывается через systemd-юнит app-staging. Ключ факта: deploy-staging.

   Codex вызовет remember и сообщит ID записи со статусом unverified.

3. В новой сессии спросите:

   Как у нас выкатывается staging? Посмотри в MMW.

   Ожидаемый ответ: Codex вызывает search и отвечает, что staging выкатывается через app-staging.

История сессий (по желанию)

Агент может загружать историю сессий Codex, но только после того, как человек подтвердит согласие в интерактивном терминале:

MMW_API_KEY=mmw_ваш_ключ uvx --from https://app.mmwhub.ru/downloads/mmw-agent/mmw_agent-0.1.4-py3-none-any.whl mmw-agent consent

Отозвать согласие — та же команда с revoke вместо consent: загрузка остановится сразу. Посмотреть состояние из самого Codex можно инструментом mmw_sync_status.

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

Типичные проблемы

Codex не запускает сервер mmw

Проверьте синтаксис TOML: env — это встроенная таблица в фигурных скобках, строки в двойных кавычках. Убедитесь, что uvx доступен (uvx --version) и установлен Python 3.11+. При необходимости укажите полный путь к uvx в command.

Превышено время запуска при первом старте

При первом запуске uvx скачивает агент, это может занять больше времени, чем Codex ждёт по умолчанию. Запустите один раз mmw-agent status из терминала (команда выше с status), чтобы колесо попало в кэш, или увеличьте таймаут запуска MCP-сервера в настройках Codex — имя параметра зависит от версии.

Ошибка 401

Ключ не передан, отозван или истёк. Проверьте MMW_API_KEY в config.toml и при необходимости выпустите новый ключ.

Что дальше

История сессий Что загружается, квоты и как остановить.

Настройка агента Переменные окружения и каталог состояния.

mmw_sync_status Что показывает инструмент состояния синхронизации.

Claude Code Тот же агент для Claude Code.