Servidor MCP

El servidor MCP del Panel KVM conecta un asistente de IA con sus VPS. MCP (Model Context Protocol) es el estándar abierto que permite a los asistentes utilizar servicios externos: usted pide en lenguaje corriente la lista de sus servidores, su carga de la semana, un snapshot antes de una actualización o la apertura de un puerto, y el asistente realiza por usted las llamadas al Panel KVM.

El servidor está alojado por LWS en la dirección https://panelkvm.lwspanel.com/mcp/v1: no hay nada que instalar. Todo se configura en el Panel KVM, en la página API / MCP, pestaña Servidor MCP: allí elige el nivel de permisos del asistente y los VPS que puede gestionar, y puede cortar su acceso en cualquier momento. Cada una de sus acciones queda registrada.

Antes de empezar

• La cuenta principal. La página API / MCP está reservada al titular de la cuenta: las subcuentas no pueden conectar un asistente.
• Un asistente compatible con MCP «remoto»: Claude, ChatGPT, Claude Code, Cursor, VS Code, Gemini CLI, Codex CLI, Mistral, n8n o cualquier herramienta compatible con Streamable HTTP.
• Nada más. El MCP funciona de forma independiente de la API REST: no es necesario activar la API, crear una clave API ni declarar una dirección IP.

Activar el MCP

1. En el Panel KVM, abra la página API / MCP (menú de la izquierda) y después la pestaña Servidor MCP.
2. Active el interruptor. Un correo electrónico le confirma cada activación y cada desactivación.
3. Elija los servidores gestionables por el asistente: todos sus VPS, incluidos los que añada más adelante, o una selección. Por defecto, no gestiona ninguno.
4. Compruebe el nivel de permisos: por defecto, el asistente está en solo lectura (véase más abajo).

Conectar su asistente

Hay dos formas de hacerlo, según el asistente:

• Claude y ChatGPT se conectan mediante autorización (OAuth): basta con la dirección del servidor, no hay ningún token que copiar. Usted da su consentimiento en una página del Panel KVM.
• Los demás (Claude Code, Cursor, VS Code, n8n…) utilizan el token MCP, que usted genera en la pestaña Servidor MCP y que envían en el encabezado Authorization: Bearer. Su valor solo se muestra una vez: cópielo al generarlo. El panel muestra además, para cada herramienta, la configuración lista para copiar.

Los derechos son los mismos en ambos casos: el nivel de permisos y los servidores gestionables de su acceso MCP.

Claude (claude.ai, aplicación de escritorio o móvil)

1. En Claude, abra Configuración › Conectores y añada un conector personalizado.
2. Nombre: LWS Panel KVM. Dirección: https://panelkvm.lwspanel.com/mcp/v1. Mantenga la autenticación propuesta por defecto, sin encabezado que introducir.
3. Claude abre la página de autorización del Panel KVM: compruebe la información y haga clic en Autorizar. El conector también está disponible en la aplicación de escritorio y en el móvil.

ChatGPT

1. En chatgpt.com, añada un servidor MCP personalizado (menú de plugins o de conectores, según su versión). La opción depende de su suscripción y de la configuración de su espacio de trabajo.
2. Dirección del servidor: https://panelkvm.lwspanel.com/mcp/v1. Autenticación: OAuth.
3. Haga clic en Conectar: ChatGPT abre la página de autorización del Panel KVM, donde hace clic en Autorizar.

Si no ha iniciado sesión en el Panel KVM, la página de autorización le invita a pasar por su área de cliente LWS y a abrir el Panel KVM desde un VPS (Gestionar): vuelve automáticamente a la autorización, que sigue siendo válida durante 10 minutos. La página indica el dominio de la aplicación (claude.ai, chatgpt.com…): compruébelo antes de autorizar. Cada nueva autorización se le notifica por correo electrónico.

Claude Code

En un terminal, sustituyendo SU_TOKEN por el valor del token:

claude mcp add --transport http lwskvm https://panelkvm.lwspanel.com/mcp/v1 --header "Authorization: Bearer SU_TOKEN"

Cursor y otros editores

Añada este servidor al archivo de configuración MCP del editor (para Cursor: ~/.cursor/mcp.json) y reinícielo:

{
  "mcpServers": {
    "lwskvm": {
      "url": "https://panelkvm.lwspanel.com/mcp/v1",
      "headers": { "Authorization": "Bearer SU_TOKEN" }
    }
  }
}

VS Code, Gemini CLI y Codex CLI tienen cada uno su propio formato de archivo: el panel muestra el adecuado para cada uno.

n8n

1. Añada a su agente de IA la herramienta MCP Client Tool.
2. Endpoint: https://panelkvm.lwspanel.com/mcp/v1. Transport: HTTP Streamable.
3. Authentication: Bearer Auth, con el valor del token.

Elegir lo que puede hacer el asistente

Su acceso MCP tiene su propia configuración, independiente de la de la API:

• el nivel de permisos, entre tres (véase más abajo);
• los servidores gestionables: un VPS fuera de la lista es invisible para el asistente;
• las direcciones IP autorizadas, opcionales: deje la lista vacía para Claude y ChatGPT, que se conectan desde su propia infraestructura.

Empiece por solo lectura y amplíe solo si es necesario. Cualquier subida de nivel se le notifica por correo electrónico, y el paso al nivel Completo debe confirmarse mediante un código enviado por correo electrónico al titular de la cuenta. Volver a un nivel inferior no lo requiere.

Las herramientas de solo lectura no cambian nada. Las de explotación actúan sin destruir nada: arrancar o apagar un VPS, crear un snapshot o una copia de seguridad, gestionar las reglas del cortafuegos, el DNS inverso, las imágenes ISO y las claves SSH. Las herramientas del nivel Completo son irreversibles o exponen el servidor: volver a un snapshot, restaurar una copia de seguridad, desactivar el cortafuegos, modo rescate, contraseña root, reinstalación. Una herramienta por encima del nivel elegido ni siquiera se propone al asistente.

Mantener el control

• Confirmación antes de cualquier acción: el asistente anuncia lo que va a hacer y espera su consentimiento. Para una acción destructiva (reinstalación, contraseña root, eliminación de un snapshot…), debe copiar una frase exacta, por ejemplo rebuild 107596.
• Simulación antes de modificar el cortafuegos: reglas añadidas o retiradas, y un aviso si el acceso SSH corre el riesgo de cortarse, sin aplicar nada.
• Historial de llamadas: las 50 últimas llamadas de los 30 últimos días (hora, herramienta, origen, VPS, resultado, dirección IP), con filtros por acciones y errores. Las acciones aparecen también en el registro de actividad de su cuenta.
• Aplicaciones conectadas: cada asistente autorizado mediante OAuth figura en ellas con su dominio y su último uso. Revocar le retira el acceso de inmediato.
• En cualquier momento, puede regenerar el token (las herramientas que lo utilizan se desconectan) o cortar el acceso MCP con un interruptor.

Conviene saber

• Un asistente puede equivocarse: revise lo que propone antes de una reinstalación, una restauración o una modificación del cortafuegos.
• El número de llamadas está limitado por hora: 600 lecturas y 60 acciones por cuenta, y 3 acciones pesadas (reinstalación, restauración, vuelta a un snapshot, modo rescate) por VPS, con un máximo de 20 para la cuenta. Por encima de ese límite, se indica al asistente cuánto tiempo debe esperar. El estado y las métricas de un VPS se actualizan como mucho cada 15 segundos.
• Los textos que ha introducido en el panel (comentarios, descripciones…) se señalan al asistente como datos, nunca como instrucciones.
• Una autorización OAuth se renueva sola; tras 30 días sin uso, el asistente le pide que vuelva a autorizarlo.
• Lo que el MCP devuelve al asistente (lista de VPS, métricas…) se transmite a su proveedor, que lo trata según sus propias condiciones. El historial, en cambio, nunca conserva el contenido de sus solicitudes.
• LWS nunca le pedirá su token MCP.