SyntheticSynthetic/Docs
ProdukteNeuigkeiten
Dashboard →

Illustrator MCP · Installation

Illustrator MCP installieren

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

Illustrator2022 (26.0) oder neuer
Node.js18 oder höher
OSWindows 10/11 · macOS 12+
MCP-ClientClaude Desktop, Cursor, Codex oder ein beliebiger MCP-Client
LizenzIhr Illustrator MCP-Lizenzschlüssel (siehe /dashboard/licenses)

1. CEP-Bridge-Plug-in installieren

Der Server spricht nicht direkt mit Illustrator — er benötigt das Bridge-Panel in Illustrator. Am einfachsten geht das mit dem Synthetic-Installer, der es für Sie installiert; Sie können das signierte Panel (.zxp) auch unter /dashboard/downloads herunterladen und mit dem ZXP Installer installieren. Das Panel erscheint unter Fenster → Erweiterungen (Legacy) → Synthetic Illustrator MCP.

Öffnen Sie das Bedienfeld in Illustrator 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 Illustrator nichts bewegen.

2. Download und Start des Servers prüfen

Führen Sie in einem beliebigen Terminal Folgendes aus (Illustrator muss noch nicht geöffnet sein):

npx -y @synthetic-ai/illustrator-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 IL_MCP_LICENSE ein.

4. Illustrator öffnen und ausprobieren

Sobald Ihr MCP-Client konfiguriert ist, öffnen Sie Illustrator mit einem beliebigen Dokument, prüfen Sie, ob das Bedienfeld Synthetic Illustrator 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 Form hinzufügen, als SVG exportieren.

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