授权与安全

usmartsg-mcp 使用 OAuth2 授权码 + PKCE：在浏览器用 uSMART 账户完成授权，令牌自动续期。你的密码只输入在 uSMART 的页面上，不会进入模型上下文。

OAuth2 授权要点

• 授权方式：授权码 + PKCE（S256），在浏览器完成授权
• 应用：使用内置的公开应用，不需要自己申请 App ID，也没有 App Secret
• 续期：access_token 过期前自动刷新，refresh_token 自动轮换，本机会话文件为 oauth_session.json
• 范围：order:all

授权流程

1. 在客户端里调用 oauth_login，返回授权链接并打开浏览器
2. 在 uSMART 页面登录并同意授权
3. 调用 oauth_login_status 等待结果并兑换令牌
4. 会话写入本机 oauth_session.json，之后自动刷新

写操作的三道保护

• 显式确认：每次写操作都必须传 confirmed=true
• 整手预检：下单前按每手股数校验，数量不对直接拒绝
• 审计与不重试：写操作落本机 JSONL 审计；超时或鉴权失败一律转人工核验，不做第二次

Claude 连接器的授权

• uSMART 是授权服务器，Claude 直接与 uSMART 完成 OAuth，连接器服务只转发令牌
• 连接器服务不保存令牌，不做服务端刷新；令牌过期后由 Claude 自动刷新
• 连接器只做订单查询与下单前预检

撤销授权

调用 oauth_logout 删除本地会话，或删除 ~/.usmart/oauth_session.json，等于本地登出。远端 refresh_token 有效期 30 天，无法由本地撤销。Claude 连接器在 Claude 的 Connectors 设置里断开即可。