SyntheticSynthetic/Docs
ProductosNovedades
Panel →

Ayuda

Solución de problemas

Problemas comunes, sus causas y soluciones paso a paso.

¿Sigues atascado? Abre un ticket de soporte en tu panel con una descripción del problema y el mensaje de error que ves — respondemos rápido. También puedes preguntar en nuestro Discord.

MCP no conectado

Claude dice que las herramientas de After Effects no están disponibles o "MCP not connected".

Verifica el formato de la clave de licencia

La clave es un UUID con el formato XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX — sin espacios antes ni después. Copia y pega directamente desde tu panel.

Reinicia tu cliente MCP

Cierra Claude Desktop (o Cursor / Windsurf) por completo y vuelve a abrirlo. La licencia se valida al iniciar.

Verifica que Node.js esté instalado

Ejecuta node --version en una terminal — necesitas v18 o más reciente. Instálalo desde nodejs.org si falta.

Las herramientas se ejecutan pero no pasa nada en After Effects

Claude confirma que la herramienta se ejecutó correctamente, pero no aparecen cambios en AE.

Abre After Effects (modo Panel)

En modo Panel, el MCP no puede comunicarse con AE si no está en ejecución: abre After Effects antes de llamar a cualquier herramienta. En modo Standalone, el MCP lo lanza por ti.

Sin diálogos que bloqueen

Si AE muestra un diálogo modal (aviso de guardado, advertencia, etc.) no puede ejecutar scripts. Cierra cualquier diálogo abierto e inténtalo de nuevo.

Se requiere un proyecto activo

Muchas herramientas requieren un proyecto abierto. Si no hay ninguno abierto, crea uno nuevo en AE primero, o pídele a Claude que lo cree.

No se encuentra After Effects

Mensaje de error como "Could not find After Effects" o "AfterFX.exe not found".

Define AE_AFTERFX_PATH manualmente

Agrega la variable de entorno apuntando a tu ejecutable de AE. Consulta la página de Configuración para ver ejemplos.

Ejemplo

claude_desktop_config.json
"AE_AFTERFX_PATH": "C:\\Program Files\\Adobe\\Adobe After Effects 2025\\Support Files\\AfterFX.exe"

Licencia inválida o rechazada

Los logs del servidor o Claude reportan "invalid license key" o "license validation failed".

Copia y pega desde el panel

Obtén tu clave exacta desde synthetic.com.ar/dashboard/licenses — no la escribas a mano.

Verifica el formato

Formato UUID: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Sin comillas dentro del valor, sin espacios extra.

Verifica el límite de dispositivos

Si alcanzaste el límite de dispositivos de tu plan (2 por licencia), desactiva primero un dispositivo antiguo en el panel.

Tiempo de espera del script agotado

La llamada a la herramienta devuelve un error de tiempo de espera, especialmente en operaciones pesadas como renders de varias capas.

Sube el timeout de la llamada

Pídele a tu IA que pase un timeoutMs más alto (en milisegundos) en la llamada. El valor predeterminado es 120000 (2 minutos). Para scripts pesados, prueba 240000 o 300000.

Errores de expresión después de hacer bake

Después de llamar a bake_expression, la propiedad muestra errores o valores incorrectos.

Verifica la sintaxis de la expresión antes de hacer bake

Usa list_expression_errors para detectar errores en una propiedad antes de hacer bake. Hacer bake de una expresión rota producirá valores incorrectos.

Haz bake en el rango de tiempo correcto

La operación de bake muestrea la expresión en cada frame del área de trabajo de la composición. Asegúrate de que el área de trabajo esté en el rango que quieres antes de hacer bake.

Tienes deshacer disponible

Si el bake produjo malos resultados, usa de inmediato undo para restaurar la expresión.

Comprobar tu configuración

Ejecuta npx -y @synthetic-ai/ae-mcp --doctor en una terminal. Revisa Node, tu licencia, la instalación de After Effects y el panel, y te dice qué corregir antes de abrir un ticket.

terminal
npx -y @synthetic-ai/ae-mcp --doctor