授權與安全

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 設定入面斷開就得。