Depanarea MCP: 401, 403, instrumente lipsă
Cele mai multe probleme MCP LanaChat vin de la token: greșit, expirat sau căruia îi lipsește o casetă. Găsiți eroarea pe care o vedeți în tabel, apoi detaliile de mai jos.
| Ce vedeți | Cauză probabilă | Soluție |
|---|---|---|
401, "unauthorized" | token greșit, expirat, revocat sau rotit | copiați-l din nou sau Rotate, verificați Bearer |
403, "permission", "requires …" | token-ului îi lipsește o casetă | Edit pe token, bifați caseta, reporniți |
| "tool not found" | caseta e oprită, nume ghicit, server neadăugat | bifați caseta, verificați /mcp |
409, "revision" sau "hash" | elementul s-a schimbat între timp | citiți-l din nou și refaceți modificarea |
| "request too large" | mai mult de 4 MiB într-o cerere | încărcați fișierele în Vault sau prin Drive |
| niciun răspuns | rețea sau o scurtă repornire | reîncercați peste câteva minute |
401: unauthorized #
Serverul nu a acceptat token-ul.
- Token-ul a fost copiat cu un caracter lipsă sau în plus. Copiați-l din nou, de unde l-ați salvat.
- Header-ul trebuie să arate exact
Authorization: Bearerurmat de token. CuvântulBearerși spațiul sunt obligatorii. - Token-ul a fost revocat sau rotit (cel vechi nu mai funcționează imediat). În Users › API & MCP, verificați starea lui.
- Token-ul a expirat: token-urile durează 365 de zile. Apăsați Rotate (sau Renew) și puneți-l pe cel nou în asistent.
- Ați folosit o cheie de angajat (Team Management) sau o parolă de Console. MCP acceptă doar un token din API & MCP.
403: forbidden sau "permission" #
Token-ul este valid, dar îi lipsește o casetă pentru această acțiune.
- În Users › API & MCP, apăsați Edit pe token.
- Bifați caseta de care are nevoie acțiunea (vedeți tabelul din Creați token-ul MCP).
- Salvați, apoi închideți și reporniți asistentul.
Două cazuri speciale:
- Atribuirea unei licențe este refuzată: token-ului îi lipsește Spend the balance on licences (cere și Read sales, iar doar proprietarul workspace-ului o poate bifa) sau Daily limit for licences a fost atinsă (0 înseamnă nicio licență). Refuzul spune care dintre ele. Remediați cu Edit pe token sau atribuiți licența în Console, la Billing › Licences.
- Playground refuzat: răspunsurile Playground cer un sold pozitiv. Alimentați în Billing › Top up sau săriți peste test.
Lipsește un instrument sau "tool not found" #
- Fără Configure agency AI, asistentul primește doar instrumentele 132 de configurare, fani și vânzări: niciun instrument AI Brain, Playground sau de publicare. Bifați caseta, reporniți.
- Un instrument listat, dar care refuză ("requires can_generate", "requires the owner's can_publish permission") înseamnă o casetă lipsă pe token. Bifați-o cu Edit, reporniți.
- Asistentul a ghicit un nume. Cereți-i: "List the tools of lanachat." Numele reale se află în referința instrumentelor.
- Serverul nu este conectat: în Claude Code sau Codex scrieți
/mcp; într-un editor, verificați setările MCP ale lui.
409, "revision" sau "hash" schimbat #
Cineva (sau asistentul însuși) a schimbat același lucru între timp. Cereți asistentului să citească din nou elementul și să refacă modificarea cu revizia proaspătă. Nu s-a pierdut nimic.
Request too large #
O cerere MCP este limitată la 4 MiB. Pozele și videoclipurile nu trec prin conversație: încărcați-le în Vault sau dați linkul unui folder Google Drive public și lăsați asistentul să îl importe.
Serverul nu răspunde #
- Verificați conexiunea la internet.
- Reîncercați peste câteva minute: poate avea loc o scurtă repornire a serverului.
- Tot căzut după 15 minute: scrieți-ne din Console (Support) cu ora și numele instrumentului. Nu trimiteți niciodată token-ul.
Sfat După orice modificare a unui token (Edit, Rotate), reporniți asistentul. Acesta citește lista de instrumente doar când se conectează.
FAQ #
De ce apare un instrument în listă, dar refuză să ruleze? #
Toate instrumentele familiei sunt listate, iar casetele se verifică la fiecare apel. Un refuz care numește o permisiune înseamnă că token-ului îi lipsește acea casetă.
Token-ul meu a funcționat ieri. De ce 401 azi? #
A fost rotit, revocat sau a expirat (365 de zile). Verificați starea lui în Users › API & MCP și puneți noul token în asistent.
Trebuie să repornesc asistentul după editarea token-ului? #
Da. Asistentul citește lista de instrumente doar când se conectează.