# autos.mcp.oauth 库模块帮助文档
## autos.mcp.oauth 成员列表 #
### autos.mcp.oauth.version #
OAuth 模块版本（独立于 MCP 传输版本）。
## autos.mcp 成员列表 #
### autos.mcp.oauth() #
[返回对象:autosMcpOAuthObject](#autosMcpOAuthObject)
### autos.mcp.oauth(config,storeName) #
独立 Remote HTTP OAuth 公共客户端，不改变 MCP 协议代际。config 至少指定 url；可选 resource、issuer、clientId、clientMetadataUrl、scope、trustedOrigins、allowDynamicRegistration、redirectPort、timeoutMs、authorizationTimeoutMs。
storeName 可选：用当前用户 DPAPI 保存绑定当前配置的凭据。不接受 clientSecret。构造不联网。
## autosMcpOAuthObject 成员列表 #
### autosMcpOAuthObject.authorize(options) #
显式浏览器授权；PKCE S256/state/resource/issuer 校验。options 可指定 challenge、shouldStop、confirmOrigin、onStatus、openBrowser。成功 true，失败 null,err,detail。回调/URL/令牌不得输出到聊天或日志。
### autosMcpOAuthObject.cancel() #
取消当前授权/网络等待，不删除已保存凭据。
### autosMcpOAuthObject.close() #
取消操作、关闭回调监听并清理内存；不删除 DPAPI 凭据。
### autosMcpOAuthObject.connect(options) #
使用有效令牌连接 MCP；不自动重试/重放。失败时由调用者检查错误后显式重新授权/重连。
### autosMcpOAuthObject.discover(challenge,options) #
资源/授权服务器发现与校验。challenge 为原 WWW-Authenticate；options.confirmOrigin(origin,purpose) 用于显式信任跨源端点。返回安全概要，不包含凭据。
### autosMcpOAuthObject.forget() #
删除本机保存凭据，不代表服务端撤销授权。
### autosMcpOAuthObject.getConfig(options) #
返回带 Bearer 的 MCP 配置，必要时刷新，不会自动打开浏览器。可用作 autos.mcp.session 的 backend 解析器；不要打印返回配置。
### autosMcpOAuthObject.refresh(options) #
显式刷新；支持轮换。发送前丢弃旧刷新凭据，失败后需要重新授权，避免重放可能已消耗的令牌。
### autosMcpOAuthObject.reopenBrowser() #
授权等待期间重新打开同一浏览器授权页；不重新发起 MCP 调用。
### autosMcpOAuthObject.state #
idle/discovering/registering/waiting_browser/exchanging/refreshing/ready/cancelled/failed。