Den EQVPS MCP-Server mit Claude Code und Codex CLI verbinden

Coding-Agenten im Terminal können gut Befehle ausführen. Was ihnen meist fehlt, ist ein eigener Server, auf dem sie das tun können. Die Verbindung zum EQVPS MCP-Server ändert das: Der Agent bekommt Tools, um Tarife nachzuschlagen, einen VPS zu bestellen, seine SSH-Daten zu lesen, ihn neu zu starten, eine Sandbox zu starten und rund vierzig weitere.

Diese Anleitung behandelt Claude Code und Codex CLI. Für Claude Desktop, Cursor und Cline siehe EQVPS mit Ihrem MCP-Client verbinden. Jeden Befehl unten haben wir vor der Veröffentlichung mit Claude Code 2.1 und Codex CLI 0.164 ausgeführt.

Die Serveradresse ist überall dieselbe:

https://mcp.eqvps.com/mcp

Er spricht Streamable HTTP und nimmt ein Bearer-Token im Header Authorization. Einen OAuth-Anmeldeablauf gibt es noch nicht, Sie fügen das Token also von Hand hinzu.

1. Ein Token holen

Wenn Sie schon ein EQVPS-Konto haben, erstellen Sie eines im Dashboard: Settings → API tokens. Andernfalls legt eine einzige Anfrage ein Konto an und gibt sein Token zurück:

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"}'

Das Feld token ist lang, etwa tausend Zeichen. Tippen Sie es nicht ab. Legen Sie es in eine Datei, an die der Agent nicht zufällig gerät, und laden Sie es von dort:

umask 077; printf '%s' 'PASTE-TOKEN' > ~/.eqvps_token
export EQVPS_TOKEN=$(cat ~/.eqvps_token)

Sie können den Agenten auch selbst registrieren lassen: ohne Token verbinden, ihn register_account aufrufen lassen und den Server dann mit dem erhaltenen Token erneut hinzufügen.

2. Claude Code

claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp \
  --header "Authorization: Bearer $EQVPS_TOKEN"

Standardmäßig wird der Server nur für das aktuelle Projekt hinzugefügt. Damit er in jedem Projekt verfügbar ist, ergänzen Sie -s user. Prüfen Sie, ob Claude Code ihn erreicht:

claude mcp list

eqvps: https://mcp.eqvps.com/mcp (HTTP) - ✔ Connected

Messen Sie dem grünen Haken nicht zu viel Bedeutung bei. Tarife, Preise und Registrierung funktionieren ohne Konto, also nimmt der Server die Verbindung auch mit einem vertippten Token an. Das Token wird erst geprüft, wenn der Agent Ihr Konto anfasst. Der schnelle Test: Bitten Sie Claude Code „call the eqvps whoami tool“. Ein gültiges Token liefert Ihre E-Mail, ein ungültiges einen 401-Fehler.

claude mcp get eqvps zeigt die Details. Dort wird auch das Token ausgegeben, kopieren Sie diese Ausgabe also nicht in einen Chat oder ein Ticket.

Eines sollten Sie vermeiden: -s project schreibt den Server in .mcp.json in Ihrem Repository. Mit einem Token im Klartext im Header landet diese Datei in git. Nutzen Sie für alles mit Zugangsdaten den Scope local oder user.

3. Codex CLI

Codex kann das Token aus einer Umgebungsvariablen lesen, damit bleibt es ganz aus der Konfigurationsdatei heraus:

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

Das schreibt drei Zeilen in ~/.codex/config.toml:

[mcp_servers.eqvps]
url = "https://mcp.eqvps.com/mcp"
bearer_token_env_var = "EQVPS_TOKEN"

Der Haken: codex mcp list zeigt nur die gespeicherte Konfiguration, es verbindet sich nicht. Die Verbindung entsteht beim Start einer Sitzung, und nur wenn EQVPS_TOKEN in dieser Shell gesetzt ist. Ist es das nicht, überspringt Codex den Server stillschweigend, und der Agent hat einfach keine EQVPS-Tools. Nehmen Sie die export-Zeile in Ihr Shell-Profil auf oder starten Sie Codex mit EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.

4. Was Sie zuerst fragen

Beginnen Sie mit etwas, das nur liest, damit Sie sehen, dass die Tools funktionieren:

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.

Dann etwas Echtes:

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.

Reicht das Guthaben für den Tarif, wird die Bestellung sofort bezahlt, und der Server ist meist in etwa einer Minute bereit. Reicht es nicht, bekommt der Agent eine unbezahlte Rechnung und einen topup_balance-Link, den Sie in USDT, USDC oder ETH auf Base, Ethereum oder Polygon bezahlen. Bitten Sie ihn nach der Aufladung, dieselbe Bestellung noch einmal aufzugeben (er übernimmt die unbezahlte Bestellung und bezahlt sie aus dem Guthaben, statt eine zweite anzulegen), oder pay_invoice aufzurufen, das diese Rechnung aus dem Guthaben bezahlt.

Vor allem Destruktiven fragt der Agent außerdem nach. Neuinstallation oder Löschen eines Servers verlangt seinen Hostnamen als Bestätigung, und unsere Tool-Beschreibungen sagen Agenten, vorher bei Ihnen nachzufragen.

Wenn es sich nicht verbindet

Weiter: was ein Agent mit dem Server macht, sobald es ihn gibt – Wie ein Agent seinen VPS per MCP selbst betreibt. Oder, wenn er nur eine Minute Code ausführen muss, ist eine Sandbox günstiger als ein VPS. Die vollständige Tool-Liste steht in der MCP-Dokumentation.