Kết nối máy chủ MCP của EQVPS với Claude Code và Codex CLI

Coding agent sống trong terminal rất giỏi chạy lệnh. Thứ chúng thường thiếu là một máy chủ riêng để chạy. Kết nối máy chủ MCP của EQVPS giải quyết điều đó: agent có công cụ để xem gói dịch vụ, đặt VPS, đọc thông tin SSH, khởi động lại, chạy sandbox và khoảng bốn mươi công cụ khác.

Hướng dẫn này dành cho Claude Code và Codex CLI. Với Claude Desktop, Cursor và Cline, xem Kết nối EQVPS với MCP client của bạn. Chúng tôi đã chạy mọi lệnh bên dưới trên Claude Code 2.1 và Codex CLI 0.164 trước khi đăng.

Địa chỉ máy chủ giống nhau ở mọi nơi:

https://mcp.eqvps.com/mcp

Máy chủ dùng Streamable HTTP và nhận bearer token trong header Authorization. Chưa có đăng nhập OAuth nên token được thêm thủ công.

1. Lấy token

Nếu đã có tài khoản EQVPS, hãy tạo token trong bảng điều khiển: Settings → API tokens. Nếu chưa, một yêu cầu duy nhất sẽ tạo tài khoản và trả về token:

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

Trường token khá dài, khoảng một nghìn ký tự. Đừng gõ lại. Lưu vào một tệp mà agent sẽ không vô tình mở và đọc từ đó:

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

Bạn cũng có thể để agent tự đăng ký: kết nối không có token, nhờ nó gọi register_account, rồi thêm lại máy chủ với token nó nhận được.

2. Claude Code

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

Mặc định máy chủ chỉ được thêm cho dự án hiện tại. Để có ở mọi dự án, thêm -s user. Kiểm tra Claude Code có kết nối được không:

claude mcp list

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

Đừng quá tin vào dấu tích xanh đó. Gói dịch vụ, giá và đăng ký hoạt động không cần tài khoản, nên máy chủ vẫn nhận kết nối kể cả khi token bị gõ sai. Token chỉ được kiểm tra khi agent chạm tới tài khoản của bạn. Cách thử nhanh là nhờ Claude Code „call the eqvps whoami tool“: token hợp lệ trả về email của bạn, token sai trả về lỗi 401.

claude mcp get eqvps hiển thị chi tiết. Token cũng được in ra ở đó, nên đừng dán kết quả đó vào chat hay ticket.

Một điều cần tránh: -s project ghi máy chủ vào .mcp.json trong kho mã của bạn. Với token dạng chữ trong header, tệp đó sẽ vào git. Hãy dùng scope local hoặc user cho mọi thứ chứa thông tin đăng nhập.

3. Codex CLI

Codex có thể đọc token từ biến môi trường, nhờ vậy token hoàn toàn không nằm trong tệp cấu hình:

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

Lệnh này ghi ba dòng vào ~/.codex/config.toml:

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

Điểm cần lưu ý: codex mcp list chỉ hiển thị cấu hình đã lưu, không kết nối. Kết nối diễn ra khi phiên bắt đầu, và chỉ khi EQVPS_TOKEN được đặt trong shell đó. Nếu không, Codex lặng lẽ bỏ qua máy chủ và agent đơn giản là không có công cụ EQVPS. Thêm dòng export vào profile của shell, hoặc chạy Codex bằng EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.

4. Nên yêu cầu gì trước tiên

Bắt đầu với thứ chỉ đọc để thấy công cụ hoạt động:

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.

Sau đó là việc thật:

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.

Nếu số dư đủ cho gói, đơn hàng được thanh toán ngay và máy chủ thường sẵn sàng trong khoảng một phút. Nếu không, agent nhận một hóa đơn chưa thanh toán và liên kết topup_balance để bạn trả bằng USDT, USDC hoặc ETH trên Base, Ethereum hoặc Polygon. Sau khi nạp, nhờ nó đặt lại đúng đơn đó (nó sẽ lấy đơn chưa thanh toán và trả từ số dư thay vì tạo đơn thứ hai), hoặc gọi pay_invoice để trả hóa đơn đó từ số dư.

Agent cũng sẽ hỏi bạn trước bất cứ thao tác phá hủy nào. Cài lại hoặc xóa máy chủ yêu cầu gõ hostname để xác nhận, và mô tả công cụ của chúng tôi dặn agent hỏi ý bạn trước.

Khi không kết nối được

Tiếp theo: agent làm được gì với máy chủ khi đã có — Cách AI agent tự quản lý VPS của mình qua MCP. Hoặc nếu chỉ cần chạy code trong một phút, sandbox rẻ hơn VPS. Danh sách đầy đủ các công cụ có trong tài liệu MCP.