Les agents de code qui vivent dans un terminal savent bien lancer des commandes. Ce qui leur manque souvent, c'est un serveur à eux pour les exécuter. Connecter le serveur MCP d'EQVPS règle cela : l'agent obtient des outils pour consulter les offres, commander un VPS, lire ses accès SSH, le redémarrer, lancer une sandbox, et une quarantaine d'autres.
Ce guide couvre Claude Code et Codex CLI. Pour Claude Desktop, Cursor et Cline, voir Connecter EQVPS à votre client MCP. Nous avons exécuté chaque commande ci-dessous sur Claude Code 2.1 et Codex CLI 0.164 avant publication.
L'adresse du serveur est la même partout :
https://mcp.eqvps.com/mcp
Il parle le Streamable HTTP et accepte un jeton bearer dans l'en-tête Authorization. Il n'y a pas encore de connexion OAuth, vous ajoutez donc le jeton à la main.
1. Obtenir un jeton
Si vous avez déjà un compte EQVPS, créez-en un dans le tableau de bord : Settings → API tokens. Sinon, une seule requête crée un compte et renvoie son jeton :
curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
-H "Content-Type: application/json" \
-d '{"first_name":"Ada","last_name":"Lovelace","email":"you@example.com"}'
Le champ token est long, environ mille caractères. Ne le retapez pas. Mettez-le dans un fichier où l'agent n'ira pas fouiller et chargez-le depuis là :
umask 077; printf '%s' 'PASTE-TOKEN' > ~/.eqvps_token
export EQVPS_TOKEN=$(cat ~/.eqvps_token)
Vous pouvez aussi laisser l'agent s'inscrire lui-même : connectez-le sans jeton, demandez-lui d'appeler register_account, puis ajoutez de nouveau le serveur avec le jeton obtenu.
2. Claude Code
claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp \
--header "Authorization: Bearer $EQVPS_TOKEN"
Par défaut, le serveur n'est ajouté que pour le projet courant. Pour l'avoir dans tous les projets, ajoutez -s user. Vérifiez que Claude Code le joint :
claude mcp list
eqvps: https://mcp.eqvps.com/mcp (HTTP) - ✔ Connected
N'accordez pas trop d'importance à cette coche verte. Les offres, les prix et l'inscription fonctionnent sans compte, donc le serveur accepte la connexion même avec un jeton mal tapé. Le jeton n'est vérifié que lorsque l'agent touche à votre compte. Le test rapide : demandez à Claude Code « call the eqvps whoami tool ». Un bon jeton renvoie votre e-mail, un mauvais renvoie une erreur 401.
claude mcp get eqvps affiche les détails. Le jeton y est imprimé aussi, ne collez donc pas cette sortie dans un chat ou un ticket.
À éviter : -s project écrit le serveur dans .mcp.json à l'intérieur de votre dépôt. Avec un jeton en clair dans l'en-tête, ce fichier finit dans git. Utilisez le scope local ou user pour tout ce qui contient un identifiant.
3. Codex CLI
Codex peut lire le jeton dans une variable d'environnement, ce qui le garde complètement hors du fichier de configuration :
codex mcp add eqvps --url https://mcp.eqvps.com/mcp --bearer-token-env-var EQVPS_TOKEN
codex mcp list
Name Url Bearer Token Env Var Status Auth
eqvps https://mcp.eqvps.com/mcp EQVPS_TOKEN enabled Bearer token
Cela écrit trois lignes dans ~/.codex/config.toml :
[mcp_servers.eqvps]
url = "https://mcp.eqvps.com/mcp"
bearer_token_env_var = "EQVPS_TOKEN"
Le piège : codex mcp list n'affiche que la configuration enregistrée, il ne se connecte pas. La connexion a lieu au démarrage d'une session, et seulement si EQVPS_TOKEN est défini dans ce shell. Sinon, Codex ignore discrètement le serveur et l'agent n'a tout simplement aucun outil EQVPS. Ajoutez la ligne export à votre profil shell, ou lancez Codex avec EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.
4. Premières demandes
Commencez par quelque chose en lecture seule pour voir que les outils fonctionnent :
Call the eqvps whoami tool and tell me which account I'm signed in as.
List the EQVPS plans with a dedicated IPv4 and their monthly prices.
Show my EQVPS balance and my servers.
Puis quelque chose de réel :
Order the cheapest EQVPS plan with Ubuntu 24.04, use my key from ~/.ssh/id_ed25519.pub, wait until it's active and give me the SSH command.
Si le solde couvre l'offre, la commande est payée sur-le-champ et le serveur est en général prêt en une minute environ. Sinon, l'agent reçoit une facture impayée et un lien topup_balance que vous réglez en USDT, USDC ou ETH sur Base, Ethereum ou Polygon. Après la recharge, demandez-lui de repasser la même commande (il reprend la commande impayée et la règle sur le solde au lieu d'en créer une seconde), ou d'appeler pay_invoice, qui paie cette facture sur le solde.
L'agent vous demandera aussi votre accord avant toute action destructive. Réinstaller ou supprimer un serveur exige de taper son hostname en confirmation, et les descriptions de nos outils demandent aux agents de vous consulter d'abord.
Quand ça ne se connecte pas
| Symptôme | Cause probable |
|---|---|
✘ Failed to connect dans claude mcp list | L'adresse est fausse ou la machine n'a pas de HTTPS sortant. Le jeton n'y est pour rien : un mauvais jeton se connecte quand même. |
whoami ou get_balance renvoie 401 | Jeton faux, tronqué, révoqué ou expiré. Recollez-le depuis le fichier, pas à la main. |
| Codex n'a aucun outil EQVPS | EQVPS_TOKEN n'est pas défini dans le shell qui a lancé codex |
Les outils répondent 401 au bout d'un moment | Le jeton a expiré (un an par défaut) ou a été renouvelé ailleurs. Lancez refresh_token et mettez à jour l'en-tête ou la variable. |
| Une commande revient avec une facture impayée | Le solde ne suffisait pas. Rechargez, puis repassez la même commande ou appelez pay_invoice avec cette facture. |
Ensuite : ce qu'un agent peut faire du serveur une fois créé — Comment un agent gère seul son VPS via MCP. Ou, s'il n'a besoin d'exécuter du code que pendant une minute, une sandbox coûte moins cher qu'un VPS. La liste complète des outils se trouve dans la documentation MCP.
Commentaires
Pas encore de commentaires. Soyez le premier.