Claude Code

Из этой страницы вы узнаете, как подключить MMW к Claude Code, проверить подключение и, если захотите, включить загрузку истории сессий.

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

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

Что нужно

• API-ключ MMW (начинается с mmw_) — см. Быстрый старт.
• Claude Code с командой claude в терминале.
• Для локального агента: Python 3.11+ и uv (команда uvx).

Подключение

Через агент (рекомендуется)

1. Выполните в терминале:

   claude mcp add mmw -s user \
     -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

   Флаг -s user делает MMW доступным во всех проектах. Без него сервер добавится только для текущего каталога.

2. Перезапустите Claude Code, если он был открыт.

3. Проверьте подключение (см. ниже).

Команда записывает блок 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_ваш_ключ" }
    }
  }
}

Напрямую по HTTP

Без установки агента, но без истории сессий и mmw_sync_status.

1. Выполните в терминале:

   claude mcp add --transport http mmw https://mcp.mmwhub.ru/mcp -s user \
     --header "Authorization: Bearer mmw_ваш_ключ"

2. Перезапустите Claude Code и проверьте подключение.

Проверка

1. В терминале выполните claude mcp list — сервер mmw должен быть в списке как подключённый.

2. Внутри сессии Claude Code введите /mcp: у сервера mmw видны инструменты remember, search, forget, validate_memory, gateway_call, а при подключении через агент — ещё mmw_sync_status.

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

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

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

4. Откройте новую сессию и спросите:

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

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

Проверить сам агент можно без Claude Code:

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

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

Агент может загружать историю Claude Code в MMW, но только после того, как человек подтвердит согласие в интерактивном терминале. Модель или скрипт выдать согласие не могут.

mmw-agent consent   # агент покажет, сколько сессий нашёл, и спросит разрешение
mmw-agent revoke    # отозвать: загрузка останавливается сразу

Если команда mmw-agent не установлена глобально, запускайте её через uvx --from <адрес колеса> mmw-agent consent с тем же MMW_API_KEY.

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

Заметка

Загруженные сессии хранятся, но поиск по ним и извлечение фактов пока не сделаны: в результатах search их нет.

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

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

Чаще всего не найден uvx или Python старше 3.11. Выполните uvx --version и python3 --version. Если uvx установлен, но Claude Code его не видит, укажите в конфиге полный путь (узнать его: which uvx).

Ошибка 401

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

MMW виден только в одном проекте

Сервер добавлен без -s user, то есть только для текущего каталога. Удалите его (claude mcp remove mmw) и добавьте заново с -s user.

Остальные ошибки — в разделе Ошибки и Решение проблем с агентом.

Что дальше

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

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

Что запоминать Правила для агента, чтобы память была полезной.

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