# Rozwiązywanie problemów z MCP: 401, 403, brakujące narzędzia

_Podłączenie Claude / Codex · 3 min czytania · Zaktualizowano 2026-11-08 · https://lanachat.ai/guides/pl/ai-troubleshooting/_

Większość problemów z MCP LanaChat wynika z tokenu: błędnego, wygasłego lub bez odpowiedniego pola. Proszę znaleźć w tabeli błąd, który Państwo widzą, a potem szczegóły poniżej.

| Co Państwo widzą | Prawdopodobna przyczyna | Rozwiązanie |
|---|---|---|
| `401`, "unauthorized" | token błędny, wygasły, unieważniony lub wymieniony | skopiować go ponownie albo **Rotate**, sprawdzić `Bearer ` |
| `403`, "permission", "requires …" | tokenowi brakuje pola | **Edit** tokenu, zaznaczyć pole, uruchomić ponownie |
| "tool not found" | pole wyłączone, nazwa zgadnięta, serwer nie dodany | zaznaczyć pole, sprawdzić `/mcp` |
| `409`, "revision" lub "hash" | element zmienił się w międzyczasie | odczytać go ponownie i powtórzyć zmianę |
| "request too large" | ponad 4 MiB w jednym żądaniu | wgrywać pliki w Vault lub przez Drive |
| brak odpowiedzi | sieć lub krótki restart | spróbować ponownie za kilka minut |

## 401: unauthorized

Serwer nie przyjął tokenu.

- Token został skopiowany z brakującym lub dodatkowym znakiem. Proszę skopiować go ponownie, z miejsca, gdzie został zapisany.
- Nagłówek musi brzmieć dokładnie `Authorization: Bearer ` i token po nim. Słowo `Bearer` i spacja są wymagane.
- Token został unieważniony lub wymieniony (stary przestaje działać natychmiast). W **Users › API & MCP** proszę sprawdzić jego status.
- Token wygasł: tokeny trwają **365 dni**. Proszę nacisnąć **Rotate** (lub **Renew**) i wpisać nowy w asystencie.
- Użyto klucza pracownika (Team Management) lub hasła do Console. MCP przyjmuje wyłącznie token z **API & MCP**.

## 403: forbidden, lub "permission"

Token jest ważny, ale brakuje mu pola dla tej czynności.

1. W **Users › API & MCP** proszę nacisnąć **Edit** przy tokenie.
2. Proszę zaznaczyć pole potrzebne dla tej czynności (patrz tabela w [Tworzenie tokenu MCP](https://lanachat.ai/guides/pl/ai-create-mcp-token/)).
3. Proszę zapisać, a potem zamknąć i uruchomić asystenta ponownie.

Dwa szczególne przypadki:

- **Przypisanie licencji jest odrzucone**: tokenowi brakuje **Spend the balance on licences** (potrzebuje też **Read sales**, a zaznaczyć je może tylko właściciel workspace) albo osiągnięto **Daily limit for licences** (0 oznacza brak jakichkolwiek licencji). Odmowa podaje, o które chodzi. Proszę to naprawić przez **Edit** tokenu albo przypisać licencję w Console, w **Billing › Licences**.
- **Playground odrzucony**: odpowiedzi w Playground wymagają dodatniego salda. Proszę doładować w **Billing › Top up** albo pominąć test.

## Brakuje narzędzia lub "tool not found"

- Bez **Configure agency AI** asystent dostaje tylko narzędzia konfiguracji, fanów i sprzedaży (132): bez AI Brain, Playground i publikacji. Proszę zaznaczyć pole i uruchomić ponownie.
- Narzędzie, które jest na liście, ale odmawia ("requires can_generate", "requires the owner's can_publish permission"), oznacza brak pola w tokenie. Proszę zaznaczyć je przez **Edit** i uruchomić ponownie.
- Asystent zgadł nazwę. Proszę go poprosić: "List the tools of lanachat." Prawdziwe nazwy są w [opisie narzędzi](https://lanachat.ai/guides/mcp-tool-reference/).
- Serwer nie jest połączony: w Claude Code lub Codex proszę wpisać `/mcp`; w edytorze proszę sprawdzić jego ustawienia MCP.

## 409, "revision" lub "hash" zmienione

Ktoś (albo sam asystent) zmienił to samo w międzyczasie. Proszę poprosić asystenta o ponowne odczytanie elementu i powtórzenie zmiany ze świeżą rewizją. Nic nie zostało utracone.

## Zbyt duże żądanie

Jedno żądanie MCP jest ograniczone do 4 MiB. Zdjęcia i filmy nie idą przez czat: proszę wgrać je do **Vault** albo podać link do publicznego folderu Google Drive i pozwolić asystentowi go zaimportować.

## Serwer nie odpowiada

- Proszę sprawdzić połączenie z internetem.
- Proszę spróbować ponownie za kilka minut: może zdarzyć się krótki restart serwera.
- Nadal nie działa po 15 minutach: proszę napisać do nas z Console (**Support**), podając godzinę i nazwę narzędzia. Proszę nigdy nie wysyłać tokenu.

> Tip: Po każdej zmianie tokenu (Edit, Rotate) proszę uruchomić asystenta ponownie. Odczytuje on listę narzędzi tylko przy łączeniu.

## FAQ

### Dlaczego narzędzie jest na liście, ale odmawia uruchomienia?
Wszystkie narzędzia rodziny są wymienione, a pola są sprawdzane przy każdym wywołaniu. Odmowa wskazująca uprawnienie oznacza, że tokenowi brakuje tego pola.

### Mój token działał wczoraj. Dlaczego dziś 401?
Został wymieniony, unieważniony lub wygasł (365 dni). Proszę sprawdzić jego status w **Users › API & MCP** i wpisać nowy token w asystencie.

### Czy po edycji tokenu muszę uruchomić asystenta ponownie?
Tak. Asystent odczytuje listę narzędzi tylko przy łączeniu.

## Powiązane artykuły

- [Jak chronić token](https://lanachat.ai/guides/pl/ai-security/)
- [MCP tool reference: every tool, by screen](https://lanachat.ai/guides/mcp-tool-reference/)
- [API & MCP: podłączenie asystenta AI](https://lanachat.ai/guides/pl/api-mcp/)