跳到正文
早期资源档案 · 内容保留供查阅探索设计 Skills →

MCP 2026 迁移前先验 6 项

给准备升级 MCP 2026-07-28 spec / SDK v2 的团队一份 server、client、host 兼容检查清单。

MCP 2026-07-28 release candidate 不是简单换 SDK import。它会影响 host 和 server 怎么声明协议版本、怎么管理状态、怎么做 discovery、怎么让 server 请求用户输入、怎么处理 auth 和 deprecated features。

先建兼容测试线

生产环境先留在官方支持线,等 host 和 server 都通过兼容检查再动默认配置。先用一个非生产 MCP server 测 v2 beta,并列出所有 host、server、transport、SDK 和 auth path。

先证明协议版本

新版请求会在 metadata 里带协议版本、client identity 和 capabilities,server 通过 discovery 暴露能力。日志里必须能看出一次请求走的是 legacy 还是 modern 路径。

  • host 和 server 是否能说出同一个 protocol version?
  • gateway 能否不看 body 就正确路由?
  • trace 能否显示这次请求走了哪个协议时代?

把隐藏 session 改成显式句柄

新版 stateless core 移除了 protocol-level session。任何需要连续状态的 workflow,都应该用 task id、browser id、workspace id 这类显式 handle,并说明生命周期、owner、撤销和脱敏规则。

把输入请求当审批面

server-to-client input 应该变成 request-scoped approval path。删除、账号、浏览器、凭证、生产环境相关动作,都要有明确 prompt、schema、request state、retry 行为和审计证据。

不要再基于弃用特性做新流程

Roots、Sampling、Logging 在 deprecation window 里仍然可用,但新产品流程不要继续依赖它们。优先用 tool parameters、resource URI、server config、直接模型 API、stderr 和 OpenTelemetry。

证据齐了再上线

生产 rollout 前,至少留下这些证据:modern request、discovery output、state-handle round trip、input-required approval、issuer-aware auth、以及能串起 host、SDK、MCP server 和下游调用的 trace。

来源

MCP 2026-07-28 迁移检查清单