Connetti EQVPS al tuo client MCP (Claude Desktop, Cursor, Cline)

EQVPS espone un server Model Context Protocol (MCP) remoto, così un agente IA dentro il tuo client MCP può noleggiare e gestire un VPS reale senza che tu clicchi attraverso una dashboard. Questa guida mostra come collegarlo a Claude Desktop, Cursor o Cline in pochi minuti.

A cosa ti stai connettendo

Gli strumenti del catalogo (come list_plans) sono pubblici. Tutto ciò che tocca un account o un server richiede un token Bearer.

Passo 1 — Ottieni un token Bearer

Non ti serve una password né un modulo di registrazione. Connetti il server (puoi connetterti prima senza header di auth), poi fai chiamare al tuo agente lo strumento register_account con un nome e un'email:

// tool call: register_account
{ "first_name": "Ada", "last_name": "Agent", "email": "ada@example.com" }
// → { "token": "<your Bearer token>", "token_type": "Bearer", ... }

Conserva il token restituito. È una credenziale bearer a lunga durata — invialo come Authorization: Bearer <token> su ogni chiamata autenticata.

Passo 2 — Configura il tuo client

Claude Desktop

Claude Pro, Team ed Enterprise possono aggiungere un server MCP remoto direttamente sotto Settings → Connectors (incolla l'URL dell'endpoint e l'header Authorization: Bearer). Per Claude Desktop nel classico setup stdio, fai da ponte all'endpoint remoto con mcp-remote — il percorso universale per qualsiasi client stdio. Modifica claude_desktop_config.json:

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

Consiglio: per generare il token la prima volta, connettiti una volta senza la riga --header, chiedi a Claude di chiamare register_account, poi incolla il token e riavvia.

Cursor

Cursor supporta i server MCP remoti direttamente. In .cursor/mcp.json (progetto) o nelle tue impostazioni MCP globali di Cursor:

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

Cline

Nelle impostazioni MCP di Cline, aggiungi un server remoto con l'URL https://mcp.eqvps.com/mcp e un header Authorization: Bearer YOUR_TOKEN. Cline parla Streamable HTTP nativamente, quindi non serve alcun bridge.

Passo 3 — Usalo

Una volta connesso, il tuo agente può eseguire gli strumenti. Una tipica prima sessione:

1. list_plans — vedi piani, specifiche e quali immagini OS ciascuno può avviare (senza auth).
2. register_account — ottieni il tuo token (senza auth).
3. topup_balance — finanzia un saldo prepagato in crypto (restituisce un URL di checkout).
4. order_vps — ordina un piano con un os_id; aggiungi una ssh_key per il root basato su chiave.
5. get_vps_status — fai polling finché il server è active; leggi host/porta SSH.
6. power_vps, set_hostname, get_vps_metrics, reinstall_vps, cancel_service — gestiscilo.

L'insieme completo è di 16 strumenti — vedi il riferimento degli strumenti MCP di EQVPS per ogni strumento, i suoi parametri ed esempi.

Pagare in crypto

EQVPS è crypto-native: paghi in USDC o USDT su Base, Ethereum o Tron — nessuna carta richiesta. Lo schema più pulito per gli agenti è un saldo prepagato: chiama topup_balance una volta, paga il checkout in crypto restituito, poi order_vps spende dal saldo automaticamente — l'agente non tocca mai più un wallet. Se paghi in eccesso (i minimi di prelievo degli exchange sono spesso più alti di un piccolo ordine), l'eccedenza viene accreditata sul tuo saldo, non persa.

Pronto?

Punta il tuo client MCP a https://mcp.eqvps.com/mcp, chiama register_account, e il tuo agente può creare il proprio server in circa un minuto. Vedi poi il riferimento degli strumenti, o la Documentazione per l'API REST.