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工具服务自身报错(已送达)检查调用参数;错误体含上游原因

端点认证方式与调用序列见端点总表。