有一鍵 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. 先請它做什麼

連不上時

常見問題

評論

發表評論