# Claude Code

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

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

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

   ```bash
   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`. Можно добавить его и вручную:

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

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

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

   ```bash
   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. Попросите:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Остальные ошибки — в разделе [Ошибки](/reference/errors/) и [Решение проблем с агентом](/agent/troubleshooting/).

## Что дальше