常見問題
我的 agent 要怎麼跟 wspc 完成認證？
wspc 使用 OAuth 2.1。Agent host（Claude Desktop、Cursor、Hermes）連到 remote MCP server，在瀏覽器用 6 位數 email 驗證碼登入。瀏覽器 SPA 走 OAuth 2.1 device flow。在終端機則執行 npx wspc login。各環境的設定方式見 /zh-tw/quickstart。
wspc 會發出哪些 scope？
目前只有 wspc:full —— 對已登入使用者在所有服務的 root 層級存取權。各 domain 細分的 scope（例如 todo:read）尚未提供；就算傳了也不會得到更細的權限。
我該用 REST、MCP，還是 CLI？
AI agent 用 MCP 或 CLI；應用程式與整合用 REST API；個人使用用 CLI。三者打的都是同一個 workspace 後端。各環境的設定方式見 /zh-tw/quickstart。
access token 有效多久？
access token有效 15 分鐘。用 refresh token 換新；每次換新都會讓上一個 refresh token 失效。
wspc 現在能做什麼？
目前的服務面是 email、calendar 與 todo（library 規劃在 POC 3）。todo 支援 OAuth 2.1 讀寫；calendar 與 email 目前接受長期有效的 API key。
最新完整的 API 參考在哪裡？
https://api.wspc.ai/<domain>/openapi.json 上各 worker 的即時 OpenAPI spec 才是真相來源。MCP 請以即時的 tools/list schema 為準；CLI 請執行 wspc --help。
wspc 免費嗎？
wspc 處於 POC 階段，可免費使用。