操作场景
当您的 MCP 网关使用多个数据面节点（多副本）对外提供服务时，MCP 客户端通过 SSE 或 Streamable HTTP 协议建立的会话（Session）默认仅保存在单个节点的内存中。一旦后续请求被负载均衡路由到其他节点，会话信息会丢失，导致连接中断或会话失效。
通过为 MCP 服务开启分布式会话缓存，网关会将会话状态统一存储到外部 Redis，使任意节点都能识别并处理同一会话的请求，从而保障多节点环境下 SSE / Streamable HTTP 长连接的稳定性。
前提条件
已创建云原生 AI 网关实例。
已创建 MCP Server，且传输协议为 SSE 或 Streamable HTTP。
已准备一个网关可访问的 Redis 实例（建议与网关同 VPC），并获取其连接地址、端口、用户名及密码。
操作步骤
1. 登录 云原生 API 网关控制台，进入目标网关实例。
2. 在左侧菜单选择 MCP 管理 > MCP 服务，进入 MCP 服务列表页面。
3. 单击新建按钮，完成「基本信息」和「后端服务配置」后，进入到「会话管理」配置页面。
4. 会话存储模式：内存模式/Redis 持久化
参数 | 是否必填 | 取值范围 / 默认值 | 说明 |
地址（Host） | 是 | 有效的 IP 或域名 | Redis 实例连接地址 |
端口（Port） | 是 | 1–65535，默认 6379 | Redis 服务端口 |
用户名（Username） | 否 | 字符串，可留空 | Redis 6.0+ ACL 用户名 |
密码（Password） | 否 | 字符串 | Redis 访问密码 |
5. 单击 保存，配置即时生效。
相关说明
会话有效期（TTL）：会话在 Redis 中默认保留 30 分钟（1800 秒），超时后自动失效，当前为固定值。
适用协议版本：SSE 协议采用
2024-11-05 版本，双端点为 GET /sse（建立连接）与 POST /message（消息传输）。切换为 Redis 存储后，已建立的旧会话不会自动迁移，建议在业务低峰期操作。
若 Redis 不可达，新会话将无法建立，请确保网络连通性与鉴权信息正确。
