# 智能体与 MCP

给智能体一个无法超支的令牌，并通过 MCP 接入。

## 给智能体一个专属令牌

在 **API & agents** 页面为智能体创建令牌，只授予它所需的内容：

- 权限范围：**read** 和 **rent**（不要给 **manage** 或 **billing**）。
- **支出上限**（美元）、**最长租用时长**（小时）和**到期时间**。

令牌只显示一次。把它存放在智能体的密钥存储中，切勿写进提示词或代码仓库。设有上限的令牌每次租用都必须设置关停时间，会超出上限的租用将被拒绝。

## 通过 MCP 接入

MCP 端点是 `$ARRAKIS_URL/mcp`，使用智能体的令牌访问。它采用 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-cn/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-cn/partners)）。 |

## 重试绝不会重复租用

为每次要进行的租用设置一个固定的 `idempotency_key`。用相同的键重试会返回同一台机器，而不会产生第二笔账单。通过 MCP 调用时，即使没有提供键，只要在 10 分钟内重复了相同的机器、名称和小时数，也会返回第一台机器。

## 不错的第一条提示词

> 租一块 B200，用 3 小时，运行 python eval.py，把结果拷回来，然后停止机器。

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