Свързване на 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“: валиден токен връща имейла ви, невалиден — грешка 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.