Kuvia
Crear cuenta

Casos de uso

Controlar equipos reales desde Claude Code, Cursor o Codex con Kuvia-MCP

Actualizado el · Equipo de Kuvia

Respuesta rápida

Kuvia-MCP es un servidor MCP (Model Context Protocol) que expone tus equipos de Kuvia a cualquier cliente compatible: Claude Code, Cursor, Codex, Antigravity o un JSON genérico. Creas una clave con permisos y caducidad, pegas el bloque que te da el panel y tu IDE puede listar equipos, abrir terminales persistentes, instalar sistemas del catálogo y seguir tareas, con control exclusivo del equipo y registro de auditoría.

Si ya trabajas con un agente de programación en tu IDE, Kuvia-MCP le da manos sobre máquinas reales: el portátil que estás reparando, el servidor de casa o un PC que acabas de arrancar con el USB. El endpoint usa transporte Streamable HTTP y se autentica con tu clave.

Si eres profesional

  • 30 herramientas MCP, entre ellas list_devices, select_device, inspect_device, open_shell, run_in_terminal, get_terminal_snapshot, install_from_catalog, autonomous_install_os, follow_task, power_device y call_device_tool.
  • Permisos por clave: devices:read y tasks:read (solo lectura) y tools:execute (control total: terminales, Wi-Fi, instalaciones). La caducidad de cada clave se elige al crearla.
  • claim_device_control reserva el equipo para tu sesión durante un tiempo y evita choques entre varios IDE; release_device_control lo libera.
  • get_device_audit y el panel de actividad registran cada acción con su nivel de riesgo y los secretos tachados.

Si no eres técnico

  • MCP es un estándar abierto para que un asistente de IA use herramientas externas. Kuvia es una de esas herramientas: tus ordenadores.
  • Empieza con una clave de solo lectura para ver tus equipos sin riesgo; crea otra con control total cuando lo necesites.
  • Las claves son como contraseñas: no las compartas ni las subas a un repositorio.
  • Todo lo que haga tu IDE queda registrado en la actividad de Kuvia-MCP.

Paso a paso

  1. Crea una clave en Kuvia-MCP

    En kuvia.dev, ve a Configuración y abre la pestaña Kuvia-MCP. Crea una clave, elige permisos (solo lectura o control total) y su caducidad, de 1 a 3650 días o sin caducidad. Guarda el secreto como guardarías una contraseña.

  2. Copia la configuración de tu cliente

    El panel muestra la URL del endpoint y un bloque listo para Claude Code (comando de terminal), Cursor y Codex (JSON con transporte streamable-http y cabeceras), Antigravity (serverUrl) o un JSON genérico de mcpServers.

  3. Comprueba la conexión

    Usa el comando de comprobación que da el propio panel o pide a tu IDE: lista mis dispositivos Kuvia. Debería responder con list_devices.

  4. Elige el equipo y reserva el control

    Pide trabajar en un equipo concreto. Para escribir, el cliente reclama el control exclusivo con claim_device_control.

  5. Trabaja con terminales persistentes

    open_shell abre una shell que puedes retomar más tarde con run_in_terminal o get_terminal_snapshot. Puedes tener varias en paralelo.

  6. Revisa la auditoría y libera

    Al terminar, libera el equipo con release_device_control y revisa la actividad en el panel de Kuvia-MCP.

Cómo ayuda Kuvia

Disponible hoy

Kuvia-MCP está completo: clientes compatibles, claves con permisos y caducidad, control exclusivo y auditoría.

  • Bloques de configuración para Claude Code, Cursor, Codex, Antigravity y JSON genérico.
  • Terminales persistentes en paralelo, instalación desde el catálogo y seguimiento de tareas.
  • Control exclusivo por sesión y registro de auditoría con secretos tachados.
  • Usado en casos reales: instalación de Windows 11 en un HP Pavilion y rescate remoto de un iMac.

Lo que todavía no hace

  • Sobre Windows y Mac con el kit, el juego de herramientas del equipo es más limitado que con el USB o Linux.
  • Los sistemas planificados del catálogo no se instalan de forma automática.

Preguntas frecuentes

¿Qué clientes MCP funcionan con Kuvia?

El panel trae configuraciones listas para Claude Code, Cursor, Codex y Antigravity, y un bloque JSON genérico para cualquier cliente que acepte servidores MCP remotos por HTTP.

¿Puedo dar acceso de solo lectura?

Sí. Crea una clave con los permisos de dispositivos y tareas en lectura y sin ejecución de herramientas. Podrá ver equipos y tareas, pero no ejecutar nada.

¿Qué pasa si dos personas usan el mismo equipo desde dos IDE?

Para escribir hace falta el control exclusivo del equipo. Mientras una sesión lo tiene, la otra puede leer pero no ejecutar acciones de escritura.

¿Queda registro de lo que hace la IA?

Sí. Cada acción MCP queda en la auditoría del dispositivo, con su nivel de riesgo y los secretos tachados.

Fuentes oficiales

Prueba Kuvia en tu propio equipo

Arranca el USB (o abre Kuvia.exe o Kuvia.app desde el pendrive si el equipo sí arranca), vincúlalo con un código de 6 dígitos y pide en el chat lo que necesitas. La IA te explica lo que va a hacer y te pide una confirmación clara antes de borrar o instalar en un disco.

Kuvia está en acceso anticipado y el lanzamiento público llega en las próximas semanas. Puedes crear tu cuenta gratis desde hoy.

Crear cuenta gratisVer planes