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_TOKENkorrekt 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_TOKENsteht ggf. nur im Terminal, aus dem der Client gestartet wurde. Wenn das Token in.mcp.jsonreferenziert 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/mcpmuss 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_reportabholen.
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_contextverifizieren — im Feldteam.namesteht der aktuell verbundene Workspace.