Zum Inhalt springen
Zur App

Was tun, wenn der MCP-Server von Picasi nicht antwortet?

Kurze Antwort

Wenn der Picasi-MCP-Server nicht antwortet, liegt es meistens an einem ungültigen API-Token, einer veralteten Konfigurationsdatei oder daran, dass der MCP-Server in der KI-Anwendung nicht korrekt eingebunden ist.

Details

Token prüfen:

Öffne in Picasi Workspace-Einstellungen → KI-Verbindungen und prüfe unter Aktive Zugriffstoken, ob das Token noch da ist und wann es Zuletzt verwendet wurde. Das Token selbst zeigt Picasi nach dem Erstellen nicht mehr an. Fehlt es oder hast du den Wert nicht mehr, erstelle ein neues und ersetze den Wert in deiner .mcp.json oder deiner Konfiguration.

Konfigurationsdatei bei Claude Code prüfen:

Öffne ~/.claude.json oder die projektspezifische .mcp.json und prüfe:

  • Ist PICASI_API_TOKEN korrekt gesetzt?
  • Stimmt die URL (https://picasi.app/mcp)?
  • Ist das JSON syntaktisch korrekt (kein fehlendes Komma, keine falschen Anführungszeichen)?

Claude Desktop / ChatGPT (OAuth):

Bei OAuth-basierten Verbindungen kann die Session abgelaufen sein. Öffne Picasi unter Persönliche Einstellungen → Verbindungen und prüfe, ob die Verbindung noch dort steht. Falls nicht, oder wenn sie nicht mehr funktioniert, widerrufe sie und verbinde den Assistenten neu, so wie beim ersten Mal.

MCP-Server neu laden:

In Claude Code: Schreibe im Chat /mcp und prüfe, ob picasi als verbundener Server aufgelistet ist. Falls nicht, starte die Anwendung neu — MCP-Server werden beim Start geladen.

Wenn gar nichts hilft:

Erstelle ein neues API-Token, widerrufe das alte, aktualisiere alle Konfigurationsdateien und starte den KI-Assistenten neu.

Weitere häufige Fehler

„Permission required“ oder Scope-Fehler beim Tool-Aufruf

Das aufgerufene Tool verlangt einen höheren Scope, als bei der Verbindung erteilt wurde. Beispiel: create_source verlangt write, das Token wurde aber nur mit read erstellt.

  • API-Token: unter Workspace-Einstellungen → KI-Verbindungen ein neues Token mit passender Berechtigungsstufe anlegen und im Client eintragen.
  • OAuth (Claude.ai, ChatGPT): unter Persönliche Einstellungen → Verbindungen die bestehende Verbindung widerrufen und beim erneuten Verbinden Lesen & Schreiben wählen.

Antwort 401 Unauthorized

Der Server konnte kein gültiges Token erkennen.

  • Fehlt der Authorization: Bearer …-Header, oder ist die Bearer-Zeichenkette leer? In der Client-Konfiguration prüfen.
  • Bei Claude Code: Umgebungsvariable PICASI_API_TOKEN steht ggf. nur im Terminal, aus dem der Client gestartet wurde. Wenn das Token in .mcp.json referenziert wird, dort direkt hinterlegen.

Antwort 403 Forbidden

Das Token ist gültig, aber die aufgerufene Ressource gehört nicht zum verbundenen Workspace.

  • Prüfen, ob das Token zum richtigen Workspace ausgestellt wurde. Beim Wechsel zwischen Workspaces wird ein neues Token benötigt.

Netzwerk-Fehler oder Timeouts

Die Anfrage erreicht Picasi nicht oder wird abgebrochen.

  • Firmen-VPN oder Proxy prüfen: https://picasi.app/mcp muss erreichbar sein.
  • Bei Analyse-Anfragen (Zusammenfassungen, Feedback): der KI-Client bricht nach ca. 30 Sekunden ab. Diese Analysen werden aktuell nicht über MCP angeboten — stattdessen den Report in der Picasi-App erzeugen und mit get_report abholen.

Verbindung bricht regelmäßig ab (Claude.ai / ChatGPT)

OAuth-Zugangs-Token laufen ab. Picasi erneuert die Verbindung normalerweise automatisch, in seltenen Fällen erlischt die Verbindung dauerhaft.

  • Unter Persönliche Einstellungen → Verbindungen die Verbindung widerrufen und den Assistenten neu verbinden.
  • Bekannter Fall: nach längerer Inaktivität (> 15 Tage ohne Refresh) muss die Verbindung neu autorisiert werden.

Server-Version passt nicht zum Client

Zeigt der KI-Client eine Fehlermeldung mit Protokoll-Version (z. B. unsupported protocol version), ist der Client vermutlich zu alt.

  • Client aktualisieren: Claude Code (claude update), Claude Desktop und ChatGPT über den jeweiligen Store.

Verbindung besteht, aber keine Daten

list_sources gibt eine leere Liste zurück, obwohl in der App Quellen sichtbar sind.

  • Prüfen, ob im richtigen Workspace verbunden wurde. Der Team-Kontext lässt sich mit get_team_context verifizieren — im Feld team.name steht der aktuell verbundene Workspace.