Wat doe ik als de MCP-server van Picasi niet reageert?
Kort antwoord
Als de Picasi-MCP-server niet reageert, komt dat meestal door een ongeldig API-token, een verouderd configuratiebestand of doordat de MCP-server niet correct in de AI-toepassing is geïntegreerd.
Details
Token controleren:
Open in Picasi Workspace-instellingen → AI-verbindingen en controleer onder Actieve toegangstokens of het token er nog staat en wanneer het Laatst gebruikt is. Het token zelf toont Picasi na het aanmaken niet meer. Ontbreekt het of heb je de waarde niet meer, maak dan een nieuw token aan en vervang de waarde in je .mcp.json of je configuratie.
Configuratiebestand bij Claude Code controleren:
Open ~/.claude.json of het projectspecifieke .mcp.json en controleer:
- Is
PICASI_API_TOKENcorrect ingesteld? - Klopt de URL (
https://picasi.app/mcp)? - Is de JSON syntactisch correct (geen ontbrekende komma’s, geen verkeerde aanhalingstekens)?
Claude Desktop / ChatGPT (OAuth):
Bij OAuth-gebaseerde verbindingen kan de sessie zijn verlopen. Open Picasi via Persoonlijke instellingen → Verbindingen en controleer of de verbinding daar nog staat. Zo niet, of als ze niet meer werkt, trek de verbinding dan in en verbind de assistent opnieuw, net als de eerste keer.
MCP-server opnieuw laden:
In Claude Code: Typ in de chat /mcp en controleer of picasi als verbonden server wordt weergegeven. Zo niet, start de applicatie dan opnieuw op — MCP-servers worden bij het opstarten geladen.
Als niets helpt:
Maak een nieuw API-token aan, trek het oude in, werk alle configuratiebestanden bij en start de AI-assistent opnieuw op.
Andere veelvoorkomende fouten
“Permission required” of scope-fout bij het aanroepen van een tool
De aangeroepen tool vereist een hogere scope dan bij het tot stand brengen van de verbinding is toegekend. Voorbeeld: create_source vereist write, maar het token is alleen aangemaakt met read.
- API-token: maak onder Workspace-instellingen → AI-verbindingen een nieuw token aan met het juiste Toegangsniveau en voer dit in de client in.
- OAuth (Claude.ai, ChatGPT): onder Persoonlijke instellingen → Verbindingen de bestaande verbinding intrekken en bij het opnieuw verbinden Lezen & schrijven kiezen.
Antwoord 401 Unauthorized
De server kon geen geldig token herkennen.
- Ontbreekt de
Authorization: Bearer …-header, of is de Bearer-string leeg? Controleer dit in de clientconfiguratie. - Bij Claude Code: de omgevingsvariabele
PICASI_API_TOKENstaat mogelijk alleen in de terminal van waaruit de client is gestart. Als er in.mcp.jsonnaar het token wordt verwezen, voer het daar dan direct in.
Antwoord 403 Forbidden
Het token is geldig, maar de opgevraagde bron behoort niet tot de verbonden Workspace.
- Controleer of het token voor de juiste Workspace is uitgegeven. Bij het wisselen tussen Workspaces is een nieuw token nodig.
Netwerkfouten of time-outs
Het verzoek bereikt Picasi niet of wordt afgebroken.
- Controleer de bedrijfs-VPN of proxy:
https://picasi.app/mcpmoet bereikbaar zijn. - Bij analyseverzoeken (samenvattingen, feedback): de AI-client breekt na ongeveer 30 seconden af. Deze analyses worden momenteel niet via MCP aangeboden — genereer in plaats daarvan het Report in de Picasi-app en haal het op met
get_report.
Verbinding wordt regelmatig verbroken (Claude.ai / ChatGPT)
OAuth-toegangstokens verlopen. Picasi vernieuwt de verbinding normaal gesproken automatisch, maar in zeldzame gevallen wordt de verbinding definitief verbroken.
- Trek onder Persoonlijke instellingen → Verbindingen de verbinding in en verbind de assistent opnieuw.
- Bekend probleem: na langdurige inactiviteit (> 15 dagen zonder verversing) moet de verbinding opnieuw worden geautoriseerd.
Serverversie komt niet overeen met de client
Als de AI-client een foutmelding met een protocolversie (bijv. unsupported protocol version) weergeeft, is de client waarschijnlijk te oud.
- Client bijwerken: Claude Code (
claude Update), Claude Desktop en ChatGPT via de betreffende store.
Verbinding is aanwezig, maar geen gegevens
list_sources retourneert een lege lijst, hoewel er bronnen zichtbaar zijn in de app.
- Controleer of je verbinding hebt gemaakt met de juiste Workspace. De teamcontext kan worden geverifieerd met
get_team_context— in het veldteam.namestaat de Workspace waarmee je momenteel verbonden bent.