# Усунення несправностей MCP: 401, 403, зниклі інструменти

_Підключення Claude / Codex · Читання 3 хв · Оновлено 2026-11-08 · https://lanachat.ai/guides/uk/ai-troubleshooting/_

Більшість проблем 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"

Токен дійсний, але для цієї дії йому бракує позначки.

1. У **Users › API & MCP** натисніть **Edit** у токена.
2. Поставте позначку, потрібну для дії (див. таблицю в розділі [Створення вашого MCP token](https://lanachat.ai/guides/uk/ai-create-mcp-token/)).
3. Збережіть, потім закрийте й перезапустіть свого асистента.

Два окремі випадки:

- **Призначення ліцензії відхилено**: у токена бракує **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." Справжні назви є в [довіднику інструментів](https://lanachat.ai/guides/mcp-tool-reference/).
- Сервер не підключено: у Claude Code або Codex введіть `/mcp`; у редакторі перевірте його налаштування MCP.

## 409, "revision" або "hash" змінився

Хтось (або сам асистент) тим часом змінив те саме. Попросіть асистента прочитати елемент знову й повторити зміну зі свіжою ревізією. Нічого не втрачено.

## Request too large

Один запит MCP обмежений 4 MiB. Фото й відео не передаються через чат: завантажте їх у **Vault** або дайте посилання на публічну папку Google Drive, і нехай асистент їх імпортує.

## Сервер не відповідає

- Перевірте підключення до інтернету.
- Спробуйте знову за кілька хвилин: може статися коротке перезавантаження сервера.
- Досі недоступний через 15 хвилин: напишіть нам з Console (**Support**), вказавши час і назву інструмента. Ніколи не надсилайте токен.

> Tip: Після будь-якої зміни токена (Edit, Rotate) перезапустіть асистента. Він читає список інструментів лише під час підключення.

## FAQ

### Чому інструмент є в списку, але відмовляється працювати?
У списку є кожен інструмент сімейства, а позначки перевіряються під час кожного виклику. Відмова, що називає дозвіл, означає, що на токені бракує цієї позначки.

### Мій токен вчора працював. Чому сьогодні 401?
Його ротовано, відкликано або він прострочений (365 днів). Перевірте його статус у **Users › API & MCP** і вставте новий токен у свого асистента.

### Чи потрібно перезапускати асистента після редагування токена?
Так. Асистент читає список інструментів лише під час підключення.

## Пов’язані статті

- [Збережіть свій токен у безпеці](https://lanachat.ai/guides/uk/ai-security/)
- [MCP tool reference: every tool, by screen](https://lanachat.ai/guides/mcp-tool-reference/)
- [API & MCP: підключення ШІ-асистента](https://lanachat.ai/guides/uk/api-mcp/)