Connectez EQVPS à votre client MCP (Claude Desktop, Cursor, Cline)

EQVPS expose un serveur Model Context Protocol (MCP) distant, de sorte qu'un agent IA à l'intérieur de votre client MCP peut louer et exploiter un vrai VPS sans que vous cliquiez dans un tableau de bord. Ce guide montre comment le câbler dans Claude Desktop, Cursor ou Cline en quelques minutes.

À quoi vous vous connectez

Les outils de catalogue (comme list_plans) sont publics. Tout ce qui touche à un compte ou à un serveur nécessite un jeton Bearer.

Étape 1 — Obtenez un jeton Bearer

Vous n'avez pas besoin d'un mot de passe ni d'un formulaire d'inscription. Connectez le serveur (vous pouvez vous connecter sans en-tête d'authentification d'abord), puis faites appeler par votre agent l'outil register_account avec un nom et un e-mail :

// appel d'outil : register_account
{ "first_name": "Ada", "last_name": "Agent", "email": "ada@example.com" }
// → { "token": "<votre jeton Bearer>", "token_type": "Bearer", ... }

Stockez le token renvoyé. C'est un identifiant Bearer de longue durée — envoyez-le en Authorization: Bearer <token> à chaque appel authentifié.

Étape 2 — Configurez votre client

Claude Desktop

Claude Pro, Team et Enterprise peuvent ajouter un serveur MCP distant directement sous Réglages → Connecteurs (collez l'URL du point de terminaison et l'en-tête Authorization: Bearer). Pour Claude Desktop sur la configuration stdio classique, faites le pont vers le point de terminaison distant avec mcp-remote — la voie universelle pour tout client stdio. Éditez claude_desktop_config.json :

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

Astuce : pour créer le jeton au départ, connectez-vous une fois sans la ligne --header, demandez à Claude d'appeler register_account, puis collez le jeton et redémarrez.

Cursor

Cursor prend en charge les serveurs MCP distants directement. Dans .cursor/mcp.json (projet) ou vos réglages MCP globaux de Cursor :

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

Cline

Dans les réglages MCP de Cline, ajoutez un serveur distant avec l'URL https://mcp.eqvps.com/mcp et un en-tête Authorization: Bearer YOUR_TOKEN. Cline parle Streamable HTTP nativement, aucun pont n'est donc nécessaire.

Étape 3 — Utilisez-le

Une fois connecté, votre agent peut lancer les outils. Une première session typique :

1. list_plans — voir les offres, specs et images OS que chacune peut démarrer (sans auth).
2. register_account — obtenir votre jeton (sans auth).
3. topup_balance — approvisionner un solde prépayé en crypto (renvoie une URL de paiement).
4. order_vps — commander une offre avec un os_id ; ajoutez une ssh_key pour un root par clé.
5. get_vps_status — interroger jusqu'à ce que le serveur soit active ; lire l'hôte/port SSH.
6. power_vps, set_hostname, get_vps_metrics, reinstall_vps, cancel_service — l'exploiter.

L'ensemble complet est de 16 outils — voir la référence des outils MCP d'EQVPS pour chaque outil, ses paramètres et des exemples.

Payer en crypto

EQVPS est crypto-natif : vous payez en USDC ou USDT sur Base, Ethereum ou Polygon — sans carte requise. Le schéma le plus propre pour les agents est un solde prépayé : appelez topup_balance une fois, payez le paiement crypto renvoyé, puis order_vps puise dans le solde automatiquement — l'agent ne touche plus jamais à un portefeuille. Si vous payez trop (les minimums de retrait d'exchange sont souvent plus élevés qu'une petite commande), l'excédent est crédité sur votre solde, pas perdu.

Prêt ?

Pointez votre client MCP vers https://mcp.eqvps.com/mcp, appelez register_account, et votre agent peut monter son propre serveur en une minute environ. Voir ensuite la référence des outils, ou la Documentation pour l'API REST.