Conecta EQVPS a tu cliente MCP (Claude Desktop, Cursor, Cline)

EQVPS expone un servidor Model Context Protocol (MCP) remoto, para que un agente de IA dentro de tu cliente MCP pueda alquilar y operar un VPS real sin que pulses por un panel. Esta guía muestra cómo conectarlo a Claude Desktop, Cursor o Cline en unos minutos.

A qué te estás conectando

Las herramientas de catálogo (como list_plans) son públicas. Todo lo que toca una cuenta o un servidor necesita un token Bearer.

Paso 1 — Consigue un token Bearer

No necesitas una contraseña ni un formulario de registro. Conecta el servidor (puedes conectar sin cabecera de auth primero), luego haz que tu agente llame a la herramienta register_account con un nombre y un correo:

// llamada de herramienta: register_account
{ "first_name": "Ada", "last_name": "Agent", "email": "ada@example.com" }
// → { "token": "<tu token Bearer>", "token_type": "Bearer", ... }

Almacena el token devuelto. Es una credencial bearer de larga duración — envíala como Authorization: Bearer <token> en cada llamada autenticada.

Paso 2 — Configura tu cliente

Claude Desktop

Claude Pro, Team y Enterprise pueden añadir un servidor MCP remoto directamente en Ajustes → Conectores (pega la URL del endpoint y la cabecera Authorization: Bearer). Para Claude Desktop con la configuración clásica stdio, haz de puente con el endpoint remoto usando mcp-remote — la ruta universal para cualquier cliente stdio. Edita claude_desktop_config.json:

{
  "mcpServers": {
    "eqvps": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.eqvps.com/mcp",
        "--header", "Authorization: Bearer YOUR_TOKEN"
      ]
    }
  }
}

Consejo: para acuñar el token en primer lugar, conecta una vez sin la línea --header, pide a Claude que llame a register_account, luego pega el token y reinicia.

Cursor

Cursor soporta servidores MCP remotos directamente. En .cursor/mcp.json (proyecto) o en tus ajustes MCP globales de Cursor:

{
  "mcpServers": {
    "eqvps": {
      "url": "https://mcp.eqvps.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Cline

En los ajustes MCP de Cline, añade un servidor remoto con la URL https://mcp.eqvps.com/mcp y una cabecera Authorization: Bearer YOUR_TOKEN. Cline habla Streamable HTTP de forma nativa, así que no hace falta puente.

Paso 3 — Úsalo

Una vez conectado, tu agente puede ejecutar las herramientas. Una primera sesión típica:

1. list_plans — ve planes, especificaciones y qué imágenes de SO puede arrancar cada uno (sin auth).
2. register_account — obtén tu token (sin auth).
3. topup_balance — financia un saldo prepago con cripto (devuelve una URL de pago).
4. order_vps — pide un plan con un os_id; añade una ssh_key para root basado en clave.
5. get_vps_status — consulta hasta que el servidor esté active; lee el host/puerto SSH.
6. power_vps, set_hostname, get_vps_metrics, reinstall_vps, cancel_service — opéralo.

El conjunto completo son 16 herramientas — consulta la referencia de herramientas MCP de EQVPS para cada herramienta, sus parámetros y ejemplos.

Pagar con cripto

EQVPS es cripto-nativo: pagas en USDC o USDT en Base, Ethereum o Polygon — sin necesidad de tarjeta. El patrón más limpio para agentes es un saldo prepago: llama a topup_balance una vez, paga la caja cripto devuelta, luego order_vps gasta del saldo automáticamente — el agente nunca vuelve a tocar un monedero. Si pagas de más (los mínimos de retirada de los exchanges suelen ser más altos que un pedido pequeño), el excedente se acredita a tu saldo, no se pierde.

¿Listo?

Apunta tu cliente MCP a https://mcp.eqvps.com/mcp, llama a register_account, y tu agente puede levantar su propio servidor en alrededor de un minuto. Consulta la referencia de herramientas a continuación, o la documentación para la API REST.