Rozwiązywanie problemów z MCP: 401, 403, brakujące narzędzia
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: Beareri token po nim. SłowoBeareri 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.
- W Users › API & MCP proszę nacisnąć Edit przy tokenie.
- Proszę zaznaczyć pole potrzebne dla tej czynności (patrz tabela w Tworzenie tokenu MCP).
- 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.
- 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.
Wskazówka 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.