Conectează serverul MCP EQVPS la Claude Code și Codex CLI

Agenții de cod care trăiesc în terminal se pricep la rulat comenzi. Ce nu au de obicei e un server propriu pe care să le ruleze. Conectarea serverului MCP EQVPS rezolvă asta: agentul primește unelte să caute planuri, să comande un VPS, să-i citească datele SSH, să-l repornească, să pornească un sandbox și încă vreo patruzeci.

Ghidul acoperă Claude Code și Codex CLI. Pentru Claude Desktop, Cursor și Cline vezi Conectează EQVPS la clientul tău MCP. Am rulat fiecare comandă de mai jos în Claude Code 2.1 și Codex CLI 0.164 înainte de publicare.

Adresa serverului e aceeași peste tot:

https://mcp.eqvps.com/mcp

Vorbește Streamable HTTP și primește un bearer token în antetul Authorization. Nu există încă un flux de autentificare OAuth, așa că adaugi tokenul de mână.

1. Obține un token

Dacă ai deja cont EQVPS, creează unul în panou: Settings → API tokens. Altfel, o singură cerere face un cont și îi întoarce tokenul:

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

Câmpul token e lung, în jur de o mie de caractere. Nu-l retasta. Pune-l într-un fișier în care agentul nu umblă din întâmplare și încarcă-l de acolo:

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

Poți lăsa și agentul să se înregistreze singur: conectează-l fără token, cere-i să apeleze register_account, apoi adaugă din nou serverul cu tokenul primit.

2. Claude Code

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

Implicit, serverul se adaugă doar pentru proiectul curent. Ca să-l ai în toate proiectele, adaugă -s user. Verifică dacă Claude Code ajunge la el:

claude mcp list

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

Nu da prea multă importanță bifei verzi. Planurile, prețurile și înregistrarea merg fără cont, așa că serverul acceptă conexiunea chiar și cu un token tastat greșit. Tokenul se verifică abia când agentul atinge contul tău. Testul rapid e să-i ceri lui Claude Code „call the eqvps whoami tool”: un token bun întoarce e-mailul tău, unul greșit o eroare 401.

claude mcp get eqvps arată detaliile. Acolo se afișează și tokenul, deci nu lipi acel output într-un chat sau un tichet.

Ce să eviți: -s project scrie serverul în .mcp.json din depozitul tău. Cu un token scris direct în antet, fișierul ajunge în git. Folosește scope-ul local sau user pentru tot ce conține credențiale.

3. Codex CLI

Codex poate citi tokenul dintr-o variabilă de mediu, așa că rămâne complet în afara fișierului de configurare:

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

Asta scrie trei rânduri în ~/.codex/config.toml:

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

Capcana: codex mcp list arată doar configurația salvată, nu se conectează. Conexiunea are loc la pornirea unei sesiuni și doar dacă EQVPS_TOKEN e setat în acel shell. Dacă nu e, Codex sare serverul fără să spună nimic, iar agentul pur și simplu nu are unelte EQVPS. Adaugă linia export în profilul shell-ului sau pornește Codex ca EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.

4. Ce să ceri mai întâi

Începe cu ceva doar de citire, ca să vezi că uneltele merg:

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.

Apoi ceva real:

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.

Dacă soldul acoperă planul, comanda se plătește pe loc și serverul e de obicei gata în aproximativ un minut. Dacă nu, agentul primește o factură neplătită și un link topup_balance pe care îl plătești în USDT, USDC sau ETH pe Base, Ethereum sau Polygon. După alimentare, cere-i să plaseze din nou aceeași comandă (preia comanda neplătită și o plătește din sold în loc să creeze alta) sau să apeleze pay_invoice, care plătește acea factură din sold.

Agentul te va întreba și înainte de orice acțiune distructivă. Reinstalarea sau ștergerea unui server cere tastarea hostname-ului drept confirmare, iar descrierile uneltelor noastre le spun agenților să te consulte mai întâi.

Când nu se conectează

Mai departe: ce poate face un agent cu serverul odată creat — Cum își administrează un agent AI propriul VPS prin MCP. Sau, dacă are nevoie doar să ruleze cod un minut, un sandbox e mai ieftin decât un VPS. Lista completă de unelte e în documentația MCP.