Zum Inhalt springen
Picasi Picasi Picasi Dokumentation
Zur App

Der MCP-Server antwortet nicht

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 Einstellungen → API-Token und prüfe, ob das Token noch vorhanden und aktiv ist. Wenn du auf Token anzeigen klickst, siehst du das vollständige Token. Kopiere es neu 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 Einstellungen → Verbundene Apps und prüfe, ob die Verbindung noch aktiv ist. Falls nicht, widerrufe sie und verbinde dich neu über Einstellungen → KI-Assistent verbinden.

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 (das alte wird damit ungültig), 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 Einstellungen → API-Token ein neues Token mit passender Rolle anlegen und im Client eintragen.
  • OAuth (Claude.ai, ChatGPT): unter Einstellungen → Verbundene Apps die bestehende Verbindung widerrufen und beim erneuten Verbinden den benötigten Scope auswä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 Einstellungen → Verbundene Apps die Verbindung widerrufen und über Einstellungen → KI-Assistent verbinden neu einrichten.
  • 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.