Cómo usar KwaFlux desde Cursor: configuración de MCP, primeras peticiones y soluciones

Lo esencial

• El agente de Cursor puede manejar KwaFlux a través del servidor MCP local que viene con la app. Para configurarlo basta un botón en KwaFlux o una entrada en mcp.json.
• Mantén KwaFlux abierto y Node.js instalado. El servidor es un programa local de tu ordenador, así que los agentes en la nube de Cursor no pueden llegar a él.
• Por defecto, Cursor pregunta antes de ejecutar herramientas MCP. Aprueba primero las de solo lectura para comprobar la conexión.
• La mayoría de los fallos de configuración vienen de tres cosas: una ruta de Windows sin escapar en el JSON, editar el mcp.json equivocado y no recargar.

El agente de Cursor puede manejar KwaFlux en tu ordenador a través del servidor MCP local que se instala con la app. En KwaFlux, abre Ajustes › Agent (MCP), elige Cursor y haz clic en Instalar en Cursor, o pega una entrada en el mcp.json de Cursor. Después, pide al agente que diagnostique, repare, convierta o mejore un vídeo.

La configuración lleva unos cinco minutos. Cursor ejecuta el servidor y KwaFlux hace el procesamiento.

En esta guía verá las dos formas de añadir KwaFlux a Cursor, cómo comprobar la conexión, qué pedir primero y cómo resolver los problemas habituales.

Contenido

1. ¿Qué hace Cursor con un servidor MCP?
2. Antes de empezar
3. Método 1: Instalar desde KwaFlux con un solo botón
4. Método 2: Editar mcp.json a mano
5. Comprueba que está conectado
6. Tus primeras peticiones
7. Aprobaciones y ejecución automática
8. Resolución de problemas
9. Preguntas frecuentes

¿Qué hace Cursor con un servidor MCP?

Un servidor MCP le da herramientas adicionales al agente de Cursor. En el caso de un servidor local (stdio), Cursor arranca el programa en tu ordenador al cargarlo, y el agente llama a sus herramientas cuando una petición las necesita.

El servidor de KwaFlux es un script de Node.js que viene con la app. Sus herramientas comprueban el estado de la app, ponen en cola trabajos como la conversión, la reparación y la mejora, y esperan a que terminen. Para saber qué es un agente y cómo funciona este bucle, lee qué es un agente de IA.

Antes de empezar

Nota: En Mac, el fragmento de KwaFlux apunta a un programa auxiliar dentro de la app (<KwaFlux.app>/Contents/Helpers/kwaflux-mcp-run) en lugar de a la ruta de un script. Cópialo desde la app para que se rellene la ubicación real.

Método 1: Instalar desde KwaFlux con un solo botón

1. En KwaFlux, abre Ajustes y ve a Agent (MCP).
2. En Host MCP, elige Cursor.
3. Haz clic en Instalar en Cursor. KwaFlux copia la configuración y abre Cursor con un enlace de instalación.
4. Aprueba la instalación en Cursor.
5. Como indica KwaFlux: «Después de instalar, recarga MCP en Cursor.»

Al hacer clic, KwaFlux copia la configuración y muestra «Configuración copiada, abriendo Cursor: pégala manualmente si no se abre». Si Cursor no se abre, sigue el método 2: la configuración ya está en tu portapapeles.

El botón abre un enlace con esta forma, con la configuración codificada al final:

cursor://anysphere.cursor-deeplink/mcp/install?name=kwaflux&config=eyJjb21tYW5kIjoiQzpcXFByb2dyYW0gRmlsZXNcXG5vZGVqc1xcbm9kZS5leGUiLCJhcmdzIjpbIkM6XFxQcm9ncmFtIEZpbGVzXFxLd2FGbHV4XFxUb29sc1xca3dhZmx1eC1tY3BcXGt3YWZsdXhfbWNwLm1qcyJdfQ

Ese es el enlace para una instalación predeterminada en Windows. El tuyo puede ser distinto si instalaste KwaFlux en otra ubicación.

Método 2: Editar mcp.json a mano

Cursor lee los servidores MCP de dos archivos:

KwaFlux es una app de escritorio, no forma parte de un proyecto, así que usa el archivo global.

1. En KwaFlux, elige Cursor en Host MCP y haz clic en Copiar config.
2. Abre ~/.cursor/mcp.json, o créalo.
3. Si el archivo es nuevo, pega el fragmento entero. Si ya tiene servidores, añade solo la entrada kwaflux dentro del mcpServers existente.

Para una instalación predeterminada en Windows, el fragmento es:

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

4. Guarda y reinicia Cursor, o desactiva y vuelve a activar el servidor en Customize.

Consejo: Mantén las barras invertidas dobles. En JSON, una \ simple inicia una secuencia de escape, así que C:\Program Files invalida el archivo entero y Cursor descarta todos los servidores que contiene, no solo KwaFlux.

Comprueba que está conectado

1. Abre Customize en la barra lateral de Cursor y busca kwaflux. Debería estar activado y con sus herramientas en la lista.
2. En el chat del agente, pregunta:

¿Está abierto KwaFlux? Compruébalo con las herramientas de KwaFlux.

El agente llama a kwaflux_get_app_status. Si KwaFlux está abierto, la respuesta indica si has iniciado sesión. Si está cerrado, la herramienta devuelve un error que empieza por app_not_running. Abre KwaFlux y vuelve a preguntar.

3. Pide tu lista de tareas. Que salga vacía no es problema: significa que toda la cadena funciona.

Tus primeras peticiones

Indica rutas locales completas y di para qué quieres el resultado:

Cada tarea aparece en la lista de tareas de KwaFlux, así que puedes seguirla, pausarla o cancelarla desde ahí. Para los detalles de la conversión, consulta el Conversor.

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.

Aprobaciones y ejecución automática

Según la documentación de Cursor, este «pide aprobación antes de usar herramientas MCP de forma predeterminada», y las herramientas MCP siguen los mismos Run Modes que los comandos de terminal. Para KwaFlux es un punto de partida sensato:

• Las herramientas de solo lectura, como el estado de la app, la lista de tareas, los detalles de una tarea y la lista de formatos de exportación, se pueden añadir sin riesgo a la lista de permitidas.
• Las herramientas que ponen trabajos en cola escriben archivos nuevos junto al de origen. Sigue aprobándolas tú hasta que confíes en tus peticiones.

Resolución de problemas

Para los problemas que no son propios de Cursor, consulta la guía de resolución de problemas de KwaFlux MCP.

Conclusión

Haz clic en Instalar en Cursor o pega una entrada en ~/.cursor/mcp.json. Después recarga, mantén KwaFlux abierto y pide al agente que compruebe el estado de la app antes del primer trabajo real. A partir de ahí, las conversiones, reparaciones y mejoras pueden empezar desde el chat de Cursor y aparecer en la lista de tareas de KwaFlux.

Maneje KwaFlux desde Cursor

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