Illustrator MCP · Instalación

Instalación de Illustrator MCP

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

Illustrator	2022 (26.0) o más reciente
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 Illustrator MCP (ver /dashboard/licenses)

1. Instala el plugin puente CEP

El servidor no habla directamente con Illustrator: necesita el panel puente instalado dentro de Illustrator. Lo más fácil es el instalador de Synthetic, que lo instala por ti; también puedes descargar el panel firmado (.zxp) desde /dashboard/downloads e instalarlo con ZXP Installer. El panel aparece en Ventana → Extensiones (heredadas) → Synthetic Illustrator MCP.

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

2. Prueba que el servidor se descarga y arranca

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

npx -y @synthetic-ai/illustrator-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 IL_MCP_LICENSE dentro de env en la config del cliente.

4. Abre Illustrator y pruébalo

Una vez que el cliente MCP esté configurado, abre Illustrator con un documento cualquiera, confirma que el panel Synthetic Illustrator 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 forma o exportar como SVG.

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

← Illustrator MCP Configuración del cliente