一句话:MCP 从“双向有状态”变成了“请求/响应无状态”
2026 年 7 月 28 日,MCP 发布了自远程传输上线以来最大的一次修订。官方博客给它的定义很直接:stateless protocol core——MCP 不再是“先建会话、再在同一连接上双向通信”的协议,而是每个请求自带上下文、可以落到任意实例上的请求/响应协议。
这不是一次普通的版本升级。它同时改了传输模型、服务端到客户端的请求方式、授权默认值和扩展机制。对正在写 MCP Server 的人,最实际的问题是:
- 新 Server 还要不要按
initialize/Mcp-Session-Id写? - 已有的远程 Server 要不要马上迁?
- 本地 stdio Server 能不能先不动?
- Tasks、MCP Apps、Enterprise Managed Authorization 这些扩展,什么时候该用?
先给结论:新远程 Server 直接按 2026-07-28 写;已有远程 Server 排期迁移;本地 stdio Server 可以晚一点,但不要再按旧的 session 模型设计新功能。
五个变化
1. 没有 handshake,也没有协议级 session
旧版 MCP 的远程连接通常从 initialize / initialized 开始,之后靠 Mcp-Session-Id 把同一客户端的请求绑到同一个服务端实例。新版把这两件事都移除了:
- 每个请求通过
_meta携带协议版本、客户端身份和客户端能力; - 客户端如果确实想先了解服务端能力,可以调用新的
server/discover,但这不是必须的前置步骤; - 任何请求都可以落到普通 round-robin 负载均衡后面的任意实例,不需要共享 session 存储。
这意味着 MCP Server 更接近普通 HTTP 服务:无状态、可水平扩展、可放在 API Gateway 后面。代价是原来藏在 transport 里的会话状态必须显式化。
2. Header 路由:网关不用再解析 JSON Body
新规范要求 Streamable HTTP 请求带上:
Mcp-Method: tools/call
Mcp-Name: search
Mcp-Method 是 JSON-RPC 方法名,Mcp-Name 是工具名或资源名。网关、限流器、WAF 可以直接按 header 路由和鉴权,不必先解析 JSON Body。
对做企业网关的人是好事;对直接暴露在公网、没有网关的 Server,则要确保这两个 header 不被代理丢掉或改写。
3. MRTR:服务端不再主动“打断”客户端
旧版里,Server 可以在一个长连接上发起 elicitation/create、sampling/createMessage 或 roots/list,要求客户端补充输入。新版用 Multi Round-Trip Requests(MRTR) 替代:
- Server 在一次调用中返回
resultType: "input_required",并列出它需要客户端回答的请求; - 客户端把答案放进
inputResponses,重试原始调用; - 整个过程仍然是请求/响应,不需要一直挂着双向流。
这解决了无状态协议下“工具执行到一半要问用户”的问题,但也要求客户端和 Server 都改成“可重试”的调用模型。把 MRTR 当成一次普通重试来设计,比试图恢复旧的长连接更稳。
4. List 结果可缓存,Tasks 进入扩展
tools/list、prompts/list、resources/list 和 resources/read 现在可以带 ttlMs 和 cacheScope。客户端可以缓存工具目录,减少重复拉取;Server 要保证缓存失效策略和工具版本一致。
Tasks 从实验性核心移到了 io.modelcontextprotocol/tasks 扩展,提供基于轮询的 tasks/get 和新的 tasks/update。长任务不再需要靠“一直占着连接”来表达,Server 可以先把任务放到后台,再让客户端轮询状态。
5. 授权硬化,旧能力进入弃用窗口
授权是这次修订里最容易被低估的部分:
- 授权服务器应返回 RFC 9207 的
iss,客户端必须校验,防止 authorization server mix-up; - Dynamic Client Registration(DCR)正式弃用,转向 Client ID Metadata Documents(CIMD);DCR 仍兼容,但会在未来版本移除;
- 客户端凭据绑定签发它的 issuer,不能跨授权服务器复用;
- Roots、Sampling、Logging 和 legacy HTTP+SSE 传输进入弃用,至少保留 12 个月。
如果你的 Server 依赖 DCR、Roots 或 Sampling,迁移不是“改个版本号”,而是要重新设计授权和输入获取路径。
影响矩阵:谁现在就该动
| 角色 | 影响 | 建议 |
|---|---|---|
| 新远程 Server | 没有历史包袱 | 直接按 2026-07-28 写,不要复制旧 quickstart |
| 已有远程 Server | session、SSE、DCR 可能都要改 | 排期迁移,先做兼容层再切主版本 |
| 本地 stdio Server | 不经过 HTTP/session,影响较小 | 可以先不动;新功能不要依赖旧 session 模型 |
| API Gateway / WAF | 需要识别 Mcp-Method / Mcp-Name |
更新路由、限流和审计规则 |
| 多租户 SaaS | 无状态后更容易扩,但状态要显式化 | 用工具返回的 handle 传递会话,不要藏 transport state |
| 企业 IdP | DCR → CIMD、issuer 校验 | 和身份团队一起改授权流程 |
一个常见误判是“本地 stdio 没事,所以整个项目不用管”。如果你的代码同时支持 stdio 和远程 transport,SDK 升级后仍可能遇到接口变化;至少要把 transport 层和业务层分开测试。
迁移清单
第 1 步:盘点版本和 transport
先列出:
- 使用的 SDK 和版本(TypeScript / Python / Go / C# / Rust);
- 是否使用 Streamable HTTP、legacy HTTP+SSE 或 stdio;
- 是否有
Mcp-Session-Id、共享 session store、粘性负载均衡; - 是否依赖 Sampling、Roots、Logging、DCR。
没有这张表,后面的迁移会变成“改到哪算哪”。
第 2 步:升级 Tier 1 SDK,先读 migration notes
官方 Tier 1 SDK(TypeScript、Python、Go、C#)已经支持 2026-07-28,Rust SDK 处于 beta。先升级 SDK,再改业务代码;不要自己手写 JSON-RPC 兼容层。
升级后先跑现有测试,记录失败项。失败通常集中在三类:session 初始化、server-initiated request、授权回调。
第 3 步:把 session 状态显式化
如果 Server 原来在 session 里存用户偏好、购物车、临时文件句柄,现在要改成:
- 工具返回一个显式 handle(例如
cart_id、job_id); - 模型在后续调用中把 handle 作为参数传回;
- Server 用 handle 查持久化存储,而不是从 transport 里猜。
官方博客的建议很明确:让模型看见 handle,比把状态藏在 transport 里更好。这样任务可以跨实例、跨重试、跨客户端继续。
第 4 步:给网关加 header 路由
在 Gateway / WAF / 限流层识别:
Mcp-Method: tools/call
Mcp-Name: search
同时检查代理是否保留这两个 header,是否会把它们当成普通自定义 header 丢掉。对按 body 解析的旧网关,这是必须改的一层。
第 5 步:把 server-initiated request 改成 MRTR
把 elicitation/create、sampling/createMessage、roots/list 的调用点找出来,改成:
- Server 返回
resultType: "input_required"; - 客户端收集答案;
- 客户端带
inputResponses重试原调用。
客户端要保证重试幂等;Server 要保证同一个 input_required 不会被重复执行副作用。
第 6 步:更新授权
- 校验
iss(RFC 9207); - DCR 客户端设置
application_type,避免 localhost redirect 被拒; - 新接入优先用 CIMD,不要把 DCR 当长期方案;
- 客户端凭据绑定 issuer,不要跨授权服务器复用。
如果企业 IdP 还没支持 CIMD,可以保留 DCR 兼容,但要在迁移计划里写明移除时间。
第 7 步:加缓存和可观测性
给 list 结果加 ttlMs / cacheScope,并在日志里记录:
- 请求命中的实例;
Mcp-Method/Mcp-Name;- 是否发生 MRTR 重试;
- Tasks 的轮询次数和完成时间;
- 缓存命中率。
无状态协议的排障方式和有状态连接不同:你不能再靠“这个 session 在哪台机器上”来定位问题,只能靠请求级 trace。
五个常见坑
坑 1:把 session 状态藏在 transport 里
无状态之后,任何“默认同一个连接就是同一个用户”的假设都会失效。状态要么放进工具参数,要么放进显式 handle,要么放进服务端持久化,并且能被任意实例读取。
坑 2:继续依赖长连接 SSE
legacy HTTP+SSE 已进入弃用窗口。新实现不应该再假设有一条长时间保持的流;需要进度就用 Tasks,需要补充输入就用 MRTR。
坑 3:工具目录缓存没有失效策略
tools/list 可以缓存,但工具版本、权限和租户配置会变。缓存 key 至少要包含租户、权限范围和工具版本;否则用户会看到已经下线的工具。
坑 4:DCR 还能用,就以为不用改
DCR 仍然兼容,但已正式弃用。新项目继续用 DCR,会在未来版本被迫迁移;企业 IdP 的 CIMD 支持应该现在就开始评估。
坑 5:把 MRTR 当成“再发一次请求”
MRTR 的重试必须幂等。如果第一次调用已经扣款、发邮件或创建了资源,第二次重试不能重复执行。用 request id + 状态机,而不是简单重放。
什么时候不该马上迁
不是所有 Server 都值得在这个月迁移。以下情况可以先等:
- 你的客户端或宿主平台还锁在旧版 SDK,升级会破坏现有集成;
- 你只做单用户本地 stdio Server,没有远程部署和多实例需求;
- 你深度依赖 Sampling / Roots,且短期内没有替代方案;
- 你没有网关、没有多实例、没有会话恢复需求,旧版运行稳定。
但“先不迁”不等于“继续按旧模型写新功能”。新功能应该避开已弃用的能力,至少把代码结构留出迁移空间。
行动建议
如果你要动手,按这个顺序:
- 用 MCP Inspector 指南 检查当前 Server 的 transport 和工具目录;
- 读 MCP 协议 2026 更新追踪 了解这次修订在全年路线中的位置;
- 看 MCP Server 生态盘点 判断你该自建还是接现成 Server;
- 如果你想把 MCP 放进一个真实项目,参考 OpenClaw 案例 的本地工具接入思路。
MCP 的无状态化不是“为了优雅”,而是为了让 Agent 工具真正跑在普通 Web 基础设施上。越早把 session 状态显式化,后面越少返工。