在 Cursor 中加入 Corvio
開啟 Cursor MCP 設定，加入名為 Corvio 的遠端 HTTP server，並填寫 Corvio 遠端 MCP 位址。
填寫 https://api.corvio.ai/mcp。不要把 API Key 放進 MCP 位址、提示詞或設定。
- 加入名為 Corvio 的遠端 HTTP MCP 或 Connector。
- 填寫 https://api.corvio.ai/mcp。
- 在 Corvio 瀏覽器頁面繼續，並核准所需權限。
- 授權後重新載入 Cursor 視窗，或建立新的 Agent 對話。
OAuth 才是一般登入方式
一般互動式連接會開啟 Corvio 授權頁面。你可以使用 Corvio 目前提供的任一帳號登入方式，檢查請求的 scope 後核准；一次性授權碼由宿主自行交換。
CORVIO_API_KEY 只適用於進階 Developer API 或非互動式 CLI。遠端 MCP 不要求它；不要把它貼到聊天中，也不要用它繞過失敗的 OAuth 回調。
驗證連接
先呼叫 list_workspaces，選擇有權限的 Workspace，再針對已知文件執行 search 和 fetch。OAuth 頁面變綠或 Connector 可見只是設定證據；工具真正回傳預期 Corvio URL 才證明連接完成。
若 Corvio 已核准但宿主仍顯示需要驗證，請移除舊連接，從宿主重新發起，只核准最新請求，並建立新工作階段。不要重複使用舊授權連結。
- 執行 list_workspaces。
- 搜尋一個已知專案或文件。
- 讀取結果並檢查 Corvio URL。
- 需要寫入權限時，做一次可逆寫入並回讀。
把檔案變成可複用工作
完成上傳只證明 Corvio 已保留原始位元組、hash、policy 與來源，並不自動證明已理解或整理。符合限制的 UTF-8 Markdown Asset 可以透過 source_asset_id 直接變成可編輯 Page；其它格式或語義重組使用 organize_files 或 ask_corvio，產出最適合讀者的 Page、Spreadsheet、Presentation、Code、HTML Artifact 或閱讀層。
對一組相關來源，要把 get_file_operation 輪詢到終態，並檢查 output_document、source_reconciliation 與 skills_evaluation。穩定事實或偏好可以進入 Memory；只有有證據、可遷移的方法、設定、約束或品質標準才成為 Project Skill。skills_extraction_mode=always 強制的是這次判斷，也可以合理回傳 evaluated_no_qualifying_skill。
- 完成所選 Asset 並核對 ID 與 hash。
- 選擇 Markdown 直轉 Page，或語義整理/ask 路徑。
- 輪詢到終態並回讀文件或 artifact。
- 只有 Skill 通過准入時才保留其候選身分與資源 receipt。
委託結果，信任終態 receipt
呼叫 ask_corvio 時，只傳使用者的自然目標、完整的決策相關 context 和明確約束。除非使用者親自指定，否則不要替 Corvio 發明 taxonomy、文件標題、artifact 數量或內部計畫。Corvio 負責認知結構和載體：相關輸入可以共享 Project，獨立 reader job 仍應分開。
把 get_question 輪詢到終態，並原樣使用 artifact.url 或 links.primary_artifact：reader_output 是使用者結果，structure_container 是層級，sources 是證據，node_id 不是文件 URL。
- 傳入自然目標和完整 context。
- 保留使用者明確約束，不新增內部方案。
- 把 Question 輪詢到終態。
- 原樣返回 canonical artifact URL。