# Решение проблем

> От симптома к решению — нет инструментов в клиенте, 401, лимиты, уведомления о подписке, переподключение claude.ai, пустой поиск.

Из этой страницы вы узнаете, как по симптому найти причину и исправить её. Проблемы именно локального агента (установка, uvx, синхронизация сессий) разобраны отдельно — в разделе [Неполадки агента](/agent/troubleshooting/).

## Быстрая проверка

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

```bash
curl -s -o /dev/null -w "%{http_code}\n" https://mcp.mmwhub.ru/mcp \
  -H "Authorization: Bearer $MMW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
```

- `200` — ключ принят, сервер работает: ищите причину в настройках клиента.
- `401` — ключ не принят: см. раздел «Ошибка 401» ниже.

## В клиенте нет инструментов MMW

**Симптом:** ассистент не видит `remember` и `search`, на просьбу «запомни» отвечает, что не может.

1. Перезапустите клиента после изменения MCP-конфига: большинство клиентов читают его только при старте.
2. Проверьте адрес: `https://mcp.mmwhub.ru/mcp` (с `/mcp` в конце) при прямом подключении; при подключении через агента — что в конфиге есть `MMW_API_KEY`.
3. Через агента: убедитесь, что установлены Python 3.11+ и `uv`, и выполните `mmw-agent status` с тем же ключом.
4. Если видите только `mmw_sync_status` — агент запустился, но не достучался до сервера. Проверьте сеть и `MMW_ENDPOINT`.
5. В claude.ai проверьте, что коннектор включён в текущем разговоре.

Инструкции по каждому клиенту — в разделе [Клиенты](/clients/overview/).

## Ошибка 401

**Симптом:** клиент показывает ошибку авторизации, curl возвращает `401`, агент пишет `MMW отклонил API-ключ`.

- Ключ скопирован не полностью или с лишними пробелами. Ключ начинается с `mmw_`.
- Ключ отозван или истёк. Выпустите новый в кабинете — старый показать повторно нельзя.
- При прямом подключении заголовок должен быть ровно `Authorization: Bearer mmw_…`.
- Аккаунт приостановлен оператором — напишите в [поддержку](/account/support/).

Подробнее — [API-ключи и OAuth](/account/api-keys-and-oauth/).

## claude.ai: коннектор перестал работать

**Симптом:** коннектор MMW в claude.ai показывает ошибку или просит войти снова.

OAuth-токен, который claude.ai получает от MMW, действует 30 дней. Если коннектор перестал работать, переподключите его: «Настройки → Коннекторы», MMW, отключить и подключить заново, на странице MMW снова вставить API-ключ. Сервер не хранит сессий, поэтому пауза в работе сама по себе соединение не ломает.

## «MCP rate limit exceeded» или «project call limit exceeded»

**Симптом:** часть вызовов возвращает одну из этих ошибок.

Агент делает слишком много вызовов в минуту. Лимит считается за последние 60 секунд, поэтому через минуту вызовы снова проходят. Если ошибка повторяется регулярно — попросите агента не вызывать `search` на каждый шаг или смените тариф. Цифры — на странице [Лимиты](/reference/limits/).

## «workspace '…' is not active»

**Симптом:** `search` возвращает эту ошибку.

В рабочей области с таким именем ещё ничего не сохраняли (поиск области не создаёт) или она удалена. Проверьте параметр `workspace`: по умолчанию это `default`. Если агент сам придумал имя области, попросите его использовать то же имя, что и при сохранении. См. [Рабочие области и проекты](/memory/workspaces-and-projects/).

## Уведомления о подписке

**Симптом:** ответ начинается с `[MMW Notice]:`.

| Начало текста | Что делать |
| --- | --- |
| `…has no active subscription…` | Активируйте тариф в кабинете. |
| `…subscription has expired. Memory is read-only during the grace period…` | Поиск работает, сохранять и удалять нельзя. Продлите подписку. |
| `…account is suspended because its subscription expired…` | Продлите подписку; данные сохранены. |

См. [Тарифы и оплата](/account/plans-and-billing/).

## Ничего не находится

**Симптом:** `search` возвращает пустой список, хотя факт сохраняли.

- **Другой проект.** Память изолирована по проектам: ключ проекта A не видит записи проекта B. Проверьте, каким ключом сохраняли.
- **Другая рабочая область.** Запись сохранена не в `default`. Найдите её в кабинете, раздел «База знаний», и проверьте область.
- **Слова не совпали.** Поиск ищет слова запроса в тексте записи. Переформулируйте, используйте термины из самой записи.
- **Фильтры.** `scope` или `exclude_stale: true` могли отсечь запись.
- **Организация.** Запись видна только автору (черновик) или другому отделу. См. [Видимость](/organizations/visibility/).
- **Запись удалена** через `forget`.
- **История сессий.** Загруженные сессии Claude Code и Codex в `search` пока не попадают: поиск по ним ещё не сделан.

## Запись отклонена

**Симптом:** `remember` вернул ошибку.

Самые частые причины — `Memory rejected by Security Guard` (текст похож на инструкцию для агентов), `project memory limit exceeded` (лимит тарифа) и `source_id is required when source_hash is provided`. Полный список — на странице [Ошибки](/reference/errors/).

Если решение не нашлось, напишите на support@mmwhub.tech: клиент, точный текст ошибки, время. Ключи и содержимое памяти не присылайте.

## Что дальше