OAuth 授权
MCP 使用 OAuth 2.1 Authorization Code + PKCE。客户端不应直接使用渠道密钥访问 MCP,也不应把 access token 写入日志或持久化存储。
端点
授权服务器提供以下端点:
| 端点 | 方法 | 用途 |
|---|---|---|
/services/oauth/authorize |
GET |
发起授权 |
/services/oauth/token |
POST |
用授权码换取 access token |
/services/oauth/revoke |
POST |
撤销 token |
/services/oauth/register |
POST |
动态注册 public client(按环境配置决定是否开放) |
MCP resource 的 protected resource metadata 会返回实际授权服务器地址和 resource 标识。客户端应优先根据 metadata 发现端点,不要硬编码环境域名。
授权要求
- 使用
response_type=code。 - 使用
code_challenge_method=S256。 redirect_uri必须与客户端注册信息匹配;loopback 客户端应按 OAuth 规范使用动态端口。- 请求的 scope 只能来自平台支持的 MCP scope。
- 访问
/services/mcp时必须使用Authorization: Bearer。
Scope
公开工具 scope 为:
mcp:hotel.meta.search
mcp:hotel.search
mcp:hotel.rates
mcp:hotel.rate-rule
mcp:order.search
内部分析工具需要额外的账号 capability。token scope 和账号能力任一缺失时,工具都不会暴露或调用成功。