SyntheticSynthetic/Docs
ProduitsNouveautés
Tableau de bord →

Illustrator MCP · Installation

Installer Illustrator MCP

Illustrator MCP s'exécute comme un serveur Node.js lancé par votre client MCP (Claude Desktop, Cursor, Codex), qui se connecte via WebSocket à un plug-in passerelle CEP dans Illustrator. Pas d'installeur pour le serveur lui-même — juste node + npx.

La méthode la plus rapide : utilisez le Synthetic Installer. Il installe les outils, connecte vos applications d'IA et maintient tout à jour. Voir le guide de l'installateur

Prérequis

Illustrator2022 (26.0) ou ultérieur
Node.js18 ou supérieur
OSWindows 10/11 · macOS 12+
Client MCPClaude Desktop, Cursor, Codex ou tout autre client MCP
LicenceVotre clé de licence Illustrator MCP (voir /dashboard/licenses)

1. Installez le plug-in passerelle CEP

Le serveur ne communique pas directement avec Illustrator : il a besoin du panneau passerelle installé dans Illustrator. Le plus simple est l'installeur Synthetic, qui s'en charge ; vous pouvez aussi télécharger le panneau signé (.zxp) depuis /dashboard/downloads et l'installer avec ZXP Installer. Le panneau apparaît dans Fenêtre → Extensions (héritées) → Synthetic Illustrator MCP.

Ouvrez le panneau dans Illustrator et vérifiez qu'il affiche « Connecté » (il retente la connexion toutes les 3 s de lui-même). Sans cela, le serveur MCP n'a aucun moyen d'agir dans Illustrator.

2. Vérifiez que le serveur se télécharge et démarre

Dans n'importe quel terminal (inutile d'ouvrir Illustrator pour l'instant), exécutez :

npx -y @synthetic-ai/illustrator-mcp

La première fois, le téléchargement prend quelques secondes. S'il démarre et attend une entrée sur stdio, tout va bien — appuyez sur Ctrl+C pour quitter et passez à l'étape 3.

Si vous obtenez "command not found: npx", installez Node.js (LTS) depuis nodejs.org.

3. Connectez-le à votre client MCP

Chaque client MCP possède un fichier de configuration où les serveurs sont déclarés. Consultez le guide de configuration du client MCP pour l'extrait JSON exact à coller dans Claude Desktop, Cursor, Codex ou un autre client.

Votre clé de licence se trouve sur /dashboard/licenses — collez sa valeur dans IL_MCP_LICENSE, sous env, dans la configuration de votre client.

4. Ouvrez Illustrator et essayez

Une fois votre client MCP configuré, ouvrez Illustrator avec n'importe quel document, vérifiez que le panneau Synthetic Illustrator MCP affiche « Connecté », puis redémarrez votre client MCP pour qu'il prenne en compte le nouveau serveur. Demandez-lui ensuite quelque chose de simple :

Liste les calques du document actif.

Si la réponse est la liste de vos calques, l'aller-retour fonctionne. Essayez ensuite autre chose — ajouter une forme, exporter en SVG.

Important : Illustrator doit être ouvert, avec le panneau Synthetic Illustrator MCP connecté, au moment où le client MCP exécute un outil. Si le panneau affiche « Déconnecté », aucun outil ne fonctionnera.