Усунення несправностей 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 token).
- Збережіть, потім закрийте й перезапустіть свого асистента.
Два окремі випадки:
- Призначення ліцензії відхилено: у токена бракує 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" змінився #
Хтось (або сам асистент) тим часом змінив те саме. Попросіть асистента прочитати елемент знову й повторити зміну зі свіжою ревізією. Нічого не втрачено.
Request too large #
Один запит MCP обмежений 4 MiB. Фото й відео не передаються через чат: завантажте їх у Vault або дайте посилання на публічну папку Google Drive, і нехай асистент їх імпортує.
Сервер не відповідає #
- Перевірте підключення до інтернету.
- Спробуйте знову за кілька хвилин: може статися коротке перезавантаження сервера.
- Досі недоступний через 15 хвилин: напишіть нам з Console (Support), вказавши час і назву інструмента. Ніколи не надсилайте токен.
Порада Після будь-якої зміни токена (Edit, Rotate) перезапустіть асистента. Він читає список інструментів лише під час підключення.
FAQ #
Чому інструмент є в списку, але відмовляється працювати? #
У списку є кожен інструмент сімейства, а позначки перевіряються під час кожного виклику. Відмова, що називає дозвіл, означає, що на токені бракує цієї позначки.
Мій токен вчора працював. Чому сьогодні 401? #
Його ротовано, відкликано або він прострочений (365 днів). Перевірте його статус у Users › API & MCP і вставте новий токен у свого асистента.
Чи потрібно перезапускати асистента після редагування токена? #
Так. Асистент читає список інструментів лише під час підключення.