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 调用始终能保持在相同的实例上。 ## 前提条件 * 已创建网关实例，详情请参见 [创建实例](https://www.volcengine.com/docs/6569/85693)。 * 已将网关实例升级至 3.2.0 及以上版本，详情请参见 [版本管理](https://www.volcengine.com/docs/6569/1657695)。 * 已创建服务，详情请参见 [创建服务](https://www.volcengine.com/docs/6569/85695#.5Yib5bu65pyN5Yqh)。 * 已创建路由，详情请参见 [创建路由](https://www.volcengine.com/docs/6569/179038)。 ## 使用限制 * 同一插件在同一资源上只能绑定一次。 * MCP 会话保持功能必须与函数服务（veFaaS ）产品配合使用。 * 在同一路由中，[LLM 负载感知路由插件](https://www.volcengine.com/docs/6569/1584313?lang=zh)、[LLM ](https://www.volcengine.com/docs/6569/1584316?lang=zh)[Session 亲和路由插件](https://www.volcengine.com/docs/6569/1584316?lang=zh) 和 MCP 会话保持插件互斥，不能同时开启。 ## 操作步骤 1. 登录 [API 网关控制台](https://console.volcengine.com/veapig)。 2. 在顶部导航栏，选择目标地域。 3. 在左侧导航栏 **实例管理** 下拉框中选择目标实例后，单击 **插件中心 \> 流量管控 \> MCP 会话保持插件。** 4. 单击 **创建插件**，配置插件参数。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_158b33b10e7f44ab70ab036d6e8ac51d.png) |配置项 |说明 | |---|---| |生效级别 |选择 MCP 会话保持插件的生效级别，当前仅支持 **路由级别**。 | |所属实例 |在下拉菜单中选择插件所属 APIG 网关实例。 | |所属服务 |在下拉菜单中选择插件所属服务。 | |所属路由 |在下拉菜单中选择插件所属路由。 | |备注 |您可以根据业务需要选择是否编辑备注内容，例如插件用途等，便于后期识别。 | 5. 单击 **确定**，完成配置。 ## 查看配置配置完成后，在插件列表中，查看已配置的插件，若插件状态为 **已启用**，表示插件已生效。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c82d4566121033535354ee75b55a4075.png)