Photoshop MCP · Installation
Photoshop MCP installieren
Photoshop MCP läuft als Node.js-Server, den Ihr MCP-Client startet (Claude Desktop, Cursor, Codex), und verbindet sich per WebSocket mit einem CEP-Bridge-Plug-in in Photoshop. Für den Server selbst gibt es keinen Installer — nur node + npx.
Voraussetzungen
| Photoshop | 2022 (23.0) oder neuer (bis 2026) |
| Node.js | 18 oder höher |
| OS | Windows 10/11 · macOS 12+ |
| MCP-Client | Claude Desktop, Cursor, Codex oder ein beliebiger MCP-Client |
| Lizenz | Ihr Photoshop MCP-Lizenzschlüssel (siehe /dashboard/licenses) |
1. CEP-Bridge-Plug-in installieren
Der Server kommuniziert nicht direkt mit Photoshop — dafür muss das Bridge-Bedienfeld in Photoshop installiert sein. Laden Sie die signierte .zxp unter /dashboard/downloads herunter (aktive Lizenz erforderlich), installieren Sie sie mit ZXP Installer und starten Sie Photoshop neu. Das Bedienfeld erscheint unter Window → Extensions (Legacy) → Synthetic Photoshop MCP.
2. Download und Start des Servers prüfen
Führen Sie in einem beliebigen Terminal Folgendes aus (Photoshop muss noch nicht geöffnet sein):
npx -y @synthetic-ai/photoshop-mcpBeim ersten Mal dauert der Download ein paar Sekunden. Wenn der Server startet und auf Eingaben über stdio wartet, ist alles in Ordnung — beenden Sie ihn mit Strg+C und fahren Sie mit Schritt 3 fort.
3. Mit Ihrem MCP-Client verbinden
Jeder MCP-Client hat eine Konfigurationsdatei, in der Server deklariert werden. Das genaue JSON-Snippet für Claude Desktop, Cursor, Codex oder einen anderen Client finden Sie in der Anleitung zur Einrichtung des MCP-Clients.
Ihren Lizenzschlüssel finden Sie unter /dashboard/licenses — fügen Sie den Wert in Ihrer Client-Konfiguration unter env in PS_MCP_LICENSE ein.
4. Photoshop öffnen und ausprobieren
Sobald Ihr MCP-Client konfiguriert ist, öffnen Sie Photoshop mit einem beliebigen Dokument, prüfen Sie, ob das Bedienfeld Synthetic Photoshop MCP "Verbunden" anzeigt, und starten Sie Ihren MCP-Client neu, damit er den neuen Server lädt. Stellen Sie dann eine einfache Anfrage:
Liste die Ebenen im aktiven Dokument auf.Wenn die Antwort eine Liste Ihrer Ebenen ist, funktioniert der Hin- und Rückweg. Probieren Sie als Nächstes etwas anderes — eine Textebene hinzufügen, als PNG exportieren.