Ошибки

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

Из этой страницы вы узнаете, как выглядят ошибки MMW, что означает каждый текст и как его устранить. Тексты приведены дословно — их удобно искать по странице (Ctrl+F).

Как приходят ошибки

  HTTP-запрос ──► проверка ключа ──► 401, если ключ не принят
                        │
                        ▼
                 вызов инструмента ──► ответ с "isError": true и текстом причины

Ошибка авторизации — статус HTTP 401 до вызова инструмента.
Ошибка инструмента — обычный ответ JSON-RPC с "isError": true. Для инструментов памяти текст имеет вид Error executing tool search: …; ниже указана часть после двоеточия.
Уведомления о подписке начинаются с [MMW Notice]: — их стоит показать человеку как есть.

Отдельного HTTP-статуса 429 нет: превышение лимита вызовов приходит как ошибка инструмента с текстом MCP rate limit exceeded или project call limit exceeded.

Авторизация и аккаунт

Ответ	Что значит	Что делать
HTTP `401`	Нет заголовка `Authorization`, ключ неверный, отозван или истёк, OAuth-токен выдан не для этого сервера, либо аккаунт приостановлен оператором.	Проверьте ключ в настройках клиента (`MMW_API_KEY` или заголовок `Authorization: Bearer mmw_…`). При необходимости выпустите новый ключ в кабинете. Для claude.ai переподключите коннектор.
`account is unavailable`	Аккаунт выключен (не в активном состоянии).	Напишите в поддержку.
`[MMW Notice]: This MMW account has no active subscription, so memory is unavailable. The account owner can manage it in their MMW account settings.`	У аккаунта нет активной подписки: память недоступна ни на чтение, ни на запись.	Владелец аккаунта активирует тариф в кабинете. Для организации — напишите нам.
`[MMW Notice]: The MMW subscription has expired. Memory is read-only during the grace period; saved memories can still be searched.`	Подписка истекла, идёт льготный период: `search`, `validate_memory`, `gateway_call` работают, `remember` и `forget` — нет.	Продлите подписку, чтобы снова сохранять.
`[MMW Notice]: This MMW account is suspended because its subscription expired. The account owner can manage it in their MMW account settings.`	Льготный период закончился, аккаунт приостановлен.	Владелец аккаунта продлевает подписку в кабинете.
`membership may not write in this organization`	В организации: у вас роль «аудитор» или ваше членство неактивно (уволены, истёк срок подрядчика).	Обратитесь к администратору организации. Проверьте пространство в переключателе кабинета.

Лимиты

Текст	Что значит	Что делать
`MCP rate limit exceeded`	Превышен общий лимит запросов аккаунта за скользящее окно в 60 секунд.	Подождите минуту; уменьшите частоту вызовов.
`project call limit exceeded`	Превышен лимит вызовов проекта в минуту по тарифу.	Подождите минуту или смените тариф.
`project gateway concurrency limit exceeded`	Слишком много одновременных вызовов интеграций.	Делайте вызовы `gateway_call` последовательно.
`project memory limit exceeded`	Достигнут лимит записей проекта по тарифу.	Удалите ненужное через `forget` или смените тариф. Чтение продолжает работать.
`maximum number of memories exceeded for workspace`	Достигнут технический лимит записей в рабочей области.	Сохраняйте в другую рабочую область или удалите ненужное.
`maximum number of memories exceeded for tenant`	Достигнут технический лимит записей аккаунта.	Удалите ненужное или напишите в поддержку.

Рабочие области и проекты

Текст	Что значит	Что делать
`workspace '…' is not active`	`search`: такой рабочей области нет (в ней ещё ничего не сохраняли) или она удалена.	Проверьте имя `workspace`. Область создаётся первым `remember`.
`workspace '…' was deleted and cannot be reused`	Область с этим именем удалена; имя занять повторно нельзя.	Используйте другое имя.
`403 Forbidden: workspace access denied for project`	Рабочая область принадлежит другому проекту, а ключ привязан к этому.	Используйте ключ нужного проекта или другое имя области.
`bound project is missing, inactive, or outside tenant`	Проект, к которому привязан ключ, удалён или неактивен.	Выпустите ключ для активного проекта.

remember

Текст	Что значит	Что делать
`content must not be empty`	Пустой текст.	Передайте непустой `content`.
`content exceeds maximum allowed length`	Текст длиннее 100 000 символов.	Разбейте на несколько записей.
`Memory rejected by Security Guard: Memory poisoning detected: matching pattern '…'`	Memory Guard увидел в тексте инструкцию, похожую на попытку «отравить» память (например, «ignore previous instructions»).	Перефразируйте запись; не сохраняйте инструкции для будущих агентов.
`workspace and scope must not be empty`	Пустые `workspace` или `scope`.	Не передавайте пустые строки, используйте значения по умолчанию.
`confidence must be between 0 and 1`	`confidence` вне диапазона.	Передайте число от 0 до 1.
`source_id is required when source_hash is provided`	Хеш без источника.	Добавьте `source_id`.
`derived_from accepts at most 50 memory ids`	Больше 50 ID.	Сделайте промежуточные сводки.
`derived_from contains unknown memory ids`	Среди ID есть несуществующие, удалённые или недоступные вам.	Возьмите ID из свежего `search`.
`invalid X-Idempotency-Key`	Ключ пустой, длиннее 256 символов или с недопустимыми символами.	Используйте 1–256 печатных ASCII-символов без пробелов, например UUID.
`409 Conflict: idempotency key was used with different input`	Тот же ключ идемпотентности уже использован с другими параметрами.	Для новой записи — новый ключ.

forget, validate_memory

Текст	Что значит	Что делать
`Either memory_id or source_id must be provided`	`forget` без `memory_id` и `source_id`.	Передайте один из параметров.
`source_id and current_source_hash are required`	`validate_memory` без источника или хеша.	Передайте оба.

gateway_call и интеграции

Текст	Что значит	Что делать
`invalid gateway server or tool name`	Пустое имя или точка в `server`/`tool`.	`server: "github_readonly"`, `tool: "get_file_contents"` — раздельно.
`gateway project not found`	`project_id` не существует или неактивен.	Не передавайте `project_id` или укажите активный проект.
`gateway tool not found`	Инструмент не найден среди включённых и работоспособных интеграций проекта.	Проверьте интеграцию в кабинете, раздел «Шлюз MCP».
`required downstream secret is missing`	У интеграции не настроен токен.	Добавьте секрет интеграции в кабинете.
`downstream tool is not allowlisted`	Инструмент не разрешён для этой интеграции.	Используйте инструменты из списка `tools/list`.
`downstream timeout`	Интеграция не ответила вовремя.	Повторите позже.
`downstream response size limit exceeded`	Ответ интеграции слишком большой.	Сузьте запрос (например, путь к файлу вместо каталога).
`downstream transport failure`, `downstream JSON-RPC error`, `downstream returned malformed JSON-RPC`	Сбой на стороне интеграции.	Повторите позже; если повторяется — в поддержку.
`unknown MCP tool`	Вызван инструмент, которого нет в списке (в том числе `gateway_call` в подключении ChatGPT).	Вызовите `tools/list` и используйте доступные имена.

Локальный агент mmw-agent

Текст	Что значит	Что делать
`MMW отклонил API-ключ (проверьте MMW_API_KEY в настройках MCP)`	Сервер ответил 401/403.	Проверьте `MMW_API_KEY`.
`Сервер MMW недоступен: …`	Нет связи с сервером.	Проверьте сеть и `MMW_ENDPOINT`.
`Не задан MMW_API_KEY. …`	Агент запущен без ключа.	Добавьте `MMW_API_KEY` в `env` MCP-конфига.

Ошибки синхронизации истории сессий (например, нехватка места по тарифу) — в mmw_sync_status и в разделе Неполадки агента.

Что дальше

Решение проблем От симптома к решению: нет инструментов, 401, пустой поиск.

Лимиты Цифры лимитов по тарифам и ограничения сервера.

Тарифы и оплата Как продлить подписку и сменить тариф.