# Решение проблем с MCP: 401, 403, пропавшие инструменты

_Подключение Claude / Codex · Чтение 3 мин · Обновлено 2026-11-08 · https://lanachat.ai/guides/ru/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-токена](https://lanachat.ai/guides/ru/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" изменились

Кто-то (или сам ассистент) изменил то же самое за это время. Попросите ассистента заново прочитать объект и повторить изменение с новой revision. Ничего не потеряно.

## Запрос слишком большой

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

## Сервер не отвечает

- Проверьте подключение к интернету.
- Повторите через несколько минут: возможен краткий перезапуск сервера.
- Всё ещё недоступен через 15 минут: напишите нам из Console (**Support**), указав время и название инструмента. Никогда не отправляйте токен.

> Tip: После любого изменения токена (Edit, Rotate) перезапустите ассистента. Он читает список инструментов только при подключении.

## FAQ

### Почему инструмент есть в списке, но отказывается работать?
В списке показаны все инструменты семейства, а отметки проверяются при каждом вызове. Отказ с названием права означает, что в токене нет этой отметки.

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

### Нужно ли перезапускать ассистента после изменения токена?
Да. Ассистент читает список инструментов только при подключении.

## Похожие статьи

- [Берегите свой токен](https://lanachat.ai/guides/ru/ai-security/)
- [MCP tool reference: every tool, by screen](https://lanachat.ai/guides/mcp-tool-reference/)
- [API & MCP: подключение AI-ассистента](https://lanachat.ai/guides/ru/api-mcp/)