在 Kimi Code 中加入 Corvio
在 Kimi Code 目前的 MCP 設定入口加入名為 Corvio 的遠端 HTTP server,並填寫 Corvio 遠端 MCP 位址。
填寫 https://api.corvio.ai/mcp。不要把 API Key 放進 MCP 位址、提示詞或設定。
- 加入名為 Corvio 的遠端 HTTP MCP 或 Connector。
- 填寫 https://api.corvio.ai/mcp。
- 在 Corvio 瀏覽器頁面繼續,並核准所需權限。
- 授權後建立新的 Kimi Code 工作階段,並確認工具已出現。
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。