Risoluzione dei problemi MCP: 401, 403, strumenti mancanti
La maggior parte dei problemi MCP di LanaChat deriva dal token: sbagliato, scaduto o privo di una casella. Trovi nella tabella l'errore che vede, poi i dettagli più sotto.
| Cosa vede | Causa probabile | Rimedio |
|---|---|---|
401, "unauthorized" | token sbagliato, scaduto, revocato o ruotato | lo copi di nuovo o usi Rotate, controlli Bearer |
403, "permission", "requires …" | al token manca una casella | usi Edit sul token, spunti la casella, riavvii |
| "tool not found" | casella disattivata, nome inventato, server non aggiunto | spunti la casella, controlli /mcp |
409, "revision" o "hash" | l'elemento è cambiato nel frattempo | lo rilegga e rifaccia la modifica |
| "request too large" | più di 4 MiB in una richiesta | carichi i file nel Vault o tramite Drive |
| nessuna risposta | rete o breve riavvio | riprovi tra qualche minuto |
401: unauthorized #
Il server non ha accettato il token.
- Il token è stato copiato con un carattere mancante o in più. Lo copi di nuovo, da dove lo ha salvato.
- L'header deve essere esattamente
Authorization: Bearerseguito dal token. La parolaBearere lo spazio sono obbligatori. - Il token è stato revocato o ruotato (il vecchio smette subito di funzionare). In Users › API & MCP, controlli il suo stato.
- Il token è scaduto: i token durano 365 giorni. Prema Rotate (o Renew) e inserisca il nuovo nel Suo assistente.
- Ha usato una chiave dipendente (Team Management) o una password della Console. L'MCP accetta solo un token da API & MCP.
403: forbidden, o "permission" #
Il token è valido ma gli manca una casella per questa azione.
- In Users › API & MCP, prema Edit sul token.
- Spunti la casella di cui l'azione ha bisogno (veda la tabella in Creare il Suo token MCP).
- Salvi, poi chiuda e riavvii il Suo assistente.
Due casi particolari:
- L'assegnazione di una licenza viene rifiutata: al token manca Spend the balance on licences (serve anche Read sales, e solo il proprietario del workspace può spuntarla), oppure è stato raggiunto il Daily limit for licences (0 significa nessuna licenza). Il rifiuto indica quale dei due. Lo risolva con Edit sul token, oppure assegni la licenza nella Console, in Billing › Licences.
- Playground rifiutato: le risposte del Playground richiedono un saldo positivo. Ricarichi in Billing › Top up, oppure salti il test.
Manca uno strumento, o "tool not found" #
- Senza Configure agency AI, l'assistente riceve solo gli strumenti di configurazione, fan e vendite 132: nessuno strumento per AI Brain, Playground o pubblicazione. Spunti la casella, riavvii.
- Uno strumento elencato che però rifiuta ("requires can_generate", "requires the owner's can_publish permission") indica una casella mancante sul token. La spunti con Edit, riavvii.
- L'assistente ha inventato un nome. Gli chieda: "List the tools of lanachat." I nomi reali sono nel riferimento degli strumenti.
- Il server non è collegato: in Claude Code o Codex digiti
/mcp; in un editor, controlli le sue impostazioni MCP.
409, "revision" o "hash" cambiati #
Qualcuno (o l'assistente stesso) ha modificato la stessa cosa nel frattempo. Chieda all'assistente di rileggere l'elemento e di rifare la modifica con la revisione aggiornata. Nulla è andato perso.
Richiesta troppo grande #
Una richiesta MCP è limitata a 4 MiB. Foto e video non passano dalla chat: li carichi nel Vault, oppure indichi il link di una cartella Google Drive pubblica e lasci che l'assistente la importi.
Il server non risponde #
- Controlli la Sua connessione a internet.
- Riprovi tra qualche minuto: può capitare un breve riavvio del server.
- Ancora non raggiungibile dopo 15 minuti: ci scriva dalla Console (Support) indicando l'ora e il nome dello strumento. Non invii mai il token.
Suggerimento Dopo qualsiasi modifica a un token (Edit, Rotate), riavvii l'assistente. Legge l'elenco degli strumenti solo quando si collega.
FAQ #
Perché uno strumento compare nell'elenco ma si rifiuta di funzionare? #
Ogni strumento della famiglia è elencato e le caselle vengono verificate a ogni chiamata. Un rifiuto che nomina un permesso significa che al token manca quella casella.
Il mio token funzionava ieri. Perché oggi 401? #
È stato ruotato, revocato o è scaduto (365 giorni). Controlli il suo stato in Users › API & MCP e inserisca il nuovo token nel Suo assistente.
Devo riavviare l'assistente dopo aver modificato il token? #
Sì. L'assistente legge l'elenco degli strumenti solo quando si collega.