Photoshop MCP · Fehlerbehebung
Fehlerbehebung
Die häufigsten Probleme und wie Sie sie beheben. Ist Ihres nicht dabei, eröffnen Sie ein Support-Ticket mit den Logs Ihres MCP-Clients und Ihrer Photoshop-Version.
Das Bedienfeld Synthetic Photoshop MCP zeigt "Getrennt"
Symptom: Das Bedienfeld in Photoshop verbindet sich nie mit dem Server, oder Tools schlagen mit einem Verbindungsfehler fehl.
Lösung: Prüfen Sie, ob der MCP-Server tatsächlich läuft (Ihr MCP-Client startet ihn beim Start). Das Bedienfeld versucht die Verbindung alle 3 Sekunden selbst erneut — Sie müssen es nicht neu öffnen. Wenn es sich weiterhin nicht verbindet, starten Sie Photoshop komplett neu (das Bedienfeld lädt nach einer Netzwerk- oder Portänderung nicht immer sauber neu).
MCP-Client meldet, dass photoshop-mcp nicht geantwortet hat
Symptom: Der Client lädt den Server, läuft dann aber in eine Zeitüberschreitung oder meldet 'tool not available'.
Lösung: Prüfen Sie, ob Photoshop mit einem geladenen Dokument geöffnet ist und ob das Bedienfeld Synthetic Photoshop MCP "Verbunden" anzeigt. Der Server kommuniziert mit Photoshop über das Bridge-Plug-in per WebSocket — ohne die App, ein Dokument oder ein verbundenes Bedienfeld schlagen Tools fehl. Starten Sie anschließend den MCP-Client neu.
Fehler wegen ungültiger Lizenz
Symptom: Die Client-Logs melden 'license validation failed' oder 'PS_MCP_LICENSE not set'.
Lösung: Die Lizenz in Ihrer Konfiguration stimmt nicht mit der unter /dashboard/licenses überein. Kopieren Sie sie erneut — und achten Sie beim Einfügen ins JSON auf Leerzeichen am Anfang oder Ende.
Das CEP-Bedienfeld erscheint nicht in Photoshop
Symptom: Sie haben die .zxp installiert, sehen "Synthetic Photoshop MCP" aber nicht unter Window → Extensions.
Lösung: Starten Sie Photoshop nach der Installation vollständig neu (das Bedienfeld zu schließen und wieder zu öffnen reicht nicht). Fehlt es weiterhin, prüfen Sie, ob ZXP Installer ohne Fehler abgeschlossen hat — eine ungültige Signatur schlägt in manchen Photoshop-Versionen stillschweigend fehl.
npx ist bei jedem Start langsam
Symptom: Bei jedem Start des MCP-Clients dauert das Laden des Servers 10-30 s.
Lösung: npx prüft bei jedem Start auf ein Update. Damit der Start sofort erfolgt, installieren Sie das Paket global: npm i -g @synthetic-ai/photoshop-mcp und ändern Sie dann command in der Konfiguration auf photoshop-mcp (ohne npx, ohne Argumente).
Wenn nichts davon hilft
Eröffnen Sie ein Ticket über Ihr Support-Dashboard mit: (1) Ihrer Photoshop-Version, (2) Ihrem MCP-Client und dessen Version, (3) den Logs des Clients beim Versuch, den Server zu starten, und (4) dem eingefügten Konfigurations-Snippet (ohne Lizenzschlüssel). Sie können auch in unserem Discord fragen.