Cómo usar KwaFlux con DeepSeek: conectar DeepSeek Harness (DSH) por MCP

Lo esencial

• DeepSeek Harness (DSH) se conecta a KwaFlux mediante una sola fila insert en un archivo cordis.patch.yml. KwaFlux te genera la fila.
• Ponla donde la lea el DSH que ejecutas: el parche general ~/.dsh/cordis.patch.yml se aplica a todos los perfiles; el archivo propio de un perfil, solo a ese perfil.
• DSH recarga en caliente los archivos de parche, así que las herramientas suelen aparecer sin reiniciar.
• Sube el tiempo de espera por llamada de las herramientas para que un trabajo de vídeo largo no se corte mientras DeepSeek espera a que termine.

El agente de DeepSeek puede manejar KwaFlux a través del servidor MCP local que se instala con la app. DeepSeek Harness (DSH) carga los servidores MCP como filas de plugin dentro de un archivo de configuración por capas llamado cordis.patch.yml. En KwaFlux, elige DeepSeek en Host MCP, copia la fila y añádela al final del archivo de parche que lee tu perfil de DSH.

En esta guía verás dónde va la fila, por qué importa el perfil, qué tiempo de espera conviene subir y qué pedir primero a DeepSeek.

Contenido

1. Cómo carga DSH los servidores MCP
2. Antes de empezar
3. Paso 1: Copia la fila desde KwaFlux
4. Paso 2: Elige el archivo de parche correcto
5. Paso 3: Añade la fila
6. Paso 4: Comprueba que se ha cargado
7. Tus primeras peticiones
8. Resolución de problemas
9. Preguntas frecuentes

Cómo carga DSH los servidores MCP

DeepSeek Harness compone su configuración a partir de capas de archivos de parche. Cada perfil tiene su propio cordis.patch.yml, y el archivo general $DSH_HOME/cordis.patch.yml contiene, en palabras de la referencia de la CLI, «preferencias locales de la máquina que comparten todos los perfiles, por lo que tiene prioridad sobre la capa de cada perfil».

Los servidores MCP son filas que usan el plugin cliente de MCP de DSH, @deepseek-ai/dsh-mcp-client. DSH no activa ninguno por defecto: la referencia explica que «cada comando de servidor es código ejecutable de confianza que queda fuera del sandbox del agente». Añadir KwaFlux es, por tanto, una decisión explícita de confiar en su servidor.

Antes de empezar

• KwaFlux 1.0.14 o posterior, abierto.
• Node.js 18 o superior, en el PATH. Compruébalo con node --version. 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.
• DeepSeek Harness instalado. Su documentación lo marca como Preview (versión preliminar), así que las rutas y los comandos pueden cambiar de una versión a otra.

Paso 1: Copia la fila desde KwaFlux

En KwaFlux, abre Ajustes › Agent (MCP), elige DeepSeek en Host MCP y haz clic en Copiar config. Para una instalación predeterminada en Windows, la fila es esta:

- insert:
    - id: mcp-kwaflux
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: kwaflux
        transport: stdio
        command: 'C:\Program Files\nodejs\node.exe'
        args: ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']

Nota: La ruta va entre comillas simples. En YAML, las cadenas entre comillas simples dejan las barras invertidas tal cual, así que una ruta de Windows no necesita escapes.

Paso 2: Elige el archivo de parche correcto

La indicación de KwaFlux nombra un solo archivo: «Inserta esta fila de plugin en ~/.dsh/profiles/web/cordis.patch.yml y reinicia la sesión DSH.» Es correcto si usas el perfil web de DSH, dsh web. Si usas otro, elige según este cuadro:

En Windows, ~ es C:\Users\<you>. Si has definido DSH_HOME, usa esa carpeta en lugar de ~/.dsh.

El motivo más habitual de que KwaFlux «no aparezca» en DSH es que la fila se añadió a un perfil que no estás ejecutando.

Paso 3: Añade la fila

1. Haz antes una copia de seguridad del archivo.
2. El archivo de parche es una lista YAML. Añade la fila de KwaFlux al final, con la misma sangría que los demás elementos de primer nivel - insert: o - replace:.
3. Si el archivo aún no existe, créalo solo con la fila de KwaFlux.
4. Si quieres, sube el tiempo de espera de las herramientas dentro de config::

- insert:
    - id: mcp-kwaflux
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: kwaflux
        transport: stdio
        command: 'C:\Program Files\nodejs\node.exe'
        args: ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
        toolCallTimeoutMs: 330000

Según una guía de configuración de terceros, el tiempo de espera por llamada predeterminado de DSH es de 60 segundos. La herramienta de espera de KwaFlux puede esperar hasta 300 segundos en una sola llamada, así que 330.000 milisegundos dejan margen. Si tu versión de DSH rechaza el campo, quítalo; DeepSeek puede volver a esperar después de un corte.

Paso 4: Comprueba que se ha cargado

DSH vigila los archivos de parche y aplica los cambios válidos con recarga en caliente, así que el servidor suele arrancar a los pocos segundos de guardar. Si no cambia nada, reinicia la sesión de DSH, como sugiere la indicación de KwaFlux.

Después, pregunta:

Usa las herramientas de KwaFlux para comprobar si KwaFlux se está ejecutando.

En DSH, las herramientas de KwaFlux se llaman mcp__kwaflux__<tool>, por ejemplo mcp__kwaflux__kwaflux_get_app_status. Si KwaFlux está cerrado, la herramienta devuelve un error que empieza por app_not_running.

Tus primeras peticiones

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

Copia la fila desde KwaFlux, ponla en el archivo de parche que lee el DSH que ejecutas de verdad y añade un tiempo de espera de herramientas más largo para los trabajos de vídeo. DSH la recarga al guardar. Después, mantén KwaFlux abierto y pide a DeepSeek que compruebe el estado de la app antes del primer trabajo real.

Maneje KwaFlux desde DeepSeek

KwaFlux incluye un servidor MCP local para DeepSeek Harness 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