為什麼 Claude 顯示 Plugin，而不是 MCP
這是 Claude 目前的產品模型，並不是 Corvio 不相容。Connector 是 Claude 對即時遠端 MCP 連接的稱呼；Plugin 是可安裝套件，可以同時包含 Connector、Skill 與其它說明。Cowork 同時支援兩者。
Claude 目錄裡已出現 Corvio 時直接安裝；在目錄審核完成前，使用下面的 Plugin 上傳或自訂 Connector 路徑。
Cowork 最快的完整安裝
先在一般瀏覽器中下載 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 讀取一次相關歷史，同時保留原有檔案流程。一次性結果通常不應保存，但這本身不取消讀取。
- 在瀏覽器下載 corvio-workspace.zip。
- 從 Claude Customize → Plugins 上傳。
- 連接 Corvio 並核准 OAuth。
- 建立新的 Cowork 任務並驗證工具。
不只檢索，還要形成可複用結果
Claude 應先把原檔案保留為 Asset。符合限制的 UTF-8 Markdown Asset 可以透過 source_asset_id 直接變成可編輯 Page；其它格式或一組相關來源應使用 organize_files 或 ask_corvio，讓 Corvio 產出最適合讀者的載體。
把操作輪詢到終態，並檢查 output_document、source_reconciliation 與 skills_evaluation。穩定事實或偏好可以進入 Memory；只有通過准入的可複用方法才成為 Project Skill。always 強制的是評估，不是製造 Skill；evaluated_no_qualifying_skill 是有效結果。
- 完成並核對 Asset。
- 選擇 Markdown 直轉 Page 或語義整理。
- 輪詢並回讀持久結果。
- 僅在 Skill 通過准入時保留候選身分與資源 receipt。
更新你實際安裝的那一份
先確認安裝來源。Claude Code 可執行 claude plugin list；名稱以 @synced 結尾，只表示它是從 Claude 帳號同步來的帳號內最新副本，不代表已同步到 Corvio 上游最新版。Cowork 中還要確認它是管理員安裝的目錄/組織版本，還是你自己上傳的 corvio-workspace.zip。
遠端 MCP 工具由 Corvio 伺服器端更新，通常建立新任務即可；scope 變更時重新 OAuth。目錄或 marketplace Plugin 跟隨對應渠道更新；手動上傳的 ZIP 要從同一官方來源下載後替換；共享或組織管理的副本由其 owner 更新；獨立 Skill 從原來源重裝。corvio update check 只檢查可選 CLI。
通過審核的目錄或 Marketplace 才是長期託管更新路徑。在外部上架獲批前，直接上傳 ZIP 是明確的 fallback；Claude 沒有為使用者上傳套件提供 Corvio 上游自動更新通道，這不是目前任務裡能開啟的一項 Corvio 設定。
- 呼叫 Corvio get_collaboration_contract，讀取 distribution.claude_plugin.current_version。
- 記錄已安裝來源和版本，不要從 @synced 推斷 Corvio 上游新舊。
- 只更新過期的本機套件或 marketplace 安裝。
- 建立新任務，呼叫 list_workspaces，並驗證一次自然讀取與持久化回讀。
只連接 Connector 的備用路徑
若目前 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 的帳號限制。
不需要 API Key
一般 Claude 連接使用瀏覽器 OAuth，可在 Corvio 頁面選擇目前提供的任一登入方式。CORVIO_API_KEY 只用於進階 Developer API 或非互動式 CLI；可選 CLI 的互動式使用者直接執行 corvio auth login。
不要讓 Claude 建立、顯示或貼上 API Key，也不要用共享 Key 繞過失敗的 OAuth 回調。
Claude 拒絕下載 ZIP 時
connect_rejected (organization policy) 這類錯誤來自 Cowork 隔離執行環境的網路出口策略；Corvio 下載端點是公開的，拒絕發生在該沙盒真正存取 Corvio 之前。瀏覽器網頁搜尋與 Cowork 程式碼沙盒可能採用不同網路策略。
請在一般瀏覽器中從 Corvio 官方位址下載 ZIP，再透過 Claude Plugin UI 上傳本機檔案。GitHub 公共儲存庫是 marketplace 安裝的受管原始碼，不是第二份二進位鏡像。目錄安裝會是長期的零下載路徑。安裝後繼續驗證 list_workspaces、search 與 fetch；僅上傳成功不能證明 OAuth 和 Workspace 權限都已完成。