Los agentes de código que viven en una terminal son buenos ejecutando comandos. Lo que no suelen tener es un servidor propio donde ejecutarlos. Conectar el servidor MCP de EQVPS lo resuelve: el agente obtiene herramientas para consultar planes, pedir un VPS, leer sus datos SSH, reiniciarlo, lanzar un sandbox y unas cuarenta más.
Esta guía cubre Claude Code y Codex CLI. Para Claude Desktop, Cursor y Cline consulta Conectar EQVPS a tu cliente MCP. Ejecutamos cada comando de abajo en Claude Code 2.1 y Codex CLI 0.164 antes de publicar.
La dirección del servidor es la misma en todas partes:
https://mcp.eqvps.com/mcp
Habla Streamable HTTP y acepta un bearer token en la cabecera Authorization. Aún no hay flujo de inicio de sesión OAuth, así que el token se añade a mano.
1. Conseguir un token
Si ya tienes cuenta de EQVPS, crea uno en el panel: Settings → API tokens. Si no, una sola petición crea una cuenta y devuelve su 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"}'
El campo token es largo, unos mil caracteres. No lo vuelvas a teclear. Guárdalo en un archivo al que el agente no vaya a parar por casualidad y cárgalo desde ahí:
umask 077; printf '%s' 'PASTE-TOKEN' > ~/.eqvps_token
export EQVPS_TOKEN=$(cat ~/.eqvps_token)
También puedes dejar que el agente se registre solo: conéctalo sin token, pídele que llame a register_account y vuelve a añadir el servidor con el token que reciba.
2. Claude Code
claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp \
--header "Authorization: Bearer $EQVPS_TOKEN"
Por defecto el servidor se añade solo para el proyecto actual. Para tenerlo en todos los proyectos, añade -s user. Comprueba que Claude Code lo alcanza:
claude mcp list
eqvps: https://mcp.eqvps.com/mcp (HTTP) - ✔ Connected
No le des demasiada importancia a esa marca verde. Los planes, los precios y el registro funcionan sin cuenta, así que el servidor acepta la conexión incluso con un token mal escrito. El token solo se comprueba cuando el agente toca tu cuenta. La prueba rápida es pedirle a Claude Code «call the eqvps whoami tool»: un token válido devuelve tu correo y uno inválido devuelve un error 401.
claude mcp get eqvps muestra los detalles. Ahí también se imprime el token, así que no pegues esa salida en un chat ni en un ticket.
Algo que conviene evitar: -s project escribe el servidor en .mcp.json dentro de tu repositorio. Con un token literal en la cabecera, ese archivo acaba en git. Usa el scope local o user para todo lo que lleve credenciales.
3. Codex CLI
Codex puede leer el token de una variable de entorno, lo que lo mantiene fuera del archivo de configuración por completo:
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
Eso escribe tres líneas en ~/.codex/config.toml:
[mcp_servers.eqvps]
url = "https://mcp.eqvps.com/mcp"
bearer_token_env_var = "EQVPS_TOKEN"
El truco: codex mcp list solo muestra la configuración guardada, no se conecta. La conexión ocurre al iniciar una sesión, y solo si EQVPS_TOKEN está definida en esa shell. Si no lo está, Codex omite el servidor sin avisar y el agente simplemente no tiene herramientas de EQVPS. Añade la línea export al perfil de tu shell o inicia Codex como EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.
4. Qué pedir primero
Empieza con algo de solo lectura para ver que las herramientas funcionan:
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.
Después, algo 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.
Si el saldo cubre el plan, el pedido se paga en el acto y el servidor suele estar listo en un minuto aproximadamente. Si no, el agente recibe una factura sin pagar y un enlace de topup_balance para que pagues en USDT, USDC o ETH en Base, Ethereum o Polygon. Tras la recarga, pídele que repita el mismo pedido (recoge el pedido sin pagar y lo paga con el saldo en lugar de crear otro) o que llame a pay_invoice, que paga esa factura con el saldo.
El agente también te preguntará antes de cualquier cosa destructiva. Reinstalar o eliminar un servidor exige escribir su hostname como confirmación, y las descripciones de nuestras herramientas indican a los agentes que te consulten antes.
Cuando no se conecta
| Síntoma | Causa probable |
|---|---|
✘ Failed to connect en claude mcp list | La dirección es incorrecta o la máquina no tiene HTTPS saliente. El token no es la causa: un token incorrecto también se conecta. |
whoami o get_balance devuelve 401 | Token incorrecto, truncado, revocado o caducado. Vuelve a pegarlo desde el archivo, no a mano. |
| Codex no tiene herramientas de EQVPS | EQVPS_TOKEN no está definida en la shell que inició codex |
Las herramientas responden 401 al cabo de un tiempo | El token caducó (un año por defecto) o se renovó en otro lugar. Ejecuta refresh_token y actualiza la cabecera o la variable. |
| Un pedido vuelve con una factura sin pagar | El saldo no lo cubría. Recarga y repite el mismo pedido o llama a pay_invoice con esa factura. |
Siguiente: qué puede hacer un agente con el servidor una vez creado — Cómo un agente gestiona su propio VPS por MCP. O, si solo necesita ejecutar código durante un minuto, un sandbox sale más barato que un VPS. La lista completa de herramientas está en la documentación de MCP.
Comentarios
Aún no hay comentarios. Sé el primero.