Servidor MCP

Conecta un agente de IA a tu infraestructura de CubePath mediante el Model Context Protocol (MCP). El servidor lo alojamos nosotros, así que no hay nada que instalar ni ejecutar en local: apunta tu cliente MCP al endpoint y autentícate con un token de API.

https://api.cubepath.com/mcp

Conectar un cliente

El servidor habla JSON-RPC 2.0 sobre HTTP streamable (un POST por mensaje), así que sirve cualquier cliente MCP con soporte de transporte HTTP. La mayoría admite una configuración como esta:

{
  "mcpServers": {
    "cubepath": {
      "url": "https://api.cubepath.com/mcp",
      "headers": {
        "X-API-Key": "TU_TOKEN_DE_API"
      }
    }
  }
}

Authorization: Bearer TU_TOKEN_DE_API también funciona. Crea el token desde Organization → Tokens, tal y como se explica en API.

Nota

El endpoint solo acepta tokens de API. Las cookies de sesión se rechazan a propósito, para que ningún navegador con sesión iniciada pueda manejarlo.

Qué puede hacer tu agente

150 herramientas cubren la superficie pública de la API, agrupadas por producto:

Cómputo — VPS, baremetal, Kubernetes, grupos de disponibilidad.
Red — balanceadores de carga, DNS, IPs flotantes, NAT gateways, redes privadas, túneles, firewalls.
Entrega y datos — CDN, bases de datos gestionadas, transcoder.
Plataforma — proyectos, claves SSH, alertas, estado, DDoS.

Las herramientas se llaman como lo que hacen: cubepath_vps_create, cubepath_k8s_cluster_list, cubepath_dns_record_create.

Los scopes deciden qué ve el agente

tools/list devuelve solo las herramientas que permiten los scopes de tu token, de modo que un token de solo lectura expone únicamente herramientas de lectura. Dale a cada agente un token con los scopes mínimos que necesite.

Cada herramienta está anotada como de solo lectura o destructiva, lo que permite que tu cliente te pida confirmación antes de ejecutar algo como cubepath_vps_destroy.

Operaciones largas

Desplegar un VPS o destruir un clúster se encola y la herramienta responde al instante. Consulta el estado del recurso para seguir el progreso en lugar de volver a llamar a la herramienta: una segunda llamada encola una segunda operación.

Límites

120 peticiones por minuto por dirección IP en el endpoint MCP.
Cuerpo de petición de hasta 256 KB y lotes de hasta 20 mensajes.
Los resultados de las herramientas se limitan a unos 15 KB. Los listados largos se recortan y la herramienta indica qué ha dejado fuera, de forma que una sola respuesta no pueda llenar el contexto del modelo.
GET devuelve 405. El servidor no tiene estado: ni SSE, ni sesiones.

On this page