# Настройка агента

> Все настройки mmw-agent и готовые конфигурации для Claude Code, Claude Desktop, Cursor и Codex.

К концу этой страницы вы сможете:

1. прописать mmw-agent в конфигурацию своего клиента;
2. поменять язык подсказок, каталог состояния и частоту синхронизации;
3. проверить, что агент видит те же настройки, что и клиент.

Пример на всю страницу: вы работаете в Claude Code и Codex на одном ноутбуке, ключ привязан к проекту «backend», а историю сессий хотите хранить в MMW.

## Все настройки

Агент настраивается только переменными окружения. Отдельного файла конфигурации у него нет.

| Переменная | Тип | По умолчанию | Описание |
| --- | --- | --- | --- |
| `MMW_API_KEY` | строка | — | API-ключ из кабинета, начинается с `mmw_`. Обязателен. |
| `MMW_CREDENTIAL` | строка | — | Запасное имя для ключа, читается только без `MMW_API_KEY`. |
| `MMW_ENDPOINT` | URL | `https://mcp.mmwhub.ru` | Адрес сервера; суффикс `/mcp` можно не писать. |
| `MMW_LANG` | `ru` или `en` | по адресу сервера | Язык подсказок, ошибок и описания `mmw_sync_status`. |
| `MMW_AGENT_HOME` | путь | `~/.mmw` | Где хранится `agent.json`: идентификатор устройства и квитанция согласия. |
| `MMW_SESSIONS_HOME` | путь | домашний каталог | Где искать `.claude/projects` и `.codex/sessions`. От него же считается `MMW_AGENT_HOME` по умолчанию. |
| `MMW_SYNC_INTERVAL` | секунды | `15` | Пауза между циклами синхронизации. |

Ключ привязан к проекту. Если вы хотите, чтобы Claude Code и Codex видели одну и ту же память, используйте в обоих один ключ (или ключи одного проекта). Подробнее — [Рабочие области и проекты](/memory/workspaces-and-projects/).

## Конфигурации клиентов

Во всех вариантах агент запускается командой `uvx --from <колесо> mmw-agent`. Адрес колеса: `https://app.mmwhub.ru/downloads/mmw-agent/mmw_agent-0.1.4-py3-none-any.whl`.

Командой:

```bash
claude mcp add mmw \
  -e MMW_API_KEY=mmw_ваш_ключ \
  -- uvx --from https://app.mmwhub.ru/downloads/mmw-agent/mmw_agent-0.1.4-py3-none-any.whl mmw-agent
```

Дополнительные переменные добавляются ещё одним `-e`, например `-e MMW_SYNC_INTERVAL=60`.

Вручную — блок `mcpServers.mmw` в `~/.claude.json`:

```json title="~/.claude.json"
{
  "mcpServers": {
    "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_ваш_ключ" }
    }
  }
}
```

«Настройки → Разработчик → Изменить конфигурацию» открывает `claude_desktop_config.json`.

```json title="claude_desktop_config.json"
{
  "mcpServers": {
    "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_ваш_ключ" }
    }
  }
}
```

Сохраните файл и полностью перезапустите Claude Desktop.

```json title="~/.cursor/mcp.json"
{
  "mcpServers": {
    "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_ваш_ключ" }
    }
  }
}
```

```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_ваш_ключ" }
```

После правки конфигурации перезапустите клиента: список инструментов клиент получает при запуске агента.

## Примеры настроек

### Английские подсказки при русском сервере

```json title="фрагмент env"
"env": {
  "MMW_API_KEY": "mmw_ваш_ключ",
  "MMW_LANG": "en"
}
```

### Синхронизация реже

По умолчанию агент проверяет новые строки сессий каждые 15 секунд. Если хотите реже — например, раз в минуту:

```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_ваш_ключ", MMW_SYNC_INTERVAL = "60" }
```

### Свой каталог состояния

Если вы задаёте `MMW_AGENT_HOME` в конфигурации клиента, задайте **ту же** переменную в терминале, когда выполняете `consent`, `revoke` и `status`. Иначе терминал запишет согласие в `~/.mmw`, а агент, запущенный клиентом, будет искать его в другом месте и не увидит.

```bash
export MMW_AGENT_HOME="$HOME/.config/mmw"
export 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
```

Не коммитьте файлы конфигурации с ключом в Git и не пересылайте их в чатах. Если ключ попал в репозиторий, отзовите его в кабинете и выпустите новый — см. [Ключи и OAuth](/account/api-keys-and-oauth/).

## Прямое подключение без агента

Если история сессий не нужна, а клиент умеет удалённые MCP-серверы по HTTP, агент можно не ставить:

```json title="mcpServers"
{
  "mcpServers": {
    "mmw": {
      "url": "https://mcp.mmwhub.ru/mcp",
      "headers": { "Authorization": "Bearer mmw_ваш_ключ" }
    }
  }
}
```

В этом режиме нет `mmw_sync_status` и синхронизации сессий. Сервер работает без сессий: каждый запрос самостоятельный, после паузы переподключаться не нужно.

## Проверка

Выполните `status` в терминале с теми же переменными, что в конфигурации:

```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 status
```

Если в ответе `"server": { "registered": …, "sources": … }` — ключ и адрес верны. Если `"server": { "error": "Offline: …" }` — агент не достучался до сервера; см. [Решение проблем](/agent/troubleshooting/).

## Что дальше