Как подключить 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, токен передаётся в заголовке Authorization как bearer. Входа через OAuth пока нет, поэтому токен добавляется вручную.

1. Получить токен

Если аккаунт EQVPS уже есть, создайте токен в кабинете: Настройки → API-токены. Если нет — один запрос создаёт аккаунт и возвращает токен:

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 «вызови инструмент eqvps whoami»: с верным токеном он вернёт ваш email, с неверным — ошибку 401.

claude mcp get eqvps покажет подробности. Токен там тоже выводится, так что не вставляйте этот вывод в чат или тикет.

Чего не стоит делать: -s project записывает сервер в .mcp.json внутри репозитория. С токеном в заголовке этот файл окажется в git. Для всего, где есть секрет, берите области 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 показывает только сохранённую конфигурацию и никуда не подключается. Подключение происходит при старте сеанса и только если в этом shell задана EQVPS_TOKEN. Если её нет, Codex молча пропускает сервер, и у агента просто нет инструментов EQVPS. Добавьте export в профиль shell или запускайте Codex так: EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.

4. Что спросить первым делом

Начните с того, что только читает, — так видно, что инструменты работают:

Вызови инструмент eqvps whoami и скажи, под каким аккаунтом я вошёл.

Покажи тарифы EQVPS со своим IPv4 и их цены в месяц.

Покажи мой баланс EQVPS и мои серверы.

Потом что-то настоящее:

Закажи самый дешёвый тариф EQVPS с Ubuntu 24.04, используй мой ключ из ~/.ssh/id_ed25519.pub, дождись, пока он станет активным, и дай команду SSH.

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

Перед разрушительными действиями агент тоже спросит. Переустановка и удаление сервера требуют ввести его имя для подтверждения, а описания наших инструментов просят агента сначала уточнить у вас.

Если не подключается

Дальше — что агент может делать с сервером, когда тот уже есть: Как агент сам обслуживает свой VPS через MCP. А если ему нужно лишь минуту погонять код, песочница дешевле VPS. Полный список инструментов — в документации MCP.