远程 MCP OAuth 不是“加一个登录,再相信 Token”。它是一套多方授权协议:MCP Server 作为 OAuth Protected Resource,发现或选择 Authorization Server,验证专门签发给自己的 Token,然后仍要对每一次 Tool Call 做应用级授权决策。
2026-07-28 版 MCP 规范实质性改变了旧集成建议。对于没有预先关系的 Client,Client ID Metadata Documents(CIMD)成为优先机制;Dynamic Client Registration(DCR)被弃用;resource 参数成为强制要求;授权响应需要明确绑定 Issuer;运行时 Scope Challenge 形成了 Step-up Authorization 流程。
核心要点
- 把 MCP Server、Authorization Server、Client、用户与下游 API 建模为不同 Principal 和 Resource。
- 通过 RFC 9728 Protected Resource Metadata 发现 Authorization Server,不能从用户输入 URL 直接推断信任。
- 优先预注册,其次使用 CIMD,DCR 只作为兼容性回退。
- 将授权响应与持久化 Client 凭证绑定到精确的 Authorization Server Issuer。
- 在授权与 Token 请求中都携带
resource,随后由 MCP Server 校验 Token Audience。 - Scope 只是粗粒度能力,Tenant、Subject、Object、Action、Purpose 与副作用必须单独鉴权。
- 运行时使用完整
insufficient_scopeChallenge 做权限升级,不要初次授权就申请所有 Scope。 - 绝不能把 MCP Access Token 原样传递给上游或下游 API。
- 所有 Metadata 抓取都要防御 SSRF、Redirect、DNS Rebinding 和私网目标。
先画清信任拓扑
信任拓扑决定每条边界应接受哪种 Credential:
Resource Owner
-> MCP Client
-> MCP Protected Resource
-> 下游 API(可选)
Authorization Server
-> 为 MCP Resource 签发 Token
选择 SDK 之前,先记录这些值:
| 决策 | 必须留存的内容 |
|---|---|
| MCP Resource 身份 | Metadata 与 resource 共用的 Canonical HTTPS URI |
| Authorization Server | 已验证的 Issuer 与 Metadata 来源 |
| Client 注册 | 注册机制、Client ID、Redirect URI、Issuer 绑定 |
| Principal 映射 | Subject、Tenant、Client 与可信 Claim 来源 |
| Tool 策略 | 必要 Scope、对象规则、副作用分类 |
| 下游访问 | 独立 Audience、凭证类型与委托策略 |
Authorization Server 负责签发证据,MCP Server 决定证据是否允许这次精确操作。即使一个 Token 签名有效,只要它是签发给另一个 API 的,对当前 MCP Server 仍然无效。
2026-07-28 授权流程
规范流程包含五个安全关键阶段:
这套授权流程用于 HTTP Transport。MCP 规范建议 stdio 实现从环境取得 Credential,而不是应用远程 OAuth 流程。
安全发现 Protected Resource
MCP Resource 通过 RFC 9728 Metadata 公布 Canonical Resource 与 Authorization Server:
{
"resource": "https://mcp.example.com/mcp",
"authorization_servers": ["https://login.example.com"],
"scopes_supported": ["files:read"]
}
未认证请求可以通过响应头把文档地址告知 Client:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://mcp.example.com/.well-known/oauth-protected-resource",
scope="files:read"
这些 URL 是网络输入,不是可信配置。服务端 MCP Client 必须校验初始 URL 与每次 Redirect;除显式 Loopback 开发环境外要求 HTTPS;拒绝私网、保留地址与 Link-local 地址;并考虑 DNS Rebinding。Egress Proxy 比自定义字符串判断提供更强边界。
Protected Resource Metadata 只告诉 Client 下一步去哪里,不能证明某个用户或 Client 已经获得权限。
按正确顺序注册 Client
当前 MCP 的优先顺序是:
- Client 与 Authorization Server 已有关系时,使用预注册信息。
- Authorization Server 声明
client_id_metadata_document_supported时使用 CIMD。 - 前两者不可用且 Server 支持时,才把 DCR 作为回退。
- 自动机制均不可用时,由用户提供已经注册的 Client 信息。
CIMD Client ID 是带路径的 HTTPS URL。文档至少包含完全匹配的 client_id、client_name 与 redirect_uris。Authorization Server 必须获取并校验文档、精确匹配 Redirect URI、按 HTTP 规则缓存,并为抓取过程配置 SSRF 防御。
DCR 是兼容旧版本的保留机制,不应作为新集成默认方案。通过 DCR 或预注册获得的持久化 Credential 必须按 Issuer 存储。若 Protected Resource Metadata 指向新的 Issuer,不能静默复用旧 Issuer 的 Credential。
把授权响应绑定到 Issuer
OAuth Mix-up Attack 会诱使 Client 把诚实 Authorization Server 签发的 Code 或 Token 发送给攻击者控制的 Server。MCP Client 在跳转用户前,必须把已选择 Issuer 与 PKCE Verifier、State 存入同一条请求记录。
授权响应包含 iss 时,应与记录的 Issuer 做精确字符串比较。Metadata 声明 authorization_response_iss_parameter_supported=true 时,缺少 iss 也应拒绝。比较前不能对 Scheme、Host 大小写、默认端口、末尾斜线或百分号编码做归一化。
state 应是绑定发起浏览器 Session 的短期、一次性值。PKCE S256 保护授权码交换,但不能替代 Issuer 校验、精确 Redirect URI 匹配与 Resource 授权。
把 Token 绑定到 MCP Resource
MCP Client 必须在授权请求和 Token 请求中都携带 RFC 8707 resource:
resource=https%3A%2F%2Fmcp.example.com%2Fmcp
应使用能够唯一标识 MCP Server 的最具体 Canonical URI。Resource 必须是包含 Scheme、且不含 Fragment 的绝对 URI。路径和末尾斜线若不一致,可能让 Token 面向另一个 Resource Identifier。
MCP Server 随后必须校验:
- 加密签名或 Introspection 结果;
- 允许的 Algorithm 与 Key;
- 精确的可信 Issuer;
- 预期 Audience 或等效 Resource 绑定;
- Expiration、Not-before 与有界时钟偏差;
- 本地策略需要的 Subject 和 Tenant Claim;
- 操作依赖 Client 身份时的 Client Claim;
- 当前能力所需的 Scope。
只解析 JWT 不等于验证。应使用维护良好的 OAuth/JWT 库或 Authorization Server Introspection,显式配置预期值,并在未知 Key 或校验依赖不可用时 Fail Closed。
用 Go 执行 Tool 与对象授权
Token 验证后,将可信 Claim 归一化为一个小型 Principal。下面仅使用标准库的程序演示加密验证之后的应用策略:跨租户、缺 Scope、未知 Resource 和未批准外部副作用都会被拒绝。
package main
import (
"errors"
"fmt"
"os"
)
type principal struct {
Subject string
Tenant string
Scopes map[string]bool
}
type toolCall struct {
Name string
ResourceID string
Effect string
}
type policy struct {
RequiredScope string
Owners map[string]string
ExternalTools map[string]bool
}
func authorize(p principal, tenant string, call toolCall, rule policy) (string, error) {
if !p.Scopes[rule.RequiredScope] {
return "deny", errors.New("insufficient_scope")
}
if p.Tenant != tenant {
return "deny", errors.New("tenant_mismatch")
}
if owner, ok := rule.Owners[call.ResourceID]; !ok || owner != p.Subject {
return "deny", errors.New("resource_not_authorized")
}
if call.Effect == "destructive" {
return "confirm", nil
}
if call.Effect == "external_write" && !rule.ExternalTools[call.Name] {
return "deny", errors.New("external_effect_not_allowed")
}
return "allow", nil
}
func main() {
p := principal{
Subject: "user-42",
Tenant: "tenant-a",
Scopes: map[string]bool{"files:write": true},
}
call := toolCall{
Name: "update_document",
ResourceID: "doc-7",
Effect: "external_write",
}
rule := policy{
RequiredScope: "files:write",
Owners: map[string]string{"doc-7": "user-42"},
ExternalTools: map[string]bool{"update_document": true},
}
decision, err := authorize(p, "tenant-a", call, rule)
if err != nil {
fmt.Fprintln(os.Stderr, err)
os.Exit(1)
}
fmt.Println(decision)
}
不能相信模型参数里的 tenant_id、owner_id、Role、Destination、Price 或 Approval State。身份来自已验证 Principal,所有权来自权威 Policy 或 Resource Service。
按需升级 Scope
初次 WWW-Authenticate Challenge 可以包含基础访问所需 Scope。Client 应把 Challenge 中的 Scope 视为当前请求的权威要求,不能假定它一定是 scopes_supported 的子集。
操作需要更多权限时,Server 应返回:
HTTP/1.1 403 Forbidden
WWW-Authenticate: Bearer error="insufficient_scope",
scope="files:write approvals:create",
resource_metadata="https://mcp.example.com/.well-known/oauth-protected-resource"
一次 Challenge 应给出本操作需要的全部 Scope。Client 重新授权时使用此前已授予 Scope 与新增 Scope 的并集,避免权限升级成功后丢失旧权限。只有用户看见并同意新增权限后,Client 才能重试。
Step-up Authorization 仍不等于对象授权。files:write 可以允许写能力,本地策略依然要拒绝修改其他租户的文档。
禁止 Token Passthrough
MCP Server 只能接收面向自己的 Access Token,不能把它原样转发给下游 API。Token Passthrough 会造成四类失败:
- 下游 Audience 不正确;
- MCP 层策略与限流可能被绕过;
- 审计日志无法还原 Client 边界;
- 被盗 Token 可以跨服务重放。
调用下游时,应为该 API 获取独立 Token:
| 下游需求 | Credential 模式 | 必须执行的检查 |
|---|---|---|
| 用户拥有的数据 | Provider 支持的委托交换 | 交换前完成 MCP 用户与对象授权 |
| 服务拥有的操作 | 窄权限 Workload Identity | 服务端策略与固定下游 Audience |
| 不支持委托 | 服务 Credential 加显式用户策略 | 禁止伪装成用户 |
不能让模型选择下游 Audience、Scope 或 Credential,也不能把 Assertion 和 Refresh Token 写入日志。
防御 OAuth 抓取攻击面
MCP OAuth 增加了多类受攻击者影响的 Fetch:resource_metadata、authorization_servers、授权端点、Token Endpoint、JWKS 与 CIMD 文档。所有跳转都应使用同一套策略:
- 使用标准 URL 库解析。
- 除显式 Loopback 开发环境外要求 HTTPS。
- 解析并阻止私网、Loopback、Link-local 与保留地址。
- 每一跳 Redirect 都重新校验。
- 固定解析结果或通过 Egress Proxy,降低 DNS TOCTOU 风险。
- 限制响应体、超时、跳转次数与 Content Type。
- 按 Expiry 和 Issuer 缓存已验证 Metadata。
- 未脱敏前,不向用户反射抓取到的错误体或 Metadata。
CIMD 把一次 Metadata Fetch 移到了 Authorization Server,因此 Server 端也必须执行相同的 SSRF 防御。
生产测试矩阵
协议机制与业务授权应分别测试:
| 场景 | 预期结果 |
|---|---|
| 缺少 Token | 返回 401 与有效 resource_metadata |
| Issuer 或 Audience 错误 | Tool Dispatch 前拒绝 |
| 不支持 PKCE | Client 拒绝启动授权 |
响应 iss 不匹配 |
Client 丢弃 Code 与错误详情 |
| 重复使用 State 或 Code | 不做 Token Exchange,直接拒绝 |
| Token 缺少操作 Scope | 返回 403 insufficient_scope 与完整 Scope 集合 |
| Scope 有效但 Tenant 或 Owner 错误 | 拒绝且不泄露对象是否存在 |
| Token 签发给下游 API | 拒绝,绝不 Passthrough |
| Metadata 指向私网 IP | Fetch 前阻止 |
| DNS 或 Redirect 改变目标 | 重新校验并阻止 |
| 未知签名 Key | 只做一次有界刷新,随后 Fail Closed |
| Step-up 后执行破坏性操作 | 仍要求独立绑定的确认 |
日志可以记录 Issuer、Resource、Client ID、Subject Hash、策略版本、Tool、Decision 与 Request ID;不能记录 Bearer Token、Authorization Code、PKCE Verifier 或原始敏感参数。
发布清单
- 固定 Client 与 Server 采用的 MCP 规范版本。
- 定义唯一 Canonical MCP Resource URI。
- 校验 Protected Resource Metadata 与 Authorization Server Metadata。
- 新 Client 优先实现预注册和 CIMD,再考虑 DCR。
- 将持久化 Credential 与授权响应绑定到精确 Issuer。
- 授权请求和 Token 请求都携带
resource。 - 要求 PKCE
S256、精确 Redirect URI 与一次性 State。 - 验证 Token 面向当前 MCP Resource,并拒绝 Token Passthrough。
- 在模型之外执行 Tenant、Object、Purpose 与副作用策略。
- 实现一次给全的 Step-up Scope Challenge。
- 对 Metadata、CIMD、JWKS 和 Redirect 执行 SSRF 控制。
- 开放高影响 Tool 前,使用合成身份跑完失败矩阵。
总结
企业 MCP OAuth 成功的标准,是每一种权威都保持独立:Discovery 找到可信 Authorization Server,注册识别 Client,PKCE 与 Issuer Binding 保护授权响应,resource 把 Token 绑定到 MCP Server,应用策略再鉴权精确 Tool 副作用。2026-07-28 规范把这些边界定义得更清楚;工程实现应把它们作为协议不变量,而不是交给模型遵守的提示词。
一手来源
- MCP Authorization 2026-07-28
- MCP Client Registration 2026-07-28
- MCP Authorization Security Considerations
- MCP Security Best Practices
- RFC 8707:OAuth 2.0 Resource Indicators
- RFC 9207:Authorization Server Issuer Identification
- RFC 9728:OAuth 2.0 Protected Resource Metadata
- RFC 9700:OAuth 2.0 Security Best Current Practice