Conectar o servidor MCP da EQVPS ao Claude Code e ao Codex CLI

Agentes de código que vivem no terminal são bons em rodar comandos. O que eles geralmente não têm é um servidor próprio para rodá-los. Conectar o servidor MCP da EQVPS resolve isso: o agente ganha ferramentas para consultar planos, pedir um VPS, ler os dados de SSH, reiniciá-lo, iniciar um sandbox e mais umas quarenta.

Este guia cobre o Claude Code e o Codex CLI. Para Claude Desktop, Cursor e Cline, veja Conectar a EQVPS ao seu cliente MCP. Rodamos cada comando abaixo no Claude Code 2.1 e no Codex CLI 0.164 antes de publicar.

O endereço do servidor é o mesmo em todo lugar:

https://mcp.eqvps.com/mcp

Ele fala Streamable HTTP e aceita um bearer token no cabeçalho Authorization. Ainda não há fluxo de login OAuth, então você adiciona o token à mão.

1. Obter um token

Se você já tem conta na EQVPS, crie um no painel: Settings → API tokens. Caso contrário, uma única requisição cria a conta e devolve o 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"}'

O campo token é longo, cerca de mil caracteres. Não digite de novo. Coloque-o num arquivo onde o agente não vá mexer por acaso e carregue de lá:

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

Você também pode deixar o agente se cadastrar sozinho: conecte sem token, peça para ele chamar register_account e depois adicione o servidor de novo com o token que ele recebeu.

2. Claude Code

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

Por padrão o servidor é adicionado só para o projeto atual. Para tê-lo em todos os projetos, acrescente -s user. Confira se o Claude Code chega até ele:

claude mcp list

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

Não dê importância demais a esse check verde. Planos, preços e cadastro funcionam sem conta, então o servidor aceita a conexão mesmo com um token digitado errado. O token só é verificado quando o agente mexe na sua conta. O teste rápido é pedir ao Claude Code "call the eqvps whoami tool": um token válido devolve o seu e-mail; um inválido, um erro 401.

claude mcp get eqvps mostra os detalhes. O token também aparece ali, então não cole essa saída num chat nem num ticket.

Uma coisa a evitar: -s project grava o servidor em .mcp.json dentro do repositório. Com um token em texto puro no cabeçalho, esse arquivo vai parar no git. Use o scope local ou user para tudo que carrega credencial.

3. Codex CLI

O Codex consegue ler o token de uma variável de ambiente, o que o deixa totalmente fora do arquivo de configuração:

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

Isso grava três linhas em ~/.codex/config.toml:

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

A pegadinha: codex mcp list só mostra a configuração salva, não conecta. A conexão acontece quando uma sessão começa, e só se EQVPS_TOKEN estiver definida naquele shell. Se não estiver, o Codex pula o servidor em silêncio e o agente simplesmente não tem ferramentas da EQVPS. Coloque a linha export no perfil do seu shell ou inicie o Codex com EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.

4. O que pedir primeiro

Comece com algo só de leitura, para ver as ferramentas funcionando:

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.

Depois, algo de verdade:

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 o saldo cobrir o plano, o pedido é pago na hora e o servidor costuma ficar pronto em cerca de um minuto. Se não cobrir, o agente recebe uma fatura em aberto e um link de topup_balance para você pagar em USDT, USDC ou ETH em Base, Ethereum ou Polygon. Depois da recarga, peça para ele repetir o mesmo pedido (ele pega o pedido em aberto e paga com o saldo em vez de criar outro) ou para chamar pay_invoice, que paga essa fatura com o saldo.

O agente também vai perguntar antes de qualquer ação destrutiva. Reinstalar ou excluir um servidor exige digitar o hostname como confirmação, e as descrições das nossas ferramentas mandam os agentes consultarem você antes.

Quando não conecta

Próximo passo: o que um agente faz com o servidor depois que ele existe — Como um agente cuida do próprio VPS via MCP. Ou, se ele só precisa rodar código por um minuto, um sandbox sai mais barato que um VPS. A lista completa de ferramentas está na documentação do MCP.