AI 代理與 MCP

給 AI 代理一個無法超支的權杖，並透過 MCP 接入。

給 AI 代理一個專屬權杖

在 API & agents 頁面為 AI 代理建立權杖，只授予它所需的內容：

權杖只顯示一次。把它存放在 AI 代理的金鑰儲存中，切勿寫進提示詞或程式碼倉庫。設有上限的權杖每次租用都必須設定關停時間，會超出上限的租用將被拒絕。

MCP 端點是 $ARRAKIS_URL/mcp，使用 AI 代理的權杖訪問。它採用 MCP 的 Streamable HTTP 傳輸，響應為普通 JSON。

Claude Code:

Shell

claude mcp add --transport http arrakis $ARRAKIS_URL/mcp --header "Authorization: Bearer ark_..."

Cursor (mcp.json):

JSON

{
  "mcpServers": {
    "arrakis": {
      "url": "$ARRAKIS_URL/mcp",
      "headers": { "Authorization": "Bearer ark_..." }
    }
  }
}

工具	功能
`search_gpus`	查詢機器，最好的排在最前面：綜合考慮 GPU 效能、價格和主機商的可靠性。給出推薦的機器及理由。篩選條件：GPU 型別、最少和最多 GPU 數量、視訊記憶體、每 GPU 小時最高價格、國家。
`get_market_summary`	按 GPU 系列檢視實時價格和可用情況。
`get_balance`	餘額還能支付多少。
`rent_gpu`	租用一臺機器，返回機器資訊和 SSH 命令。啟動 `template_id` 對應的映像，或任意公開 `image`。會計費。
`deploy_model`	在配置合適的機器上用 vLLM、SGLang 或 llama.cpp 部署 Hugging Face 模型，返回其端點和 API 金鑰（部署模型）。會計費。
`list_images`	Arrakis 映像和你儲存的映像，供 `template_id` 使用。
`list_instances`	你的機器。
`get_instance`	單臺機器的最新資訊，以及主機商發出的任何通知。
`get_events`	你的機器發生了什麼：已就緒、已結束及原因（是否被主機商中斷），以及主機商發出的通知。每個工具結果還會附帶過去一天的提醒。
`terminate_instance`	停止並移除機器。
`schedule_removal`	設定機器何時自行移除。
`get_partner_earnings`	面向合作伙伴：你的合作伙伴碼和連結、你帶來的客戶、你獲得的收益，以及合作伙伴計劃是否開放。
`join_partner_program`	在帳戶所有者同意的前提下，為該帳戶加入合作伙伴計劃（/partners）。

為每次要進行的租用設定一個固定的 idempotency_key。用相同的鍵重試會返回同一臺機器，而不會產生第二筆帳單。透過 MCP 呼叫時，即使沒有提供鍵，只要在 10 分鐘內重複了相同的機器、名稱和小時數，也會返回第一臺機器。

以 AI 代理身份閱讀？請看本頁的 Markdown 版本。