首页/新闻资讯/正文详情

MCP 实战手记(十三):MCP多租户隔离,一个网关服务多个团队

发布时间:2026/11/16 20:35:23 来源:云帆数科 栏目:资讯中心
MCP 实战手记(十三):MCP多租户隔离,一个网关服务多个团队
前置篇六自建 MCP 网关、篇八无状态生产落地、篇九6层安全防护技术基线MCP Java SDK 2.0.0非 Spring AI同篇六网关多租户在传输拦截器层实施不依赖 Spring AI 注解实测环境本地 Docker 内置 k8s双网关实例 Redis本文实测项均在该环境验证引子网关接了第三个团队开始串味篇六我把网关搭起来了门店运营的工具先挂上去跑得挺好。后来供应链团队说我们也想用再后来财务团队也来了。第三个团队接进来那天出了两件事财务的gen_finance_report被供应链误调——不是故意是工具目录没隔开搜出来就点了供应链写了个脚本狂刷get_inventory把门店那边的配额全吃光门店大促时调不动。这一刻我懂了一个网关服务多团队不隔离就是事故。本文就讲怎么在已有网关上把多租户这层补上——租户路由、凭证隔离、配额、数据隔离四件套。范围说明本文是逻辑隔离单网关按 tenantId 过滤实例级强隔离只在对比里提不展开部署。预算计量、错误处理属于另一回事见配套散点文。一、为什么需要多租户动机说明成本一套网关养多个团队远比每团队各起一套省运维隔离工具、权限、数据、配额都按租户隔开互不串味合规财务/HR 这类敏感租户出了泄漏能定位到哪个租户不隔离的三类后果正是引子里的真实事故串调工具可见性、超额配额、泄漏数据。下面四个小节一一对应解决。二、三种多租户方案对比方案做法隔离强度成本适用共享实例逻辑隔离单网关一切按tenantId过滤中同进程最低本文做法绝大多数企业够用实例级隔离每租户独立网关实例 / 命名空间高进程级高强合规金融/政务混合核心租户独立实例 长尾共享高中多数中大型企业选共享实例逻辑隔离因为它改动最小、复用篇六网关、且配额/凭证天然能集中。实例级隔离只是把逻辑换成物理过滤逻辑一样本文不重复。三、租户路由请求怎么认出是哪个租户传递方式三选一推荐第三种API Key 隐含 tenantIdKey 查表得租户——简单但 Key 轮换时要同步映射独立头X-Tenant-Id——直观但客户端要配合带Token claim 带 tenantOAuth 2.1 / IdP 签发时塞tenantclaim——最干净与篇九 L2/L3 身份体系打通。本文用方案 12 组合演示Key 映射为主X-Tenant-Id为辅覆盖服务间调用生产建议升级到方案 3。在传输层提取 tenantId实测落地版代码见13-multitenant/TenantFilter.java// 传输层拦截每个请求先解析租户缺失/非法直接拒再做配额计数ComponentpublicclassTenantFilterextendsOncePerRequestFilter{privatefinalTenantStorestore;privatefinalQuotaServicequota;OverrideprotectedvoiddoFilterInternal(HttpServletRequestrequest,HttpServletResponseresponse,FilterChainchain)throwsServletException,IOException{StringapiKeyfirstNonBlank(request.getHeader(X-Api-Key),request.getHeader(X-Tenant-Id));TenantProperties.TenantDeftenantstore.resolve(apiKey);// Redis 查映射if(tenantnull){reject(response,401,unknown tenant);return;}if(POST.equalsIgnoreCase(request.getMethod())!quota.allow(tenant)){reject(response,429,tenant quota exceeded);return;}MDC.put(tenant,tenant.getId());// 日志全链路带租户TenantContext.set(tenant.getId());// 下游拦截器/工具可取try{chain.doFilter(request,response);}finally{TenantContext.clear();MDC.remove(tenant);}}}✅已实测核对结论与初稿假设不同MCP Java SDK 2.0.0不提供ServerTransportInterceptor接口——篇六网关实际用的是HttpServletStatelessServerTransportMcpServer.sync(...)SDK 暴露的是 transport provider不是拦截器。因此按预案把拦截等价迁移到 Servlet Filter位置同样在传输层逻辑完全一致解析租户 → 拒非法 → 配额 → 写上下文/日志。若后续 SDK 提供装饰器式扩展点把这四步搬过去即可业务代码零改动。四、凭证隔离不同租户不同 API Key每个租户签发独立 KeyKey→tenantId 映射存 Redistenant:key:{hash}→ tenantId。吊销/轮换删 Redis 键即生效无需重启网关——这是 Redis 集中存的好处。与篇九L2 客户端身份衔接本文的 Key 是客户端身份那一层租户内的用户身份走篇九 L3X-User-Id / ID-JAG。// 凭证签发与校验示意Stringkeysk-TenantId-random32();redis.opsForValue().set(tenant:key:hash(key),tenantId,Duration.ofDays(90));// 90天过期// 校验拦截器里 resolve(apiKey) 命中即过未命中 401五、配额管理别让一个租户刷爆这是引子里供应链刷爆门店配额的直接解。计数放 Redis天然跨实例一致——呼应篇八“多实例下状态要外置”配额计数属于下一次请求打到另一个实例还必须对的数据所以必须进 Redis。固定窗口配额Redis Lua 原子自增 TTL非真滑动窗口// 固定窗口窗口60s TTL首调用起算每次自增会续期 TTL故是固定窗口而非真滑动窗口// 真滑动窗口需用 ZSET 记每次时间戳本文为可读性用固定窗口近似生产可按精度升级Stringlua local cnt redis.call(INCR, KEYS[1]) if cnt 1 then redis.call(EXPIRE, KEYS[1], 60) end return cnt ;Longnowredis.eval(lua,List.of(quota:tenantId:toolName),List.of());if(nowlimit)thrownewQuotaExceededException(429,tenant quota exceeded);超限返回429与篇九L5 限流一致limit按租户配置长尾租户低配、核心租户高配。多实例一致性因为计数在 Redis两个网关副本Docker/k8s 双实例看到的是同一份数字——不会出现副本A 限了、副本B 还放的裂隙。这恰好是篇八会话数据外置思想在配额上的落地。✅已实测双副本 Redis起两个网关副本18080/18081本机 8080 被占故改用高位端口 共享 Redis从副本A 连续打满门店租户配额limit20 / 窗口60s副本B 立即同样 429——实测输出GW1 hit 1~20 - 200 GW1 hit 21~23 - 429 GW2 store - 429 # 同一租户计数在 Redis换副本同样被限 GW2 supply - 200 # 未超限租户不受影响证明是租户级而非全局限流故障演练Redis 挂了怎么办两种策略——fail-open放行保可用适合内部可信或fail-closed全拒保隔离适合多租户公网。本文选按租户分级核心租户 fail-closed长尾租户 fail-open。配置示例# 配额降级策略按租户分级 quota.failover.policy.coreclosed # 核心租户Redis 不可用时全拒保隔离 quota.failover.policy.longtailopen # 长尾租户Redis 不可用时放行保可用六、数据隔离日志 / 配置 / 缓存类型做法日志MDC 带tenant按租户分索引敏感租户财务/HR行级脱敏后再落盘配置租户级配置命名空间cfg:{tenantId}:...避免共享 map 串改缓存所有缓存 key 前缀tenant:{id}:即使同 key 不同租户也不串与篇八会话数据外置 Redis同一套键规范redis.opsForValue().set(tenant:tenantId:ctx:sessionKey,ctx,Duration.ofMinutes(30));七、实战在现有网关上加多租户拓扑本地 Docker 内置 k8s 验证环境┌──────────── LB / Ingress ────────────┐ │ │ client ──┤ gw-1 (MCP 网关副本1) ┐ │ │ gw-2 (MCP 网关副本2) ├─ 共享 ── Redis租户映射 配额计数│ │ (k8s Deployment 2副本)┘ │ └───────────────────────────────────────┘两个网关副本无状态篇八状态全在 Redis扩副本只改replicas隔离逻辑不变。改造步骤清单引入TenantTransportInterceptor所有请求先解析租户接 Redis 存 Key→tenant 映射与配额计数工具目录按租户过滤租户只能 list 到自己被授权的工具——防引子的误调MDC 缓存 key 前缀接入双副本部署跑配额一致性 故障演练。目录过滤是关键引子事故①财务工具被供应链误调的根因是目录没隔开。租户 list 工具时网关只返回该租户allowed_tools集合内的工具——看不见就点不到。✅已实测以上拓扑与演练已跑通真实输出如下本机双副本 Redis 容器。 1) 租户路由 no-key - 401 bad-key - 401 store - 200 2) 目录隔离看不见就点不到 store 目录: {tools:[get_store_sales,get_inventory],tenant:store} finance 目录: {tools:[gen_finance_report],tenant:finance} PASS: 门店目录已过滤不含 gen_finance_report 3) 凭证隔离 supply - get_store_sales - 403 5) 故障演练Redis 不可用按租户分级 finance(closed) - 429 # 核心租户全拒保隔离 supply(open) - 200 # 长尾租户放行保可用 恢复 Redis 后 - 200 # 自愈无需重启八、诚实边界mTLS 未实测租户间传输加密依赖篇九L1本文不重复本机未跑真实证书体系。实例级隔离未展开仅对比提及强合规场景的部署成本需另文。真实压测待补双副本下的配额吞吐基线P95待压测填充避免拍脑袋给数字。SDK API 已核对MCP Java SDK 2.0.0 无ServerTransportInterceptor接口第三节已按预案改为 Servlet Filter 落地并实测跑通结论见该节。预算计量不在此篇按租户成本归因见配套散点文三大坑·坑二。九、与全季的关系 多租户自查清单互链点击跳转对应篇章→ 篇六自建 MCP 网关本文在其基础上加租户层不重造网关。→ 篇八无状态生产落地双副本无状态 状态外置 Redis思路同源。→ 篇九6层安全防护Key 是 L2 客户端身份租户内用户身份走 L3。→ 散点文《企业级 MCP 部署三大坑》待发布预算坑二、错误码坑三、Schema 版本隐藏坑是本文未覆盖的企业部署另一半。多租户自查清单项必做请求能可靠解析 tenantId缺失/非法即拒必做每租户独立凭证可独立吊销必做工具目录按租户过滤看不见点不到必做配额计数跨实例一致Redis 集中必做超限返回 429 降级策略fail-open/closed 分级必做日志/缓存按租户隔离、敏感租户脱敏必做双副本 failover 演练过建议一句话收尾多租户不是再起一套而是在同一套网关上把 tenantId 当成第一公民——路由认租户、凭证分租户、配额限租户、数据隔租户。四件套做完一个网关就能安稳服务好几个团队。代码已开源本篇四件套实现见13-multitenant/模块Spring Boot 4.0.0 Java 21 Redistagv13—— Gitee / GitHub。mvn clean package后docker compose up -d起双副本./verify-multitenant.sh一键复现上文全部实测输出觉得有用欢迎 star。相关阅读第二季 · 企业级 MCP 生产落地篇六自建 MCP 网关本文多租户层直接搭在它上面篇八无状态MCP Server生产落地清单双副本无状态 状态外置 Redis思路同源篇九生产化MCP Server的6层安全防护Key 是 L2 客户端身份租户内用户身份走 L3篇十二企业级Toolbox治理同季前作工具治理与多租户是企业落地的两块拼图本篇 tenantId 字段即由它定义

相关推荐

C#上位机四路相机Halcon OCR实时采集与多线程避坑实战
C#上位机四路相机Halcon OCR实时采集与多线程避坑实战

简介:这份资源面向具备一定C#与机器视觉基础的开发者,聚焦多相机实时OCR采集场景,提供一套可直接运行的上位机工程代码。项目基于C#联合Halcon实现四路相机同步采集与字符识别,涵盖图像尺寸获取、窗口显示区域设置、ROI矩形区域生… · 2026/11/4 10:18:57

SpringBoot+MybatisPlus智慧校园源码:从解压部署到避坑实践
SpringBoot+MybatisPlus智慧校园源码:从解压部署到避坑实践

简介:基于SpringBoot与MyBatis-Plus打造的智慧校园管理系统,是一份高分通过的期末大作业与课程设计源码,面向Java初学者、高校学生,以及需要完成毕设或实训项目的开发者,也可作为日常练习的完整参考样例。资源包共82个… · 2026/11/16 7:46:49

几十个角色、几十条命令是工程化还是过度设计?一场正在发生的路线之争
几十个角色、几十条命令是工程化还是过度设计?一场正在发生的路线之争

几十个角色、几十条命令是工程化还是过度设计?一场正在发生的路线之争 【免费下载链接】Claude-Code-Game-Studios Turn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio… · 2026/11/15 18:42:24

库尔勒电工证退600 良心建议:考不过白交培训费怎么办?
库尔勒电工证退600 良心建议:考不过白交培训费怎么办?

库尔勒电工证退600 良心建议:考不过白交培训费怎么办? 怕考不过白交培训费?别急,库尔勒电工证退600的政策其实早就存在,但很多人并不清楚。今天我就从一个干了十年特种作业证培训的老手角度,讲讲怎么在考电工证之前避开坑,把钱花在刀刃上,还别… · 2026/11/16 20:35:02

丹东电工证复检多少钱?全国通用怎么考别被中介坑
丹东电工证复检多少钱?全国通用怎么考别被中介坑

丹东电工证复检多少钱?全国通用怎么考别被中介坑 你是不是也遇到过这种情况?手里攥着一张电工证,想在外地干活,结果被告知“这证不行,得重新考”。其实不是你的证有问题,是 全国通用 的证书在不同地方可能有不同的“说法”,尤其是像… · 2026/11/16 20:35:02

即墨电工证补办怎么操作?学历不高也能拿全国通用证书
即墨电工证补办怎么操作?学历不高也能拿全国通用证书

即墨电工证补办怎么操作?学历不高也能拿全国通用证书 你是不是也担心学历不高,根本报不了名?别急,我这有实操经验,今天就给你讲清楚【即墨电工证补办】怎么搞,还能拿全国通用的证书,别让学历限制了你的选择。… · 2026/11/16 20:35:02

电工证在什么上面查询怎么查电子证书
电工证在什么上面查询怎么查电子证书

电工证在什么上面查询怎么查电子证书 你是不是也遇到过这种情况,刚听说要考电工证,结果网上一搜信息五花八门,不知道该相信哪家,更怕被中介坑了钱还拿不到证?别担心,这篇文章就是为了解决“ 电工证在什么上面查询… · 2026/11/16 20:35:02

电工培训班 电工证电子证书查询
电工培训班 电工证电子证书查询

工地太忙根本没时间复习考试?电工培训班电工证怎么报名全攻略 工地太忙根本没时间复习考试,这话听起来像是每个建筑工人的日常。尤其是像你这样在开封从事建筑工作的电工,既要赶工期,又要兼顾电工证考试,压力真的不小。别急,… · 2026/11/16 20:35:01

松原考特种电工证怎么考?工地太忙根本没时间复习考试?良心建议在这
松原考特种电工证怎么考?工地太忙根本没时间复习考试?良心建议在这

松原考特种电工证怎么考?工地太忙根本没时间复习考试?良心建议在这 工地太忙根本没时间复习考试,你不是一个人。在新乡从事水利工程的你,天天在工地上跑,连喘口气的时间都没有,更别说腾出时间来准备特种电工证的考试了。 良心建议… · 2026/11/16 20:34:01

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/16 3:21:55

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/16 3:01:18

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/16 8:30:17

电工证培训的通知在哪考?别再被中介骗了
电工证培训的通知在哪考?别再被中介骗了

电工证培训的通知在哪考?别再被中介骗了 你是不是还在为 电工证培训的通知在哪考 发愁?网上搜了一堆信息,结果要么是挂羊头卖狗肉的培训机构,要么就是打着“包过”旗号的骗子?别急,今天我来给你讲讲, 电工证培训的通知… · 2026/11/16 0:00:34

高级电工证企业认可吗保姆级教程:实操考试心里没底怕挂科?看完这些建议再考不迟
高级电工证企业认可吗保姆级教程:实操考试心里没底怕挂科?看完这些建议再考不迟

高级电工证企业认可吗保姆级教程:实操考试心里没底怕挂科?看完这些建议再考不迟 你是不是也这样,站在高压电工实操考试的设备前,手心冒汗,生怕一个操作失误就被判不合格?实操考试心里没底怕挂科,这是很多准备考高级电工证的人的真实写照。别担心,今天… · 2026/11/16 0:00:34

电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享
电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享

电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享 怕考不过白交培训费?你不是一个人,信阳的李师傅去年刚转岗做电工,就因为没搞清楚电工证去哪个部门考核,差点交了8000块的培训费。别急,下面这份实操考试全攻略,告诉你电工证到底值不值得考… · 2026/11/16 0:00:34

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/16 16:48:43

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/16 16:48:57

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/16 16:48:48

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码