Photoshop MCP · Installation

Installer Photoshop MCP

Photoshop 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 Photoshop. Pas d'installeur pour le serveur lui-même — juste node + npx.

Prérequis

1. Installez le plug-in passerelle CEP

Le serveur ne communique pas directement avec Photoshop — il a besoin du panneau passerelle installé dans Photoshop. Téléchargez le .zxp signé depuis /dashboard/downloads (licence active requise), installez-le avec ZXP Installer et redémarrez Photoshop. Le panneau apparaît sous Window → Extensions (Legacy) → Synthetic Photoshop MCP.

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

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

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.

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 PS_MCP_LICENSE, sous env, dans la configuration de votre client.

4. Ouvrez Photoshop et essayez

Une fois votre client MCP configuré, ouvrez Photoshop avec n'importe quel document, vérifiez que le panneau Synthetic Photoshop 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 :

Si la réponse est la liste de vos calques, l'aller-retour fonctionne. Essayez ensuite autre chose — ajouter un calque de texte, exporter en PNG.