Interfaz web
Un chat completamente local que controla Photoshop a través del servidor MCP. Un comando y tu navegador se abre — sin necesidad de IDE.
Empieza con un solo comando
npx -p @alisaitteke/photoshop-mcp photoshop-mcp-uiSe inicia un servidor local en 127.0.0.1 (puerto libre aleatorio) y tu navegador predeterminado abre el chat automáticamente.
Elige un proveedor
En el primer arranque, elige una opción: con una clave de API o con tu cuenta de suscripción de CLI existente (Anthropic y Google).
| Proveedor | Modelos | Clave de API | Cuenta CLI |
|---|---|---|---|
| Anthropic | Claude Sonnet / Opus / Haiku | console.anthropic.com | npm i -g @anthropic-ai/claude-code → claude auth login |
| OpenAI | GPT-5, GPT-4.1, o-series | platform.openai.com | — |
| Gemini 2.5 Pro / Flash / Flash-Lite | aistudio.google.com | npm i -g @google/gemini-cli → gemini auth login | |
| OpenRouter | 100+ models | openrouter.ai | — |
Dos formas de autenticarse
Puedes cambiar el método de autenticación de cada proveedor en Settings sin perder la otra credencial: guarda una clave de API mientras pruebas la cuenta CLI y vuelve atrás cuando quieras.
Qué ocurre en el primer arranque
- Elige un proveedor y selecciona API key o Uses your account.
- Valida la clave o comprueba la conexión del CLI. La configuración se guarda localmente en ~/.photoshop-mcp/data.db (SQLite, chmod 600): las claves nunca salen de tu máquina.
- Escribe prompts en lenguaje natural. La interfaz muestra la respuesta del modelo en streaming, ejecuta las llamadas a herramientas de Photoshop en tiempo real y renderiza cada llamada como una tarjeta inspeccionable (entrada + resultado).
- Cambia de proveedor, método de autenticación o modelo en cualquier momento desde Settings o el selector de modelo: los chats, los costes y el historial de herramientas se conservan entre sesiones.
Un modo de ejecución opcional para la autenticación con clave de API. En lugar del bucle modelo → herramienta paso a paso, una única llamada de planificación construye una lista ordenada de tareas con llamadas a herramientas de Photoshop que se ejecutan directamente en secuencia.
- Una llamada de planificación construye una lista ordenada de tareas con llamadas a herramientas de Photoshop.
- Las herramientas se ejecutan directamente en secuencia, sin viajes de ida y vuelta al modelo entre pasos.
- Si un paso falla, un bucle de reparación acotado vuelve a planificar solo los pasos restantes (hasta 3 veces).
Desactivado por defecto: actívalo junto al selector de modelo. Ideal para prompts de varios pasos como «quita el fondo y exporta para web», con menos llamadas al modelo y una ejecución total más rápida.
Cambiar de método de autenticación más tarde
Abre Settings desde la barra lateral en cualquier momento.
| Acción | Modo clave de API | Modo cuenta CLI |
|---|---|---|
| Configurar | Pega la clave → Save | Instala el CLI → auth login → Check connection |
| Cambiar a otro método | Elige API key: la clave guardada se conserva | Elige Uses your account: la clave no se borra |
| Binario personalizado | — | Ruta opcional del CLI si claude / gemini no está en el PATH |
| Visualización del coste | Estimación por token en la barra de estado | Insignia de «incluido en la suscripción» |
El método de autenticación se guarda por proveedor en ~/.photoshop-mcp/data.db: las configuraciones existentes siguen funcionando sin cambios.
Flags del CLI
photoshop-mcp-ui [--port 5174] [--host 127.0.0.1] [--no-open]Seguridad de la API local
El servidor de la interfaz guarda las claves de tus proveedores y puede controlar Photoshop, así que cada petición a /api/* pasa tres comprobaciones:
- Host — debe ser la dirección de loopback (o el --host al que lo hayas vinculado) en el puerto del servidor. Bloquea el DNS rebinding.
- Origin — cuando está presente, debe coincidir con el origen de la propia interfaz. Bloquea llamadas del navegador desde otros orígenes.
- Token de sesión — un secreto aleatorio por arranque. Bloquea otros procesos locales, que pueden falsificar cualquier cabecera pero no pueden leer el token.
El navegador nunca tiene que lidiar con el token: el servidor lo inyecta en la página que sirve. Para scripting, léelo de ~/.photoshop-mcp/ui-session.json y envíalo como cabecera:
TOKEN=$(node -p "require('$HOME/.photoshop-mcp/ui-session.json').token")
curl -H "x-psmcp-token: $TOKEN" http://127.0.0.1:5174/api/statusAuthorization: Bearer <token> también funciona. Define PSMCP_UI_TOKEN antes de arrancar el servidor para fijar un token conocido; las peticiones sin un token válido reciben 401 unauthorized.
Variables de entorno
PHOTOSHOP_PATH— ruta personalizada de instalación de Photoshop (opcional)LOG_LEVEL— nivel de registro (0=DEBUG, 1=INFO, 2=WARN, 3=ERROR)PSMCP_UI_TOKEN— fija el token de sesión de la interfaz webANALYTICS_DISABLED— ponlo a 1 o true para desactivar por completo la analítica de uso anónimaPOSTHOG_DISABLED— alias heredado de ANALYTICS_DISABLEDRYBBIT_API_KEY / RYBBIT_HOST / RYBBIT_SITE_ID— overrides opcionales de analítica para forks o staging
¿Tienes problemas?
Los errores 401, los problemas de conexión y las soluciones para la cuenta CLI están en la página de solución de problemas.