V2 独立版已交付
MCP 工具网关
HeteroFlow 是本站的异构算力与大模型调度产品。MCP 工具网关。MCP 工具网关把管理员注册的 MCP(Model Context Protocol)工具服务纳入统一大模型网关:开发者用调用模型同一把密钥经单端点发现并调用工具,鉴权、配额、审计与租户隔离完全同源,无需额外凭证。
MCP 工具网关
> MCP 工具网关把管理员注册的 MCP(Model Context Protocol)工具服务纳入统一大模型网关:开发者用调用模型同一把密钥经单端点发现并调用工具,鉴权、配额、审计与租户隔离完全同源,无需额外凭证。
三步上手
1. initialize 握手(不消耗额度);
2. tools/list 列出当前可用的全部工具;
3. tools/call 按名调用,参数随方法传递。
工具名带服务前缀:多个工具服务聚合在同一端点下,工具名统一为 {服务名}__{工具名}(双下划线分隔)——tools/list 返回的就是带前缀的全量目录,调用时也要带前缀。前缀同时是路由键:跨租户的前缀与未知工具名一律按「工具不存在」处理,不泄露其他租户的服务目录。
配额口径
- 只有
tools/call计数,且与模型调用共享同一把密钥的当日限额桶;握手、列目录、探活不消耗额度; - 平台侧拒绝(未知工具 / 服务停用 / 连接失败)不消耗额度;已转发到工具服务的调用(含其报错)照常计数——与配额与限流「拒绝不消耗额度」的承诺一致。
治理同源
- 内容护栏同样生效:若平台启用了内容安全护栏,
tools/call的参数文本先过请求侧检查,命中拦截规则返回MCP_GUARDRAIL_BLOCKED且不计费; - 每次调用写审计留痕,配合 Request-Id 可定位(见审计与日志)。
错误码速查
HTTP 200 + JSON-RPC error 的 data.error_code:
| error_code | 场景 | 处置 |
|---|---|---|
MCP_TOOL_NOT_FOUND | 工具名不存在 / 没带前缀 / 该服务不在本租户 | 先 tools/list 核对带前缀的准确名称 |
MCP_SERVER_DISABLED | 前缀命中的服务被管理员停用 | 联系管理员确认服务状态 |
MCP_UPSTREAM_UNREACHABLE | 工具服务连接失败 / 超时(未送达) | 稍后重试;持续失败报障 |
MCP_UPSTREAM_ERROR | 工具服务自身报错(已送达) | 检查调用参数;错误体含上游原因 |
端点认证方式与调用序列见端点总表。