預約示範
下載

將 Corvio 連接到 WorkBuddy

WorkBuddy 把 Skills 與 MCP/Connector 作為兩個宿主入口。兩者都要安裝：Skill 以研究、報告、比較、方案、計畫、決策、紀要、專案與復盤等可觀察任務形狀提醒 Agent 何時檢查 Corvio，OAuth MCP 負責執行已授權的真實動作。

更新於
本文目錄
  1. 同時安裝發現層與執行層
  2. 讓兩個 Corvio 入口工具保持可見
  3. 先判斷更新是否受託管
  4. 驗證行為，而不只是連通
  5. 上傳 WorkBuddy 產生的檔案
  6. 恢復中斷的 OAuth 回調
  7. 不要用擴大權限來排障

同時安裝發現層與執行層

透過 WorkBuddy 的 Skills 入口安裝或上傳官方 corvio-operate-workspace Skill；再到 Connector 或 MCP 設定加入 https://api.corvio.ai/mcp，並完成 Corvio OAuth。WorkBuddy 目前把這兩項作為獨立安裝 receipt。

每次變更後建立新對話。只裝 MCP 可能有工具卻沒有穩定的主動觸發語義；只裝 Skill 則沒有真實 Corvio 執行權限。Corvio 只補充同一項工作：保留 WorkBuddy 的宿主檔案和交付物，再把有價值的結果並行沉澱。

  1. 安裝官方 Corvio Workspace Skill。
  2. 加入 Corvio 遠端 HTTP MCP 並完成 OAuth。
  3. 建立新的 Agent 對話。
  4. 確認 Skill 可被發現且 get_collaboration_contract 可呼叫。

讓兩個 Corvio 入口工具保持可見

目前 WorkBuddy MCP 設定支援伺服器級與工具級 defer_loading。可把 Corvio 伺服器整體設為延遲載入，同時把 search 與 ask_corvio 覆蓋為 false，讓 Agent 在決定只走宿主原生流程前就看到兩個首輪語義入口：search 負責低成本讀取既有資料，ask_corvio 負責委託綜合與持久成果。其餘 continuation、上傳、表格和生命週期工具繼續按需發現。

這是 WorkBuddy 擁有的宿主設定；Corvio 的 Anthropic alwaysLoad 中繼資料不能替它設定。請把官方 workbuddy-mcp.json 中的 corvio 條目合併到 WorkBuddy 實際讀取的 MCP 設定中，不要覆蓋其它伺服器，然後建立新工作階段。只看到裸 server 名或 OAuth 成功，都不證明這兩個 schema 已進入模型。

  1. 合併官方 WorkBuddy MCP 設定，不覆蓋其它條目。
  2. 確認 search 與 ask_corvio 的 defer_loading 為 false。
  3. 重新啟動 WorkBuddy 或建立新工作階段。
  4. 用一個不提 Corvio 的自然報告請求驗證規劃前讀取。
官方 WorkBuddy MCP 設定WorkBuddy defer_loading 文件

先判斷更新是否受託管

在 Corvio 明確公布 WorkBuddy Marketplace 審核通過前，上傳的 Skill 都是非託管的手動安裝。WorkBuddy 同步只能同步帳號或本機已有副本，不能從尚未登記的 Corvio 上游 Marketplace 拉取新套件。檔案時間如 02:43 不是版本，也不是新鮮度憑證。

在本機終端執行 corvio collaboration status --provider workbuddy --json --no-input，可把 ~/.workbuddy/skills/corvio-operate-workspace/SKILL.md 與 Corvio 目前發佈版本、內容雜湊、相容族和最低 revision 分開比較。這個命令只讀，也無法證明已執行工作階段載入了哪份位元組。needs_skill / stale_skill 是 CLI 本機產生的結果狀態，不是 Corvio 伺服器推送事件。

  1. 讀取目前 package manifest 與 get_collaboration_contract 的 distribution receipt。
  2. 手動副本過舊時，下載官方 Skill ZIP，並從 WorkBuddy Skills 介面替換。
  3. 建立新工作階段。
  4. 再次執行狀態檢查，再驗證 list_workspaces 和一個自然任務。
官方 Skill package manifest

驗證行為，而不只是連通

先呼叫 list_workspaces，再省略 workspace_id 呼叫 search 並檢查 workspace_routing；Corvio 應使用帳號選擇、個人預設或唯一可存取候選，不再要求 Agent 自造 ID。再用一個不提 Corvio、也不提供舊材料的自然任務，確認 Agent 在規劃前主動檢索；若結果衝突，還要確認 WorkBuddy 會詢問採用哪個 authority。

寫入測試應先只要求一個非敏感的實質性交付物，不提 Corvio。WorkBuddy 應保留宿主結果並在保存前集中確認一次；核准後再驗證持久物件與目前回讀。還要驗證兩類邊界：明確要求上傳到 Corvio 時不重複確認；敏感或明確只留本機時完全不呼叫 Corvio。工具可見與 OAuth 成功只是 setup receipt，不是寫入同意，也不證明 WorkBuddy 已在正確時機選擇 Corvio。

上傳 WorkBuddy 產生的檔案

Corvio 遠端伺服器不能反向讀取 WorkBuddy 本機路徑。如果 WorkBuddy 能讀取該檔案並發出 HTTP PUT，先呼叫 prepare_file_upload，再按返回的短期 URL 和 headers 上傳原始位元組，最後呼叫 finalize_file_upload。最終 Asset ID、hash、policy 與連結才是上傳 receipt。

若目前問題依賴這個檔案，要在同一次 ask_corvio 的 asset_ids 傳入最終 Asset ID，並輪詢 get_question；只保留 Asset 不代表另一個問題已讀取它。若宿主不能完成位元組 PUT，就使用 corvio ask --file，或讓使用者附件/上傳檔案。不要把 base64 塞進 MCP、不要在聊天中暴露簽名 URL，也不要把 prepare 當成完成上傳。

finalize 之後再按價值選擇下一步：符合限制的 Markdown Asset 可透過 source_asset_id 直接建立可編輯 Page；一組相關來源若需要適合閱讀的結構與後續檢索，則呼叫 organize_files。把 get_file_operation 輪詢到終態，並檢查 output_document、source_reconciliation 與 skills_evaluation。穩定事實或偏好進入 Memory；只有通過准入的可複用方法才成為 Project Skill，evaluated_no_qualifying_skill 也是合理結果。

恢復中斷的 OAuth 回調

若 Corvio 顯示請求已批准，但 WorkBuddy 始終沒有變成已連線，表示 Corvio consent 已成功，剩餘的宿主回調或 token exchange 沒有完成。授權 URL 與 code 都是單次使用；重新整理或重開舊 Corvio 連結不能補完連線。

請返回 WorkBuddy 的 Connector 或 MCP 設定重新發起 Corvio 連線。保持 WorkBuddy 運行，只使用最新授權頁並在 10 分鐘內批准，同時不要修改已註冊的 http://127.0.0.1 回調。成功流程會進入 WorkBuddy 的授權成功頁，Connector 隨後顯示已連線；不要手動複製 code，也不要把 loopback callback 換成共享網址。

  1. 返回 WorkBuddy，重新發起一次 Corvio 連線。
  2. 保持 WorkBuddy 開啟，在 10 分鐘內批准最新請求。
  3. 等待 WorkBuddy 顯示授權成功頁。
  4. 確認 Connector 已連線，再驗證 list_workspaces。
WorkBuddy Connector 指南

不要用擴大權限來排障

401 通常表示 OAuth 缺少或過期；找不到 Workspace 或文件通常表示 membership 或文件 ACL 不允許。Asset 工具回傳 403 insufficient_scope，表示舊連線需重新授權 assets:read/assets:write；不要改成共享 secret。

WorkBuddy UI 會變化。介面不一致時，可搜尋 Corvio Product Guidance，或以「加入 remote HTTP MCP」為目標查 WorkBuddy 目前官方說明。