Підключити MCP-сервер EQVPS до Claude Code і Codex CLI

Coding-агенти в терміналі добре виконують команди. Чого їм зазвичай бракує — власного сервера, де це робити. Підключення MCP-сервера EQVPS це виправляє: агент отримує інструменти, щоб переглянути тарифи, замовити VPS, прочитати його SSH-доступи, перезавантажити його, запустити пісочницю, і ще близько сорока.

Ця інструкція — про Claude Code і Codex CLI. Для Claude Desktop, Cursor і Cline дивіться Підключити EQVPS до MCP-клієнта. Кожну команду нижче ми виконали в Claude Code 2.1 і Codex CLI 0.164 перед публікацією.

Адреса сервера всюди однакова:

https://mcp.eqvps.com/mcp

Він працює через Streamable HTTP і приймає bearer-токен у заголовку Authorization. Входу через OAuth поки немає, тож токен додається вручну.

1. Отримати токен

Якщо акаунт EQVPS уже є, створіть токен у кабінеті: Settings → API tokens. Інакше один запит створить акаунт і поверне його токен:

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

Поле token довге, близько тисячі символів. Не передруковуйте його. Покладіть у файл, куди агент випадково не забреде, і читайте звідти:

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

Можна дати агенту зареєструватися самому: підключіть його без токена, попросіть викликати register_account, а потім додайте сервер ще раз з отриманим токеном.

2. Claude Code

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

За замовчуванням сервер додається лише для поточного проєкту. Щоб він був у всіх проєктах, додайте -s user. Перевірте, що Claude Code до нього достукується:

claude mcp list

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

Не надавайте зеленій галочці зайвого значення. Тарифи, ціни й реєстрація працюють без акаунта, тож сервер приймає підключення навіть із помилковим токеном. Токен перевіряється лише тоді, коли агент звертається до вашого акаунта. Швидкий тест — попросити Claude Code «call the eqvps whoami tool»: правильний токен поверне ваш email, неправильний — помилку 401.

claude mcp get eqvps показує подробиці. Там виводиться й токен, тож не вставляйте цей вивід у чат чи тікет.

Чого уникати: -s project записує сервер у .mcp.json у вашому репозиторії. З токеном відкритим текстом у заголовку цей файл потрапить у git. Для всього, що містить облікові дані, використовуйте scope local або user.

3. Codex CLI

Codex уміє читати токен зі змінної оточення, і тоді його взагалі немає у файлі конфігурації:

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

Це записує три рядки в ~/.codex/config.toml:

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

Підступ: codex mcp list лише показує збережену конфігурацію й не підключається. Підключення відбувається на старті сесії, і лише якщо в цій оболонці задано EQVPS_TOKEN. Якщо ні, Codex мовчки пропускає сервер, і в агента просто немає інструментів EQVPS. Додайте рядок export у профіль оболонки або запускайте Codex як EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.

4. Що спитати першим

Почніть із чогось, що лише читає, щоб побачити, що інструменти працюють:

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.

Потім щось справжнє:

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.

Якщо балансу вистачає на тариф, замовлення оплачується одразу, і сервер зазвичай готовий приблизно за хвилину. Якщо ні, агент отримає неоплачений рахунок і посилання topup_balance, яке ви оплатите в USDT, USDC або ETH у мережах Base, Ethereum чи Polygon. Після поповнення попросіть його повторити те саме замовлення (він підхопить неоплачене замовлення й оплатить його з балансу, а не створить друге) або викличте pay_invoice — він оплатить із балансу.

Перед усім руйнівним агент також спитає. Перевстановлення чи видалення сервера вимагає ввести його ім'я як підтвердження, а в описах наших інструментів агентам сказано спершу узгодити це з вами.

Коли не підключається

Далі: що агент може робити із сервером, коли той уже є, — Як ШІ-агент сам обслуговує свій VPS через MCP. Або, якщо йому треба лише запустити код на хвилину, пісочниця дешевша за VPS. Повний перелік інструментів — у документації MCP.