MCP 服务器

通过 Sakuranbo AI 的 MCP 服务器，编码代理可以搜索本文档、浏览模型目录、预估请求的费用，并读取你的余额和历史记录。服务器 URL 为 https://api.sakuranbo.ai/mcp，使用 Streamable HTTP 传输。

所有工具都是只读的。该服务器无法生成内容、消耗你的余额或更改你的账户。

对该服务器的所有请求都需要认证，文档和模型工具也不例外。请通过 OAuth 登录，或将 API 密钥作为 Bearer 令牌发送。没有有效令牌的请求会返回 401。

• search_docs：搜索本文档。
• get_doc：以 Markdown 读取文档的某一页。
• list_models：按模态或任务筛选并列出模型。
• get_model：读取单个模型的输入参数和价格。
• estimate_cost：在运行请求之前预估费用。
• get_balance：读取预付余额。
• get_usage：读取某段时间内的用量。
• list_requests：列出最近的请求。
• list_jobs：列出图像和视频生成任务。
• get_job：读取单个生成任务。

客户端默认通过 OAuth 登录：浏览器会打开，你登录控制台并批准访问。详见登录与权限。下面的每个客户端也给出了改用 API 密钥的配置，另见使用 API 密钥。

claude mcp add --transport http sakuranbo https://api.sakuranbo.ai/mcp

然后在 Claude Code 中运行 /mcp，按照浏览器中的提示登录。如需改用 API 密钥：

claude mcp add --transport http sakuranbo https://api.sakuranbo.ai/mcp \
  --header "Authorization: Bearer $SAKURANBO_API_KEY"

将服务器添加到项目中的 .cursor/mcp.json，或添加到 ~/.cursor/mcp.json 以便在所有项目中使用。Cursor 通过 OAuth 登录。

{
  "mcpServers": {
    "sakuranbo": {
      "url": "https://api.sakuranbo.ai/mcp"
    }
  }
}

如需改用 API 密钥：

{
  "mcpServers": {
    "sakuranbo": {
      "url": "https://api.sakuranbo.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SAKURANBO_API_KEY}"
      }
    }
  }
}

将服务器添加到工作区中的 .vscode/mcp.json。也可以在命令面板中运行 MCP: Add Server，选择 HTTP，然后输入服务器 URL。VS Code 提示登录时，请在浏览器中完成流程。

{
  "servers": {
    "sakuranbo": {
      "type": "http",
      "url": "https://api.sakuranbo.ai/mcp"
    }
  }
}

如需改用 API 密钥，VS Code 会在服务器启动时请你输入密钥，密钥不会写入文件：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sakuranbo-api-key",
      "description": "Sakuranbo AI API key",
      "password": true
    }
  ],
  "servers": {
    "sakuranbo": {
      "type": "http",
      "url": "https://api.sakuranbo.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sakuranbo-api-key}"
      }
    }
  }
}

将服务器添加到 ~/.codex/config.toml：

[mcp_servers.sakuranbo]
url = "https://api.sakuranbo.ai/mcp"

然后运行 codex mcp login sakuranbo 登录。如需改用 API 密钥，请设置环境变量 SAKURANBO_API_KEY，并添加 bearer_token_env_var：

[mcp_servers.sakuranbo]
url = "https://api.sakuranbo.ai/mcp"
bearer_token_env_var = "SAKURANBO_API_KEY"

客户端首次连接时的流程：

1. 客户端打开浏览器。
2. 如果尚未登录，请登录 Sakuranbo AI 控制台。
3. 授权页面会显示该客户端及其请求的访问权限。选择“允许”。

客户端会自行注册，因此无需创建 OAuth 应用或复制客户端 ID。

唯一的权限是 account:read。客户端可以读取你的余额、用量，以及请求和任务的历史记录。它不能生成内容，也不能消耗你的余额。

当客户端无法打开浏览器，或你从 CI 连接时，请使用 API 密钥。如上面的示例所示，将密钥作为 Bearer 令牌放在 Authorization 请求头中发送。

API 密钥以 cherry_ 开头。服务器始终把以 cherry_ 开头的令牌当作 API 密钥来验证，不会把它当作 OAuth 令牌。

在控制台的 API 密钥页面创建密钥。请从 SAKURANBO_API_KEY 之类的环境变量中读取，不要把它写进会提交的文件。

打开控制台的 API 密钥页面。在“已连接的应用（MCP）”下，选择该应用的“断开连接”并确认，该应用大约一分钟内就会失去访问权限。如果你是通过 API 密钥连接的，请改为对该密钥选择“吊销”；被吊销的密钥从下一个请求起就会被拒绝。