SyntheticSynthetic/Docs
ProductosNovedades
Panel →

DaVinci Resolve MCP · Instalación

Instalación de DaVinci Resolve MCP

DaVinci Resolve MCP es un servidor que corre en tu computadora y que lanza tu cliente MCP (Claude Desktop, Cursor, Claude Code, Codex). Se instala con Synthetic Setup. Habla con DaVinci Resolve a través de un pequeño conector que cargas dentro de Resolve. Funciona en Windows. macOS está en beta: no se probó por completo y puede tener errores. La ventana de Synthetic, que se instala junto con el servidor en Windows, puede cargar el conector por ti con un botón (paso 5).

Requisitos

DaVinci Resolve21, versión gratuita
Node.js18 o superior
OSWindows 10/11 · macOS (beta: puede tener errores)
Ventana de SyntheticLa instala Synthetic Setup en Windows; macOS (beta): descárgala en el paso 5
Cliente MCPClaude Desktop, Cursor, Codex, o cualquier cliente MCP
LicenciaTu clave de licencia de DaVinci Resolve MCP (ver /dashboard/licenses)

1. Instálalo con Synthetic Setup

Descarga Synthetic Setup desde /dashboard/downloads y ejecútalo. Encuentra tus clientes MCP (Claude Desktop, Cursor, Claude Code, Codex) y agrega DaVinci Resolve MCP a cada uno con tu licencia ya cargada. Al terminar, muestra la línea que pegas en DaVinci Resolve en el paso 3.

¿Prefieres editar la configuración de tu cliente a mano? La guía de configuración del cliente MCP muestra la entrada exacta.

2. Reinicia tu cliente MCP

Cierra tu cliente MCP y vuelve a abrirlo: los servidores se cargan al iniciar. La primera vez, el servidor se descarga en unos segundos y, una vez comprobada tu licencia, crea el conector para DaVinci Resolve en tu computadora.

Synthetic Setup también se ocupa de Node.js: si tu computadora no lo tiene, lo agrega para tus clientes MCP.

3. Carga el conector dentro de DaVinci Resolve

Abre DaVinci Resolve con un proyecto. Ve a Workspace → Console, elige Lua arriba de la Consola y pega la línea de tu sistema, reemplazando YOUR_USER por tu nombre de usuario en esa computadora:

Windows

dofile([[C:\Users\YOUR_USER\.synthetic\davinci-resolve-mcp\bridge\synthetic_server.lua]])

macOS

dofile([[/Users/YOUR_USER/.synthetic/davinci-resolve-mcp/bridge/synthetic_server.lua]])

La Consola muestra que el conector está listo y Resolve sigue funcionando con normalidad. Esto se hace una vez por sesión de Resolve: si cierras y vuelves a abrir Resolve, pega la línea otra vez.

La primera vez que el servidor crea el conector, el registro de tu cliente MCP muestra esta misma línea con tu propia carpeta ya escrita, lista para copiar.

4. Pruébalo

Con Resolve abierto y el conector cargado, pídele algo simple a tu cliente MCP:

¿Qué proyecto está abierto en DaVinci Resolve y qué hay en la línea de tiempo actual?

Si te responde con tu proyecto y tu línea de tiempo, todo funciona. Después prueba algo más grande: agregar marcadores, aplicar un LUT, renderizar la línea de tiempo.

Importante: DaVinci Resolve tiene que estar abierto, con un proyecto y el conector cargado, cada vez que tu cliente MCP usa una herramienta. Si no, las herramientas responden que Resolve no está conectado.

5. La ventana de Synthetic

La ventana Synthetic DaVinci Resolve MCP muestra si Resolve está conectado y tiene un botón Conectar que abre la Consola de Resolve y carga el conector por ti. Necesita Node.js en la computadora (el mismo que usa tu cliente MCP). Si Conectar no lo logra, Conectar a mano muestra la línea para pegar. En Windows, Synthetic Setup la instala junto con el servidor: la encuentras en el menú Inicio como «Synthetic DaVinci Resolve MCP». También puedes descargarla desde /dashboard/downloads.

  • Windows: Synthetic Setup la instala por ti; si descargas el instalador a mano, ejecútalo. Todavía no está firmado, así que Windows puede mostrar un aviso de SmartScreen: haz clic en Más información y después en Ejecutar de todas formas.
  • macOS: descarga el .dmg que corresponde al chip de tu Mac, Apple Silicon (M1 o posterior) o Intel, y arrastra la app a Aplicaciones. Todavía no está firmada por Apple: la primera vez, haz clic derecho en la app y elige Abrir. Si macOS igual no la deja abrir, ve a Ajustes del Sistema → Privacidad y seguridad y haz clic en Abrir igualmente.

En una Mac, Conectar necesita el permiso de Accesibilidad para escribir la línea en la Consola de Resolve: Ajustes del Sistema → Privacidad y seguridad → Accesibilidad → activa «Synthetic DaVinci Resolve MCP» (macOS también puede pedirte que la dejes controlar System Events). Si prefieres no darlo, usa Conectar a mano: Workspace → Console, modo Lua, pega la línea del paso 3, una vez por sesión de Resolve.

En una Mac, esta ventana y su botón Conectar solo se probaron en máquinas de prueba, todavía no con DaVinci Resolve. Si Conectar no funciona, usa Conectar a mano y cuéntanos qué pasó.