动态:一手资料追踪

MCP 2026-07-28 正式版:无状态核心、Tasks 扩展与迁移清单


一句话: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 的调用点找出来,改成:

  1. Server 返回 resultType: "input_required";
  2. 客户端收集答案;
  3. 客户端带 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,且短期内没有替代方案;
  • 你没有网关、没有多实例、没有会话恢复需求,旧版运行稳定。

但“先不迁”不等于“继续按旧模型写新功能”。新功能应该避开已弃用的能力,至少把代码结构留出迁移空间。


行动建议

如果你要动手,按这个顺序:

  1. 用 MCP Inspector 指南 检查当前 Server 的 transport 和工具目录;
  2. 读 MCP 协议 2026 更新追踪 了解这次修订在全年路线中的位置;
  3. 看 MCP Server 生态盘点 判断你该自建还是接现成 Server;
  4. 如果你想把 MCP 放进一个真实项目,参考 OpenClaw 案例 的本地工具接入思路。

MCP 的无状态化不是“为了优雅”,而是为了让 Agent 工具真正跑在普通 Web 基础设施上。越早把 session 状态显式化,后面越少返工。