Manejar KwaFlux desde Codex, Claude, OpenClaw, DeepSeek, Hermes y Cursor
KwaFlux incluye un servidor MCP local. Deja la app abierta y conecta Codex, Claude, OpenClaw, DeepSeek, Hermes o Cursor. Convertir, reparar, mejorar y descargar requieren iniciar sesión y un plan de pago.
Qué es esto
Sí, un agente de IA puede manejar KwaFlux: la app de escritorio incluye un servidor MCP local al que pueden conectarse Codex, Claude, OpenClaw, DeepSeek (DSH), Hermes y Cursor. Abre Ajustes › Avanzado › Agent (MCP), copia la configuración en tu app de chat y deja KwaFlux en marcha. La conexión es stdio local en este equipo, sin paso de OAuth.

Dónde guarda la config cada host
| Host | Dónde |
|---|---|
| Codex | Añade a ~/.codex/config.toml. La clave es mcp_servers. Reinicia Codex o ejecuta /mcp. |
| Claude Code | El .mcp.json del proyecto, o el comando de instalación. Abre una sesión nueva después del cambio. |
| Claude Desktop | Combina en claude_desktop_config.json y luego sal de la app y de su proceso, no solo de la ventana. En Windows el archivo está en %APPDATA%\Claude\. |
| OpenClaw | Combina bajo mcp.servers en ~/.openclaw/openclaw.json, o ejecuta openclaw mcp set. |
| DeepSeek | Un YAML de perfil DSH. Reinicia la sesión DSH. |
| Hermes | Ejecuta hermes mcp add, o escribe mcp_servers en config.yaml (%LOCALAPPDATA%\hermes en Windows nativo, ~/.hermes en los demás). |
| Cursor | Usa la instalación integrada en la app y luego ejecuta Reload MCP en Cursor. |
Qué puede hacer el agente
Puede comprobar si la app está en marcha y con sesión iniciada, listar tareas y esperar a que una termine. También puede pausar, reanudar, cancelar o reintentar una tarea que él inició. Diagnostica un archivo dañado antes de repararlo.
- Convertir: exporta a 64 formatos con el nivel de calidad que elijas, con preajustes para YouTube, TikTok y otras plataformas, y convierte un tramo en un GIF. El archivo se guarda junto al archivo de entrada.
- Reparar: el diagnóstico puede ir primero.
- Mejorar: reparación de calidad, color, estabilización, desentrelazado, efectos inteligentes y belleza. El archivo se guarda junto al archivo de entrada.
- Descargar: consultar un enlace y luego guardarlo. Las descargas siguen desactivadas hasta que eliges Preguntar cada vez en Autorización de agentes. A partir de ahí, KwaFlux te pregunta en una ventana emergente antes de cada descarga.
- La interpolación de fotogramas se queda en la app de escritorio.
- El recorte y el reemplazo de fondo de personas, objetos y cielo se quedan en la app de escritorio.
- Hacer clic en un sujeto de un fotograma en pausa se queda en la app de escritorio.
- El agente no puede manejar una tarea que tú iniciaste en la ventana.
Las descargas siguen apagadas hasta que tú las actives
Abre Ajustes › General y busca Autorización de agentes. Permitir que los agentes inicien descargas tiene tres modos: desactivado, Preguntar cada vez y uno que deja pasar las descargas sin preguntar. Con Preguntar cada vez, KwaFlux muestra una ventana emergente en el escritorio con el enlace, la carpeta y el formato, y solo tu clic la aprueba. Si nadie responde, la ventana caduca a los 120 segundos. El asistente también te pide en el chat que confirmes que tienes derecho a guardar el archivo, pero lo que afirme él no cuenta. KwaFlux no inicia sesión en un sitio ni salta un muro de pago.
Límites
Las rutas deben ser absolutas y estar en este equipo. Convertir y mejorar no dejan que el agente elija la carpeta de salida. La app está en descarga.
Usarlo con un agente no requiere otra licencia: una sola licencia cubre la app y su servidor MCP en hasta 2 ordenadores, Windows y Mac en cualquier combinación. Las tareas que inicia un agente se ejecutan en ese ordenador, y los archivos multimedia no se suben para procesarlos.
Qué se queda en la ventana
El agente puede hacer los trabajos de la lista de arriba, y nada más. Puede comprobar si la app está en marcha y si has iniciado sesión. Puede listar tareas y esperar a que una termine. Puede pausar, reanudar, cancelar o reintentar una tarea que él mismo inició. Puede diagnosticar un archivo dañado antes de una reparación. No puede manejar una tarea que tú iniciaste desde la ventana de KwaFlux.
Convertir exporta a 64 formatos con el nivel de calidad que elijas y puede convertir un tramo en un GIF. Mejorar cubre reparación de calidad, color, estabilización, desentrelazado, efectos inteligentes y belleza. El archivo se guarda junto al archivo de entrada, y el agente no puede elegir otra carpeta. Las rutas que le das tienen que ser rutas absolutas en este equipo.
La interpolación de fotogramas, el recorte y el reemplazo de fondo, hacer clic en un sujeto en un fotograma en pausa y las vistas previas gratis de 1, 3 y 5 segundos se quedan en la app de escritorio. El agente no las ejecuta.
Las descargas siguen desactivadas hasta que las pones en Preguntar cada vez en Autorización de agentes. A partir de ahí, KwaFlux te pregunta en una ventana emergente antes de cada descarga. Una frase del asistente no cuenta como aprobación. KwaFlux no inicia sesión en un sitio por ti y no salta un muro de pago. La tabla de hosts de arriba indica dónde guarda cada app la configuración que copiaste desde Ajustes. No inventes una ruta. Deja KwaFlux abierto mientras la app de chat está conectada por stdio local.
Si no conecta o una tarea falla
Mira primero el lado de KwaFlux. Abre Ajustes › General. En Autorización de agentes, la línea bajo Permitir que los agentes de IA controlen KwaFlux muestra cada host conectado en ese momento. Si pone No hay agentes conectados, la app de chat no ha llegado a KwaFlux, así que el arreglo está en la app de chat.
- Ejecuta
node --versionen una terminal. El servidor necesita Node.js 18 o posterior. Con una versión más antigua se detiene al arrancar, y el registro del host lo dice tal cual. - Codex: escribe
/mcpen la interfaz de terminal para ver los servidores activos, o ejecutacodex mcp list. - Claude Code:
claude mcp listmuestra un estado junto a cada servidor, como Connected o Failed to connect. Un servidor definido en el .mcp.json de un proyecto espera tu aprobación la primera vez que ejecutasclaude. - Claude Desktop: los registros están en %APPDATA%\Claude\logs en Windows y en ~/Library/Logs/Claude en Mac. mcp.log recoge las conexiones y mcp-server-kwaflux.log guarda los mensajes del propio servidor.
- Cursor: abre el panel Output con Ctrl+Mayús+U (Cmd+Shift+U en Mac) y elige MCP Logs en el desplegable.
Cuando ya está conectado, una tarea fallida devuelve un código corto, y los asistentes suelen contarlo con otras palabras. Acciones recientes de agentes, en el mismo panel, lista cada llamada con su host y su resultado, así que puedes leer el código tú mismo.
| Código | Qué significa | Qué hacer |
|---|---|---|
app_not_running | KwaFlux no está abierto en este equipo. | Abre KwaFlux y después recarga MCP o reinicia la app de chat. |
agent_control_disabled | Permitir que los agentes de IA controlen KwaFlux está desactivado. | Vuelve a activarlo en Ajustes › General › Autorización de agentes. |
not_signed_in, entitlement_denied | La tarea necesita iniciar sesión y un plan de pago. | Inicia sesión en KwaFlux y revisa tu plan. |
app_busy | Se lanzaron demasiadas tareas en poco tiempo. | Espera un minuto y vuelve a pedirlo. |
input_not_local | La ruta empieza por dos barras, como \\server\share, o es una dirección web. | Copia el archivo a una carpeta local y pasa su ruta completa. |
model_not_installed | El modelo de IA de esa función aún no está en el equipo. | Abre la función en KwaFlux y descarga su modelo, o ve a Ajustes › Modelos y almacenamiento. |
agent_download_disabled | Las descargas por agentes siguen desactivadas. | Si las necesitas, elige Preguntar cada vez en Autorización de agentes. |
user_declined, approval_expired | Rechazaste la descarga, o nadie respondió a la ventana en 120 segundos. | Vuelve a pedirlo cuando estés delante del ordenador. |
Cada tarea que añade un agente muestra además un aviso corto con el nombre del host, por ejemplo «Codex añadió una tarea». La tarea aparece en el centro de tareas junto a las tuyas. Si crees que el token de acceso se ha filtrado, pulsa Restablecer el token de acceso de agentes al final de la línea de conexión. Las conexiones actuales se cortan y los hosts que configuraste se reconectan con el token nuevo en su siguiente llamada.
Prueba con tu propio material
Descarga KwaFlux y previsualiza gratis los efectos con tu propio material antes de pagar. No necesitas cuenta. Tus archivos se procesan en tu GPU y no se suben para procesarlos. Las vistas previas de vídeo duran 1, 3 o 5 segundos; las de estabilización, 5, 15 o 30 segundos.
Preguntas frecuentes
¿Puedo controlar KwaFlux desde Claude, Cursor u otro asistente de IA?
Sí. KwaFlux incluye un servidor MCP local que funciona por stdio, así que clientes como Codex, Claude y Cursor pueden controlarlo. Mantén KwaFlux abierto, copia la configuración de Ajustes → Avanzado → Agent (MCP) en la app de IA e instala Node.js 18 o posterior: la app de IA lo usa para iniciar el servidor.
¿Por qué no hay un botón Authenticate para KwaFlux?
Porque el servidor MCP de KwaFlux funciona en local por stdio, no en una URL remota. Por eso no hay paso de OAuth.
¿Puede el agente exportar o convertir gratis en KwaFlux?
No, KwaFlux exige iniciar sesión y un plan de pago para convertir, reparar, mejorar y descargar por MCP. Las vistas previas gratis de 1 s, 3 s y 5 s se quedan en la app de escritorio.
¿Puede el agente iniciar descargas en KwaFlux?
Sí, en cuanto pongas Permitir que los agentes inicien descargas en Preguntar cada vez. A partir de ahí, KwaFlux te pregunta en una ventana emergente antes de cada descarga, y el asistente no puede aprobarla por ti.
¿Por qué KwaFlux rechaza la ruta de mi archivo?
Las rutas tienen que ser rutas completas de este equipo, como C:\Videos\clip.mp4 o /Users/you/Movies/clip.mp4. Una ruta relativa falla. También una que empieza por dos barras, como \\server\share\clip.mp4. KwaFlux rechaza ese tipo de ruta antes de abrir nada, porque en Windows, solo con comprobar el archivo, el equipo puede intentar iniciar sesión en ese servidor. Copia antes el archivo a una carpeta local.
¿Cómo veo lo que ha hecho el agente en KwaFlux?
En KwaFlux, abre Ajustes › General › Autorización de agentes y mira Acciones recientes de agentes. Cada línea muestra la hora, el host, la llamada y el resultado. Las tareas que añadió el agente también están en el centro de tareas, y cada una llegó con un aviso que nombra al host.
¿Pueden los Cloud Agents de Cursor usar un servidor MCP local?
No. Un servidor stdio local es un programa de tu ordenador. Los Cloud Agents se ejecutan en la infraestructura de Cursor, así que no pueden arrancarlo. Usa el agente de la app de escritorio de Cursor en el mismo ordenador.
¿Por qué las rutas de Windows llevan barras invertidas dobles en mcp.json?
Porque JSON trata la barra invertida como el inicio de una secuencia de escape. C:\\Program Files es el JSON válido para C:\Program Files. Con una barra simple, el archivo no se puede analizar. Las barras normales también sirven.
¿Por qué Claude Desktop no ve un servidor MCP nuevo?
Normalmente porque sigue ejecutándose en segundo plano. Cierra la ventana, sal desde la bandeja del sistema o la barra de menús y vuelve a abrirlo. Lo siguiente que conviene revisar es si el JSON es válido. Por ejemplo, una barra invertida simple en una ruta de Windows lo invalida.
¿Claude Code en la web ve mi KwaFlux local?
No. El servidor de KwaFlux es un programa local que el host arranca en tu ordenador. Las sesiones en la nube cargan servidores remotos de un .mcp.json de proyecto, no el proceso Node junto a KwaFlux. Usa Claude Code o Claude Desktop en el mismo equipo donde está abierta la app.
¿Qué es tool_timeout_sec en Codex?
Es el tiempo que Codex espera a una llamada a una herramienta MCP antes de darla por perdida: 60 segundos por defecto. Súbelo en los servidores cuyas herramientas pueden tardar más en responder, como una herramienta que espera a que termine una exportación de vídeo. Consulta cómo se gestionan los trabajos largos.
¿Por qué se usan comillas simples para las rutas de Windows en config.toml?
Porque en TOML las cadenas entre comillas simples son literales: las barras invertidas se quedan tal cual. Entre comillas dobles, una barra invertida inicia una secuencia de escape, así que C:\Program Files tendría que escribirse C:\\Program Files.
¿Tengo que configurar MCP otra vez en la app de escritorio de ChatGPT?
No. La página MCP de OpenAI dice que la app de escritorio de ChatGPT, la CLI y la extensión de IDE comparten la config del host Codex. Añade KwaFlux una vez en ~/.codex/config.toml y abre Codex en cualquiera. ChatGPT en la web no lee ese archivo.
¿Dónde se añaden los servidores MCP en DeepSeek Harness?
En un archivo cordis.patch.yml, como una fila insert del plugin @deepseek-ai/dsh-mcp-client. Usa el archivo propio de un perfil para ese perfil, o el archivo general ~/.dsh/cordis.patch.yml para todos.
El archivo de parche es `[]`. ¿Pego KwaFlux debajo?
No, sustituye el [] por el bloque - insert: de KwaFlux. Un archivo con [] y otro elemento de lista no es YAML válido, y DSH sale con un error de análisis. Un parche de perfil nuevo suele empezar como esa lista vacía.
¿Puede un agente en un VPS usar un servidor MCP local de mi PC?
No, si es un servidor stdio. Un servidor stdio se ejecuta como proceso hijo del agente, en la misma máquina. Para usar uno que está en tu PC, ejecuta también allí el agente. En qué es un agente de IA verás cómo se conectan las piezas.
¿Por qué falla un servidor MCP con el error «node is not recognized» («node no se reconoce»)?
Porque Node.js no está instalado o no está en el PATH que ve el host. Instálalo y después cierra y vuelve a abrir el host. Si no se arregla, pon la ruta completa de node.exe en el command del servidor.
¿Por qué se agota el tiempo de espera en las llamadas largas a herramientas MCP?
Porque algunos hosts, como Codex y DeepSeek Harness, limitan por defecto cada llamada a una herramienta a 60 segundos. Y algunas herramientas de KwaFlux están pensadas para esperar más. Sube el tiempo de espera de herramientas del host para ese servidor. El trabajo en sí suele seguir en marcha.
El host dice `env: node: No such file or directory` en un Mac. ¿Qué hago?
Lo más probable es que abrieras el host desde el Dock o Spotlight, así que no recibe el PATH de Terminal y no ve el Node.js instalado con Homebrew o nvm. En Mac, el lanzador de KwaFlux ejecuta el node que haya en ese PATH. Ejecuta which node en Terminal. Luego pon en el env del servidor un PATH con esa carpeta más /usr/bin:/bin, por ejemplo /opt/homebrew/bin:/usr/bin:/bin. O arranca el host desde Terminal. Más sobre Mac: KwaFlux en Mac.
Fuentes
- Model Context Protocol: What is the Model Context Protocol (MCP)? (consultado el 2026-10-11)
- Model Context Protocol specification: Transports (stdio) (consultado el 2026-10-11)
- Node.js: Node.js releases (consultado el 2026-10-11)
- Model Context Protocol: Connect to local MCP servers (troubleshooting and Claude Desktop logs) (consultado el 2026-11-08)
- Claude Code docs: Connect Claude Code to tools via MCP (claude mcp list and server status) (consultado el 2026-11-08)
- OpenAI Codex docs: Model Context Protocol (codex mcp list and /mcp) (consultado el 2026-11-08)
Artículos relacionados
Conversión de formato
H.264, H.265 y AV1, procesados en local
AbrirConvertir formatos de vídeo en local (H.264, H.265, MP4, MOV) sin subir nada
Convierte en local los másteres terminados tras la mejora: qué códec y contenedor elegir y por qué un conversor integrado te ahorra una subida.
AbrirReparación de archivo
Vídeo, imagen y audio
AbrirDescarga de archivo
Un enlace pegado
Abrir

