# MCP 服务

> 使用 API Key 将 Claude Code、Cursor 等 MCP 客户端连接到 Kerox 远程 MCP 服务。

## 接口地址与鉴权

Kerox 提供基于 streamable HTTP 的远程 MCP 服务，使用与公开 API 相同的 Bearer API Key 鉴权：

- **地址**：`https://api.kerox.ai/mcp`
- **请求头**：`Authorization: Bearer $KEROX_API_KEY`

通过 MCP 创建的任务用同样的价格，以及同样的冻结、结算、退回规则，会以 `source: "mcp"` 出现在[控制台 → 任务](/console/tasks)和 `GET /v1/tasks` 里。

## 提供的工具

| 工具名 | 说明 |
| --- | --- |
| `list_models` | 列出已发布的图片与视频模型及当前价格 |
| `get_model_schema` | 查看指定模型的原厂 `input_schema` 与统一格式映射 |
| `estimate` | 提交前预估任务费用，不扣费 |
| `create_task` | 提交生成任务（重试时带上同一个 `idempotency_key`） |
| `get_task` | 查询任务状态、输出文件、花费或失败信息 |
| `list_tasks` | 列出账户最近任务 |
| `upload_file` | 准备上传参考文件：返回 `upload_url` 和 `upload_headers`（把文件 `PUT` 过去），以及可以填进输入的 `url` |
| `get_balance` | 查询余额、冻结中的金额和限流上限 |

## 客户端配置

```json
{
  "mcpServers": {
    "kerox": {
      "type": "http",
      "url": "https://api.kerox.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${KEROX_API_KEY}"
      }
    }
  }
}
```
