Salta ai contenuti
Apri l'app

Che cosa fare se il server MCP di Picasi non risponde?

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 del Workspace → Connessioni IA e verifica in Token di accesso attivi se il token è ancora presente e quando risale il suo Ultimo utilizzo. Dopo la creazione Picasi non mostra più il token stesso. Se manca o non hai più il valore, creane uno nuovo 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 personali → Connessioni e verifica se la connessione è ancora presente. In caso contrario, o se non funziona più, revocala e ricollega l’assistente, come la prima volta.

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, revoca quello vecchio, 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 del Workspace → Connessioni IA creare un nuovo token con il Livello di autorizzazione appropriato e inserirlo nel client.
  • OAuth (Claude.ai, ChatGPT): in Impostazioni personali → Connessioni revocare la connessione esistente e, al momento di ricollegarsi, scegliere Lettura e scrittura.

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 al Workspace connesso.

  • Verificare che il token sia stato emesso per il Workspace corretto. Quando si passa da un Workspace 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 personali → Connessioni revoca la connessione e ricollega l’assistente.
  • Caso noto: dopo un periodo prolungato di inattività (> 15 giorni senza Update), è 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 al Workspace corretto. Il contesto del team può essere verificato con get_team_context — nel campo team.name è indicato il Workspace attualmente collegato.