# Codex

> Подключение MMW к 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_`) — см. [Быстрый старт](/start/quickstart/).
- Codex с поддержкой MCP-серверов.
- Python 3.11+ и [uv](https://docs.astral.sh/uv/) (команда `uvx`).

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

```text
~/.codex/config.toml
```

```text
~/.codex/config.toml
```

```text
%USERPROFILE%\.codex\config.toml
```

## Подключение

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

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

   ```toml title="~/.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. Попросите:

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

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

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

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

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

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

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

```bash
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`.

Рассуждения модели, системные промпты, снимки файлов и пути не загружаются; секреты вычищаются на компьютере до отправки и ещё раз на сервере. Поиск по загруженным сессиям пока не сделан. Подробнее — [История сессий](/agent/session-history/).

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

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

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

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

## Что дальше