# Claude Desktop

> Подключение MMW к приложению Claude Desktop через локальный агент mmw-agent.

Из этой страницы вы узнаете, как подключить MMW к приложению Claude Desktop, где лежит его конфигурация и как проверить, что память работает.

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

- Инструменты `remember`, `search`, `forget`, `validate_memory`, `gateway_call` и `mmw_sync_status` в разговорах Claude Desktop.
- Ту же память, что у Claude Code, Cursor и claude.ai с тем же ключом.

История сессий для Claude Desktop не загружается: агент умеет загружать только сессии Claude Code и Codex.

## Что нужно

- API-ключ MMW (начинается с `mmw_`) — см. [Быстрый старт](/start/quickstart/).
- Claude Desktop для macOS или Windows.
- Python 3.11+ и [uv](https://docs.astral.sh/uv/) (команда `uvx`).

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

```text
~/Library/Application Support/Claude/claude_desktop_config.json
```

```text
%APPDATA%\Claude\claude_desktop_config.json
```

Официальной версии Claude Desktop для Linux нет. Неофициальные сборки мы не проверяли. На Linux используйте [Claude Code](/clients/claude-code/) или [claude.ai](/clients/claude-web/).

Проще всего открыть файл из самого приложения: «Настройки → Разработчик → Изменить конфигурацию».

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

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

2. Добавьте блок `mmw` в `mcpServers`. Если в файле уже есть другие серверы, добавьте `mmw` рядом с ними, не удаляя их.

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

3. Сохраните файл и **полностью закройте** Claude Desktop (через меню приложения, а не крестиком окна), затем откройте снова.

## Проверка

1. В новом разговоре откройте меню инструментов (значок под полем ввода): там должен быть сервер `mmw` с инструментами `remember`, `search`, `forget`, `validate_memory`, `gateway_call`, `mmw_sync_status`.

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

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

   Claude может спросить разрешение на вызов `remember` и после подтверждения сообщит, что запись сохранена.

3. Откройте новый разговор и спросите:

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

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

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

Приложения с графическим интерфейсом часто не видят `uvx`, установленный в домашний каталог. Укажите полный путь в `command`: на macOS и Linux узнайте его командой `which uvx`, на Windows — `where uvx`. Также проверьте, что Python 3.11+ установлен.

Claude Desktop читает конфигурацию только при запуске. Закройте приложение полностью и откройте снова. Если сервер всё равно не появился, проверьте JSON на лишние или пропущенные запятые.

Используйте веб-версию [claude.ai](/clients/claude-web/) с коннектором по OAuth — там ничего устанавливать не нужно.

Проверить агент отдельно от приложения можно командой `mmw-agent status` — см. [Решение проблем с агентом](/agent/troubleshooting/).

## Что дальше