DaVinci Resolve MCP · Solución de problemas
Problemas y límites
Los problemas más comunes y cómo resolverlos, y después los límites honestos del producto. Si el tuyo no está acá, abre un ticket de soporte.
Las herramientas dicen que DaVinci Resolve no está conectado
Síntoma: El cliente carga el servidor, pero las herramientas responden con un error de conexión.
Solución: Abre DaVinci Resolve con un proyecto y carga el conector: Workspace → Console, elige Lua y pega la línea de la guía de instalación. Hazlo de nuevo cada vez que reinicies Resolve.
La Consola muestra un error cuando pego la línea
Síntoma: La Consola de Resolve responde con un error en vez de decir que el conector está listo.
Solución: Comprueba que la Consola esté en modo Lua (no Py) y que reemplazaste el nombre de usuario por el tuyo. El archivo se crea la primera vez que tu cliente MCP inicia el servidor con una licencia válida: inicia el cliente antes de pegar la línea.
Resolve abre un aviso para pasarte a Studio y deja de responder
Síntoma: Una herramienta pidió una función que solo tiene DaVinci Resolve Studio. La versión gratuita abre su aviso para pasarte a Studio, que bloquea todas las ventanas de Resolve hasta que se cierra.
Solución: Cierra el aviso con su botón Not Yet: Resolve y las herramientas vuelven a funcionar. Pídele a tu cliente de IA que no use funciones exclusivas de Studio (mira los límites más abajo).
Error de licencia inválida
Síntoma: Las herramientas responden que falta la licencia o que no es válida, o los registros del cliente dicen que DAVINCI_RESOLVE_MCP_LICENSE no está definida.
Solución: La licencia de tu configuración no coincide con la de /dashboard/licenses. Vuelve a copiarla — revisa que no queden espacios al principio o al final cuando la pegaste en el JSON — y reinicia el cliente MCP.
Las herramientas dejaron de funcionar después de una actualización
Síntoma: El servidor se actualizó solo y ahora las herramientas fallan cuando hablan con Resolve.
Solución: Una actualización puede traer un conector nuevo. Pídele a tu cliente de IA que ejecute resolve_reload_server, o reinicia DaVinci Resolve y pega la línea otra vez.
En una Mac, Conectar pide un permiso o no conecta
Síntoma: La ventana Synthetic DaVinci Resolve MCP dice que macOS necesita tu permiso, o que no encontró el menú Workspace o la Console.
Solución: Activa «Synthetic DaVinci Resolve MCP» en Ajustes del Sistema → Privacidad y seguridad → Accesibilidad y vuelve a presionar Conectar. Si Resolve está en un idioma que no es el inglés, Conectar puede no encontrar el menú: usa Conectar a mano (Workspace → Console, modo Lua, pega la línea de la guía de instalación), que no depende del idioma.
La ventana dice que no encontró Node.js
Síntoma: La ventana Synthetic DaVinci Resolve MCP se abre con un mensaje sobre Node.js en lugar del estado de la conexión.
Solución: Instala Node.js (LTS) desde nodejs.org y vuelve a abrir la ventana. El servidor MCP también lo necesita.
Límites
Lo que DaVinci Resolve MCP no hace, o con lo que no se probó. Lo decimos acá para que lo sepas antes de comprar.
- Verificado en Windows con la versión gratuita de DaVinci Resolve 21.1.1. macOS está en beta: no se probó por completo y puede tener errores. Linux no está soportado.
- DaVinci Resolve Studio y Blackmagic Cloud no se probaron. Las funciones que solo tiene Studio (por ejemplo aislamiento de voz, Magic Mask, transcripción y clasificación de audio) abren el aviso para pasarte a Studio en la versión gratuita.
- Resolve tiene que estar abierto, con un proyecto, y el conector se carga una vez por sesión desde la Consola.
- Fusion: no se pueden crear macros dentro de una composición (instálalas como archivos con las herramientas de complementos), y una composición de Fusion no se puede renderizar sola: renderiza con la cola de procesamiento.
- Los plug-ins de Workflow Integration y de códecs no se pueden instalar con las herramientas de complementos.
- Resolve no tiene identificadores permanentes para los clips: las herramientas encuentran un clip por su pista y su posición, así que después de mover clips tu cliente de IA debería volver a leer la línea de tiempo.
- En una Mac, usa DaVinci Resolve descargado del sitio de Blackmagic Design: la versión de la Mac App Store corre en un entorno aislado (sandbox) que puede no dejar que el conector abra su conexión local.
Si nada de esto ayuda
Abre un ticket en tu panel de soporte con: (1) tu versión de DaVinci Resolve, (2) tu cliente MCP y su versión, (3) los registros del cliente cuando intenta lanzar el servidor, y (4) el fragmento de configuración que pegaste (sin la clave de licencia). También puedes preguntar en nuestro Discord.