Ga naar inhoud
Naar de app

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_TOKEN correct 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_TOKEN staat mogelijk alleen in de terminal van waaruit de client is gestart. Als er in .mcp.json naar 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/mcp moet 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 veld team.name staat de Workspace waarmee je momenteel verbonden bent.