1. 什么是 MCP 授权？ #

MCP 授权使 MCP 客户端能够代表用户向受保护的 MCP 服务器发起请求。当服务器需要验证「谁在访问」时，客户端通过 OAuth 2.1 流程获取访问令牌，并在请求中携带令牌。

协议修订版：2025-11-25

典型场景：用户用 VS Code 连接公司的远程 MCP 服务器（如内部文档、数据库）。首次连接时，VS Code 会打开浏览器让用户登录公司账号，登录成功后拿到令牌，后续请求自动携带令牌访问受保护资源。

2. 本章你将学到 #

• 授权涉及的角色与协议要求
• 授权服务器发现流程
• 客户端注册方式（Client ID 元数据、预注册、动态注册）
• 授权流程步骤、错误处理与安全要点

若需动手实现带授权的 MCP 服务器，详见 理解 MCP 中的授权。

3. 协议要求 #

4. 角色 #

用户 ──► MCP 客户端（如 VS Code）──► MCP 服务器（受保护资源）
                    │
                    └──► 授权服务器（登录、签发令牌）

5. 概述 #

6. 授权服务器发现 #

客户端首次请求受保护服务器时，会收到 401，需要知道「去哪登录、去哪换令牌」。发现就是客户端如何找到授权服务器地址的过程。

6.1 发现流程 #

MCP 服务器通过以下方式向客户端告知授权服务器位置：

客户端应当优先使用 WWW-Authenticate 中的 URL；否则回退到 well-known URI。

401 示例（带 scope 指导）：

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://mcp.example.com/.well-known/oauth-protected-resource",
                         scope="files:read"

6.2 授权服务器元数据发现 #

客户端根据 authorization_servers 中的 issuer URL，按优先级尝试 OAuth 2.0 元数据或 OIDC Discovery 端点，获取 authorization_endpoint、token_endpoint 等。

6.3 发现时序图 #

7. 客户端注册方式 #

在 OAuth 中，客户端需要先在授权服务器上「登记」自己，才能参与授权流程。MCP 支持多种登记方式：

7.1 Client ID Metadata Documents #

通俗理解：客户端不用提前去授权服务器注册，而是把自己的「身份证」（元数据 JSON）放在一个 HTTPS 地址上。授权服务器在授权时去取这个文档，验证后即可完成登记。

客户端使用 HTTPS URL 作为 client_id，该 URL 指向包含客户端元数据的 JSON 文档。授权服务器获取并验证该文档。

元数据示例：

{
  "client_id": "https://app.example.com/oauth/client-metadata.json",
  "client_name": "Example MCP Client",
  "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"
}

授权服务器通过元数据中的 client_id_metadata_document_supported: true 表明支持此方式。

7.2 预注册 #

客户端使用预注册的 client_id（及 client credentials，若适用），可硬编码或由用户输入。

7.3 Dynamic Client Registration #

客户端向授权服务器的 registration_endpoint 发送 POST 请求，动态获取 client ID。用于向后兼容。

8. 范围选择策略 #

Scope（范围）表示「能访问什么」。客户端在授权时应请求最小必要的 scope，避免一次性要全部权限。

遵循最小权限原则；额外 scope 通过 Scope Challenge 处理 逐步请求。

9. 授权流程 #

完整流程可概括为 8 步：

1. 客户端发起未认证请求 → 收到 401
2. 获取资源元数据 → 提取授权服务器
3. 获取授权服务器元数据
4. 选择客户端注册方式（Client ID 元数据 / 预注册 / 动态注册）
5. 生成 PKCE 参数，包含 resource 参数
6. 打开浏览器 → 用户授权 → 重定向回带授权码
7. 用授权码 + code_verifier 交换访问令牌
8. 后续请求携带 Authorization: Bearer <token>

resource 参数：客户端必须在授权请求和 token 请求中包含 resource，标识目标 MCP 服务器（如 https://mcp.example.com）。详见 RFC 8707。

10. 错误处理 #

10.1 Scope Challenge 处理 #

当客户端持有令牌但 scope 不足时，服务器应当返回：

HTTP/1.1 403 Forbidden
WWW-Authenticate: Bearer error="insufficient_scope",
                         scope="files:read files:write",
                         resource_metadata="https://mcp.example.com/.well-known/oauth-protected-resource"

客户端应当通过 step-up 授权流程请求更大 scope 的令牌，或重试有限次数后中止。

11. 安全要点 #

详见 安全最佳实践 中的令牌透传、混淆代理等。

12. 术语速查 #