Cómo usar KwaFlux desde Codex: configuración de MCP, tiempos de espera y aprobaciones

Lo esencial

• Codex se conecta a KwaFlux con un solo comando codex mcp add o con una tabla [mcp_servers.kwaflux] en ~/.codex/config.toml. KwaFlux te genera las dos cosas.
• Codex concede por defecto 60 segundos a cada llamada a una herramienta MCP, y la herramienta de espera de KwaFlux puede esperar hasta 300. Sube tool_timeout_sec para que Codex no corte los trabajos de vídeo largos.
• El comando no añade el tiempo de espera de arranque de 20 segundos que sí incluye el TOML de KwaFlux. Añádelo si el servidor tarda en arrancar.
• Con los modos de aprobación de Codex, las herramientas de solo lectura de KwaFlux pueden ejecutarse sin más, mientras Codex sigue preguntándote antes de los trabajos que escriben archivos.

Codex, de OpenAI, puede manejar KwaFlux a través del servidor MCP local que se instala con la app. En los Ajustes de KwaFlux, elige Codex, copia el comando de instalación o la tabla TOML, añádelo a Codex y mantén KwaFlux abierto. Para trabajar con vídeo conviene cambiar dos ajustes: el tiempo de espera de las herramientas y el modo de aprobación.

En esta guía verá las dos formas de añadir KwaFlux a Codex, los tiempos de espera que cuentan en los trabajos largos, cómo controlar las aprobaciones y qué pedir primero.

Contenido

1. Cómo ejecuta Codex un servidor MCP
2. Antes de empezar
3. Método 1: codex mcp add
4. Método 2: Editar config.toml
5. Tiempos de espera para trabajos de vídeo largos
6. Aprobaciones y listas de herramientas
7. Tus primeras peticiones
8. Resolución de problemas
9. Preguntas frecuentes

Cómo ejecuta Codex un servidor MCP

Al empezar una sesión, Codex arranca cada servidor MCP local que figura en su configuración y se comunica con él por la entrada y la salida estándar. A partir de ahí, el modelo ve las herramientas del servidor junto a las propias de Codex. La CLI de Codex y la app de escritorio de Codex usan la misma configuración.

El servidor de KwaFlux es un script de Node.js que se instala con la app. No procesa nada por sí mismo: pasa las peticiones a la app de KwaFlux en ejecución, que las comprueba y ejecuta los trabajos.

Antes de empezar

• KwaFlux 1.0.14 o posterior, abierto.
• Node.js 18 o superior, en el PATH. Compruébalo con node --version y, si hace falta, instala la versión LTS actual desde nodejs.org. La tarjeta de Ajustes de KwaFlux también busca Node.js y escribe su ruta completa en la configuración, como en los ejemplos de abajo; si no lo encuentra, lo indica y escribe node en su lugar.
• En KwaFlux: Ajustes › Agent (MCP) y, en Host MCP, elige Codex.

Método 1: codex mcp add

Haz clic en Copiar comando de instalación y ejecútalo en un terminal. Para una instalación predeterminada en Windows, es este:

codex mcp add kwaflux -- "C:\Program Files\nodejs\node.exe" "C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs"

Lo ejecutamos con Codex CLI 0.118.0 y mostró Added global MCP server 'kwaflux'. Después, compruébalo:

codex mcp list

KwaFlux debería aparecer como activado. El comando escribe en ~/.codex/config.toml una tabla que solo lleva command y args. Más abajo verás las dos líneas que conviene añadir a mano.

Método 2: Editar config.toml

Si lo prefieres, haz clic en Copiar config y añade la tabla al final de ~/.codex/config.toml, o de .codex/config.toml en un proyecto de confianza:

[mcp_servers.kwaflux]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
startup_timeout_sec = 20

Como recuerda la indicación de KwaFlux: «La clave es mcp_servers (guion bajo).» Después, reinicia Codex o ejecuta /mcp en una sesión para ver el servidor.

Nota: La ruta va entre comillas simples a propósito. En TOML, las cadenas entre comillas simples son literales, así que no hace falta escapar las barras invertidas de Windows. Entre comillas dobles, tendrías que escribir \\ en lugar de cada una.

Tiempos de espera para trabajos de vídeo largos

La documentación de MCP de Codex recoge dos tiempos de espera por servidor:

El segundo es el que más importa. Cuando Codex pide a KwaFlux que espere a una exportación, la herramienta de espera queda bloqueada hasta que la tarea termina o llega a su propio límite, de hasta 300 segundos. Con los 60 segundos que Codex da por defecto, una espera más larga se corta desde el lado de Codex, y el modelo puede tomarla por un fallo. Configura lo siguiente:

[mcp_servers.kwaflux]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
startup_timeout_sec = 20
tool_timeout_sec = 330

En cualquier caso, la tarea sigue en marcha en KwaFlux. Agotar el tiempo de espera solo pone fin a esa espera concreta, y Codex puede volver a consultar la tarea.

Aprobaciones y listas de herramientas

Codex te deja elegir, servidor por servidor, cuándo pregunta antes de ejecutar una herramienta. Su documentación recoge los valores auto, prompt, writes y approve para default_tools_approval_mode, donde writes «pide confirmación para las herramientas que no están marcadas como de solo lectura». A KwaFlux le viene bien: las consultas de estado y de la lista de tareas pasan directamente, y los trabajos que escriben archivos siguen pidiendo aprobación.

También puedes limitar lo que carga Codex con enabled_tools, una lista de permitidas, o con disabled_tools, una lista de bloqueadas. Por ejemplo, si solo usas Codex para convertir y reparar, incluye únicamente las herramientas de tareas, conversión y reparación. Con menos herramientas también queda más espacio libre en el contexto del modelo, como explicamos en nuestro artículo sobre el diseño de herramientas.

Tus primeras peticiones

Comprueba si KwaFlux se está ejecutando y muéstrame mis tareas recientes de KwaFlux.

Después:

La interpolación de fotogramas y las herramientas de recorte y sustitución se quedan en la app; el asistente tiene instrucciones de remitirte allí para esas funciones. Las descargas por parte de agentes siguen desactivadas salvo que, en Autorización de agentes, pongas Permitir que los agentes inicien descargas en Preguntar cada vez. Entonces KwaFlux muestra una ventana emergente para cada descarga, y el asistente también te pide que confirmes en el chat que tienes derecho a descargar ese contenido.

Resolución de problemas

Para los problemas comunes a todos los hosts, consulta la guía de resolución de problemas de KwaFlux MCP.

Conclusión

Añade KwaFlux con el comando o el TOML que KwaFlux te copia y, después, añade dos líneas: un tiempo de espera de arranque de 20 segundos y otro de herramientas de 330 segundos. Elige el modo de aprobación writes si quieres que Codex te pregunte solo antes de los trabajos que crean archivos. Mantén KwaFlux abierto y empieza por una comprobación del estado.

Maneje KwaFlux desde Codex

KwaFlux incluye un servidor MCP local para Codex y otras apps MCP. El procesamiento de IA corre en tu propia GPU y tus archivos multimedia no se suben para procesarlos. Funciona en Windows 10 (64 bits, versión 1809 o posterior), Windows 11 y macOS 12 o posterior en Apple Silicon. Importar archivos y explorar la app no requieren cuenta. Iniciar sesión con un plan de pago solo hace falta para exportar, convertir, reparar un archivo o descargar un archivo desde un enlace.

Descargar KwaFlux · Ver planes