了解 OAuth 连接

OAuth 是受支持的认证模式，但每条同意授权流程都必须针对准确目标配置和测试。API 密钥测试成功，不能证明某个 AI 客户端已具备可用的 OAuth 连接。

识别两种授权关系#

AI 客户端可能通过受支持的登录流程向部署或网关认证；服务本身也可能需要 OAuth 凭据，以业务账号身份调用上游平台。

二者不能互换。上游 OAuth 代理可能需要授权端点、令牌端点、客户端注册资料和权限范围。不要只因客户端出现 OAuth 按钮，就改变现有 API 密钥连接。

按约定流程连接#

使用交接中的准确服务或网关地址。浏览器出现授权页面时，检查域名、账号和申请的权限，只通过提供方正常流程授权给约定对象及范围。

不要把含授权码的回调 URL 发给支持人员或贴进 AI 对话。令牌和客户端密钥应保存在受支持的加密配置中。

授权后验证#

确认 AI 客户端恢复已连接状态，只发现预期工具，并在正确账号中完成约定的只读操作。若配置包含令牌刷新，还应验证刷新流程，不能认为首次连接会永久有效。

授权失败时#

记录失败阶段和脱敏后的错误。回调地址不匹配、不支持的注册流程、错误账号、缺失权限和上游授权过期，需要不同修复。不要关闭认证、接受证书警告，或借用他人的令牌。