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

Копировать страницу Markdown llms.txt

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

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

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

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, на просьбу «запомни» отвечает, что не может.

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

Инструкции по каждому клиенту — в разделе Клиенты.

Ошибка 401

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

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

Подробнее — API-ключи и OAuth.

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

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

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

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

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

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

«workspace ’…’ is not active»

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

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

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

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

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

См. Тарифы и оплата.

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

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

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

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

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

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

Что дальше

Ошибки Полный список текстов ошибок.

Неполадки агента Установка mmw-agent и синхронизация сессий.

Поддержка Как связаться с нами.