Illustrator 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 Illustrator-Version.
Das Bedienfeld Synthetic Illustrator MCP zeigt "Getrennt"
Symptom: Das Bedienfeld in Illustrator 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 Illustrator komplett neu (das Bedienfeld lädt nach einer Netzwerk- oder Portänderung nicht immer sauber neu).
MCP-Client meldet, dass illustrator-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 Illustrator mit einem geladenen Dokument geöffnet ist und ob das Bedienfeld Synthetic Illustrator MCP "Verbunden" anzeigt. Der Server kommuniziert mit Illustrator ü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 'IL_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 Illustrator
Symptom: Sie haben das Bridge-Panel installiert, sehen aber Synthetic Illustrator MCP nicht unter Fenster → Erweiterungen (Legacy).
Lösung: Starten Sie Illustrator nach der Installation vollständig neu (das Panel zu schließen und wieder zu öffnen genügt nicht). Falls Sie es manuell installiert haben, prüfen Sie, ob die .zxp-Installation abgeschlossen ist, oder führen Sie den Synthetic-Installer erneut aus: Er erkennt und repariert das Panel. Öffnen Sie ein Support-Ticket, falls es weiterhin nicht erscheint.
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/illustrator-mcp und ändern Sie dann command in der Konfiguration auf illustrator-mcp (ohne npx, ohne Argumente).
Wenn nichts davon hilft
Eröffnen Sie ein Ticket über Ihr Support-Dashboard mit: (1) Ihrer Illustrator-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.