# 开发 OAuth MCP 客户端

自行开发客户端时，可以使用支持 OAuth 的 Streamable HTTP MCP SDK。资源地址和令牌受众均为 `https://i2v.ai/api/mcp`。

## 发现并注册

1. 未认证的 MCP 请求返回 HTTP `401`。读取 `WWW-Authenticate` 中的 `resource_metadata`，它指向 `https://i2v.ai/.well-known/oauth-protected-resource/api/mcp`。
2. 从资源元数据找到授权服务器，再读取 `https://i2v.ai/.well-known/oauth-authorization-server`，发现授权、令牌、注册与撤销端点。
3. 使用元数据公布的 `registration_endpoint` 注册公开客户端。通过 `redirect_uris` 提供回调地址，`token_endpoint_auth_method` 设为 `none`。登记准确的 HTTPS 回调地址，本地应用可使用回环地址。

## 授权与初始化

1. 为本次授权生成新的 PKCE verifier，发送其 S256 challenge，并保存用于回调校验的 `state`。授权请求需带上 `response_type=code`、已登记的 `client_id` 和 `redirect_uri`、MCP 的 `resource` 及所需权限。
2. 模型和账户查询申请 `mcp:read`。需要上传或提交时，同时申请 `mcp:write`，由用户在授权页同意。以最终授予的权限为准。
3. 回调中校验 `state`，用原 verifier 和回调地址交换令牌。将 access token 作为 Bearer 凭据发送给 MCP 端点。在发现或调用工具前，先完成 SDK 的连接初始化。

## 刷新与撤销

授权码有效期为 60 秒，access token 有效期为 1 小时，refresh token 有效期为 30 天且每次使用后轮换。原子保存最新的 refresh token，避免并发进程重用已消费的令牌。可使用发现文档中的撤销端点，也可让用户在[连接管理](/settings/connections)撤销。避免把令牌写入日志或工单。客户端行为见 [MCP 授权规范](https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization)。