Решение проблем с MCP: 401, 403, пропавшие инструменты
Большинство проблем с MCP в LanaChat связано с токеном: он неверный, просрочен или в нём нет нужной отметки. Найдите свою ошибку в таблице, затем читайте подробности ниже.
| Что вы видите | Вероятная причина | Решение |
|---|---|---|
401, "unauthorized" | токен неверный, просрочен, отозван или заменён через ротацию | скопируйте его заново или нажмите Rotate, проверьте Bearer |
403, "permission", "requires …" | в токене нет нужной отметки | Edit токена, поставьте отметку, перезапустите |
| "tool not found" | отметка выключена, имя угадано, сервер не добавлен | поставьте отметку, проверьте /mcp |
409, "revision" или "hash" | объект изменился за это время | прочитайте его заново и повторите изменение |
| "request too large" | больше 4 MiB в одном запросе | загружайте файлы в Vault или через Drive |
| нет ответа | сеть или краткий перезапуск | повторите через несколько минут |
401: unauthorized #
Сервер не принял токен.
- Токен скопирован с пропущенным или лишним символом. Скопируйте его заново оттуда, где вы его сохранили.
- Заголовок должен выглядеть именно как
Authorization: Bearerи затем токен. СловоBearerи пробел обязательны. - Токен был отозван или заменён через ротацию (старый перестаёт работать сразу). Проверьте его статус в Users › API & MCP.
- Срок токена истёк: токены действуют 365 дней. Нажмите Rotate (или Renew) и вставьте новый токен в ассистента.
- Вы использовали ключ сотрудника (Team Management) или пароль от Console. MCP принимает только токен из API & MCP.
403: forbidden, или "permission" #
Токен действителен, но в нём нет нужной отметки для этого действия.
- В Users › API & MCP нажмите Edit у токена.
- Поставьте отметку, которая нужна для действия (см. таблицу в руководстве Создание MCP-токена).
- Сохраните, затем закройте и перезапустите ассистента.
Два особых случая:
- Назначение лицензии отклонено: в токене нет Spend the balance on licences (нужен и Read sales, а поставить отметку может только владелец рабочего пространства), либо достигнут Daily limit for licences (0 означает, что лицензий нет вообще). В отказе указано, что именно. Исправьте через Edit у токена или назначьте лицензию в Console, в Billing › Licences.
- Playground отклонён: для ответов Playground нужен положительный баланс. Пополните в Billing › Top up или пропустите тест.
Инструмента нет, или "tool not found" #
- Без Configure agency AI ассистент получает только инструменты настройки, фанов и продаж (132): без инструментов AI Brain, Playground и публикации. Поставьте отметку, перезапустите.
- Инструмент, который есть в списке, но отказывает ("requires can_generate", "requires the owner's can_publish permission"), означает, что в токене нет отметки. Поставьте её через Edit, перезапустите.
- Ассистент угадал имя. Попросите его: "List the tools of lanachat." Настоящие имена есть в справочнике инструментов.
- Сервер не подключён: в Claude Code или Codex введите
/mcp; в редакторе проверьте его настройки MCP.
409, "revision" или "hash" изменились #
Кто-то (или сам ассистент) изменил то же самое за это время. Попросите ассистента заново прочитать объект и повторить изменение с новой revision. Ничего не потеряно.
Запрос слишком большой #
Один запрос MCP ограничен 4 MiB. Фото и видео через чат не передаются: загружайте их в Vault или дайте ссылку на публичную папку Google Drive и пусть ассистент её импортирует.
Сервер не отвечает #
- Проверьте подключение к интернету.
- Повторите через несколько минут: возможен краткий перезапуск сервера.
- Всё ещё недоступен через 15 минут: напишите нам из Console (Support), указав время и название инструмента. Никогда не отправляйте токен.
Совет После любого изменения токена (Edit, Rotate) перезапустите ассистента. Он читает список инструментов только при подключении.
FAQ #
Почему инструмент есть в списке, но отказывается работать? #
В списке показаны все инструменты семейства, а отметки проверяются при каждом вызове. Отказ с названием права означает, что в токене нет этой отметки.
Мой токен вчера работал. Почему сегодня 401? #
Его заменили через ротацию, отозвали или срок истёк (365 дней). Проверьте его статус в Users › API & MCP и вставьте новый токен в ассистента.
Нужно ли перезапускать ассистента после изменения токена? #
Да. Ассистент читает список инструментов только при подключении.