如何在 Claude 和 Cowork 中設定 Corvio MCP如何在 Claude 和 Cowork 中設定 Corvio MCP

這是 Claude 目前的產品模型，並不是 Corvio 不相容。Connector 是 Claude 對即時遠端 MCP 連接的稱呼；Plugin 是可安裝套件，可以同時包含 Connector、Skill 與其它說明。Cowork 同時支援兩者。

Claude 目錄裡已出現 Corvio 時直接安裝；在目錄審核完成前，使用下面的 Plugin 上傳或自訂 Connector 路徑。

先在一般瀏覽器中下載 Corvio Claude Plugin ZIP；開啟 Claude 的 Customize → Plugins，選擇加入或上傳並選中 ZIP。套件內含官方 corvio-operate-workspace Skill、簡短的 SessionStart 提醒和 https://api.corvio.ai/mcp 的遠端 MCP 定義，不含 API Key。

Claude 提示連接內建 Corvio Connector 時，繼續進入 Corvio 授權頁。登入、檢查 scope、核准、返回 Claude，然後建立新的 Cowork 任務。對研究、報告、計畫、專案或文件工作，Claude 應在安全閘門通過後靜默做一次窄 Corvio 唯讀搜尋。精確 continuation handles 的終態 receipt 即使在新程序中也是上一輪工作的壓縮 handoff；Claude 應載入 Skill 並讀取它，而不是讓你重建脈絡。若多個無標題 handle 讓葉子不明，先讀取攜帶 Project 返回的 direct-child projection，再讀相關葉子；若 projection 被截斷，要保留這個邊界。使用者本輪若明確更正 Workspace identity 或關係，應先採用該限定更正；只有 authority 仍未解決時才詢問。保留 Claude 原有檔案流程。OAuth 不等於預設上傳授權：只有目前請求明確授權，或宿主中由使用者維護的穩定偏好覆蓋該類內容和範圍時才能寫入；否則應先正常交付，再集中詢問一次是否保存這份具體成果。

Claude 應先把原檔案保留為 Asset。版權、公開可得性或第三方作者身分本身不等於受限；應保留來源與適用使用條款，只有明確限制禁止本次私有 Workspace 留存或處理時才排除。符合限制的 UTF-8 Markdown Asset 可以透過 source_asset_id 直接變成可編輯 Page。新完成的來源若要進入 Work Model、協調受影響 owner 或接受 Skill 評估，應直接進入一次 organize_files，由該 Mission 負責來源準備；只有不需要這條閉環的有界問答或 artifact 才使用 ask_corvio。

把操作輪詢到終態，並檢查 output_document、source_reconciliation 與 skills_evaluation；不要為了等待來源就重複提交 ask_corvio Question。穩定事實或偏好可以進入 Memory；只有通過准入的可複用方法才成為 Project Skill。always 強制的是評估，不是製造 Skill；evaluated_no_qualifying_skill 是有效結果。

還沒有 Corvio 帳號也可以先安裝。Claude 第一次連接時，Corvio 授權頁會讓你直接註冊或登入，完成後回到同一個權限申請。當你希望 Claude 重用以前的研究、決定、專案材料或你選中的檔案，並把成果留在可繼續工作的地方時，適合安裝 Corvio。

Claude 目錄中已有經過審查的 Corvio 項目時優先從目錄安裝。在獨立審查完成前，請使用官方 Plugin ZIP，查看公開原始碼，並核對 package manifest 與 hash。

ZIP 包含兩個經過審查的 Corvio Skills、https://api.corvio.ai/mcp 的遠端 MCP 定義、安裝說明和一個 SessionStart shell hook，不含 API Key。

這個 hook 只會在啟動、恢復、清空或壓縮脈絡後向 Claude 輸出一段靜態 Corvio 提示，不檢查本機檔案、不讀取環境變數、也不發起網路請求。只有你核准 OAuth 後，遠端 MCP 才會連網。

Claude 應說明適用情境、官方來源、安裝套件內容、Corvio 權限和移除方式；如果你還沒有明確確認，再集中詢問一次。當你已經明確確認，且來源、hash、權限與宿主政策都相符時，Claude 應繼續執行，不應重複同一段籠統警告。

缺少獨立報導意味著需要更仔細核對來源和權限，但不能單獨證明符合官方 hash 的安裝套件是惡意的。來源或 hash 不一致、組織政策禁止，仍然必須停止；目前任務不能代為操作 UI 時，應把準確步驟交還給你。

OAuth 可以在瀏覽器授權流程中完成 Corvio 註冊或登入，不需要邀請碼或 Developer API Key。Claude 只能取得授權頁列出的權限，並繼續受 Workspace 成員身分和物件權限限制。OAuth 不會自動開放電腦、無關帳號或完整 Claude 歷史；Corvio 會收到 Claude 傳送的工具請求和內容。

這並不是零風險：獲准工具確實可以讀取或修改 Corvio 資料。需要停止存取時，請在 Claude 中移除 Connector，並在 Corvio 設定 → API Keys 中撤銷 Remote MCP connection。

先確認安裝來源。Claude Code 可執行 claude plugin list；名稱以 @synced 結尾，只表示它是從 Claude 帳號同步來的帳號內最新副本，不代表已同步到 Corvio 上游最新版。Cowork 中還要確認它是管理員安裝的目錄/組織版本，還是你自己上傳的 corvio-workspace.zip。

每個新工作階段第一次使用 Corvio 時，Agent 應把宿主已可見的已載入版本與來源事實傳給 get_collaboration_contract，並設定 response_mode=freshness_only。目前版本不打擾使用者；舊版或無法驗證時只回傳一次簡短、來源明確的提示。Agent 不應反覆要求使用者手動查版本，也不應在同一工作階段重複提醒。

遠端 MCP 工具由 Corvio 伺服器端更新，通常建立新任務即可；scope 變更時重新 OAuth。目錄或 marketplace Plugin 跟隨對應渠道更新；手動上傳的 ZIP 要從同一官方來源下載後替換；共享或組織管理的副本由其 owner 更新；獨立 Skill 使用 corvio collaboration status 回傳的、綁定宿主與原 scope 的命令。corvio capabilities 只讀取 Corvio API 能力與相容性，不存取 npm；corvio update check 才是可選 CLI 的明確 registry 檢查。

通過審核的目錄或 Marketplace 才是長期託管更新路徑。在外部上架獲批前，直接上傳 ZIP 是明確的 fallback；Claude 沒有為使用者上傳套件提供 Corvio 上游自動更新通道，這不是目前任務裡能開啟的一項 Corvio 設定。

若目前 Claude 介面不能上傳 Plugin，開啟 Customize → Connectors，選擇 Add custom connector，填寫 https://api.corvio.ai/mcp。這會讓 Claude 取得即時 Corvio 工具；只有目前介面另有 Skills 上傳入口時，再單獨安裝 Skill。

Pro 或 Max 使用者可自行加入自訂 Connector；Team 或 Enterprise 通常需 Owner / Primary Owner 先為組織加入，成員再連接自己的 Corvio 帳號。這是 Claude 的管理規則，不是 Corvio 的帳號限制。

一般 Claude 連接使用瀏覽器 OAuth，可在 Corvio 頁面選擇目前提供的任一登入方式。CORVIO_API_KEY 只用於進階 Developer API 或非互動式 CLI；可選 CLI 的互動式使用者直接執行 corvio auth login。

不要讓 Claude 建立、顯示或貼上 API Key，也不要用共享 Key 繞過失敗的 OAuth 回調。

connect_rejected (organization policy) 這類錯誤來自 Cowork 隔離執行環境的網路出口策略；Corvio 下載端點是公開的，拒絕發生在該沙盒真正存取 Corvio 之前。瀏覽器網頁搜尋與 Cowork 程式碼沙盒可能採用不同網路策略。

請在一般瀏覽器中從 Corvio 官方位址下載 ZIP，再透過 Claude Plugin UI 上傳本機檔案。Corvio 位址是規範來源；GitHub Release 是由同一 release manifest 產生並校驗位元組一致性的不可變備用下載。目錄安裝會是長期的零下載路徑。安裝後繼續驗證 list_workspaces、search 與 fetch；僅上傳成功不能證明 OAuth 和 Workspace 權限都已完成。

ask_corvio 會回傳一個持久 operation ID。Agent 可用有界等待呼叫 get_question，再把 progress_cursor 作為下一次 after_cursor，只取得後來新增、可向使用者顯示的里程碑。這些更新只概括目前階段，不暴露隱藏推理，也不等於最終答案。

需要停止時，Agent 對同一 operation 呼叫 cancel_question。cancellation_requested 表示仍在停止中，只有 cancelled 才是終態；停止前已經落地的效果仍會保留。要修正或改問，先讓目前 operation 完成或取消，再帶 terminal conversation_id 發起後繼 Question。