Cómo usar KwaFlux desde Claude Code y Claude Desktop (configuración de MCP)

Lo esencial

• Claude Code se conecta a KwaFlux con un solo comando claude mcp add que KwaFlux genera por ti; Claude Desktop, con una entrada en claude_desktop_config.json.
• En Claude Code, usa el ámbito de usuario (user) para que KwaFlux esté disponible en todos los proyectos, no solo en una carpeta.
• Después de editar la configuración de Claude Desktop, ciérralo del todo, también desde la bandeja del sistema, o no cargará el servidor.
• Los dos clientes preguntan antes de ejecutar herramientas MCP, y /mcp en Claude Code muestra si KwaFlux se ha conectado y cuántas herramientas ofrece.

Claude puede manejar KwaFlux en tu ordenador a través del servidor MCP local que se instala con la app. Para Claude Code, KwaFlux te da un comando claude mcp add ya preparado. Para Claude Desktop, te da una entrada JSON que debes combinar en claude_desktop_config.json. En los dos casos, mantén KwaFlux abierto mientras Claude trabaja.

En esta guía verás cómo conectar cada cliente de Claude, dónde guarda su configuración, cómo comprobar la conexión, qué pedir primero y cómo resolver los problemas habituales.

Contenido

1. ¿Claude Code o Claude Desktop?
2. Antes de empezar
3. Claude Code: un solo comando
4. Claude Code: compartirlo con un proyecto
5. Claude Desktop: editar la configuración
6. Tus primeras peticiones
7. Trabajos largos y tiempos de espera
8. Resolución de problemas
9. Preguntas frecuentes

¿Claude Code o Claude Desktop?

Claude Code es el agente de programación de Anthropic para el terminal y los IDE; Claude Desktop es la app de chat de Claude para Windows y macOS. Los dos pueden ejecutar servidores MCP locales y los dos pueden usar KwaFlux.

Si lo que quieres sobre todo es hablar con Claude de tus vídeos, Claude Desktop es el comienzo más sencillo. Si ya trabajas en un terminal o un IDE, Claude Code encaja ahí. Para los demás asistentes, consulta nuestra comparativa.

Antes de empezar

• KwaFlux 1.0.14 o posterior, abierto. El servidor MCP habla con la app en ejecución.
• Node.js 18 o superior, en el PATH. La tarjeta de Ajustes de KwaFlux lo dice así: «El host arranca el servidor con Node.js 18 o superior, así que Node debe estar instalado y en el PATH.» Si node --version falla, 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: abre Ajustes › Agent (MCP), elige Claude en Host MCP y después Claude Code o Claude Desktop.

Claude Code: un solo comando

1. Con Claude Code seleccionado, haz clic en Copiar comando de instalación.
2. Pégalo en un terminal y ejecútalo. Para una instalación predeterminada en Windows, es este:

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

3. Abre una sesión nueva de Claude Code y ejecuta /mcp. Deberías ver kwaflux conectado, con su número de herramientas.

Hay dos partes del comando que importan:

• **--scope user** guarda el servidor en ~/.claude.json para todos tus proyectos. Con el ámbito predeterminado de Claude Code, el local, KwaFlux solo aparecería en la carpeta donde ejecutaste el comando.
• **--** separa las opciones propias de Claude del comando que arranca el servidor. La documentación de Claude Code explica que «todo lo que va después de -- se pasa al servidor sin modificar».

Claude Code: compartirlo con un proyecto

La indicación de KwaFlux también ofrece un archivo de proyecto: «Añádelo al .mcp.json de la raíz del proyecto o ejecuta la CLI.» Un .mcp.json de proyecto sirve para compartir servidores, mediante el control de versiones, con todos los que trabajan en esa carpeta. Úsalo si un equipo guarda un proyecto de vídeo en un repositorio y todos tienen KwaFlux instalado en la misma ubicación.

Con Claude Code seleccionado, haz clic en Copiar config y guárdalo como .mcp.json en la raíz del proyecto:

{
  "mcpServers": {
    "kwaflux": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Program Files\\KwaFlux\\Tools\\kwaflux-mcp\\kwaflux_mcp.mjs"
      ]
    }
  }
}

En una sesión interactiva, Claude Code pide aprobación antes de usar los servidores del .mcp.json de un proyecto. Hasta que lo apruebes, /mcp muestra el servidor como pendiente.

Claude Desktop: editar la configuración

1. En KwaFlux, elige Claude › Claude Desktop y haz clic en Copiar config.
2. En Claude Desktop, abre Settings (ajustes) desde el menú de Claude, ve a Developer y haz clic en Edit Config. Así se abre, o se crea, este archivo: - Windows: %APPDATA%\Claude\claude_desktop_config.json - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Añade la entrada kwaflux dentro de mcpServers. No borres los servidores que ya haya.
4. Cierra Claude Desktop del todo, incluido el icono de la bandeja del sistema o de la barra de menús, y vuelve a abrirlo. La indicación de KwaFlux lo deja claro: «Cierra Claude Desktop por completo después de editar.»
5. En una conversación, abre el menú de la parte inferior izquierda del cuadro de texto, ve a Connectors y comprueba que kwaflux aparece con sus herramientas.

Claude Desktop te pide aprobación antes de ejecutar cada herramienta, salvo que permitas una herramienta durante la conversación.

Tus primeras peticiones

Empieza con una comprobación de solo lectura:

Usa las herramientas de KwaFlux para comprobar si KwaFlux está abierto y si he iniciado sesión.

Después prueba trabajos reales, con rutas locales completas:

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.

Consejo: En Claude Code, las herramientas de KwaFlux aparecen como mcp__kwaflux__<tool>, por ejemplo mcp__kwaflux__kwaflux_get_app_status. Usa esos nombres para permitir las herramientas de solo lectura en tus reglas de permisos, y así no te preguntará cada vez que Claude consulte la lista de tareas.

Trabajos largos y tiempos de espera

Los trabajos de vídeo pueden tardar minutos. La herramienta de espera de KwaFlux aguarda hasta 300 segundos por llamada, 60 por defecto, y después informa de si la tarea ha terminado. Si no ha terminado, Claude puede volver a esperar sin más.

Si en un equipo lento el propio servidor tarda en arrancar, la documentación de Claude Code describe la variable de entorno MCP_TIMEOUT para el arranque, por ejemplo MCP_TIMEOUT=10000 claude. Para las llamadas a herramientas, una entrada del .mcp.json de un proyecto admite un campo timeout en milisegundos. Ponlo por encima de 300.000 si pides esperas largas.

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

En Claude Code, ejecuta el comando que KwaFlux copia por ti, con ámbito de usuario, y comprueba /mcp. En Claude Desktop, añade la entrada a claude_desktop_config.json y cierra la app del todo antes de volver a abrirla. Después, mantén KwaFlux abierto y empieza por una comprobación de estado.

Maneje KwaFlux desde Claude

KwaFlux incluye un servidor MCP local para Claude Code, Claude Desktop 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