Coding-agents in de terminal zijn goed in commando's uitvoeren. Wat ze meestal niet hebben, is een eigen server om dat op te doen. Koppelen aan de EQVPS MCP-server lost dat op: de agent krijgt tools om pakketten op te zoeken, een VPS te bestellen, de SSH-gegevens te lezen, hem te herstarten, een sandbox te starten en zo'n veertig andere.
Deze handleiding behandelt Claude Code en Codex CLI. Voor Claude Desktop, Cursor en Cline zie EQVPS koppelen aan je MCP-client. Elk commando hieronder hebben we vóór publicatie uitgevoerd op Claude Code 2.1 en Codex CLI 0.164.
Het serveradres is overal hetzelfde:
https://mcp.eqvps.com/mcp
Hij spreekt Streamable HTTP en neemt een bearer token in de header Authorization. Er is nog geen OAuth-inlogflow, dus je voegt het token met de hand toe.
1. Een token halen
Heb je al een EQVPS-account, maak er dan een aan in het dashboard: Settings → API tokens. Anders maakt één verzoek een account aan en geeft het token terug:
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"}'
Het veld token is lang, ongeveer duizend tekens. Typ het niet over. Zet het in een bestand waar de agent niet zomaar in komt en laad het van daaruit:
umask 077; printf '%s' 'PASTE-TOKEN' > ~/.eqvps_token
export EQVPS_TOKEN=$(cat ~/.eqvps_token)
Je kunt de agent ook zelf laten aanmelden: verbind zonder token, vraag hem register_account aan te roepen en voeg de server daarna opnieuw toe met het token dat hij terugkreeg.
2. Claude Code
claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp \
--header "Authorization: Bearer $EQVPS_TOKEN"
Standaard wordt de server alleen voor het huidige project toegevoegd. Wil je hem in elk project, voeg dan -s user toe. Controleer of Claude Code hem bereikt:
claude mcp list
eqvps: https://mcp.eqvps.com/mcp (HTTP) - ✔ Connected
Hecht niet te veel waarde aan dat groene vinkje. Pakketten, prijzen en aanmelden werken zonder account, dus de server accepteert de verbinding ook met een verkeerd getypt token. Het token wordt pas gecontroleerd als de agent aan je account komt. De snelle test is Claude Code vragen „call the eqvps whoami tool”: een goed token geeft je e-mailadres terug, een fout token een 401-fout.
claude mcp get eqvps toont de details. Ook het token wordt daar afgedrukt, plak die uitvoer dus niet in een chat of ticket.
Eén ding om te vermijden: -s project schrijft de server naar .mcp.json in je repository. Met een letterlijk token in de header belandt dat bestand in git. Gebruik voor alles met inloggegevens de scope local of user.
3. Codex CLI
Codex kan het token uit een omgevingsvariabele lezen, zodat het helemaal buiten het configuratiebestand blijft:
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
Dat schrijft drie regels naar ~/.codex/config.toml:
[mcp_servers.eqvps]
url = "https://mcp.eqvps.com/mcp"
bearer_token_env_var = "EQVPS_TOKEN"
Het addertje: codex mcp list toont alleen de opgeslagen configuratie, het maakt geen verbinding. De verbinding ontstaat bij het starten van een sessie, en alleen als EQVPS_TOKEN in die shell is gezet. Is dat niet zo, dan slaat Codex de server stilletjes over en heeft de agent gewoon geen EQVPS-tools. Zet de export-regel in je shellprofiel of start Codex als EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.
4. Wat je eerst vraagt
Begin met iets wat alleen leest, zodat je ziet dat de tools werken:
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.
Dan iets echts:
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.
Dekt het saldo het pakket, dan wordt de bestelling meteen betaald en is de server meestal binnen ongeveer een minuut klaar. Zo niet, dan krijgt de agent een onbetaalde factuur en een topup_balance-link die jij betaalt in USDT, USDC of ETH op Base, Ethereum of Polygon. Vraag hem na het opwaarderen dezelfde bestelling opnieuw te plaatsen (hij pakt de onbetaalde bestelling op en betaalt die uit het saldo in plaats van een tweede te maken), of pay_invoice aan te roepen, dat die factuur uit het saldo betaalt.
De agent vraagt je ook toestemming vóór alles wat destructief is. Herinstalleren of verwijderen van een server vraagt de hostname als bevestiging, en onze toolbeschrijvingen zeggen agents dat ze eerst bij jou moeten navragen.
Als het geen verbinding maakt
| Symptoom | Waarschijnlijke oorzaak |
|---|---|
✘ Failed to connect in claude mcp list | Het adres klopt niet of de machine heeft geen uitgaand HTTPS. Het token is niet de oorzaak: ook een fout token maakt verbinding. |
whoami of get_balance geeft 401 | Token fout, afgekapt, ingetrokken of verlopen. Plak het opnieuw uit het bestand, niet met de hand. |
| Codex heeft geen EQVPS-tools | EQVPS_TOKEN is niet gezet in de shell die codex startte |
Tools antwoorden na een tijd met 401 | Het token is verlopen (standaard na een jaar) of elders vernieuwd. Voer refresh_token uit en werk de header of de variabele bij. |
| Een bestelling komt terug met een onbetaalde factuur | Het saldo was niet genoeg. Waardeer op en herhaal dezelfde bestelling of roep pay_invoice aan met die factuur. |
Verder: wat een agent met de server doet zodra die bestaat — Hoe een AI-agent zijn eigen VPS via MCP beheert. Of, als hij maar een minuut code hoeft te draaien, is een sandbox goedkoper dan een VPS. De volledige toollijst staat in de MCP-documentatie.
Reacties
Nog geen reacties. Wees de eerste.