ZRouter

ZRouter MCP 服务

通过任意 AI 助手管理你的 ZRouter 账户。查看支出、搜索请求日志、创建虚拟模型路由器、签发 API 密钥，并用日常语言设置预算和速率限制。

https://zrouter.si/mcp

ZRouter 是 Super Intelligence Router：一个兼容 OpenAI 的 API 密钥，可用于聊天、图像、音频和视频，并路由至合适的模型和提供商。此 MCP 服务用于管理你的账户。它作为托管的远程服务运行，无需安装任何内容。

• 传输方式： Streamable HTTP
• 登录： 使用 PKCE 和动态客户端注册的 OAuth 2.1，或使用 bearer token
• 范围： 仅限你自己的账户，遵循与控制面板相同的规则
• 工具： 24 个（14 个只读，4 个写入，6 个标记为破坏性操作）

目录

• 快速入门
• 连接客户端
• 使用令牌代替登录
• 你可以询问什么
• 工具
• 安全性
• 身份验证详情
• 故障排除
• 常见问题
• 链接

快速入门

1. 在 zrouter.si 创建免费账户。
2. 在客户端中将 https://zrouter.si/mcp 添加为远程 MCP 服务。
3. 在打开的 ZRouter 页面上批准访问。
4. 询问：“我本周按模型统计的支出是多少？”

支持 MCP 登录的客户端只需提供 URL。无需复制或续期令牌。

连接客户端

Claude（claude.ai 和 Claude Desktop）

设置 → 连接器 → 添加自定义连接器。粘贴 https://zrouter.si/mcp，然后选择连接并批准访问。

ChatGPT

设置 → 应用和连接器 → 使用 URL https://zrouter.si/mcp 和 OAuth 身份验证创建连接器。根据你的套餐，自定义连接器可能需要开发者模式。

Claude Code

claude mcp add --transport http zrouter https://zrouter.si/mcp

然后在 Claude Code 中运行 /mcp，并选择身份验证。

Cursor

此仓库也是一个 Cursor 插件（.cursor-plugin/plugin.json）。或者将服务添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "zrouter": {
      "url": "https://zrouter.si/mcp"
    }
  }
}

VS Code

将服务添加到 .vscode/mcp.json 或你的用户配置中：

{
  "servers": {
    "zrouter": {
      "type": "http",
      "url": "https://zrouter.si/mcp"
    }
  }
}

其他客户端

使用 URL https://zrouter.si/mcp 和 Streamable HTTP 传输方式添加远程 MCP 服务。客户端提示时，选择 OAuth 登录。

不同版本的客户端配置格式可能会有变化。如果上面的代码片段与你的客户端不匹配，请参阅客户端自己的 MCP 文档并使用相同的 URL。

使用令牌代替登录

对于脚本和不支持 MCP 登录的客户端，请使用 MCP 令牌。

1. 在 ZRouter 控制面板中打开CLI 和 MCP 访问。
2. 使用客户端名称为令牌命名，并选择创建 MCP 令牌。
3. 立即复制令牌。令牌只会显示一次，并在 30 天后过期。

将其作为 bearer token 发送：

claude mcp add --transport http zrouter https://zrouter.si/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

{
  "mcpServers": {
    "zrouter": {
      "url": "https://zrouter.si/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

请使用 MCP 令牌，而不是账户 API 密钥。API 密钥只能发送模型请求，无法管理账户，因此即使 API 密钥泄露，也无法创建密钥或更改预算。请勿将 MCP 令牌放入共享的仓库配置中，并在同一控制面板页面撤销不再使用的令牌。

你可以询问的内容

• “我本周按模型分别花了多少钱？”
• “显示今天失败并返回 429 的请求。”
• “我上次向支持机器人发送的请求为什么失败了？”
• “创建一个名为 support-bot 的路由器，在两个模型之间分配流量。”
• “将简单提示词路由到便宜的模型，将复杂提示词路由到我最强的模型。”
• “为 staging 创建一个 API 密钥，并将每天的支出上限设为 $10。”
• “将 staging 用户路径的请求速率限制为每分钟 60 次。”

连接此服务不会更改助手自身的模型提供商。要通过 ZRouter 发送模型请求，请按照其中一个集成指南设置 API 密钥。

工具

每个工具都在经过身份验证的账户中运行。只读工具标注为 readOnlyHint。删除和重置操作标注为 destructiveHint，因此会在有风险的操作前征求你确认的客户端会先询问你。

账户

工具	功能	类型
account_info	已登录账户及其信用余额	只读
credit_ledger	信用额度购买和扣费记录	只读

用量

工具	功能	类型
usage_summary	指定时间范围内的请求总数、令牌数和费用	只读
usage_daily	按日、周或月统计的用量和费用	只读
usage_by_model	按模型分组统计的用量和费用	只读
usage_log	包含令牌数和费用的逐条请求记录	只读

用量工具接受 days（默认值为 30）、start_date 和 end_date（YYYY-MM-DD）、user_path、model 和 provider。

日志

工具	功能	类型
logs_search	按状态码、错误类型或文本搜索请求日志	只读
logs_get	获取单条日志的完整详情（log_id 来自 logs_search）	只读
logs_stats	请求数、错误率和延迟	只读

模型和路由器

工具	功能	类型
models_list	此账户可使用的模型	只读
virtual_models_list	你的路由器、路由策略和模型名称前缀	只读
virtual_models_upsert	创建或更新路由器：最多 32 个目标、权重，以及 round_robin 或 super_intelligence 等策略	写入
virtual_models_delete	删除路由器	破坏性操作

路由器是应用调用的稳定模型名称。super_intelligence 策略会根据请求的难度进行评分，并将请求发送到 simple_targets、standard_targets 或 complex_targets。

API 密钥

工具	功能	类型
api_keys_list	列出密钥。绝不会返回密钥内容。	只读
api_keys_create	创建密钥。密钥内容仅返回一次。	写入
api_keys_delete	删除密钥。使用该密钥的请求会立即停止工作。	破坏性操作

预算

工具	功能	类型
budgets_list	显示预算及当前支出	只读
budgets_upsert	创建或更新 USD 支出限额（按小时、天、周或月）	写入
budgets_delete	删除预算	破坏性操作
budgets_reset	将某个预算的当前支出重置为零	破坏性操作

速率限制

工具	功能	类型
rate_limits_list	显示速率限制及当前计数	只读
rate_limits_upsert	创建或更新每分钟、每小时或每天的请求数或令牌数限制	写入
rate_limits_delete	删除速率限制	破坏性操作
rate_limits_reset	重置某个速率限制的计数器	破坏性操作

预算适用于 user_path 或 label。速率限制适用于 user_path、provider 或 model。设置 per_child，即可将规则分别应用于每个子用户路径。

安全性

• 仅限你的账户。 每次工具调用都会使用你的凭据，通过与控制面板相同的客户 API，因此身份验证、账户范围限制和验证方式完全一致。
• 凭据分离。 MCP 访问使用 OAuth 令牌或 MCP 令牌。账户 API 密钥无法管理账户。
• 可撤销。 在 CLI 和 MCP 访问 → 已连接的应用 下断开应用连接，并在同一页面撤销 MCP 令牌。
• 结果有上限。 单个工具结果上限为 256 KB，避免大型日志页面占满助手的上下文。
• 历史记录中的密钥。 新 API 密钥的密钥值会显示在 api_keys_create 结果中，因此也会出现在助手的对话历史记录中。请妥善处理这些历史记录，或在控制面板中创建密钥。

身份验证详情

面向客户端开发者。该服务遵循 MCP 授权规范。

MCP 端点	https://zrouter.si/mcp（POST、Streamable HTTP、无状态、JSON 响应）
受保护资源元数据	https://zrouter.si/.well-known/oauth-protected-resource/mcp（RFC 9728）
授权服务器元数据	https://zrouter.si/.well-known/oauth-authorization-server（RFC 8414）
授权端点	https://zrouter.si/oauth/authorize
令牌端点	https://zrouter.si/oauth/token
动态客户端注册	https://zrouter.si/oauth/register（RFC 7591）
授权类型	authorization_code、refresh_token
PKCE	必需，S256
客户端身份验证	none（公共客户端）
范围	account

不含有效令牌的请求会收到 401，响应如下：

WWW-Authenticate: Bearer resource_metadata="https://zrouter.si/.well-known/oauth-protected-resource/mcp", scope="account"

使用 MCP 令牌快速检查：

curl -s https://zrouter.si/mcp \
  -H "Authorization: Bearer YOUR_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

故障排除

问题	解决方法
401，错误为 invalid_token	令牌已过期（MCP 令牌有效期为 30 天）或已被撤销，或者发送的是账户 API 密钥而非 MCP 令牌。请重新登录或创建新的 MCP 令牌。
客户端无法登录	请确认其支持使用 OAuth 的远程 MCP。否则，请使用 MCP 令牌。
工具报告验证错误	工具返回的消息与控制面板中的相同。请修正消息中指出的参数，然后重试。
助手使用了错误的账户	在 已连接的应用 下断开应用连接，然后使用正确的账户重新登录。

常见问题

需要安装或托管任何内容吗？ 不需要。ZRouter 在 https://zrouter.si/mcp 托管该服务。

需要付费吗？ 不需要。通过 MCP 管理账户是免费的。你使用 API 密钥发送的模型请求仍会像往常一样从预付余额中扣费。

助手可以访问其他账户吗？ 不可以。每个工具都在已登录的账户中运行。

连接 MCP 会改变助手使用的模型吗？ 不会。它只会添加账户管理工具。

我可以改用终端管理账户吗？ 可以，使用 zctl CLI 即可。

链接

• 网站：https://zrouter.si
• MCP 指南：https://zrouter.si/docs/mcp
• API 指南：https://zrouter.si/docs/api
• 集成：https://zrouter.si/docs/integrations
• zctl CLI：https://zrouter.si/cli
• 状态：https://zrouter.si/status
• Smithery https://smithery.ai/badge/sali/zrouter

许可证

本目录内容采用 MIT License 授权。