远程 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_scope Challenge 做权限升级,不要初次授权就申请所有 Scope。
  • 绝不能把 MCP Access Token 原样传递给上游或下游 API。
  • 所有 Metadata 抓取都要防御 SSRF、Redirect、DNS Rebinding 和私网目标。

先画清信任拓扑

信任拓扑决定每条边界应接受哪种 Credential:

text
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 授权流程

规范流程包含五个安全关键阶段:

sequenceDiagram participant C as "MCP Client" participant R as "MCP Resource" participant A as "Authorization Server" participant U as "Resource Owner" C->>R: 未带 Token 的 MCP 请求 R-->>C: 401 + resource_metadata + scope C->>R: 获取 Protected Resource Metadata C->>A: 获取并校验 AS 或 OIDC Metadata C->>C: 选择注册机制,生成 PKCE 与 State C->>A: Authorization Request + resource A->>U: 用户认证与授权同意 A-->>C: Code + Issuer C->>C: 校验 State 与 Issuer C->>A: Code + Verifier + resource A-->>C: 签发给 MCP Resource 的 Access Token C->>R: 每个请求携带 Bearer Token R->>R: 校验 Token,再鉴权 Tool

这套授权流程用于 HTTP Transport。MCP 规范建议 stdio 实现从环境取得 Credential,而不是应用远程 OAuth 流程。

安全发现 Protected Resource

MCP Resource 通过 RFC 9728 Metadata 公布 Canonical Resource 与 Authorization Server:

json
{
  "resource": "https://mcp.example.com/mcp",
  "authorization_servers": ["https://login.example.com"],
  "scopes_supported": ["files:read"]
}

未认证请求可以通过响应头把文档地址告知 Client:

http
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 的优先顺序是:

  1. Client 与 Authorization Server 已有关系时,使用预注册信息。
  2. Authorization Server 声明 client_id_metadata_document_supported 时使用 CIMD。
  3. 前两者不可用且 Server 支持时,才把 DCR 作为回退。
  4. 自动机制均不可用时,由用户提供已经注册的 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:

text
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 和未批准外部副作用都会被拒绝。

go
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
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 文档。所有跳转都应使用同一套策略:

  1. 使用标准 URL 库解析。
  2. 除显式 Loopback 开发环境外要求 HTTPS。
  3. 解析并阻止私网、Loopback、Link-local 与保留地址。
  4. 每一跳 Redirect 都重新校验。
  5. 固定解析结果或通过 Egress Proxy,降低 DNS TOCTOU 风险。
  6. 限制响应体、超时、跳转次数与 Content Type。
  7. 按 Expiry 和 Issuer 缓存已验证 Metadata。
  8. 未脱敏前,不向用户反射抓取到的错误体或 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 或原始敏感参数。

发布清单

  1. 固定 Client 与 Server 采用的 MCP 规范版本。
  2. 定义唯一 Canonical MCP Resource URI。
  3. 校验 Protected Resource Metadata 与 Authorization Server Metadata。
  4. 新 Client 优先实现预注册和 CIMD,再考虑 DCR。
  5. 将持久化 Credential 与授权响应绑定到精确 Issuer。
  6. 授权请求和 Token 请求都携带 resource。
  7. 要求 PKCE S256、精确 Redirect URI 与一次性 State。
  8. 验证 Token 面向当前 MCP Resource,并拒绝 Token Passthrough。
  9. 在模型之外执行 Tenant、Object、Purpose 与副作用策略。
  10. 实现一次给全的 Step-up Scope Challenge。
  11. 对 Metadata、CIMD、JWKS 和 Redirect 执行 SSRF 控制。
  12. 开放高影响 Tool 前,使用合成身份跑完失败矩阵。

总结

企业 MCP OAuth 成功的标准,是每一种权威都保持独立:Discovery 找到可信 Authorization Server,注册识别 Client,PKCE 与 Issuer Binding 保护授权响应,resource 把 Token 绑定到 MCP Server,应用策略再鉴权精确 Tool 副作用。2026-07-28 规范把这些边界定义得更清楚;工程实现应把它们作为协议不变量,而不是交给模型遵守的提示词。

一手来源

相关资源