New Hot

MCP 规范 2025-11-25 更新:新增 OAuth 发现、工具图标与采样工具调用等多项新增能力

MCP协议规范授权版本更新

MCP 规范发布 2025-11-25 版本,新增 OAuth 授权发现、工具与资源图标、增量范围授权以及采样工具调用等能力。面向维护 MCP 服务器与客户端的开发者,新规范已在官方 changelog 公布,可按清单逐项对照迁移,并按自身节奏逐步落地。

MCP 2025-11-25 新增 OAuth 发现与采样工具调用

MCP 规范发布 2025-11-25 版本,集中补充授权发现、工具元数据与采样工具调用等能力。 官方 changelog 把变化分为主要、次要、schema 与治理四类。(来源:MCP 官方规范更新日志)

授权与客户端注册

授权服务器发现开始支持 OpenID Connect Discovery 1.0,并引入通过 WWW-Authenticate 的增量范围授权。OAuth Client ID Metadata Documents 被列为推荐的客户端注册机制;受保护资源元数据发现与 RFC 9728 对齐,WWW-Authenticate 头改为可选并回退到 .well-known 端点。官方原文称:“Enhance authorization server discovery with support for OpenID Connect Discovery 1.0.”

工具、资源与采样

服务器可以为工具、资源、资源模板与提示暴露图标,作为额外元数据。采样新增工具调用支持,通过 tools 与 toolChoice 参数传入。官方还补充了工具命名指引,并把输入校验错误明确为工具执行错误,方便模型自我纠正。

schema 与治理

ElicitResult 与 EnumSchema 改用更贴近标准的写法,支持带标题与不带标题、单选与多选枚举,并新增 URL 模式 elicitation。JSON Schema 2020-12 成为 MCP schema 定义的默认方言,请求负载也从 RPC 方法定义中拆成独立参数 schema。治理方面,官方正式化了治理结构、工作组与兴趣小组,并建立 SDK 分层体系。

授权链路与 JSON Schema 方言需要跟进迁移

维护 MCP 服务器或客户端的开发者需要关注授权流程与 schema 方言的变化。 图标、采样工具调用与任务支持属于新增能力,可以按需接入。

授权实现要跟进

增量范围授权与 OAuth 元数据发现的变化会影响登录与授权链路,尤其是自建授权服务器的项目。

schema 与请求结构有迁移量

独立参数 schema 与 JSON Schema 2020-12 默认方言,会让依赖旧结构的生成代码需要调整。从官方描述看,这类变化对代码生成与校验工具影响更直接。

新能力可以分批接入

图标元数据、URL 模式 elicitation 与实验性任务支持都不是强制项,可以跟着产品节奏分批落地。同期 OpenAI Agents SDK 0.25.0 的更新 也涉及 MCP v2,可以一起对照。

没有统一迁移脚本,需按 changelog 逐项对照

按官方 changelog 逐项对照即可,本次没有给出统一的迁移脚本。 具体落地时间以各 SDK 为准。

谁需要尽快跟进

实现授权服务器、做 MCP 客户端注册或依赖 schema 生成的项目优先级更高。只做基础工具调用的服务器可以稍后跟进。

怎么升级

按官方 2025-11-25 规范与对应 SDK 版本升级,先对照主要与次要变更清单。任务、URL elicitation 等实验性能力可以留到后续迭代。

兼容与回退

官方未披露回退步骤。从官方描述看,治理与 SDK 分层属于流程性更新,对运行时影响有限;协议字段变化则需要逐个验证。同批发布的 LangGraph 1.2.22 也是生态侧的常规更新,可以对照阅读。

常见问题

MCP 规范 2025-11-25 主要更新了什么?
新增授权服务器发现、工具与资源图标、增量范围授权、采样工具调用与实验性任务支持。
MCP 这次更新会影响授权流程吗?
会。授权服务器发现支持 OpenID Connect Discovery 1.0,并新增增量范围授权。
MCP 规范这次有破坏性变更吗?
官方把请求负载拆成独立参数 schema,并确定 JSON Schema 2020-12 为默认方言。
MCP 新规范现在可以使用了吗?
可以。官方已在 changelog 公布更新清单,具体落地版本以各 SDK 为准。

相关术语

MCP
MCP 是 Model Context Protocol,一套让模型连接外部工具与数据源的开放协议。
elicitation
elicitation 是服务端向用户请求补充信息的机制,本次新增 URL 模式与默认值。
SEP
SEP 是 MCP 的规范提案编号,用于标识一项具体变更的来源。

这篇文章的来源是什么?

文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。

「MCP 规范 2025-11-25 更新」 —— Model Context Protocol

搜索文章

输入关键词,快速查找标题和正文内容。