Dépannage

Le panneau Synthetic Illustrator MCP affiche « Déconnecté »

Symptôme : Le panneau dans Illustrator ne parvient jamais à se connecter au serveur, ou les outils échouent avec une erreur de connexion.

Solution : Vérifiez que le serveur MCP est bien en cours d'exécution (votre client MCP le lance au démarrage). Le panneau retente la connexion toutes les 3 secondes de lui-même — inutile de le rouvrir. S'il ne se connecte toujours pas, redémarrez complètement Illustrator (le panneau ne se recharge pas toujours proprement après un changement de réseau ou de port).

Le client MCP indique qu'illustrator-mcp n'a pas répondu

Symptôme : Le client charge le serveur, mais expire ensuite ou indique 'tool not available'.

Solution : Vérifiez qu'Illustrator est ouvert avec un document chargé et que le panneau Synthetic Illustrator MCP affiche « Connecté ». Le serveur communique avec Illustrator via le plug-in passerelle, en WebSocket — sans l'application, sans document ou sans le panneau connecté, les outils renvoient une erreur. Redémarrez ensuite le client MCP.

Erreur de licence non valide

Symptôme : Les journaux du client indiquent 'license validation failed' ou 'IL_MCP_LICENSE not set'.

Solution : La licence de votre configuration ne correspond pas à celle indiquée sur /dashboard/licenses. Recopiez-la — vérifiez qu'aucun espace ne s'est glissé au début ou à la fin quand vous l'avez collée dans le JSON.

Le panneau CEP n'apparaît pas dans Illustrator

Symptôme : Vous avez installé le panneau passerelle mais Synthetic Illustrator MCP n'apparaît pas dans Fenêtre → Extensions (héritées).

Solution : Redémarrez complètement Illustrator après l'installation (fermer et rouvrir le panneau ne suffit pas). Si vous l'avez installé manuellement, vérifiez que l'installation du .zxp est terminée, ou relancez l'installeur Synthetic : il détecte et répare le panneau. Ouvrez un ticket de support si le panneau n'apparaît toujours pas.

npx est lent à chaque lancement

Symptôme : À chaque démarrage du client MCP, le chargement du serveur prend 10 à 30 s.

Solution : npx vérifie la présence d'une mise à jour à chaque lancement. Pour un démarrage instantané, installez-le globalement : npm i -g @synthetic-ai/illustrator-mcp, puis, dans la configuration, remplacez la valeur de command par illustrator-mcp (sans npx ni arguments).