Los 52 casos
Caso 123Preparación y análisis del material

Uso de FilmCraft con Codex

Prompt para conectar FilmCraft con Codex por MCP y dejar el entorno listo para editar vídeo con IA en futuras sesiones.

Hecho con GPChatGPT (Codex)

FilmCraft es un editor de vídeo no lineal de código abierto, escrito en Rust, pensado para que lo controlen agentes de IA. Trae su propio servidor MCP (filmcraft-cli mcp). Con este prompt le pides a Codex que deje ese servidor conectado a la aplicación abierta, comprobado y listo, antes de tocar ningún vídeo.


Para qué sirve

  • Que Codex pueda leer tu proyecto de FilmCraft y lanzar comandos sobre la aplicación que tienes abierta (modo bridge).

  • Dejar la configuración hecha una sola vez: CLI, puerto, registro del MCP y un lanzador para las próximas sesiones.

  • Evitar perder trabajo: el prompt obliga a confirmar que el proyecto está guardado antes de cerrar o reiniciar FilmCraft.

Requisitos

  • FilmCraft instalado (macOS, Windows o Linux).

  • ChatGPT con Codex instalado en el mismo ordenador.

  • filmcraft-cli: en Windows y Linux viene con el instalador; en macOS se descarga aparte desde las releases oficiales.

  • Un puerto local libre para el puente (la documentación usa el 9876).

Qué hice

Antes de editar con FilmCraft se pidió a Codex que preparase él mismo el entorno: detectar versiones, conseguir la CLI compatible, activar el puente de control local, registrar el MCP y crear un lanzador, sin tocar ningún vídeo.

Resultado esperado

MCP de FilmCraft registrado en Codex, puente comprobado contra la aplicación abierta y un lanzador listo para las próximas sesiones.

Lo que conviene saber

Que la configuración esté escrita no significa que funcione: hay que comprobar el puente con una prueba real. Y las herramientas MCP pueden no aparecer en el chat actual hasta reiniciar Codex o abrir uno nuevo.

Qué esperar al terminar

  • Las versiones de FilmCraft y de la CLI que ha usado.

  • Si el puente responde y el MCP «filmcraft» queda registrado en Codex.

  • Dónde está el lanzador y cómo usarlo.

  • Si tienes que reiniciar Codex o abrir un chat nuevo para ver las herramientas.

Pruébalo tú con ChatGPT (Codex) y FilmCraft

Tengo Codex y FilmCraft instalados. Configura y conecta el MCP de FilmCraft con Codex para dejar el entorno listo para futuras sesiones de edición.

Realiza tú las comprobaciones, descargas y configuraciones necesarias:

1. Detecta mi sistema operativo, la ubicación de FilmCraft y su versión.
2. Consulta la documentación oficial de FilmCraft:
   https://github.com/storytold/filmcraft/blob/main/docs/agents.md
3. Localiza filmcraft-cli y verifica su compatibilidad con la aplicación, preferiblemente usando la misma versión. Si falta o es incompatible, descarga el binario adecuado desde las releases oficiales de storytold/filmcraft. En macOS la CLI se descarga por separado. No compiles si existe un binario compatible.
4. Comprueba si la aplicación tiene activo el puente de control local. Configura el modo bridge para que Codex controle la aplicación visible.
5. Antes de cerrar o reiniciar FilmCraft, conserva el proyecto y sus cambios. Si no puedes confirmar que están guardados, detente antes de cerrar la aplicación y explícame qué falta.
6. Abre FilmCraft con el puente habilitado. La configuración documentada utiliza --control 9876 en la aplicación y filmcraft-cli mcp --bridge 127.0.0.1:9876 para el servidor. Comprueba las opciones de la versión instalada y utiliza un puerto libre, manteniéndolo coherente en ambos extremos.
7. Registra el MCP como filmcraft en la configuración de Codex, con la ruta absoluta real de la CLI. Respalda la configuración antes de modificarla, conserva los demás ajustes y evita entradas duplicadas.
8. Crea un lanzador adecuado a mi sistema para abrir FilmCraft con el puente activo en futuras sesiones. Si ya existe una instancia conectada, reutilízala.
9. Verifica el arranque del servidor, el listado de herramientas y la lectura del proyecto de la aplicación mediante el puente. No basta con comprobar que la configuración está escrita.

No realices ninguna edición de vídeo durante esta preparación.

Al terminar, indica brevemente:

- Las versiones de FilmCraft y de la CLI utilizadas.
- Si el puente responde y el MCP está registrado.
- Dónde está el lanzador y cómo usarlo.
- Si necesito reiniciar Codex o abrir un nuevo chat para cargar las herramientas.

Distingue entre una conexión comprobada mediante una prueba externa y las herramientas MCP realmente disponibles en este chat. Si necesitas que reinicie Codex, deja todo lo demás preparado antes de pedírmelo.

Pégalo tal cual en Codex, en el ordenador donde tienes FilmCraft. ¿Lo quieres funcionando en tu productora? Llamada de 15 min ↗ · Plan de implementación, 199 €/mes.

Documentación oficial

Preguntas frecuentes

¿Qué es el MCP de FilmCraft?

Es el servidor que arranca filmcraft-cli mcp. Expone herramientas para inspeccionar el proyecto y la secuencia, ejecutar comandos, importar medios y capturar fotogramas, de forma que un agente como Codex pueda trabajar dentro del editor.

¿Qué diferencia hay entre el modo headless y el modo bridge?

El modo headless trabaja con una sesión interna sin ventana. El modo bridge controla la aplicación de escritorio que tienes abierta, arrancada con filmcraft --control 9876 y conectada con filmcraft-cli mcp --bridge 127.0.0.1:9876. Este prompt configura el modo bridge.

¿Dónde está filmcraft-cli?

Según la documentación oficial, en Windows se instala por defecto en C:\Program Files\FilmCraft\filmcraft-cli.exe, en Linux en /usr/bin/filmcraft-cli y en macOS se descarga como un zip aparte en las releases.

¿El prompt edita mi vídeo?

No. Solo prepara la conexión y la verifica. La edición empieza en una sesión posterior.

¿Tengo que reiniciar Codex?

A veces sí: las herramientas MCP nuevas pueden no aparecer en el chat abierto. El prompt pide a Codex que deje todo preparado y te avise si hace falta reiniciar o abrir un chat nuevo.

Newsletter

Un caso por semana, los jueves

Te lo escribo yo. Qué he probado con ChatGPT y Resolve, qué ha funcionado y qué no. Te das de baja con un clic.

Revisa tu email para confirmar