Photoshop MCP · Instalação

Instalar o Photoshop MCP

O Photoshop MCP roda como um servidor Node.js que o seu cliente MCP inicia (Claude Desktop, Cursor, Codex) e se conecta via WebSocket a um plug-in ponte CEP dentro do Photoshop. O servidor em si não tem instalador — basta node + npx.

A maneira mais rápida: use o Synthetic Installer. Ele instala as ferramentas, conecta seus apps de IA e mantém tudo atualizado. Veja o guia do instalador

Requisitos

Photoshop	2022 (23.0) ou mais recente (até 2026)
Node.js	18 ou mais recente
OS	Windows 10/11 · macOS 12+
Cliente MCP	Claude Desktop, Cursor, Codex ou qualquer cliente MCP
Licença	Sua chave de licença do Photoshop MCP (veja /dashboard/licenses)

1. Instale o plug-in ponte CEP

O servidor não se comunica diretamente com o Photoshop — ele precisa do painel ponte instalado dentro do Photoshop. Baixe o .zxp assinado em /dashboard/downloads (requer uma licença ativa), instale-o com o ZXP Installer e reinicie o Photoshop. O painel aparece em Janela → Extensões (legado) → Synthetic Photoshop MCP.

Abra o painel dentro do Photoshop e confirme que ele mostra "Conectado" (ele tenta de novo sozinho a cada 3s). Sem isso, o servidor MCP não tem como mexer em nada no Photoshop.

2. Verifique se o servidor é baixado e inicia

Em qualquer terminal (ainda não é preciso ter o Photoshop aberto), execute:

npx -y @synthetic-ai/photoshop-mcp

Na primeira vez, o download leva alguns segundos. Se ele iniciar e ficar esperando entrada via stdio, está tudo certo — pressione Ctrl+C para sair e siga para o passo 3.

Se aparecer "command not found: npx", instale o Node.js a partir de nodejs.org (LTS).

3. Conecte ao seu cliente MCP

Cada cliente MCP tem um arquivo de configuração onde os servidores são declarados. Veja o guia de configuração do cliente MCP para o trecho JSON exato que você cola no Claude Desktop, no Cursor, no Codex ou em outro cliente.

Sua chave de licença está em /dashboard/licenses — cole o valor em PS_MCP_LICENSE, dentro de env, na configuração do cliente.

4. Abra o Photoshop e teste

Com o cliente MCP configurado, abra o Photoshop com qualquer documento, confirme que o painel Synthetic Photoshop MCP mostra "Conectado" e reinicie o cliente MCP para que ele carregue o novo servidor. Depois, peça algo simples:

Liste as camadas do documento ativo.

Se a resposta for uma lista das suas camadas, a comunicação de ida e volta está funcionando. Depois, tente outra coisa — adicionar uma camada de texto, exportar como PNG.

Importante: o Photoshop precisa estar aberto, com o painel Synthetic Photoshop MCP conectado, quando o cliente MCP executar uma ferramenta. Se o painel mostrar "Desconectado", nenhuma ferramenta vai funcionar.

← Photoshop MCP Configuração do cliente