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

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

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 видели одну и ту же память, используйте в обоих один ключ (или ключи одного проекта). Подробнее — Рабочие области и проекты.

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

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

Claude Code

Командой:

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:

~/.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

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

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.

Cursor

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

Codex

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

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

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

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

фрагмент env

"env": {
  "MMW_API_KEY": "mmw_ваш_ключ",
  "MMW_LANG": "en"
}

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

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

~/.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, а агент, запущенный клиентом, будет искать его в другом месте и не увидит.

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.

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

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

mcpServers

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

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

Проверка

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

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: …" } — агент не достучался до сервера; см. Решение проблем.

Что дальше

История сессий Согласие, что загружается, квоты и отзыв.

Решение проблем агента Что делать, если инструменты не появились.

Все клиенты Подробные инструкции по каждому ассистенту, включая VS Code и claude.ai.