Guía Definitiva: Edición de Vídeo con IA y DaVinci Resolve (Studio y Free)

Conectar agentes como Claude Code con DaVinci Resolve fracasa cuando intentas usar un único martillo para todo.

Los dos errores que más tiempo y tokens queman hoy son:

Usar un LLM para tareas deterministas: Pedirle a Claude que recorte silencios clip por clip mediante la API en vivo es lento, caro y propenso a fallos.
Instalar solo paquetes de "Skills" (archivos Markdown) sin un motor debajo: Si solo le das instrucciones en texto, el agente intentará programar scripts desde cero contra fusionscript (la API de Resolve), que falla silenciosamente en operaciones complejas.

Para editar a velocidad de producción, la arquitectura real se divide en cuatro capas: limpieza determinista, montaje estructural por XML, control en vivo vía MCP y criterio editorial (Skills).

1. Mapa Rápido: ¿Qué herramienta necesitas según tu caso?

Qué quieres resolver	Herramienta recomendada	Tipo	¿Exige Resolve Studio ($295)?
Cortar silencios y tiempos muertos en segundos (0 tokens)	Auto-Editor	CLI determinista	No (Exporta timeline para Free y Studio)
*Primer montaje (rough cut) por guion desde Claude Code*	ButterCut	Agente XML / FCPXML	No (Se importa como XML en Free y Studio)*
Buscar fragmentos en horas de bruto y armar historias en local	StoryToolkitAI	App + Whisper + LLM Local	No para exportar EDL/XML (Sí para enlace en vivo)
Empezar en Studio 21.1+ sin instalar nada externo	ResolveMCP Oficial	MCP nativo (~14 tools)	Sí (Integrado en `File > Setup AI Assistants`)
Control total y estable en vivo desde Claude Code	DaVinci Resolve MCP	Servidor MCP (~4k ⭐) + Skills	Sí en v21.1+ (En Free solo hasta v21.0.x)
Criterio editorial para diálogo, Fairlight y cortes	Alex's Skills + ChaiWithJai	Skills + Scripts Python	Depende del motor MCP que uses debajo
Editar desde un panel visual dentro de Resolve (sin consola)	Claude Cut	Plugin GUI nativo	No, pero el plugin es Freemium ($7.99/mes Pro+)
Conectar Claude en vivo usando DaVinci Resolve FREE 21.1+	Resolve MCP Free	Servidor MCP + Puente Lua	No (Usa Lua + FCPXML para esquivar el bloqueo Python)

*Nota sobre licencias: Salvo Claude Cut (comercial) y ButterCut (licencia PolyForm Shield: gratis para crear vídeos comerciales propios o de clientes, pero prohíbe revender el software en un SaaS), el resto de herramientas de la tabla son Open Source (MIT / GPL-3.0 / Unlicense).

2. La Arquitectura en 4 Capas (Cómo combinarlas)

Capa 1: Limpieza determinista (Sin LLM, Cero Tokens)

Antes de abrir Claude Code, limpia los silencios y tiempos muertos con matemáticas puras.

Auto-Editor (Unlicense): Analiza el umbral de volumen y el movimiento visual por línea de comandos y escupe un timeline listo para DaVinci Resolve en segundos, sin recodificar el archivo original. Además, el repositorio incluye sus propias skills instalables para que tu agente sepa invocarlo.
```
auto-editor grabacion.mp4 --margin 0.3s,0.5s --export resolve
```
Alcance real: Es imbatible quitando silencios con márgenes exactos (ej. dejar 0.3s antes y 0.5s después de hablar), pero no entiende qué estás diciendo. Úsalo como filtro inicial antes de pasar a la selección narrativa.

Capa 2: Selección narrativa y Rough Cut vía XML (Sin pelear con la API)

La API en vivo de DaVinci Resolve es rígida al mover decenas de clips simultáneamente. Para armar la estructura de un talking head, entrevista o vlog, es mucho más rápido que la IA genere un archivo XML / FCPXML fuera de Resolve e importarlo.

ButterCut (+600 ⭐ | PolyForm Shield): Agente para Claude Code escrito en Ruby. Analiza el vídeo y su transcripción, descarta tomas falsas, ordena la narrativa y genera un XML limpio. Lo importas en DaVinci y tienes el montaje base al instante.
StoryToolkitAI (GPL-3.0): La mejor opción si trabajas con horas de entrevistas, clases o brutos largos y buscas privacidad 100% local. Transcribe con Whisper en tu máquina, indexa el metraje para hacer búsquedas semánticamente y se conecta con Ollama, LM Studio o vLLM para armar guiones y exportarlos en EDL/XML (o enviarlos en vivo a Resolve Studio).
Para desarrolladores de producto (OpenTimelineIO): Si estás programando tu propia herramienta interna de edición, no generes cadenas XML a mano desde un prompt. Usa OpenTimelineIO (Apache 2.0) en Python como capa intermedia estándar para estructurar cortes y exportarlos a cualquier editor.

Capa 3: Control en vivo sobre DaVinci Resolve Studio (Servidores MCP)

Cuando ya tienes el montaje base y quieres que Claude opere en directo sobre el proyecto abierto (aplicar keyframes, escalar encuadres, organizar el Media Pool, tocar nodos de color o lanzar colas de render):

1. Punto de partida oficial: MCP Nativo de Blackmagic (Resolve Studio 21.1+)

Cómo se activa: Dentro de DaVinci Resolve Studio 21.1, ve a File > Setup AI Assistants. Cero instalaciones externas.
Alcance y límites: Expone unas 14 herramientas base y ejecuta la mayor parte del trabajo pesado a través de run_script (lanzando Python contra la API). Es perfecto para automatizaciones rápidas y oficiales, pero se queda corto en flujos complejos donde los servidores comunitarios ya traen funciones preconstruidas y validaciones de seguridad. (Si quieres exprimir el MCP nativo con flujos de interfaz, revisa el repo experimental codex-skill-davinci-resolve-edit).

2. El estándar de producción: DaVinci Resolve MCP de Samuel Gursky (~4.000 ⭐ | MIT)

Es el servidor MCP más maduro y probado por la comunidad. Destaca porque divide su arquitectura en tres modos según lo que necesites:

Modo Compuesto (37 herramientas — Recomendado): Agrupa operaciones complejas en llamadas únicas con protecciones integradas (por ejemplo, evita que un comando de color sobrescriba tu grade anterior sin posibilidad de recuperación). Consume muy pocos tokens por turno.
Modo Granular (390 herramientas): Expone casi toda la API para ajustes quirúrgicos.
Modo Avanzado Offline (davinci-resolve-advanced-mcp): 18 herramientas que leen y modifican archivos nativos de DaVinci (.drp, .drt, .drx) directamente en disco sin necesidad de tener DaVinci Resolve abierto. Ideal para procesar plantillas o auditar proyectos en lote (hazlo siempre sobre copias del archivo).

3. Alternativa de cobertura extrema: Lordhoell Resolve MCP

Envuelve más de 440 funciones de la API (incluyendo partes profundas de Fusion y Fairlight). Tiene mucha menor adopción comunitaria (~25 estrellas) que el de Gursky. Úsalo solo si necesitas un endpoint específico de Fusion que no esté en otros MCPs, y asegúrate de tener activa la búsqueda diferida de herramientas (Tool Search) en Claude Code para no penalizar el contexto.

Capa 4: El Criterio Editorial (Skills para Claude Code)

Un MCP le da "manos" al agente; las Skills le enseñan a editar con criterio humano y a no tropezar con los bugs silenciosos de DaVinci.

Recetas integradas de Samuel Gursky (MIT): Su propio repositorio ya incluye documentación editorial y skills listas para usar con su servidor MCP. Empieza por ahí.
Alex's DaVinci Editing Skills (MIT): 4 flujos profesionales muy estrictos: limpieza de diálogo en Fairlight, first cut, crossfades de audio y reencuadre. Su mayor virtud es que obliga al agente a auditar las formas de onda antes de dar un corte por bueno.
ChaiWithJai Claude Skills (MIT): Destila la documentación oficial de DaVinci Resolve en contexto accionable e incluye scripts en Python ya hechos para recorte de silencios y colas de render. Muy enfocado a tutoriales, screen recordings y talking heads.
El caso de Video Editor Skills de Apparicio Junior (CC BY-NC 4.0):
- Qué es realmente: Un paquete reciente (octubre de 2026) con 12 skills en Markdown (ritmo de vlog, B-roll, subtítulos, música, integración con Remotion y una guía muy detallada de fallos de la API llamada resolve-scripting).
- Qué debes tener claro: No incluye código ejecutable ni un servidor MCP; su flujo consiste en que Claude programe y mantenga los scripts de Python en tu carpeta local durante la configuración inicial. Además, su licencia es CC BY-NC 4.0 (Prohibido el uso comercial). Si editas vídeos para clientes, empresa o canales monetizados, no copies sus archivos a tu flujo sin permiso expreso del autor; utiliza los repositorios MIT anteriores.

3. Vía Rápida sin Terminal (Plugins GUI dentro de Resolve)

Si prefieres no mantener servidores MCP ni usar la consola para limpiar un vídeo rápido:

Claude Cut / Suite DavinciClaude (Freemium / $7.99 USD al mes en Pro+): Se instala como un panel nativo dentro de DaVinci Resolve. Permite cortar por transcripción y pedir ajustes en lenguaje natural en un par de minutos.
- Letra pequeña importante: Revisa qué incluye exactamente el plan Pro+, ya que en su ecosistema ciertas utilidades (como corte de silencios dedicado o multicámara) pueden ofrecerse como módulos separados. Ten en cuenta también la privacidad: envía transcripciones y prompts a la nube (Anthropic/Google), a diferencia de StoryToolkitAI o Auto-Editor.
Clautter (GPL-3.0, Beta): Plugin abierto en fase beta para acelerar la edición de talking heads. Úsalo en entornos de prueba hasta verificar su estabilidad con tu versión exacta de Resolve.

4. Guía de Supervivencia para DaVinci Resolve FREE (Versión 21.1 vs 21.0.x)

Si usas la versión gratuita de DaVinci Resolve, cuidado con seguir tutoriales desactualizados:

Qué cambió exactamente en DaVinci Resolve 21.1

El External Scripting (conectar un programa externo a DaVinci) siempre ha sido exclusivo de la versión Studio ($295). Sin embargo, hasta la versión 21.0.x, la comunidad conectaba DaVinci Free ejecutando un script puente en Python desde dentro del menú superior del programa (Workspace > Scripts).

A partir de DaVinci Resolve 21.1, Blackmagic bloqueó la ejecución de scripts Python en la versión gratuita para evitar que se desbloquearan funciones de Studio, dejando activo únicamente el intérprete Lua. Por tanto, puentes clásicos en Python dejan de aparecer en el menú de Resolve Free 21.1.

Tus 3 opciones reales hoy en DaVinci Resolve Free:

Si estás en Resolve Free 21.1+ y quieres MCP en vivo: Usa Resolve MCP Free (emircbngl). Está diseñado específicamente para el bloqueo de la 21.1: utiliza un puente en Lua (que sí sigue funcionando en Free), combinado con generación de FCPXML y automatización de interfaz en macOS.
El flujo híbrido o externo (Cero fricción con licencias):
- Usa Auto-Editor + ButterCut (o StoryToolkitAI) para generar el montaje fuera de DaVinci en formato XML/FCPXML e impórtalo manualmente (File > Import > Timeline).
- O utiliza Unofficial DaVinci MCP, que ofrece una vía dual: control en vivo si detecta Studio, y generación de FCPXML, EDL, LUTs y marcadores listos para importar si estás en Free.
Si dependes de puentes Python internos (Samuel Gursky o HiteshK03): Quédate en DaVinci Resolve Free 21.0.x (no actualices a la 21.1). En la 21.0.x, el puente interno de Gursky y el CursorBridge.py de HiteshK03 (que además añade Whisper local para suplir herramientas de Studio) siguen funcionando desde el menú de scripts.

5. Reglas de Seguridad antes de meter IA en un proyecto real

Ctrl+Z no te salvará siempre: En la API de DaVinci Resolve, varias operaciones ejecutadas por código (como aplicar o copiar ciertos grades de color o alterar propiedades en el Media Pool) modifican la base de datos del proyecto sin generar un paso limpio en el historial de Deshacer.
Regla obligatoria en tu CLAUDE.md: Añade esta instrucción fija para tu agente:

"Antes de ejecutar cualquier modificación mediante MCP sobre una línea de tiempo activa, duplica siempre el timeline actual añadiendo el sufijo _ai_backup y trabaja únicamente sobre la copia."
Un solo servidor MCP activo: No actives simultáneamente el MCP nativo, el de Gursky y el de Lordhoell en tu configuración de Claude Code. Mantén encendido solo uno (idealmente el modo compuesto de samuelgursky) para evitar colisiones de nombres de herramientas y respuestas redundantes.

Guía edición de Vídeos con IA en Davinci Resolve