授权
简介
目的和范围
模型上下文协议在传输层提供授权能力,使 MCP 客户端能够代表资源所有者向受限的 MCP 服务器发出请求。本规范定义了基于 HTTP 传输的授权流程。
协议要求
授权对于 MCP 实现是可选的。当支持时:
- 使用基于 HTTP 传输的实现应该遵循本规范。
- 使用 STDIO 传输的实现不应该遵循本规范,而应从环境中获取凭据。
- 使用替代传输的实现必须遵循其协议的既定安全最佳实践。
标准合规性
此授权机制基于以下列出的既定规范,但实现了其功能的选定子集,以确保安全性和互操作性,同时保持简洁性:
- OAuth 2.1 IETF DRAFT (draft-ietf-oauth-v2-1-13)
- OAuth 2.0 授权服务器元数据 (RFC8414)
- OAuth 2.0 动态客户端注册协议 (RFC7591)
- OAuth 2.0 受保护资源元数据 (RFC9728)
- OAuth 客户端 ID 元数据文档 (draft-ietf-oauth-client-id-metadata-document-00)
角色
受保护的 _MCP 服务器_充当 OAuth 2.1 资源服务器,能够接受并响应使用访问令牌的受保护资源请求。
_MCP 客户端_充当 OAuth 2.1 客户端,代表资源所有者发出受保护资源请求。
_授权服务器_负责与用户交互(如有必要)并为在 MCP 服务器上使用而颁发访问令牌。 授权服务器的实现细节超出了本规范的范围。它可以与资源服务器托管在一起或作为独立实体。授权服务器发现部分指定了 MCP 服务器如何向客户端指示其对应授权服务器的位置。
概述
授权服务器必须实现 OAuth 2.1,并为机密客户端和公共客户端采取适当的安全措施。
授权服务器和 MCP 客户端应该支持 OAuth 客户端 ID 元数据文档 (draft-ietf-oauth-client-id-metadata-document-00)。
授权服务器和 MCP 客户端可以支持 OAuth 2.0 动态客户端注册 协议 (RFC7591)。
MCP 服务器必须实现 OAuth 2.0 受保护资源元数据 (RFC9728)。 MCP 客户端必须使用 OAuth 2.0 受保护资源元数据来进行授权服务器发现。
MCP 授权服务器必须提供以下至少一种发现机制:
- OAuth 2.0 授权服务器元数据 (RFC8414)
- OpenID Connect Discovery 1.0
MCP 客户端必须支持两种发现机制,以获取与授权服务器交互所需的信息。
授权服务器发现
本节描述了 MCP 服务器向 MCP 客户端通告其关联授权服务器的机制,以及 MCP 客户端确定授权服务器端点和支持的功能的发现过程。
授权服务器位置
MCP 服务器必须实现 OAuth 2.0 受保护资源元数据 (RFC9728)规范,以指示授权服务器的位置。MCP 服务器返回的受保护资源元数据文档必须包含
authorization_servers 字段,其中包含至少一个授权服务器。
authorization_servers 的具体使用超出了本规范的范围;实现者应咨询
OAuth 2.0 受保护资源元数据 (RFC9728)以获取实现细节的指导。
实现者应注意,受保护资源元数据文档可以定义多个授权服务器。选择使用哪个授权服务器的责任在于 MCP 客户端,遵循 RFC9728 第 7.6 节 “授权服务器”中指定的指南。
受保护资源元数据发现要求
MCP 服务器必须实现以下发现机制之一,以向 MCP 客户端提供授权服务器位置信息:
WWW-Authenticate 头:在返回
401 Unauthorized响应时,在WWW-AuthenticateHTTP 头的resource_metadata中包含资源元数据 URL,如 RFC9728 第 5.1 节中所述。Well-Known URI:在 RFC9728中指定的 well-known URI 上提供元数据。可以是:
- 在服务器 MCP 端点的路径上:
https://example.com/public/mcp可以在https://example.com/.well-known/oauth-protected-resource/public/mcp托管元数据 - 在根目录:
https://example.com/.well-known/oauth-protected-resource
- 在服务器 MCP 端点的路径上:
MCP 客户端必须支持两种发现机制,并在存在时使用解析的 WWW-Authenticate 头中的资源元数据 URL;否则,它们必须回退到按上述顺序构造和请求 well-known URI。
MCP 服务器应该在 WWW-Authenticate 头中包含 scope 参数,如
RFC 6750 第 3 节中所定义,以指示访问资源所需的作用域。这为客户端提供了关于在授权期间请求的适当作用域的即时指导,遵循最小权限原则并防止客户端请求过度的权限。
WWW-Authenticate 质询中包含的作用域可以与 scopes_supported 匹配、是其子集或超集,或者是既非严格子集也非超集的替代集合。客户端绝不能假设质询作用域集和 scopes_supported 之间的任何特定集合关系。客户端必须将质询中提供的作用域视为满足当前请求的权威。服务器应该努力在构造作用域集时保持一致性,但它们不需要通过 scopes_supported 公开每个动态颁发的作用域。
带有作用域指导的示例 401 响应:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://mcp.example.com/.well-known/oauth-protected-resource",
scope="files:read"MCP 客户端必须能够解析 WWW-Authenticate 头并适当地响应来自 MCP 服务器的 HTTP 401 Unauthorized 响应。
如果缺少 scope 参数,客户端应该应用作用域选择策略部分中定义的回退行为。
授权服务器元数据发现
为了处理不同的颁发者 URL 格式并确保与 OAuth 2.0 授权服务器元数据和 OpenID Connect Discovery 1.0 规范的互操作性,MCP 客户端在发现授权服务器元数据时必须尝试多个 well-known 端点。
发现方法基于 RFC8414 第 3.1 节 “授权服务器元数据请求”进行 OAuth 2.0 授权服务器元数据发现,以及 RFC8414 第 5 节 “兼容性说明”进行 OpenID Connect Discovery 1.0 互操作性。
对于具有路径组件的颁发者 URL(例如 https://auth.example.com/tenant1),客户端必须按以下优先级顺序尝试端点:
- 带有路径插入的 OAuth 2.0 授权服务器元数据:
https://auth.example.com/.well-known/oauth-authorization-server/tenant1 - 带有路径插入的 OpenID Connect Discovery 1.0:
https://auth.example.com/.well-known/openid-configuration/tenant1 - OpenID Connect Discovery 1.0 路径追加:
https://auth.example.com/tenant1/.well-known/openid-configuration
对于没有路径组件的颁发者 URL(例如 https://auth.example.com),客户端必须尝试:
- OAuth 2.0 授权服务器元数据:
https://auth.example.com/.well-known/oauth-authorization-server - OpenID Connect Discovery 1.0:
https://auth.example.com/.well-known/openid-configuration
授权服务器发现序列图
下图概述了一个示例流程:
sequenceDiagram
participant C as 客户端
participant M as MCP 服务器(资源服务器)
participant A as 授权服务器
Note over C: 尝试未经身份验证的 MCP 请求
C->>M: 不带令牌的 MCP 请求
M-->>C: HTTP 401 Unauthorized(可能包含 WWW-Authenticate 头)
alt 头包含 resource_metadata
Note over C: 从头中提取 resource_metadata URL
C->>M: GET resource_metadata URI
M-->>C: 带有授权服务器 URL 的资源元数据
else 头中没有 resource_metadata
Note over C: 回退到 well-known URI 探测
Note over M: _如果 MCP 服务器在根目录,则不适用_
C->>M: GET /.well-known/oauth-protected-resource/mcp
alt 找到子路径元数据
M-->>C: 带有授权服务器 URL 的资源元数据
else 未找到子路径
C->>M: GET /.well-known/oauth-protected-resource
alt 找到根元数据
M-->>C: 带有授权服务器 URL 的资源元数据
else 未找到根元数据
Note over C: 中止或使用预配置的值
end
end
end
Note over C: 验证 RS 元数据,<br />构建 AS 元数据 URL
C->>A: GET 授权服务器元数据端点
Note over C,A: 按优先级顺序尝试 OAuth 2.0 和 OpenID Connect<br/>发现端点
A-->>C: 授权服务器元数据
Note over C,A: OAuth 2.1 授权流程在此处发生
C->>A: 令牌请求
A-->>C: 访问令牌
C->>M: 带有访问令牌的 MCP 请求
M-->>C: MCP 响应
Note over C,M: MCP 通信继续使用有效令牌
客户端注册方法
MCP 支持三种客户端注册机制。根据您的场景选择:
- 客户端 ID 元数据文档:当客户端和服务器没有先前的关系时(最常见)
- 预注册:当客户端和服务器存在现有关系时
- 动态客户端注册:用于向后兼容或特定需求
支持所有选项的客户端应该遵循以下优先级顺序:
- 如果客户端有可用的服务器预注册客户端信息,则使用它
- 如果授权服务器指示支持(通过 OAuth 授权服务器元数据中的
client_id_metadata_document_supported),则使用客户端 ID 元数据文档 - 如果授权服务器支持(通过 OAuth 授权服务器元数据中的
registration_endpoint),则回退到动态客户端注册 - 如果没有其他选项可用,则提示用户输入客户端信息
客户端 ID 元数据文档
MCP 客户端和授权服务器应该支持 OAuth 客户端 ID 元数据文档中指定的 OAuth 客户端 ID 元数据文档。 这种方法使客户端能够使用 HTTPS URL 作为客户端标识符,其中 URL 指向包含客户端元数据的 JSON 文档。这解决了 MCP 的常见场景,即服务器和客户端没有预先存在的关系。
实现要求
支持客户端 ID 元数据文档的 MCP 实现必须遵循 OAuth 客户端 ID 元数据文档中指定的要求。关键要求包括:
对于 MCP 客户端:
- 客户端必须在遵循 RFC 要求的 HTTPS URL 上托管其元数据文档
client_idURL 必须使用 “https” 方案并包含路径组件,例如https://example.com/client.json- 元数据文档必须至少包含以下属性:
client_id、client_name、redirect_uris - 客户端必须确保元数据中的
client_id值与文档 URL 完全匹配 - 客户端可以使用
private_key_jwt进行客户端身份验证(例如,对于对令牌端点的请求),并具有适当的 JWKS 配置,如 客户端 ID 元数据文档第 6.2 节中所述
对于授权服务器:
- 应该在遇到 URL 格式的 client_ids 时获取元数据文档
- 必须验证获取的文档的
client_id与 URL 完全匹配 - 应该遵循 HTTP 缓存头缓存元数据
- 必须根据元数据文档中列出的 redirect_uris 验证授权请求中呈现的 redirect_uris
- 必须验证文档结构是有效的 JSON 并且包含必需的字段
- 应该遵循 客户端 ID 元数据文档第 6 节中的安全注意事项
示例元数据文档
{
"client_id": "https://app.example.com/oauth/client-metadata.json",
"client_name": "Example MCP Client",
"client_uri": "https://app.example.com",
"logo_uri": "https://app.example.com/logo.png",
"redirect_uris": [
"http://127.0.0.1:3000/callback",
"http://localhost:3000/callback"
],
"grant_types": ["authorization_code"],
"response_types": ["code"],
"token_endpoint_auth_method": "none"
}客户端 ID 元数据文档流程
下图说明了使用客户端 ID 元数据文档时的完整流程:
sequenceDiagram
participant User as 用户
participant Client as MCP 客户端
participant Server as 授权服务器
participant Metadata as 元数据端点<br/>(客户端的 HTTPS URL)
participant Resource as MCP 服务器
Note over Client,Metadata: 客户端在以下位置托管元数据<br/>https://app.example.com/oauth/metadata.json
User->>Client: 发起到 MCP 服务器的连接
Client->>Server: 授权请求<br/>client_id=https://app.example.com/oauth/metadata.json<br/>redirect_uri=http://localhost:3000/callback
Server->>User: 身份验证提示
User->>Server: 提供凭据
Note over Server: 验证用户身份
Note over Server: 检测到 URL 格式的 client_id
Server->>Metadata: GET https://app.example.com/oauth/metadata.json
Metadata-->>Server: JSON 元数据文档<br/>{client_id, client_name, redirect_uris, ...}
Note over Server: 验证:<br/>1. client_id 与 URL 匹配<br/>2. redirect_uri 在允许列表中<br/>3. 文档结构有效<br/>4.(可选)通过信任策略允许域名
alt 验证成功
Server->>User: 显示带有 client_name 的同意页面
User->>Server: 批准访问
Server->>Client: 通过 redirect_uri 发送授权代码
Client->>Server: 交换代码以获取令牌<br/>client_id=https://app.example.com/oauth/metadata.json
Server-->>Client: 访问令牌
Client->>Resource: 带有访问令牌的 MCP 请求
Resource-->>Client: MCP 响应
else 验证失败
Server->>User: 错误响应<br/>error=invalid_client 或 invalid_request
end
Note over Server: 为未来的请求缓存元数据<br/>(遵循 HTTP 缓存头)
发现
授权服务器通过在其 OAuth 授权服务器元数据中包含以下属性来通告它们支持使用客户端 ID 元数据文档的客户端:
{
"client_id_metadata_document_supported": true
}MCP 客户端应该检查此功能,如果不可用可以回退到动态客户端注册或预注册。
预注册
MCP 客户端应该支持静态客户端凭据的选项,例如通过预注册流程提供的凭据。这可以是:
- 硬编码客户端 ID(以及适用的客户端凭据),专门供 MCP 客户端在与该授权服务器交互时使用,或
- 向用户呈现 UI,允许他们在自己注册 OAuth 客户端之后输入这些详细信息(例如,通过服务器托管的配置界面)。
动态客户端注册
MCP 客户端和授权服务器可以支持 OAuth 2.0 动态客户端注册协议 RFC7591,以允许 MCP 客户端在无需用户交互的情况下获取 OAuth 客户端 ID。此选项的包含是为了与早期版本的 MCP 授权规范向后兼容。
作用域选择策略
实现授权流程时,MCP 客户端应该遵循最小权限原则,仅请求其预期操作所需的作用域。在初始授权握手期间,MCP 客户端应该遵循以下作用域选择的优先级顺序:
- 使用
scope参数:如果提供了 401 响应中初始WWW-Authenticate头中的scope参数 - 如果
scope不可用:使用受保护资源元数据文档中scopes_supported中定义的所有作用域,如果scopes_supported未定义,则省略scope参数
这种方法适应了 MCP 客户端的通用性质,它们通常缺乏特定领域的知识来对单个作用域选择做出明智的决策。请求所有可用作用域允许授权服务器和最终用户在同意过程中确定适当的权限。
这种方法在遵循最小权限原则的同时最大限度地减少了用户摩擦。scopes_supported 字段旨在表示基本功能所需的最小作用域集(请参阅作用域最小化),通过作用域质询处理部分描述的逐步授权流程步骤请求增量作用域。
授权流程步骤
完整的授权流程进行如下:
sequenceDiagram
participant B as 用户代理(浏览器)
participant C as 客户端
participant M as MCP 服务器(资源服务器)
participant A as 授权服务器
C->>M: 不带令牌的 MCP 请求
M->>C: 带有 WWW-Authenticate 头的 HTTP 401 Unauthorized
Note over C: 从 WWW-Authenticate 提取 resource_metadata URL
C->>M: 请求受保护资源元数据
M->>C: 返回元数据
Note over C: 解析元数据并提取授权服务器<br/>客户端确定要使用的 AS
C->>A: GET 授权服务器元数据端点
Note over C,A: 按优先级顺序尝试 OAuth 2.0 和 OpenID Connect<br/>发现端点
A-->>C: 授权服务器元数据
alt 客户端 ID 元数据文档
Note over C: 客户端使用 HTTPS URL 作为 client_id
Note over A: 服务器检测到 URL 格式的 client_id
A->>C: 从 client_id URL 获取元数据
C-->>A: JSON 元数据文档
Note over A: 验证元数据和 redirect_uris
else 动态客户端注册
C->>A: POST /register
A->>C: 客户端凭据
else 预注册客户端
Note over C: 使用现有的 client_id
end
Note over C: 生成 PKCE 参数<br/>包含资源参数<br/>应用作用域选择策略
C->>B: 使用授权 URL + code_challenge + resource 打开浏览器
B->>A: 带有资源参数的授权请求
Note over A: 用户授权
A->>B: 使用授权代码重定向到回调
B->>C: 授权代码回调
C->>A: 令牌请求 + code_verifier + resource
A->>C: 访问令牌(+ 刷新令牌)
C->>M: 带有访问令牌的 MCP 请求
M-->>C: MCP 响应
Note over C,M: MCP 通信继续使用有效令牌
资源参数实现
MCP 客户端必须按照 RFC 8707中的定义实现 OAuth 2.0 的资源指示器,以明确指定正在为其请求令牌的目标资源。resource 参数:
- 必须包含在授权请求和令牌请求中。
- 必须标识客户端打算使用令牌的 MCP 服务器。
- 必须使用 RFC 8707 第 2 节中定义的 MCP 服务器规范 URI。
规范服务器 URI
就本规范而言,MCP 服务器的规范 URI 定义为 RFC 8707 第 2 节中指定的资源标识符,并与 RFC 9728中的 resource 参数一致。
MCP 客户端应该为其打算访问的 MCP 服务器提供最具体的 URI,遵循 RFC 8707中的指导。虽然规范形式使用小写方案和主机组件,但为了稳健性和互操作性,实现应该接受大写方案和主机组件。
有效规范 URI 的示例:
https://mcp.example.com/mcphttps://mcp.example.comhttps://mcp.example.com:8443https://mcp.example.com/server/mcp(当路径组件对于标识单个 MCP 服务器是必需的时)
无效规范 URI 的示例:
mcp.example.com(缺少方案)https://mcp.example.com#fragment(包含片段)
注意: 虽然根据 RFC 3986,
https://mcp.example.com/(带尾部斜杠)和https://mcp.example.com(不带尾部斜杠)在技术上都是有效的绝对 URI,但为了更好的互操作性,实现应该始终使用不带尾部斜杠的形式,除非尾部斜杠对特定资源具有语义意义。
例如,如果访问位于 https://mcp.example.com 的 MCP 服务器,授权请求将包括:
&resource=https%3A%2F%2Fmcp.example.comMCP 客户端必须发送此参数,无论授权服务器是否支持它。
访问令牌使用
令牌要求
向 MCP 服务器发出请求时的访问令牌处理必须符合 OAuth 2.1 第 5 节 “资源请求”中定义的要求。具体来说:
- MCP 客户端必须使用 OAuth 2.1 第 5.1.1 节中定义的授权请求头字段:
Authorization: Bearer <access-token>请注意,授权必须包含在从客户端到服务器的每个 HTTP 请求中,即使它们属于同一个逻辑会话。
- 访问令牌绝不能包含在 URI 查询字符串中
示例请求:
GET /mcp HTTP/1.1
Host: mcp.example.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...令牌处理
MCP 服务器作为 OAuth 2.1 资源服务器必须按照 OAuth 2.1 第 5.2 节中的描述验证访问令牌。 MCP 服务器必须验证访问令牌是专门为它们作为预期受众而颁发的,根据 RFC 8707 第 2 节。 如果验证失败,服务器必须按照 OAuth 2.1 第 5.3 节错误处理要求进行响应。无效或过期的令牌必须收到 HTTP 401 响应。
MCP 客户端绝不能向 MCP 服务器发送不是由 MCP 服务器的授权服务器颁发的令牌。
MCP 服务器必须仅接受对其自己的资源有效的令牌。
MCP 服务器绝不能接受或传递任何其他令牌。
错误处理
服务器必须为授权错误返回适当的 HTTP 状态代码:
| 状态代码 | 描述 | 用法 |
|---|---|---|
| 401 | Unauthorized | 需要授权或令牌无效 |
| 403 | Forbidden | 无效作用域或权限不足 |
| 400 | Bad Request | 格式错误的授权请求 |
作用域质询处理
本节涵盖在运行时操作期间处理作用域不足错误,此时客户端已有令牌但需要额外权限。这遵循 OAuth 2.1 第 5 节中定义的错误处理模式,并利用 RFC 9728 (OAuth 2.0 受保护资源元数据)中的元数据字段。
运行时作用域不足错误
当客户端在运行时操作期间使用作用域不足的访问令牌发出请求时,服务器应该响应:
HTTP 403 Forbidden状态代码(根据 RFC 6750 第 3.1 节)- 带有
Bearer方案和附加参数的WWW-Authenticate头:error="insufficient_scope"- 指示授权失败的特定类型scope="required_scope1 required_scope2"- 指定操作所需的最低作用域resource_metadata- 受保护资源元数据文档的 URI(为了与 401 响应一致)error_description(可选)- 错误的人类可读描述
服务器作用域管理:当响应对作用域不足的错误时,服务器应该在 scope 参数中包含满足当前请求所需的作用域。
服务器在确定包含哪些作用域方面具有灵活性:
- 最小方法:仅包含特定操作新需要的作用域。如果需要,还包括任何现有授予的作用域,以防止客户端失去先前授予的权限。
- 推荐方法:包括现有的相关作用域和新需要的作用域,以防止客户端失去先前授予的权限
- 扩展方法:包括现有作用域、新需要的作用域以及通常一起工作的相关作用域
选择取决于服务器对用户体验影响和授权摩擦的评估。
服务器应该在作用域包含策略中保持一致,以为客户端提供可预测的行为。
服务器应该在确定响应中包含哪些作用域时考虑用户体验影响,因为错误配置的作用域可能需要频繁的用户交互。
示例作用域不足响应:
HTTP/1.1 403 Forbidden
WWW-Authenticate: Bearer error="insufficient_scope",
scope="files:read files:write user:profile",
resource_metadata="https://mcp.example.com/.well-known/oauth-protected-resource",
error_description="需要额外的文件写入权限"逐步授权流程
客户端将在初始授权或运行时(insufficient_scope)收到与作用域相关的错误。客户端应该通过通过逐步授权流程请求具有增加作用域集的新访问令牌来响应这些错误,或以其他适当方式处理错误。代表用户行事的客户端应该尝试逐步授权流程。代表自己行事的客户端(client_credentials 客户端)可以尝试逐步授权流程或立即中止请求。
流程如下:
- 解析错误信息:从授权服务器响应或
WWW-Authenticate头中 - 确定所需作用域:如作用域选择策略中概述
- 发起(重新)授权:使用确定的作用域集
- 重试原始请求:使用新授权重试不超过几次,并将此视为永久授权失败
客户端应该实现重试限制并应该跟踪作用域升级尝试,以避免对相同的资源和操作组合重复失败。
安全注意事项
实现必须遵循 OAuth 2.1 第 7 节 “安全注意事项”中列出的 OAuth 2.1 安全最佳实践。
令牌受众绑定和验证
RFC 8707 资源指示器在授权服务器支持该功能时通过将令牌绑定到其预期受众来提供关键的安全好处。为了支持当前和未来的采用:
- MCP 客户端必须在授权和令牌请求中包含
resource参数,如 资源参数实现部分中所指定 - MCP 服务器必须验证向其呈现的令牌是专门为它们的使用而颁发的
安全最佳实践文档概述了为什么令牌受众验证至关重要以及为什么明确禁止令牌传递。
令牌盗取
获得客户端存储的令牌或在服务器上缓存或记录的令牌的攻击者可以使用对资源服务器看起来合法的请求访问受保护资源。
客户端和服务器必须实现安全的令牌存储并遵循 OAuth 最佳实践,如 OAuth 2.1 第 7.1 节中所述。
授权服务器应该颁发短期访问令牌以减少泄露令牌的影响。对于公共客户端,授权服务器必须按照 OAuth 2.1 第 4.3.1 节 “令牌端点扩展”中的描述轮换刷新令牌。
通信安全
实现必须遵循 OAuth 2.1 第 1.5 节 “通信安全”。
具体来说:
- 所有授权服务器端点必须通过 HTTPS 提供。
- 所有重定向 URI 必须是
localhost或使用 HTTPS。
授权代码保护
已获得访问授权响应中包含的授权代码的攻击者可以尝试兑换授权代码以获取访问令牌或以其他方式使用授权代码。(在 OAuth 2.1 第 7.5 节中进一步描述)
为了减轻这种情况,MCP 客户端必须按照 OAuth 2.1 第 7.5.2 节实现 PKCE,并在继续授权之前必须验证 PKCE 支持。PKCE 有助于防止授权代码拦截和注入攻击,通过要求客户端创建秘密验证器-质询对,确保只有原始请求者可以交换授权代码以获取令牌。
按照 OAuth 2.1 第 4.1.1 节的要求,当技术能力允许时,MCP 客户端必须使用 S256 代码质询方法。
由于 OAuth 2.1 和 PKCE 规范没有为客户端定义发现 PKCE 支持的机制,MCP 客户端必须依赖授权服务器元数据来验证此功能:
OAuth 2.0 授权服务器元数据:如果缺少
code_challenge_methods_supported,则授权服务器不支持 PKCE,MCP 客户端必须拒绝继续。OpenID Connect Discovery 1.0:虽然 OpenID 提供者元数据未定义
code_challenge_methods_supported,但此字段通常由 OpenID 提供者包含。MCP 客户端必须验证提供者元数据响应中存在code_challenge_methods_supported。如果缺少该字段,MCP 客户端必须拒绝继续。
提供 OpenID Connect Discovery 1.0 的授权服务器必须在其元数据中包含 code_challenge_methods_supported 以确保 MCP 兼容性。
开放重定向
攻击者可以制作恶意重定向 URI 以将用户定向到钓鱼网站。
MCP 客户端必须在授权服务器处注册重定向 URI。
授权服务器必须根据预注册的值验证精确的重定向 URI 以防止重定向攻击。
MCP 客户端应该在授权代码流程中使用和验证状态参数,并丢弃任何不包含或与原始状态不匹配的结果。
授权服务器必须采取预防措施以防止将用户代理重定向到不受信任的 URI,遵循 OAuth 2.1 第 7.12.2 节中列出的建议
授权服务器应该仅在它信任重定向 URI 时才自动重定向用户代理。如果 URI 不受信任,授权服务器可以通知用户并依靠用户做出正确的决定。
客户端 ID 元数据文档安全
实现客户端 ID 元数据文档时,授权服务器必须考虑 OAuth 客户端 ID 元数据文档第 6 节中详细说明的安全影响。关键注意事项包括:
授权服务器滥用保护
授权服务器从未知客户端获取 URL 作为输入并获取该 URL。恶意客户端可以使用此功能触发授权服务器向任意 URL 发出请求,例如对授权服务器有权访问的私有管理端点的请求。
获取元数据文档的授权服务器应该考虑服务器端请求伪造 (SSRF) 风险,如 OAuth 客户端 ID 元数据文档:服务器端请求伪造 (SSRF) 攻击中所述。
Localhost 重定向 URI 风险
客户端 ID 元数据文档本身无法防止 localhost URL 伪装。攻击者可以通过以下方式声称自己是任何客户端:
- 提供合法客户端的元数据 URL 作为其
client_id - 绑定到任何
localhost端口,并提供该地址作为 redirect_uri - 在用户批准时通过重定向接收授权代码
服务器将看到合法客户端的元数据文档,用户将看到合法客户端的名称,从而使攻击检测变得困难。
授权服务器:
- 应该为仅
localhost的重定向 URI 显示额外警告 - 可以要求额外的证明机制以增强安全性
- 必须在授权期间清楚地显示重定向 URI 主机名
信任策略
授权服务器可以实现基于域的信任策略:
- 受保护服务器的受信任域名的允许列表
- 接受任何 HTTPS
client_id(用于开放服务器) - 未知域名的声誉检查
- 基于域名年龄或证书验证的限制
- 突出显示 CIMD 和其他关联的客户端主机名以防止钓鱼
服务器维护对其访问策略的完全控制。
代理人问题
攻击者可以利用充当第三方 API 中介的 MCP 服务器,导致代理人漏洞。通过使用盗取的授权代码,他们可以在未经用户同意的情况下获取访问令牌。
使用静态客户端 ID 的 MCP 代理服务器必须在转发到第三方授权服务器之前获得每个动态注册的客户端的用户同意(这可能需要额外的同意)。
访问令牌权限限制
如果服务器接受为其他资源颁发的令牌,攻击者可以未经授权访问或以其他方式危及 MCP 服务器。
此漏洞有两个关键维度:
- 受众验证失败。 当 MCP 服务器不验证令牌是专门为其颁发的时(例如,通过受众声明,如 RFC9068中所述),它可能会接受最初为其他服务颁发的令牌。这破坏了基本的 OAuth 安全边界,允许攻击者在不同的服务上重用合法令牌,而不是预期的服务。
- 令牌传递。 如果 MCP 服务器不仅接受具有错误受众的令牌,还将这些未修改的令牌转发到下游服务,它可能会导致“代理人"问题,其中下游 API 可能会错误地信任令牌,就好像它来自 MCP 服务器一样,或者假设令牌已由上游 API 验证。有关更多详细信息,请参阅安全最佳实践指南的令牌传递部分。
MCP 服务器必须在处理请求之前验证访问令牌,确保访问令牌是专门为 MCP 服务器颁发的,并采取所有必要步骤以确保不会向未经授权的方返回数据。
MCP 服务器必须遵循 OAuth 2.1 - 第 5.2 节中的指南来验证入站令牌。
MCP 服务器必须仅接受专门为其自己的令牌,并必须拒绝不在受众声明中包含它们的令牌,或以其他方式验证它们是令牌的预期接收者。有关详细信息,请参阅安全最佳实践令牌传递部分。
如果 MCP 服务器向上游 API 发出请求,它可能充当 OAuth 客户端。在上游 API 使用的访问令牌是一个单独的令牌,由上游授权服务器颁发。MCP 服务器绝不能传递它从 MCP 客户端收到的令牌。
MCP 客户端必须实现并使用 RFC 8707 - OAuth 2.0 的资源指示器中定义的 resource 参数,以明确指定正在为其请求令牌的目标资源。此要求与 RFC 9728 第 7.4 节中的建议一致。这确保访问令牌绑定到其预期资源,并且不能在不同服务上滥用。
MCP 授权扩展
核心协议有多个授权扩展,它们定义了额外的授权机制。这些扩展是:
- 可选的 - 实现可以选择采用这些扩展
- 附加的 - 扩展不修改或破坏核心协议功能;它们添加新功能,同时保留核心协议行为
- 可组合的 - 扩展是模块化的,设计为无冲突地协同工作,允许实现同时采用多个扩展
- 独立版本控制 - 扩展遵循核心 MCP 版本控制周期,但可能根据需要采用独立版本控制
支持的扩展列表可以在 MCP 授权扩展存储库中找到。