配套篇十三多租户隔离定位篇13 解决了一个网关服务多团队的隔离与 RBAC——这是企业就绪的第一块。但企业真正把 MCP 推到生产还会被另外三件事放倒身份怎么跨系统传、花了多少钱说不清、错误看不出门道。本篇是篇13 的实战补完。坑一 · 身份与授权篇13 未竟之处篇13 的 RBAC 解决的是这个租户的用户能看哪些工具。但企业里还有一层更棘手的用户身份怎么从上游一路带到 MCP 服务端。过渡方案X-User-Id头声明见篇九 L3——但它是断言不是验证伪造、委托链、凭证轮换、audience/issuer 校验都防不住仅限内部可信网络。生产方案对接企业 IdPEntra ID / OIDC走OAuth 2.1用可验证令牌带issuer audience或等ID-JAG / DPoP落地篇九已详述迁移路径。跨系统更尖锐Agent 代表用户去调另一个 Agent / 另一个服务时confused deputy权威误用和token passthrough令牌透传会比单跳更危险——令牌被带到不该去的地方或agent 用自己的身份顶替用户干了越权的事。这正是 2026-07-28 规范列为 MUST 缓解的陷阱只能靠含 audience 校验的可验证令牌根治。相关阅读 → 篇九 L3本坑的过渡→生产升级路径在那里讲透了本篇不重复只点出多跳场景下更危险。坑二 · 预算 / 资源管控财务黑洞这是企业最痛苦、篇13 完全没覆盖的坑。现象MCP 网关一开全公司都来调工具月底老板问花了多少、谁花的答不上来。根因是计量计费 metadata 缺失——协议层没强制带成本归属信息。怎么做按租户 / 按工具计量// 每次工具调用记一笔租户 工具 token 单价demo 用 mock 单价Stringkeycost:tenantId:toolName:day;redis.opsForHash().increment(key,calls,1);redis.opsForHash().increment(key,tokens,promptTokenscompletionTokens);// 定时聚合出某租户某工具本月成本再叠上配额 / 限流 / 熔断篇十一 L5 已讲避免单个租户把额度刷爆。⚠️待实测本机跑通后补某租户某工具本月成本查询示例与聚合脚本。单价用 mock 值真实单价以云厂商账单为准别用 demo 数当财务依据。相关阅读 → 篇十一 L5 限流预算管控的闸那一半在那里。坑三 · 错误处理工具一多错误就五花八门。裸抛500在生产里等于没说。工具级错误码体系别只抛异常定义一套McpBizErrorCode枚举如TOOL_NOT_FOUND / PARAM_INVALID / UPSTREAM_TIMEOUT / RATE_LIMITED让调用方和日志都能区分谁的错。重试 / 退避 幂等协同瞬时失败靠篇十一的退避重试有副作用的工具靠篇八的幂等键——两者必须一起设计否则重试两次 下两次单。结构化错误日志沿篇九 L6错误也打结构化日志含租户、工具、错误码、耗时排查才快。跨 Agent 错误传播当 A2A 多 Agent 协作篇十七时错误会跨 Agent 边界传播需要在边界处统一错误模型避免下层细节泄漏成上层事故。相关阅读 → 篇八幂等、篇十一退避重试、篇九 L6 审计。隐藏坑 · 工具级 Schema 版本治理升级困难是另一个隐形杀手一个工具改了入参结构老客户端全挂。版本号 兼容策略工具 manifest 带schemaVersion破坏性变更升主版本并灰度呼应篇十二工具治理 / 状态机。破坏性变更灰度新版本先对白名单租户开放观察错误率再全量——和篇八的老客户端兼容端点是同一思路。企业部署自查清单线检查项必做身份用户身份从上游到 MCP 服务端可验证非 X-User-Id 裸声明必做公网身份audience/issuer 校验防 confused deputy / token passthrough必做多跳预算按租户/工具的成本计量已落地必做企业预算配额/限流/熔断已配置必做错误工具级错误码体系必做错误重试幂等协同、结构化错误日志必做版本工具 schema 版本号 破坏性变更灰度建议诚实边界预算计量用 mock 单价演示真实成本口径以云账单为准避免财务误导。本篇是篇13 的实战补完不重复篇13 已讲的租户隔离与 RBAC。真实聚合脚本、跨 Agent 错误传播示例为待实测项占位待补。
配套篇十三多租户隔离定位篇13 解决了一个网关服务多团队的隔离与 RBAC——这是企业就绪的第一块。但企业真正把 MCP 推到生产还会被另外三件事放倒身份怎么跨系统传、花了多少钱说不清、错误看不出门道。本篇是篇13 的实战补完。坑一 · 身份与授权篇13 未竟之处篇13 的 RBAC 解决的是这个租户的用户能看哪些工具。但企业里还有一层更棘手的用户身份怎么从上游一路带到 MCP 服务端。过渡方案X-User-Id头声明见篇九 L3——但它是断言不是验证伪造、委托链、凭证轮换、audience/issuer 校验都防不住仅限内部可信网络。生产方案对接企业 IdPEntra ID / OIDC走OAuth 2.1用可验证令牌带issuer audience或等ID-JAG / DPoP落地篇九已详述迁移路径。跨系统更尖锐Agent 代表用户去调另一个 Agent / 另一个服务时confused deputy权威误用和token passthrough令牌透传会比单跳更危险——令牌被带到不该去的地方或agent 用自己的身份顶替用户干了越权的事。这正是 2026-07-28 规范列为 MUST 缓解的陷阱只能靠含 audience 校验的可验证令牌根治。相关阅读 → 篇九 L3本坑的过渡→生产升级路径在那里讲透了本篇不重复只点出多跳场景下更危险。坑二 · 预算 / 资源管控财务黑洞这是企业最痛苦、篇13 完全没覆盖的坑。现象MCP 网关一开全公司都来调工具月底老板问花了多少、谁花的答不上来。根因是计量计费 metadata 缺失——协议层没强制带成本归属信息。怎么做按租户 / 按工具计量// 每次工具调用记一笔租户 工具 token 单价demo 用 mock 单价Stringkeycost:tenantId:toolName:day;redis.opsForHash().increment(key,calls,1);redis.opsForHash().increment(key,tokens,promptTokenscompletionTokens);// 定时聚合出某租户某工具本月成本再叠上配额 / 限流 / 熔断篇十一 L5 已讲避免单个租户把额度刷爆。⚠️待实测本机跑通后补某租户某工具本月成本查询示例与聚合脚本。单价用 mock 值真实单价以云厂商账单为准别用 demo 数当财务依据。相关阅读 → 篇十一 L5 限流预算管控的闸那一半在那里。坑三 · 错误处理工具一多错误就五花八门。裸抛500在生产里等于没说。工具级错误码体系别只抛异常定义一套McpBizErrorCode枚举如TOOL_NOT_FOUND / PARAM_INVALID / UPSTREAM_TIMEOUT / RATE_LIMITED让调用方和日志都能区分谁的错。重试 / 退避 幂等协同瞬时失败靠篇十一的退避重试有副作用的工具靠篇八的幂等键——两者必须一起设计否则重试两次 下两次单。结构化错误日志沿篇九 L6错误也打结构化日志含租户、工具、错误码、耗时排查才快。跨 Agent 错误传播当 A2A 多 Agent 协作篇十七时错误会跨 Agent 边界传播需要在边界处统一错误模型避免下层细节泄漏成上层事故。相关阅读 → 篇八幂等、篇十一退避重试、篇九 L6 审计。隐藏坑 · 工具级 Schema 版本治理升级困难是另一个隐形杀手一个工具改了入参结构老客户端全挂。版本号 兼容策略工具 manifest 带schemaVersion破坏性变更升主版本并灰度呼应篇十二工具治理 / 状态机。破坏性变更灰度新版本先对白名单租户开放观察错误率再全量——和篇八的老客户端兼容端点是同一思路。企业部署自查清单线检查项必做身份用户身份从上游到 MCP 服务端可验证非 X-User-Id 裸声明必做公网身份audience/issuer 校验防 confused deputy / token passthrough必做多跳预算按租户/工具的成本计量已落地必做企业预算配额/限流/熔断已配置必做错误工具级错误码体系必做错误重试幂等协同、结构化错误日志必做版本工具 schema 版本号 破坏性变更灰度建议诚实边界预算计量用 mock 单价演示真实成本口径以云账单为准避免财务误导。本篇是篇13 的实战补完不重复篇13 已讲的租户隔离与 RBAC。真实聚合脚本、跨 Agent 错误传播示例为待实测项占位待补。
