經銷商 API 與 MCP（白牌）

典型流程

建立方案、新增客戶、為客戶訂購 VM；以您自己的品牌交付存取資訊。

// Reseller token (rk_...) from the Partners cabinet -> Authorization: Bearer rk_...
// One MCP endpoint, role-filtered: a reseller token exposes the 30 reseller_* tools.
reseller_create_plan({ name, cores, ram_gb, disk_gb, ipv4, ipv6, locations, markup_price })   // ipv4 0-4, ipv6 0-1, at least one
reseller_add_client({ email }) -> { client_id }
reseller_order_for_client({ plan_id, client_id, os_id? })   // os_id: see list_plans catalog
reseller_vm_details({ service_id }) -> { access, password }  // deliver to your client

os_id 為選填 — 不填則使用該地點的預設作業系統。若要指定作業系統，請使用公開 list_plans 目錄中的 os_id；它會依地點對應到正確的映像。

作業系統與 os_id

提供 14 個 Linux 映像（見下方）。在 reseller_order_for_client 中傳入 os_id — 請從公開的 list_plans 目錄取得。注意：available_os 在不同地點可能列出不同的 id；list_plans 中的 os_id 會對應到該方案地點的正確映像。不填 os_id 則使用該地點的預設作業系統。

虛擬機器狀態

active — 執行中。provisioning — 建立中（下單後短暫的非同步期間）。suspended — 已暫停（例如您暫停了客戶，或未付款）；可用 reseller_unsuspend_client 恢復。cancelled — 已終止（VM 已移除）。

連接任何代理或工具

單一 MCP 端點 — mcp.eqvps.com/mcp — 以您的經銷商權杖驗證。接上您已在使用的任何工具即可。

# Claude Code - add the reseller MCP server (token: Partners cabinet -> API)
claude mcp add --transport http eqvps-reseller https://mcp.eqvps.com/mcp \
  --header "Authorization: Bearer rk_YOUR_RESELLER_TOKEN"

// Claude Desktop / Cursor / Windsurf - mcp.json
{
  "mcpServers": {
    "eqvps-reseller": {
      "type": "http",
      "url": "https://mcp.eqvps.com/mcp",
      "headers": { "Authorization": "Bearer rk_YOUR_RESELLER_TOKEN" }
    }
  }
}

# LangChain / LangGraph (Python) - langchain-mcp-adapters
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"eqvps": {"transport": "streamable_http",
  "url": "https://mcp.eqvps.com/mcp",
  "headers": {"Authorization": "Bearer rk_YOUR_RESELLER_TOKEN"}}})
tools = await client.get_tools()   # 30 reseller_* tools

# Raw MCP (JSON-RPC) - n8n HTTP, Zapier/Make, cURL, any language
curl -X POST https://mcp.eqvps.com/mcp \
  -H "Authorization: Bearer rk_YOUR_RESELLER_TOKEN" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"reseller_order_for_client","arguments":{"client_id":123,"plan_id":45}}}'
# List tools first: {"jsonrpc":"2.0","id":1,"method":"tools/list"}

現成的代理提示詞

自動續費

客戶伺服器不需人工就會續費。reseller_set_autorenew 可為每台 VM 開關自動續費（預設開啟）；每日排程會從批發餘額為 3 天內到期的 VM 續費。用 reseller_renew 可立即續費 N 個期間（1–24 個月）。餘額不足時您會收到一次提醒，並進入一般的寬限期 — 絕不會在沒通知的情況下遺失。

沙箱測試（dry-run）

在 reseller_order_for_client 中傳入 test: true（或以 {"test":true} 呼叫 POST /api/reseller/orders）即可進行 dry-run：您會收到結構與真實訂單完全相同的模擬回應，但不會建立任何 VM，也不會扣除任何餘額。上線前可用來從頭到尾驗證您的 API/MCP 整合。

客戶電子郵件通知

預設情況下，EQVPS 會在開通/暫停/終止/密碼/重灌時寄信給帳戶。您可以在經銷商後台關閉「Notify clients by email」，自行處理客戶通知（白牌）— 開通與續費照常運作，只是不會寄信。