SyntheticSynthetic/Docs
ProdutosNovidades
Dashboard →

Illustrator MCP · Instalação

Instalar o Illustrator MCP

O Illustrator 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 Illustrator. 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

Illustrator2022 (26.0) ou mais recente
Node.js18 ou mais recente
OSWindows 10/11 · macOS 12+
Cliente MCPClaude Desktop, Cursor, Codex ou qualquer cliente MCP
LicençaSua chave de licença do Illustrator MCP (veja /dashboard/licenses)

1. Instale o plug-in ponte CEP

O servidor não conversa diretamente com o Illustrator — ele precisa do painel-ponte instalado dentro do Illustrator. O mais fácil é usar o instalador da Synthetic, que instala tudo para você; você também pode baixar o painel assinado (.zxp) em /dashboard/downloads e instalá-lo com o ZXP Installer. O painel aparece em Janela → Extensões (herdadas) → Synthetic Illustrator MCP.

Abra o painel dentro do Illustrator 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 Illustrator.

2. Verifique se o servidor é baixado e inicia

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

npx -y @synthetic-ai/illustrator-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 IL_MCP_LICENSE, dentro de env, na configuração do cliente.

4. Abra o Illustrator e teste

Com o cliente MCP configurado, abra o Illustrator com qualquer documento, confirme que o painel Synthetic Illustrator 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 forma, exportar como SVG.

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