协议版本
原文：协议版本
一句话
MCP 协议使用 YYYY-MM-DD 格式的版本标识符，表示最后一次向后不兼容更改的日期，支持 Draft、Current 和 Final 三种状态。
什么时候翻这页
当你需要了解 MCP 协议版本管理策略、版本协商过程或功能弃用政策时，可查阅此页面。
核心概念
- 版本标识符：采用
YYYY-MM-DD格式，表示最后一次向后不兼容更改的日期 - 版本状态：
- Draft：草稿状态，尚未完成的规范，不建议使用
- Current：当前版本，已准备好使用，可能继续接收向后兼容的更改
- Final：最终版本，已完成且不会再更改的过去规范
- 功能状态：
- Deprecated：已弃用功能，仍属于规范一部分，但计划移除
- 弃用功能会提供迁移路径，并在规范中保留至少12个月或90天（根据快速移除例外政策）
- 当前版本：2025-11-25
怎么做
- 版本协商：在初始化阶段进行，客户端和服务器可能同时支持多个协议版本
- 达成一致：双方必须就单个版本达成一致，用于整个会话
- 错误处理：如果版本协商失败，协议提供适当的错误处理，允许客户端优雅地终止连接
命令 / 配置速查
- 版本协商：在初始化阶段自动进行，无需手动命令
- 弃用功能注册表：deprecated features registry 列出当前已弃用的功能
与 Claude Code / Hello-Agents 的联系
在 Claude Code 中，MCP 作为连接外部工具的桥梁，其版本管理确保了不同版本间的兼容性。Hello-Agents 第10章中讨论的工具集成也依赖于稳定的协议版本，确保 Agent 与外部系统的可靠通信。
初学者易错点
- 误以为版本号会随着每次更新而递增，实际上只有在发生向后不兼容更改时才会更新
- 忽视弃用功能的时间表，可能导致在功能移除后遇到兼容性问题
- 假设客户端和服务器必须使用相同版本，实际上它们可以协商兼容的版本