Verbind EQVPS met je MCP-client (Claude Desktop, Cursor, Cline)

EQVPS stelt een remote Model Context Protocol (MCP) server beschikbaar, zodat een AI-agent binnen je MCP-client een echte VPS kan huren en bedienen zonder dat jij door een dashboard klikt. Deze gids toont hoe je het in een paar minuten aansluit op Claude Desktop, Cursor of Cline.

Waarmee je verbindt

Catalogus-tools (zoals list_plans) zijn publiek. Alles wat een account of een server raakt heeft een Bearer-token nodig.

Stap 1 — Krijg een Bearer-token

Je hebt geen wachtwoord of aanmeldformulier nodig. Verbind de server (je kunt eerst verbinden zonder auth-header), laat je agent dan de register_account-tool aanroepen met een naam en e-mail:

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

Sla het teruggegeven token op. Het is een langlevend bearer-credential — stuur het als Authorization: Bearer <token> op elke geauthenticeerde aanroep.

Stap 2 — Configureer je client

Claude Desktop

Claude Pro, Team en Enterprise kunnen een remote MCP-server rechtstreeks toevoegen onder Settings → Connectors (plak de endpoint-URL en de Authorization: Bearer-header). Voor Claude Desktop op de klassieke stdio-setup, bridge het remote endpoint met mcp-remote — het universele pad voor elke stdio-client. Bewerk claude_desktop_config.json:

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

Tip: om het token in de eerste plaats te minten, verbind één keer zonder de --header-regel, vraag Claude om register_account aan te roepen, plak dan het token erin en herstart.

Cursor

Cursor ondersteunt remote MCP-servers rechtstreeks. In .cursor/mcp.json (project) of je globale Cursor MCP-instellingen:

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

Cline

Voeg in Cline's MCP-instellingen een remote server toe met de URL https://mcp.eqvps.com/mcp en een Authorization: Bearer YOUR_TOKEN-header. Cline spreekt Streamable HTTP native, dus geen bridge nodig.

Stap 3 — Gebruik het

Eenmaal verbonden, kan je agent de tools draaien. Een typische eerste sessie:

1. list_plans — zie plannen, specificaties, en welke OS-images elk kan booten (geen auth).
2. register_account — krijg je token (geen auth).
3. topup_balance — financier een vooraf betaald saldo met crypto (geeft een checkout-URL terug).
4. order_vps — bestel een plan met een os_id; voeg een ssh_key toe voor key-based root.
5. get_vps_status — poll tot de server active is; lees SSH-host/poort.
6. power_vps, set_hostname, get_vps_metrics, reinstall_vps, cancel_service — bedien het.

De volledige set is 16 tools — zie de EQVPS MCP-tools-referentie voor elke tool, zijn parameters en voorbeelden.

Betalen met crypto

EQVPS is crypto-native: je betaalt in USDC of USDT op Base, Ethereum of Tron — geen kaart vereist. Het schoonste patroon voor agents is een vooraf betaald saldo: roep topup_balance één keer aan, betaal de teruggegeven crypto-checkout, dan geeft order_vps automatisch uit vanuit het saldo — de agent raakt nooit meer een wallet aan. Als je te veel betaalt (opnameminimums van beurzen zijn vaak hoger dan een kleine bestelling), wordt het overschot bijgeschreven op je saldo, niet verloren.

Klaar?

Richt je MCP-client op https://mcp.eqvps.com/mcp, roep register_account aan, en je agent kan zijn eigen server opzetten in ongeveer een minuut. Zie hierna de tools-referentie, of de Docs voor de REST API.