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.

After Effects debe estar abierto

El MCP no puede comunicarse con AE si no está en ejecución. Abre After Effects antes de llamar a cualquier herramienta.

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 (1 para el Mensual, 2 para el Anual), 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.

Aumenta AE_MCP_TIMEOUT

Define AE_MCP_TIMEOUT con un valor más alto en milisegundos. El valor predeterminado es 30000 (30 segundos). Para scripts complejos, prueba 60000 o 120000.

Ejemplo de configuración

claude_desktop_config.json

"env": {
  "AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "AE_MCP_TIMEOUT": "60000"
}

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.

Obtener logs de depuración

Define AE_MCP_LOG_LEVEL en debug en tu configuración para ver salida detallada del servidor MCP. Esto muestra exactamente qué scripts se envían a AE y qué respuestas regresan — útil para diagnosticar comportamientos inesperados.

claude_desktop_config.json

"env": {
  "AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "AE_MCP_LOG_LEVEL": "debug"
}

Preguntas frecuentes Referencia de herramientas