有一键 Connect 按钮吗？

还没有。两个 CLI 都通过您自己添加的 bearer 令牌连接我们的服务器——一条命令，见下文。托管聊天应用中的一键登录需要 OAuth，我们尚未推出。

需要先有账户吗？

需要的是令牌。不用控制面板也能获取：先不带令牌连接一次，让智能体调用 register_account，或向 /auth/register 发送一个 curl 请求。然后带上令牌重新添加服务器。

Claude Code 把令牌存在哪里？

存在 ~/.claude.json 中，按您选择的 scope。默认 scope local 只对当前项目生效；-s user 则全局生效。不要在令牌明文的情况下使用 -s project——它会把 .mcp.json 写进代码仓库。

Codex 列出了服务器，但智能体没有 EQVPS 工具。为什么？

Codex 启动时从您指定的环境变量读取令牌。如果启动 codex 的 shell 中没有设置该变量，它根本不会连接服务器。export 该变量后重新启动 codex。

智能体会花我的钱吗？

它可以用预付余额订购和续费服务器，也可以创建沙箱。请把余额控制在您愿意花的范围内，并为沙箱设置支出上限。用加密货币支付账单仍然需要一个持有钱包的人。

在 Claude Code 和 Codex CLI 中配置 EQVPS MCP

两个终端编程智能体，两条命令。如何用 bearer 令牌把 EQVPS MCP 服务器添加到 Claude Code 和 Codex CLI，确认确实已连接，让令牌远离 git，以及先让智能体做什么。

运行在终端里的编程智能体很擅长执行命令。它们通常缺少的是一台属于自己的服务器。连接 EQVPS MCP 服务器就能解决这个问题：智能体获得查看套餐、订购 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 账户，请在控制面板中创建：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 只显示已保存的配置，并不连接。连接发生在会话启动时，而且只有当该 shell 中设置了 EQVPS_TOKEN 时才会进行。否则 Codex 会静默跳过服务器，智能体就只是没有 EQVPS 工具。请把 export 这一行加入 shell 配置文件，或用 EQVPS_TOKEN=$(cat ~/.eqvps_token) codex 启动 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 链接，您可用 Base、Ethereum 或 Polygon 上的 USDT、USDC 或 ETH 支付。充值后，让它再下一次同样的订单（它会接手未付订单并从余额支付，而不是新建第二个），或调用 pay_invoice 从余额支付这张账单。

在执行任何破坏性操作之前，智能体也会先问您。重装或删除服务器需要输入主机名确认，我们的工具说明也要求智能体先征得您的同意。

连接不上时

现象	可能原因
`claude mcp list` 中显示 `✘ Failed to connect`	地址错误，或机器没有出站 HTTPS。与令牌无关：错误的令牌也能连接。
`whoami` 或 `get_balance` 返回 401	令牌错误、被截断、已撤销或已过期。请从文件重新粘贴，不要手打。
Codex 没有 EQVPS 工具	启动 `codex` 的 shell 中未设置 `EQVPS_TOKEN`
一段时间后工具返回 `401`	令牌已过期（默认一年）或在别处被刷新。运行 `refresh_token` 并更新头或变量。
订单返回了未付账单	余额不足。充值后重复同样的订单，或用这张账单调用 `pay_invoice`。

接下来：服务器建好后智能体能做什么——AI 智能体如何通过 MCP 自己维护 VPS。如果只需要运行一分钟代码，沙箱比 VPS 更便宜。完整工具列表见 MCP 文档。

将 EQVPS MCP 服务器连接到 Claude Code 和 Codex CLI

1. 获取令牌

2. Claude Code

3. Codex CLI

4. 先让它做什么

连接不上时

常见问题

评论

发表评论