Conecte a EQVPS ao seu cliente MCP (Claude Desktop, Cursor, Cline)

A EQVPS expõe um servidor Model Context Protocol (MCP) remoto, para que um agente de IA dentro do seu cliente MCP possa alugar e operar um VPS de verdade sem você clicar por um painel. Este guia mostra como conectá-lo ao Claude Desktop, Cursor ou Cline em poucos minutos.

Ao que você está se conectando

Ferramentas de catálogo (como list_plans) são públicas. Tudo que toca uma conta ou um servidor precisa de um token Bearer.

Passo 1 — Obtenha um token Bearer

Você não precisa de senha nem de um formulário de cadastro. Conecte o servidor (você pode conectar sem header de autenticação primeiro), depois faça seu agente chamar a ferramenta register_account com um nome e um e-mail:

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

Guarde o token retornado. É uma credencial bearer de longa duração — envie-o como Authorization: Bearer <token> em toda chamada autenticada.

Passo 2 — Configure seu cliente

Claude Desktop

Claude Pro, Team e Enterprise podem adicionar um servidor MCP remoto diretamente em Settings → Connectors (cole a URL do endpoint e o header Authorization: Bearer). Para o Claude Desktop na configuração clássica stdio, faça a ponte do endpoint remoto com o mcp-remote — o caminho universal para qualquer cliente stdio. Edite claude_desktop_config.json:

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

Dica: para cunhar o token em primeiro lugar, conecte uma vez sem a linha --header, peça ao Claude para chamar register_account, depois cole o token e reinicie.

Cursor

O Cursor suporta servidores MCP remotos diretamente. Em .cursor/mcp.json (projeto) ou nas suas configurações globais de MCP do Cursor:

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

Cline

Nas configurações de MCP do Cline, adicione um servidor remoto com a URL https://mcp.eqvps.com/mcp e um header Authorization: Bearer YOUR_TOKEN. O Cline fala Streamable HTTP nativamente, então nenhuma ponte é necessária.

Passo 3 — Use

Uma vez conectado, seu agente pode rodar as ferramentas. Uma primeira sessão típica:

1. list_plans — veja planos, specs e quais imagens de SO cada um pode inicializar (sem autenticação).
2. register_account — obtenha seu token (sem autenticação).
3. topup_balance — abasteça um saldo pré-pago com cripto (devolve uma URL de checkout).
4. order_vps — peça um plano com um os_id; adicione uma ssh_key para root baseado em chave.
5. get_vps_status — consulte até o servidor estar active; leia host/porta SSH.
6. power_vps, set_hostname, get_vps_metrics, reinstall_vps, cancel_service — opere-o.

O conjunto completo são 16 ferramentas — veja a referência de ferramentas MCP da EQVPS para cada ferramenta, seus parâmetros e exemplos.

Pagando com cripto

A EQVPS é cripto-nativa: você paga em USDC ou USDT na Base, Ethereum ou Polygon — sem cartão. O padrão mais limpo para agentes é um saldo pré-pago: chame topup_balance uma vez, pague o checkout cripto retornado, depois order_vps gasta do saldo automaticamente — o agente nunca mais toca numa carteira. Se você pagar a mais (os mínimos de saque das exchanges costumam ser maiores que um pedido pequeno), o excedente é creditado no seu saldo, não perdido.

Pronto?

Aponte seu cliente MCP para https://mcp.eqvps.com/mcp, chame register_account, e seu agente pode levantar o próprio servidor em cerca de um minuto. Veja a referência de ferramentas a seguir, ou os Docs para a API REST.