Corvio 說明中心 · MCP 與 Agent

Corvio MCP:安裝、連接與驗證

Corvio MCP 讓 AI 宿主在你核准的權限範圍內存取 Workspace。用宿主的 Connector 或 MCP 入口取得即時工具,用 Corvio Skill 或 Plugin 補充主動協作方法;只有宿主需要本機檔案或專案 Agent 時才需要 CLI。

更新於 2026-09-09

選擇正確的 Corvio 安裝面

遠端 MCP 是即時連接:加入 https://api.corvio.ai/mcp,並透過 Corvio OAuth 登入。Skill 教 Agent 何時讀取共享脈絡、何時把有價值的結果送回。Plugin 可以把兩者打包。可選的 @corvio/cli 只用於本機路徑、下載、同步或專案 Agent。

一般 Claude、ChatGPT、Codex、WorkBuddy、Cursor 或其它互動式 MCP 連接不需要建立 API Key。不要把憑證貼到聊天中。

安裝並授權

宿主目錄中已有 Corvio 項目時優先從目錄安裝;尚未收錄時,直接加入遠端 HTTP MCP 位址並完成 Corvio 授權。宿主另有 Skills 入口時也安裝 Skill;Claude Cowork 和 Claude Code 則可用 Corvio Plugin 同時攜帶 Skill 與 MCP 定義。

在 Corvio 頁面使用目前提供的任一帳號方式登入,檢查 scope 後核准。Corvio 隨後把控制權交還宿主,由宿主交換一次性授權碼。

  1. 開啟宿主的 Connector、MCP 或 Plugin 設定。
  2. 加入 https://api.corvio.ai/mcp 或安裝 Corvio Plugin。
  3. 完成 Corvio OAuth,不要修改回調位址。
  4. 建立新的宿主工作階段。

證明整條連接已完成

呼叫 list_workspaces,再針對已知文件執行 search 和 fetch。若 Agent 需要寫入,做一次可逆編輯或建立測試文件並回讀。安裝包存在、授權頁成功或工具清單可見,都不能單獨證明全流程完成。

檔案流程要驗證完整價值鏈:最終 Asset、Markdown 直轉 Page 或合適的派生載體、終態整理 receipt、來源對帳,以及通過證據准入的 Memory/Skill 結果。僅上傳不算完成;Skill 策略為 always 時也可以合理回傳 evaluated_no_qualifying_skill。

若 Corvio 已核准但宿主仍顯示需要驗證,請移除舊連接並從宿主重新發起。授權連結和 code 都是單次使用。若雲端 Agent 因網路策略無法下載 ZIP,請在一般瀏覽器中下載,再從宿主的 Plugin 或 Skill UI 上傳。

  1. 驗證 list_workspaces。
  2. 驗證 search 與 fetch。
  3. 需要時驗證一次授權寫入與回讀。
  4. 保留一個不應自動上傳的簡單或敏感任務作為反例。