协议版本：2025-03-26
简介
目的和范围
Model Context Protocol（模型上下文协议）在传输层提供授权能力，使MCP客户端能够代表资源所有者向受限制的MCP服务器发起请求。本规范定义了基于HTTP传输的授权流程。协议要求
授权对于MCP实现是可选的。当支持授权时：- 使用HTTP传输的实现应该遵循本规范。
- 使用STDIO传输的实现不应该遵循本规范，而应从环境中获取凭证。
- 使用其他传输方式的实现必须遵循其协议的安全最佳实践。
标准合规性
本授权机制基于以下已确立的规范，但仅实现其部分功能，以确保安全性、互操作性和简洁性：- OAuth 2.1 IETF 草案
- OAuth 2.0 授权服务器元数据 (RFC8414)
- OAuth 2.0 动态客户端注册协议 (RFC7591)
授权流程
概述
- MCP授权实现必须实现OAuth 2.1，并为保密客户端和公开客户端都采取适当的安全措施。
- MCP授权实现应该支持OAuth 2.0动态客户端注册协议 (RFC7591)。
- MCP服务器应该且MCP客户端必须实现OAuth 2.0授权服务器元数据 (RFC8414)。不支持授权服务器元数据的服务器必须遵循默认的URI方案。
OAuth授权类型
OAuth定义了不同的流程或授权类型，即获取访问令牌的不同方式。每种类型适用于不同的使用场景。 MCP服务器应该支持最适合其目标用户的OAuth授权类型。例如：- 授权码：当客户端代表（人类）终端用户操作时使用。
- 例如，一个代理调用由SaaS系统实现的MCP工具。
- 客户端凭证：客户端是另一个应用程序（非人类）。
- 例如，一个代理调用安全的MCP工具以检查特定门店的库存。无需模拟终端用户。
示例：授权码授权
此示例演示了用于用户认证的OAuth 2.1授权码授权流程。 注意：以下示例假设MCP服务器同时作为授权服务器。然而，授权服务器也可以作为独立的服务部署。 人类用户通过Web浏览器完成OAuth流程，获取一个代表其身份的访问令牌，使客户端能够代表用户操作。 当客户端未提供授权时，服务器必须返回_HTTP 401 未授权_响应。 客户端在收到_HTTP 401 未授权_响应后，启动 OAuth 2.1 IETF 草案 授权流程。 以下演示了使用PKCE的公共客户端基本OAuth 2.1流程。服务器元数据发现
对于服务器能力发现：- MCP客户端_必须_遵循在RFC8414中定义的OAuth 2.0授权服务器元数据协议。
- MCP服务器_应该_遵循OAuth 2.0授权服务器元数据协议。
- 不支持OAuth 2.0授权服务器元数据协议的MCP服务器，_必须_支持回退URL。
服务器元数据发现请求头
MCP客户端在进行服务器元数据发现时，_应该_包含请求头MCP-Protocol-Version: <protocol-version>，以便MCP服务器可以根据MCP协议版本做出响应。
例如：MCP-Protocol-Version: 2024-11-05
授权基础URL
授权基础URL必须通过丢弃任何现有的path组件从MCP服务器URL中确定。例如：
如果MCP服务器URL是 https://api.example.com/v1/mcp，那么：
- 授权基础URL是
https://api.example.com - 元数据端点必须位于
https://api.example.com/.well-known/oauth-authorization-server
无元数据发现服务器的回退方案
对于不实现OAuth 2.0授权服务器元数据的服务器，客户端必须使用以下相对于授权基础URL的默认端点路径：| 端点 | 默认路径 | 描述 |
|---|---|---|
| 授权端点 | /authorize | 用于授权请求 |
| 令牌端点 | /token | 用于令牌交换和刷新 |
| 注册端点 | /register | 用于动态客户端注册 |
https://api.example.com/v1/mcp 的MCP服务器，默认端点将是：
https://api.example.com/authorizehttps://api.example.com/tokenhttps://api.example.com/register
动态客户端注册
MCP客户端和服务器应该支持 OAuth 2.0动态客户端注册协议 ，以允许MCP客户端在无需用户交互的情况下获取OAuth客户端ID。这为客户端自动注册到新服务器提供了一种标准化方式，这对MCP至关重要，因为：- 客户端无法预先知道所有可能的服务器
- 手动注册会增加用户使用难度
- 它允许无缝连接到新服务器
- 服务器可以实施自己的注册策略
- 为该MCP服务器硬编码客户端ID（以及适用时的客户端密钥），或
- 提供一个UI，允许用户输入这些信息（例如，通过服务器托管的配置界面自行注册OAuth客户端后）。
授权流程步骤
完整的授权流程如下所示：决策流程概览
访问令牌使用
令牌要求
访问令牌处理必须符合 OAuth 2.1 第5节 中对资源请求的要求。具体而言：- MCP客户端必须使用授权请求头字段 第5.1.1节：
- 访问令牌不得包含在URI查询字符串中
令牌处理
资源服务器必须按照 第5.2节 描述验证访问令牌。如果验证失败，服务器必须按照 第5.3节 的错误处理要求作出响应。无效或过期的令牌必须返回HTTP 401响应。安全考虑
以下安全要求必须实施：- 客户端必须按照OAuth 2.0最佳实践安全存储令牌
- 服务器应该强制实施令牌过期和轮换
- 所有授权端点必须通过HTTPS提供
- 服务器必须验证重定向URI以防止开放重定向漏洞
- 重定向URI必须是localhost URL或HTTPS URL
错误处理
服务器必须为授权错误返回适当的HTTP状态码：| 状态码 | 描述 | 使用场景 |
|---|---|---|
| 401 | 未授权 | 需要授权或令牌无效 |
| 403 | 禁止 | 范围无效或权限不足 |
| 400 | 错误请求 | 授权请求格式错误 |
实现要求
- 实现必须遵循OAuth 2.1安全最佳实践
- PKCE对所有客户端是强制要求
- 令牌轮换应该实现以增强安全性
- 令牌生命周期应该根据安全要求进行限制
第三方授权流程
概述
MCP服务器可以通过第三方授权服务器支持委托授权。在此流程中，MCP服务器同时作为OAuth客户端（对第三方授权服务器）和OAuth授权服务器（对MCP客户端）。流程描述
第三方授权流程包括以下步骤：- MCP客户端向MCP服务器发起标准OAuth请求
- MCP服务器将用户重定向到第三方授权服务器
- 用户向第三方服务器授权
- 第三方服务器将授权码重定向回MCP服务器
- MCP服务器用授权码换取第三方访问令牌
- MCP服务器生成绑定到第三方会话的自己的访问令牌
- MCP服务器完成与MCP客户端的原始OAuth流程
会话绑定要求
实现第三方授权的MCP服务器必须：- 在第三方令牌和发出的MCP令牌之间保持安全映射
- 在接受MCP令牌之前验证第三方令牌状态
- 实现适当的令牌生命周期管理
- 处理第三方令牌过期和续订
安全考虑
在实现第三方授权时，服务器必须：- 验证所有重定向URI
- 安全存储第三方凭证
- 实现适当的会话超时处理
- 考虑令牌链的安全影响
- 为第三方授权失败实现适当的错误处理
最佳实践
本地客户端作为公共OAuth 2.1客户端
我们强烈建议本地客户端将OAuth 2.1作为公共客户端实现：- 使用代码挑战（PKCE）进行授权请求，以防止拦截攻击
- 根据本地系统实现安全的令牌存储
- 遵循令牌刷新最佳实践以维持会话
- 正确处理令牌过期和续订