Dépannage

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

Symptôme : Le panneau dans Photoshop 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 Photoshop (le panneau ne se recharge pas toujours proprement après un changement de réseau ou de port).

Le client MCP indique que photoshop-mcp n'a pas répondu

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

Solution : Vérifiez que Photoshop est ouvert avec un document chargé et que le panneau Synthetic Photoshop MCP affiche « Connecté ». Le serveur communique avec Photoshop 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 'PS_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 Photoshop

Symptôme : Vous avez installé le .zxp, mais « Synthetic Photoshop MCP » n'apparaît pas sous Window → Extensions.

Solution : Redémarrez complètement Photoshop après l'installation (fermer et rouvrir le panneau ne suffit pas). S'il manque toujours, vérifiez que ZXP Installer s'est terminé sans erreur — une signature non valide échoue sans message sur certaines versions de Photoshop.

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/photoshop-mcp, puis, dans la configuration, remplacez la valeur de command par photoshop-mcp (sans npx ni arguments).