# AI 代理與 MCP

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

## 給 AI 代理一個專屬權杖

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

- 許可權範圍：**read** 和 **rent**（不要給 **manage** 或 **billing**）。
- **支出上限**（美元）、**最長租用時長**（小時）和**到期時間**。

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

## 透過 MCP 接入

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

Claude Code:

```sh
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 金鑰（[部署模型](/zh-tw/docs/models)）。會計費。 |
| `list_images` | Arrakis 映像和你儲存的映像，供 `template_id` 使用。 |
| `list_instances` | 你的機器。 |
| `get_instance` | 單臺機器的最新資訊，以及主機商發出的任何通知。 |
| `get_events` | 你的機器發生了什麼：已就緒、已結束及原因（是否被主機商中斷），以及主機商發出的通知。每個工具結果還會附帶過去一天的提醒。 |
| `terminate_instance` | 停止並移除機器。 |
| `schedule_removal` | 設定機器何時自行移除。 |
| `get_partner_earnings` | 面向合作伙伴：你的合作伙伴碼和連結、你帶來的客戶、你獲得的收益，以及合作伙伴計劃是否開放。 |
| `join_partner_program` | 在帳戶所有者同意的前提下，為該帳戶加入合作伙伴計劃（[/partners](/zh-tw/partners)）。 |

## 重試絕不會重複租用

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

## 不錯的第一條提示詞

> 租一塊 B200，用 3 小時，執行 python eval.py，把結果拷回來，然後停止機器。

更多：[全部文件](/zh-tw/docs.md) · [OpenAPI](/openapi.json) · [llms.txt](/zh-tw/llms.txt)