开发 OAuth MCP 客户端
发现 i2v.ai 授权服务器,注册公开客户端,并按需申请权限。
自行开发客户端时,可以使用支持 OAuth 的 Streamable HTTP MCP SDK。资源地址和令牌受众均为 https://i2v.ai/api/mcp。
发现并注册
- 未认证的 MCP 请求返回 HTTP
401。读取WWW-Authenticate中的resource_metadata,它指向https://i2v.ai/.well-known/oauth-protected-resource/api/mcp。 - 从资源元数据找到授权服务器,再读取
https://i2v.ai/.well-known/oauth-authorization-server,发现授权、令牌、注册与撤销端点。 - 使用元数据公布的
registration_endpoint注册公开客户端。通过redirect_uris提供回调地址,token_endpoint_auth_method设为none。登记准确的 HTTPS 回调地址,本地应用可使用回环地址。
授权与初始化
- 为本次授权生成新的 PKCE verifier,发送其 S256 challenge,并保存用于回调校验的
state。授权请求需带上response_type=code、已登记的client_id和redirect_uri、MCP 的resource及所需权限。 - 模型和账户查询申请
mcp:read。需要上传或提交时,同时申请mcp:write,由用户在授权页同意。以最终授予的权限为准。 - 回调中校验
state,用原 verifier 和回调地址交换令牌。将 access token 作为 Bearer 凭据发送给 MCP 端点。在发现或调用工具前,先完成 SDK 的连接初始化。
刷新与撤销
授权码有效期为 60 秒,access token 有效期为 1 小时,refresh token 有效期为 30 天且每次使用后轮换。原子保存最新的 refresh token,避免并发进程重用已消费的令牌。可使用发现文档中的撤销端点,也可让用户在撤销。避免把令牌写入日志或工单。客户端行为见 MCP 授权规范。

