De MCP-server reageert niet

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 Instellingen → API-token en controleer of het token nog aanwezig en actief is. Als je op Token weergeven klikt, zie je het volledige token. Kopieer het opnieuw 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 Instellingen → Gekoppelde apps en controleer of de verbinding nog actief is. Zo niet, trek de verbinding dan in en maak opnieuw verbinding via Instellingen → AI-assistent koppelen.

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 (het oude wordt hierdoor ongeldig), 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 Instellingen → API-token een nieuw token aan met de juiste rol en voer dit in de client in.
OAuth (Claude.ai, ChatGPT): onder Instellingen → Gekoppelde apps de bestaande verbinding intrekken en bij het opnieuw verbinden de vereiste scope selecteren.

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 werkruimte.

Controleer of het token voor de juiste werkruimte is uitgegeven. Bij het wisselen tussen werkruimten 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 rapport 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 Instellingen → Gekoppelde apps de verbinding in en stel deze opnieuw in via Instellingen → AI-assistent koppelen.
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 werkruimte. De teamcontext kan worden geverifieerd met get_team_context — in het veld team.name staat de werkruimte waarmee je momenteel verbonden bent.