SyntheticSynthetic/Docs
ProdukteNeuigkeiten
Dashboard →

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.

Der schnellste Weg: Nutzen Sie den Synthetic Installer. Er installiert die Tools, verbindet Ihre KI-Apps und hält alles auf dem neuesten Stand. Installer-Leitfaden ansehen

Voraussetzungen

Photoshop2022 (23.0) oder neuer (bis 2026)
Node.js18 oder höher
OSWindows 10/11 · macOS 12+
MCP-ClientClaude Desktop, Cursor, Codex oder ein beliebiger MCP-Client
LizenzIhr 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.

Öffnen Sie das Bedienfeld in Photoshop und prüfen Sie, ob dort "Verbunden" steht (bei Bedarf versucht es alle 3 s selbst eine neue Verbindung). Ohne diesen Schritt kann der MCP-Server in Photoshop nichts bewegen.

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-mcp

Beim 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.

Wenn Sie "command not found: npx" erhalten, installieren Sie Node.js von nodejs.org (LTS).

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.

Wichtig: Photoshop muss geöffnet und das Bedienfeld Synthetic Photoshop MCP verbunden sein, wenn der MCP-Client ein Tool ausführt. Zeigt das Bedienfeld "Getrennt" an, funktioniert kein Tool.