Photoshop MCP · Instalación

Instalación de Photoshop MCP

Photoshop MCP se ejecuta como un servidor Node.js que lanza tu cliente MCP (Claude Desktop, Cursor, Codex) y se conecta por WebSocket a un plugin puente CEP dentro de Photoshop. No hay un instalador para el server — basta con node + npx.

La forma más rápida: usa el Instalador de Synthetic. Instala las herramientas, conecta tus apps de IA y mantiene todo al día. Ver la guía del instalador

Requisitos

Photoshop	2022 (23.0) o más reciente (hasta 2026)
Node.js	18 o superior
OS	Windows 10/11 · macOS 12+
Cliente MCP	Claude Desktop, Cursor, Codex, o cualquier cliente MCP
Licencia	Tu clave de licencia de Photoshop MCP (ver /dashboard/licenses)

1. Instala el plugin puente CEP

El server no habla con Photoshop directamente — necesita el panel puente instalado adentro de Photoshop. Descarga el .zxp firmado desde /dashboard/downloads (necesita licencia activa), instálalo con ZXP Installer y reinicia Photoshop. El panel aparece en Window → Extensions (Legacy) → Synthetic Photoshop MCP.

Abre el panel dentro de Photoshop y confirma que dice "Conectado" (reintenta cada 3s solo). Sin esto, el server MCP no tiene forma de mover nada en Photoshop.

2. Prueba que el servidor se descarga y arranca

En una terminal cualquiera (no es necesario tener Photoshop abierto todavía), ejecuta:

npx -y @synthetic-ai/photoshop-mcp

La primera vez tarda un par de segundos en descargar el paquete. Si arranca y se queda esperando input por stdio, está OK — presiona Ctrl+C para salir y sigue al paso 3.

Si te aparece un error tipo "command not found: npx", instala Node.js desde nodejs.org (LTS).

3. Conéctalo a tu cliente MCP

Cada cliente MCP tiene un archivo de configuración donde se declaran los servers. Mira la guía de configuración del cliente para el JSON exacto que pegas en Claude Desktop, Cursor, Codex u otro.

Tu clave de licencia la consigues en /dashboard/licenses — pega el valor en PS_MCP_LICENSE dentro de env en la config del cliente.

4. Abre Photoshop y pruébalo

Una vez que el cliente MCP esté configurado, abre Photoshop con un documento cualquiera, confirma que el panel Synthetic Photoshop MCP dice "Conectado", y reinicia el cliente MCP para que cargue el nuevo server. Después pídele algo simple:

Lista las capas del documento activo.

Si la respuesta es una lista de tus capas, el flujo está funcionando. Prueba ahora algo como agregar una capa de texto o exportar como PNG.

Importante: Photoshop tiene que estar abierto y el panel Synthetic Photoshop MCP conectado al momento que el cliente MCP corre una tool. Si el panel dice "Desconectado", ninguna tool va a funcionar.

← Photoshop MCP Configuración del cliente