# Cursor

> Подключение MMW к Cursor через локальный агент или напрямую по HTTP — глобально или для одного проекта.

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

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

- Инструменты `remember`, `search`, `forget`, `validate_memory`, `gateway_call` в агенте Cursor.
- `mmw_sync_status` — при подключении через локальный агент.
- Общую память с Claude Code, Codex и claude.ai: факт, сохранённый утром в Claude Code, Cursor найдёт днём.

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

## Что нужно

- API-ключ MMW (начинается с `mmw_`) — см. [Быстрый старт](/start/quickstart/).
- Cursor с поддержкой MCP.
- Для локального агента: Python 3.11+ и [uv](https://docs.astral.sh/uv/) (команда `uvx`).

## Где разместить конфигурацию

| Файл | Действует |
|---|---|
| `~/.cursor/mcp.json` | Во всех проектах (рекомендуется). |
| `.cursor/mcp.json` в корне проекта | Только в этом проекте. |

Проектный `.cursor/mcp.json` легко случайно закоммитить вместе с ключом. Добавьте его в `.gitignore` или используйте глобальный файл.

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

1. Откройте или создайте файл конфигурации (глобальный или проектный).

2. Добавьте блок `mmw` в `mcpServers`:

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

3. Сохраните файл и перезапустите Cursor (или переключите сервер в настройках MCP).

1. Откройте или создайте файл конфигурации (глобальный или проектный).

2. Добавьте блок `mmw` в `mcpServers`:

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

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

3. Сохраните файл и перезапустите Cursor (или переключите сервер в настройках MCP).

## Проверка

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

2. В чате в режиме агента попросите:

   ```text
   Запомни в MMW: интеграционные тесты запускать с --forked, иначе падает фикстура базы. Ключ факта: tests-run.
   ```

   Cursor предложит вызвать `remember`; после подтверждения запись сохранится со статусом `unverified`.

3. В новом чате спросите:

   ```text
   Как у нас запускаются интеграционные тесты? Посмотри в MMW.
   ```

   Ожидаемый ответ: агент вызывает `search` и отвечает, что тесты запускают с `--forked`.

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

Для агента — чаще всего Cursor не нашёл `uvx` или Python старше 3.11: укажите полный путь к `uvx` в `command` (`which uvx` на macOS и Linux, `where uvx` на Windows). Для прямого подключения — проверьте URL и заголовок `Authorization`.

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

Инструменты MCP работают в режиме агента. Добавьте в правила проекта Cursor указание искать в MMW перед решением задачи и сохранять принятые решения — см. [Лучшие практики](/memory/best-practices/).

## Что дальше