# Быстрый старт

> От регистрации до первого факта, который агент вспомнит в новой сессии, — за пять минут.

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

1. получите API-ключ MMW;
2. подключите MMW к своему ИИ-ассистенту;
3. сохраните факт в одной сессии и найдёте его в другой — уже без вашего напоминания.

Пример на всю страницу: команда договорилась, что **staging выкатывается через systemd-юнит `app-staging`**. Через неделю новый разработчик спрашивает агента, как выкатить staging, — и агент отвечает правильно, потому что помнит договорённость.

## 1. Аккаунт и ключ

1. Зарегистрируйтесь на [app.mmwhub.ru](https://app.mmwhub.ru/signup) и подтвердите почту по ссылке из письма.

2. Выберите тариф. **Free** — тестовый период 3 дня, банковская карта не нужна.

3. Скопируйте API-ключ. Он начинается с `mmw_` и показывается **один раз** — сохраните его в менеджере паролей.

Ключ даёт доступ ко всей памяти проекта. Не вставляйте его в чаты, публичные репозитории и скриншоты. Если ключ утёк — отзовите его в кабинете и выпустите новый.

## 2. Подключите ассистента

Рекомендуемый способ — локальный агент **mmw-agent**: он подключает все инструменты MMW и, если вы разрешите, сохраняет историю сессий. Нужны Python 3.11+ и [uv](https://docs.astral.sh/uv/) (команда `uvx`).

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

Claude Desktop: «Настройки → Разработчик → Изменить конфигурацию». Cursor: файл `~/.cursor/mcp.json`.

```json title="mcpServers"
{
  "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_ваш_ключ" }
    }
  }
}
```

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

Агент в веб-версии не запускается — подключение идёт напрямую по OAuth:

1. «Настройки → Коннекторы → Добавить свой коннектор».
2. URL: `https://mcp.mmwhub.ru/mcp`.
3. На странице MMW вставьте API-ключ и нажмите «Разрешить». Claude получит собственный токен на 30 дней; ваш ключ claude.ai не передаётся.

Перезапустите клиента. В списке инструментов должны появиться `remember`, `search`, `forget`, `validate_memory`, `gateway_call`, а у mmw-agent ещё и `mmw_sync_status`.

Проверить подключение можно из терминала: `MMW_API_KEY=mmw_ваш_ключ uvx --from <адрес колеса> mmw-agent status`.

## 3. Сохраните факт

Попросите ассистента:

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

Ассистент вызовет `remember`. Ответ сервера выглядит так:

```json
{
  "id": "4d428a41-e7b0-4f81-a886-f40c6f6c766c",
  "workspace": "default",
  "scope": "shared",
  "status": "unverified",
  "source_id": null,
  "derived_from": [],
  "created_at": "2026-10-05T09:12:00+00:00"
}
```

`unverified` — нормальный статус новой записи: MMW хранит происхождение факта, но не утверждает, что он истинен. Подробнее — в разделе [Источник и свежесть](/memory/source-and-freshness/).

## 4. Найдите его в новой сессии

Закройте разговор, откройте новый (можно в другом клиенте с тем же ключом) и спросите:

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

Ассистент вызовет `search` и получит запись вместе с источником и статусом:

```json
{
  "result": [
    {
      "id": "4d428a41-e7b0-4f81-a886-f40c6f6c766c",
      "content": "staging выкатывается через systemd-юнит app-staging",
      "fact_key": "deploy-staging",
      "status": "unverified",
      "confidence": 0.5,
      "graph_relations": []
    }
  ]
}
```

Запись также видна в кабинете, раздел «База знаний».

## Как это устроено

```text
  Сессия 1                MMW                        Сессия 2 (любой клиент)
  ─────────               ───                        ───────────────────────
  remember(факт)   →   запись + источник     →     search(вопрос)
                       + статус + связи             → факт с источником и статусом
                       (изоляция по аккаунту
                        и проекту ключа)
```

Память не привязана к модели и компьютеру: Claude, Cursor и Codex с одним ключом видят одни и те же записи.

## Что дальше