Il server MCP non risponde

Consiglio

Direttamente nell’app: picasi.app/workspace/ai-connections

Risposta breve

Se il server MCP di Picasi non risponde, nella maggior parte dei casi ciò è dovuto a un token API non valido, a un file di configurazione obsoleto o al fatto che il server MCP non sia integrato correttamente nell’applicazione AI.

Dettagli

Verifica del token:

In Picasi, apri Impostazioni → Token API e verifica se il token è ancora presente e attivo. Cliccando su Visualizza token, vedrai il token completo. Copialo nuovamente e sostituisci il valore nel tuo .mcp.json o nella tua configurazione.

Verifica il file di configurazione in Claude Code:

Apri ~/.claude.json o il file specifico del progetto .mcp.json e verifica:

• PICASI_API_TOKEN è impostato correttamente?
• L’URL (https://picasi.app/mcp) è corretto?
• Il JSON è sintatticamente corretto (nessuna virgola mancante, nessuna virgoletta errata)?

Claude Desktop / ChatGPT (OAuth):

Nel caso di connessioni basate su OAuth, la sessione potrebbe essere scaduta. Apri Picasi in Impostazioni → App collegate e verifica se la connessione è ancora attiva. In caso contrario, revocala e riconnettiti tramite Impostazioni → Collega assistente IA.

Ricarica il server MCP:

In Claude Code: scrivi nella chat /mcp e verifica se picasi è elencato come server collegato. In caso contrario, riavvia l’applicazione: i server MCP vengono caricati all’avvio.

Se nulla funziona:

Crea un nuovo token API (quello vecchio diventerà così non valido), aggiorna tutti i file di configurazione e riavvia l’Assistente IA.

Altri errori comuni

“Permission required” o errore di ambito durante il richiamo dello strumento

Lo strumento richiamato richiede un ambito (scope) superiore a quello concesso al momento della connessione. Esempio: create_source richiede write, ma il token è stato creato solo con read.

• Token API: in Impostazioni → Token API creare un nuovo token con il ruolo appropriato e inserirlo nel client.
• OAuth (Claude.ai, ChatGPT): in Impostazioni → App collegate revocare la connessione esistente e, al momento di ricollegarsi, selezionare l’ambito richiesto.

Risposta 401 Unauthorized

Il server non è riuscito a riconoscere un token valido.

• Manca l’intestazione Authorization: Bearer … o la stringa Bearer è vuota? Verificare nella configurazione del client.
• Per Claude Code: la variabile d’ambiente PICASI_API_TOKEN potrebbe essere presente solo nel terminale da cui è stato avviato il client. Se il token viene referenziato in .mcp.json, inserirlo direttamente lì.

Risposta 403 Forbidden

Il token è valido, ma la risorsa richiesta non appartiene allo spazio di lavoro connesso.

• Verificare che il token sia stato emesso per lo spazio di lavoro corretto. Quando si passa da uno spazio di lavoro all’altro, è necessario un nuovo token.

Errori di rete o timeout

La richiesta non raggiunge Picasi o viene interrotta.

• Verificare la VPN aziendale o il proxy: https://picasi.app/mcp deve essere raggiungibile.
• Per le richieste di analisi (riepiloghi, feedback): il client IA si interrompe dopo circa 30 secondi. Queste analisi non sono attualmente disponibili tramite MCP; generare invece il report nell’app Picasi e recuperarlo con get_report.

La connessione si interrompe regolarmente (Claude.ai / ChatGPT)

I token di accesso OAuth scadono. Picasi di norma rinnova automaticamente la connessione; in rari casi, la connessione si interrompe definitivamente.

• In Impostazioni → App collegate revoca la connessione e riconfiguralo tramite Impostazioni → Connetti assistente IA.
• Caso noto: dopo un periodo prolungato di inattività (> 15 giorni senza aggiornamento), è necessario autorizzare nuovamente la connessione.

La versione del server non corrisponde a quella del client

Se il client IA mostra un messaggio di errore con la versione del protocollo (ad es. unsupported protocol version), è probabile che il client sia troppo vecchio.

• Aggiornare il client: Claude Code (claude update), Claude Desktop e ChatGPT tramite i rispettivi store.

Connessione attiva, ma nessun dato

list_sources restituisce un elenco vuoto, sebbene nell’app siano visibili delle fonti.

• Verificare di essersi collegati allo spazio di lavoro corretto. Il contesto del team può essere verificato con get_team_context — nel campo team.name è indicato lo spazio di lavoro attualmente collegato.