# Risoluzione dei problemi MCP: 401, 403, strumenti mancanti

_Collegare Claude / Codex · 3 min di lettura · Aggiornato 2026-11-08 · https://lanachat.ai/guides/it/ai-troubleshooting/_

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: Bearer ` seguito dal token. La parola `Bearer` e 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.

1. In **Users › API & MCP**, prema **Edit** sul token.
2. Spunti la casella di cui l'azione ha bisogno (veda la tabella in [Creare il Suo token MCP](https://lanachat.ai/guides/it/ai-create-mcp-token/)).
3. 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](https://lanachat.ai/guides/mcp-tool-reference/).
- 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.

> Tip: 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.

## Articoli correlati

- [Proteggere il Suo token](https://lanachat.ai/guides/it/ai-security/)
- [MCP tool reference: every tool, by screen](https://lanachat.ai/guides/mcp-tool-reference/)
- [API & MCP: collegare un assistente IA](https://lanachat.ai/guides/it/api-mcp/)