API 网关
API 网关
文档指南
请输入
- 文档首页
API 网关用户指南插件中心流量管控MCP 会话保持插件
复制全文
下载 pdfMCP 会话保持插件
文档反馈
问问助手MCP 会话保持插件支持基于 MCP 协议的多实例会话保持。本文介绍如何配置 MCP 会话保持插件。
背景信息
什么是 MCP 会话保持
MCP 会话保持是指，在在多实例 MCP Server 部署架构中，确保同一客户端发起的所有请求（包括 SSE 长连接和后续 HTTP 请求）始终被路由到同一个后端服务实例。其核心机制是基于 MCP-Session-Id 头字段进行一致性路由，而非传统的轮询或随机负载均衡。
在生产环境中使用基于 SSE 的 2024-11-05 版本 MCP 协议时，存在如下问题：
- 连接绑定实例
- SSE 是 HTTP 长连接，服务器需在内存中维护连接状态。
- 连接只能由建立时的实例持有。
- 没有内建会话共享机制
- 原生 SSE 没有像 WebSocket 那样支持 Session 重绑定或分布式路由。
- 请求随机转发到其他实例，会导致消息丢失、错误响应或连接失效
- 后续客户端请求若落到 ServerB（而不是原来的 ServerA），就无法访问 SSE 的连接状态。
- 实例 B 查不到 Session，就会响应错误或重新建立一个连接，造成状态错乱或重复连接。
MCP 会话保持插件支持会话保持能力，在后端对接多个 MCP Server 实例时，通过 MCP-Session-Id 进行会话保持，让 MCP 调用始终能保持在相同的实例上。
前提条件
- 已创建网关实例，详情请参见 创建实例。
- 已将网关实例升级至 3.2.0 及以上版本，详情请参见 版本管理。
- 已创建服务，详情请参见 创建服务。
- 已创建路由，详情请参见 创建路由。
使用限制
- 同一插件在同一资源上只能绑定一次。
- MCP 会话保持功能必须与函数服务（veFaaS ）产品配合使用。
- 在同一路由中，LLM 负载感知路由插件、LLM Session 亲和路由插件 和 MCP 会话保持插件 互斥，不能同时开启。
操作步骤
- 登录 API 网关控制台。
- 在顶部导航栏，选择目标地域。
- 在左侧导航栏 实例管理 下拉框中选择目标实例后， 单击 插件中心 > 流量管控 > MCP 会话保持插件。
- 单击 创建插件，配置插件参数。
-
- 配置项说明生效级别选择 MCP 会话保持插件的生效级别，当前仅支持 路由级别。所属实例在下拉菜单中选择插件所属 APIG 网关实例。所属服务在下拉菜单中选择插件所属服务。所属路由在下拉菜单中选择插件所属路由。备注您可以根据业务需要选择是否编辑备注内容，例如插件用途等，便于后期识别。
- 单击 确定，完成配置。
查看配置
配置完成后，在插件列表中，查看已配置的插件，若插件状态为 已启用，表示插件已生效。
最近更新时间：2026.08.17 14:17:46
这个页面对您有帮助吗？
有用
有用
无用
无用