Gli agenti di coding che vivono nel terminale sono bravi a eseguire comandi. Quello che di solito non hanno è un server proprio su cui eseguirli. Collegare il server MCP di EQVPS risolve il problema: l'agente ottiene strumenti per consultare i piani, ordinare un VPS, leggerne i dati SSH, riavviarlo, avviare una sandbox e una quarantina di altri.
Questa guida copre Claude Code e Codex CLI. Per Claude Desktop, Cursor e Cline vedi Collegare EQVPS al tuo client MCP. Abbiamo eseguito ogni comando qui sotto su Claude Code 2.1 e Codex CLI 0.164 prima di pubblicare.
L'indirizzo del server è lo stesso ovunque:
https://mcp.eqvps.com/mcp
Parla Streamable HTTP e accetta un bearer token nell'header Authorization. Non c'è ancora un flusso di accesso OAuth, quindi il token si aggiunge a mano.
1. Ottenere un token
Se hai già un account EQVPS, creane uno nel pannello: Settings → API tokens. Altrimenti una sola richiesta crea l'account e restituisce il suo token:
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"}'
Il campo token è lungo, circa mille caratteri. Non ridigitarlo. Mettilo in un file dove l'agente non andrà a curiosare e caricalo da lì:
umask 077; printf '%s' 'PASTE-TOKEN' > ~/.eqvps_token
export EQVPS_TOKEN=$(cat ~/.eqvps_token)
Puoi anche lasciare che l'agente si registri da solo: collegalo senza token, chiedigli di chiamare register_account, poi aggiungi di nuovo il server con il token ricevuto.
2. Claude Code
claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp \
--header "Authorization: Bearer $EQVPS_TOKEN"
Per impostazione predefinita il server viene aggiunto solo per il progetto corrente. Per averlo in tutti i progetti, aggiungi -s user. Verifica che Claude Code lo raggiunga:
claude mcp list
eqvps: https://mcp.eqvps.com/mcp (HTTP) - ✔ Connected
Non dare troppo peso a quella spunta verde. Piani, prezzi e registrazione funzionano senza account, quindi il server accetta la connessione anche con un token digitato male. Il token viene controllato solo quando l'agente tocca il tuo account. Il test rapido è chiedere a Claude Code «call the eqvps whoami tool»: un token valido restituisce la tua email, uno non valido un errore 401.
claude mcp get eqvps mostra i dettagli. Lì viene stampato anche il token, quindi non incollare quell'output in una chat o in un ticket.
Una cosa da evitare: -s project scrive il server in .mcp.json dentro il tuo repository. Con un token in chiaro nell'header, quel file finisce in git. Usa lo scope local o user per tutto ciò che contiene una credenziale.
3. Codex CLI
Codex può leggere il token da una variabile d'ambiente, così resta del tutto fuori dal file di configurazione:
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
Questo scrive tre righe in ~/.codex/config.toml:
[mcp_servers.eqvps]
url = "https://mcp.eqvps.com/mcp"
bearer_token_env_var = "EQVPS_TOKEN"
Il tranello: codex mcp list mostra solo la configurazione salvata, non si collega. La connessione avviene all'avvio di una sessione, e solo se EQVPS_TOKEN è impostata in quella shell. Se non lo è, Codex salta il server in silenzio e l'agente semplicemente non ha strumenti EQVPS. Aggiungi la riga export al profilo della shell, oppure avvia Codex con EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.
4. Cosa chiedere per primo
Inizia con qualcosa di sola lettura, per vedere che gli strumenti funzionano:
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.
Poi qualcosa di reale:
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.
Se il saldo copre il piano, l'ordine viene pagato subito e il server è di solito pronto in circa un minuto. Se non lo copre, l'agente riceve una fattura non pagata e un link topup_balance da pagare in USDT, USDC o ETH su Base, Ethereum o Polygon. Dopo la ricarica, chiedigli di ripetere lo stesso ordine (riprende l'ordine non pagato e lo paga dal saldo invece di crearne un secondo) oppure di chiamare pay_invoice, che paga quella fattura dal saldo.
L'agente ti chiederà conferma anche prima di qualsiasi azione distruttiva. Reinstallare o eliminare un server richiede di digitare il suo hostname come conferma, e le descrizioni dei nostri strumenti dicono agli agenti di consultarti prima.
Quando non si collega
| Sintomo | Causa probabile |
|---|---|
✘ Failed to connect in claude mcp list | L'indirizzo è sbagliato o la macchina non ha HTTPS in uscita. Il token non c'entra: anche un token sbagliato si collega. |
whoami o get_balance restituisce 401 | Token sbagliato, troncato, revocato o scaduto. Incollalo di nuovo dal file, non a mano. |
| Codex non ha strumenti EQVPS | EQVPS_TOKEN non è impostata nella shell che ha avviato codex |
Gli strumenti rispondono 401 dopo un po' | Il token è scaduto (un anno per impostazione predefinita) o è stato rinnovato altrove. Esegui refresh_token e aggiorna l'header o la variabile. |
| Un ordine torna con una fattura non pagata | Il saldo non bastava. Ricarica, poi ripeti lo stesso ordine o chiama pay_invoice con quella fattura. |
Prossimo passo: cosa può fare un agente con il server una volta creato — Come un agente IA gestisce da solo il proprio VPS via MCP. Oppure, se deve solo eseguire codice per un minuto, una sandbox costa meno di un VPS. L'elenco completo degli strumenti è nella documentazione MCP.
Commenti
Ancora nessun commento. Sii il primo.