Podłączenie serwera MCP EQVPS do Claude Code i Codex CLI

Agenty kodujące w terminalu dobrze uruchamiają polecenia. Zwykle brakuje im jednak własnego serwera, na którym mogłyby to robić. Podłączenie serwera MCP EQVPS to zmienia: agent dostaje narzędzia do przeglądania planów, zamówienia VPS, odczytu danych SSH, restartu, uruchomienia sandboxa i około czterdziestu innych.

Ten poradnik obejmuje Claude Code i Codex CLI. Dla Claude Desktop, Cursor i Cline zobacz Podłączenie EQVPS do klienta MCP. Każde polecenie poniżej uruchomiliśmy przed publikacją w Claude Code 2.1 i Codex CLI 0.164.

Adres serwera jest wszędzie taki sam:

https://mcp.eqvps.com/mcp

Serwer mówi Streamable HTTP i przyjmuje token bearer w nagłówku Authorization. Nie ma jeszcze logowania przez OAuth, więc token dodajesz ręcznie.

1. Zdobądź token

Jeśli masz już konto EQVPS, utwórz go w panelu: Settings → API tokens. W przeciwnym razie jedno żądanie zakłada konto i zwraca jego 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"}'

Pole token jest długie, około tysiąca znaków. Nie przepisuj go. Zapisz je w pliku, do którego agent przypadkiem nie zajrzy, i wczytuj stamtąd:

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

Możesz też pozwolić agentowi zarejestrować się samodzielnie: połącz go bez tokena, poproś o wywołanie register_account, a potem dodaj serwer ponownie z otrzymanym tokenem.

2. Claude Code

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

Domyślnie serwer jest dodawany tylko dla bieżącego projektu. Żeby był dostępny we wszystkich projektach, dodaj -s user. Sprawdź, czy Claude Code go widzi:

claude mcp list

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

Nie przywiązuj zbyt dużej wagi do zielonego znaczka. Plany, ceny i rejestracja działają bez konta, więc serwer przyjmuje połączenie nawet z błędnie wpisanym tokenem. Token jest sprawdzany dopiero, gdy agent sięga do twojego konta. Szybki test: poproś Claude Code „call the eqvps whoami tool”. Dobry token zwróci twój e-mail, zły — błąd 401.

claude mcp get eqvps pokazuje szczegóły. Wypisuje tam też token, więc nie wklejaj tego wyniku na czat ani do zgłoszenia.

Czego unikać: -s project zapisuje serwer w .mcp.json w twoim repozytorium. Z tokenem wpisanym wprost w nagłówku ten plik trafi do gita. Do wszystkiego, co zawiera dane logowania, używaj zakresu local lub user.

3. Codex CLI

Codex potrafi czytać token ze zmiennej środowiskowej, dzięki czemu w ogóle nie trafia on do pliku konfiguracyjnego:

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

To zapisuje trzy linijki w ~/.codex/config.toml:

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

Haczyk: codex mcp list pokazuje tylko zapisaną konfigurację, nie łączy się. Połączenie następuje przy starcie sesji i tylko wtedy, gdy w tej powłoce ustawione jest EQVPS_TOKEN. Jeśli nie jest, Codex po cichu pomija serwer, a agent po prostu nie ma narzędzi EQVPS. Dodaj linię export do profilu powłoki albo uruchamiaj Codex jako EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.

4. O co poprosić najpierw

Zacznij od czegoś tylko do odczytu, żeby zobaczyć, że narzędzia działają:

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.

Potem coś prawdziwego:

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.

Jeśli saldo pokrywa plan, zamówienie jest od razu opłacane, a serwer zwykle gotowy w około minutę. Jeśli nie, agent dostaje nieopłaconą fakturę i link topup_balance, który opłacasz w USDT, USDC lub ETH w sieciach Base, Ethereum lub Polygon. Po doładowaniu poproś go o ponowne złożenie tego samego zamówienia (przejmie nieopłacone zamówienie i opłaci je z salda zamiast tworzyć drugie) albo o wywołanie pay_invoice, które opłaci tę fakturę z salda.

Przed każdą destrukcyjną operacją agent też zapyta. Reinstalacja lub usunięcie serwera wymaga wpisania jego nazwy hosta jako potwierdzenia, a opisy naszych narzędzi każą agentom najpierw zapytać ciebie.

Gdy nie chce się połączyć

Dalej: co agent może zrobić z serwerem, gdy już istnieje — Jak agent AI sam obsługuje swój VPS przez MCP. A jeśli ma tylko uruchomić kod na minutę, sandbox wyjdzie taniej niż VPS. Pełna lista narzędzi jest w dokumentacji MCP.