Corvio MCP 設定、安裝與連接指南Corvio MCP 設定、安裝與連接指南

不同 AI 工具會把同一種連接稱為 MCP、Connector、App 或 Plugin。請選擇對應宿主的指南，並使用同一個官方遠端 MCP 位址；這些不同名稱不需要重複加入連接。

Corvio 遠端 MCP 位址是 https://api.corvio.ai/mcp。完成設定後還要透過 OAuth 登入並驗證一份你認得的 Workspace 內容；只看到連接成功提示不代表權限和讀取已可用。

如果你希望 Agent 在研究、報告、計畫、決策、會議紀要、專案、複盤或後續跟進時重用以前的工作，Corvio 會比較有價值。基礎能力是把經過你同意的文件變成自己 Workspace 裡的可編輯線上頁面和可分享協作連結。

更長期的價值來自經過授權的零碎資料：Corvio 可以把它們對帳到你的 Work Model 和知識樹，把穩定偏好放進合適的 Memory，只把證據充分、可遷移的方法沉澱為 Skills 或 Patterns。後續 Agent 可以直接找回這些 owner，減少重複 Token 和心智成本。如果內容只想留在目前聊天或本機，就不需要連接 Corvio。

整理會議、事故更新、slogan 變化、程式任務或檔案集前，Agent 應先搜尋長期工作主體並讀取可能相關的目前 Project。只把自然目標、來源 handle、已確認關係和使用者約束交給 Corvio，不替它發明 taxonomy；Corvio 寫入前會比較目前 Tree 與長期閱讀、更新、行動和驗收職責。使用者若明確更正了 Workspace Project 的身分、關係或 owner，本輪陳述就是該限定變更的 authority：舊材料作為 lineage 保留並被對帳；只有更正本身仍含糊或仍有互斥 authority 時才繼續詢問。

Agent 在承諾是否寫入之前，應先判斷使用者是否要把選中材料轉換成供後續行動、跟進、決策、複盤或其他持續工作使用的形態。這個未來用途會修飾整個轉換請求：即使沒有儲存動詞，也應保留原件並做一次 Work Model 對帳，而不是先在聊天裡通篇重寫再詢問是否保存。只有明確要求僅歸檔/僅保留原件，或材料除了原檔外沒有語義 owner，才停在上傳。只有 Agent 消費 canonical Project、受影響 owner receipt 與目前 Tree 回讀，終態結果才算完整；上傳成功或新建一篇 Page 還不夠。

一份保留的來源可以分別更新多個獨立治理的 Project，同時仍保持為一份可追溯文件。Corvio 應把其中的語義單元拆到受影響的 owner；不能只因來源 Page 留在 Docs 根部，就把它升格成虛構的 umbrella Project。

只有來源本身足以證明一個長期生命週期時，才建立獨立 Project。稀疏或跨專案證據應保留目前 owner 邊界，直到後續工作或使用者明確更正足以證明合併、拆分、移動或重掛。

前一輪已回傳準確的 Project、Page 或 Skill handle 時，其終態 receipt 即使在新程序中也是 prior-work 的壓縮 handoff。Agent 應讀取這份 handoff，而不是讓你重建脈絡：能識別葉子時先讀最相關 Page；多個無標題 handle 讓葉子不明時，先讀取攜帶 Project 回傳的 direct-child projection，再讀相關葉子，而不是做 Workspace 廣泛搜尋；若 projection 被截斷，必須保留這個邊界。只要你沒有切換主題，其他 Project 中字面相似的結果只能作為候選。

當你要求把反覆出現的穩定做法與先前工作對齊、供之後重用時，完成證據應是 reusable owner 的持久更新 receipt，或準確回讀證明本輪增量早已完整存在。Agent 應先判斷證據是否具備可重用資格，再選擇歸屬：另一個 Project 中的相似 Skill 不能被越權修改，但也不能成為把合格方法埋進普通事實頁的理由。只在聊天中比較或表示之後可以保存，不算 Work Model 更新完成。

用 search、fetch 或 read_document 發現並讀取目前 owner。search.content_complete 只表示發現結果集已完整，不表示命中的標題或摘要就是 owner 的完整目前正文；若 effect 更新的是同一個內容型 Page、Memory 或 Skill，且舊正文會影響保留、刪除、順序或合併，才在更新前讀取它。這不放寬精確 continuation 規則：已攜帶 Project 的 receipt 缺少 handoff 所需目前正文或 topology 時必須讀取；只有完整搜尋新選中的 Project，僅用於路由本輪新材料或重認搜尋中已明確的歸檔/不合併邊界時，才不讀取。exact continuation handles 缺少目前正文時，先用 fetch 或 read_document 讀最窄的相關 handles，再做任何 Workspace search 或 action；不得用 search 重新發現已攜帶的準確 owner；多個 handles 本身不是 semantic synthesis 的理由。answer-only Question 只用於真正的唯讀語意答案，不能把它當作同一目標中 allow-actions Question 之前的 owner 查詢或預演。應把選中的 owner，以及限制本次更新的舊版、歸檔、錯誤 scope 或禁止合併 owner，一起交給這唯一一次效果呼叫。若唯讀任務所需的最小精確 owner 集已回傳有界確定性判斷的全部 operands，就由宿主直接判斷，不能在這些讀取前後再開 answer-only Question 複述證據。除非使用者明確只要結論，還應同時說明決定性的可重用規則與目前 operands，不能漏掉已讀到的閾值或條件。

宿主生成的 Markdown 一旦參與供未來使用的語意效果，就應在只套用使用者要求的安全排除、保留標題、heading、內部空行、空格和標點且只允許末尾換行正規化後，把選中的標題與全部剩餘 Markdown 內容原樣作為 inline_materials 交給一次 allow-actions Question；即使目標 owner 已知仍然如此，因為 owner handle 只是路由證據，不能把正文變成 prompt prose。同一個未來用途還包含 finalized 原件時，原件繼續作為 Assets，並把 asset_ids 與 inline_materials 放進同一個 Question。只有正文、carrier 和 owner 都已確定時才直接建立 Page，不再追加 cleanup run。

終態 readback 只能證明它實際回傳的欄位。若使用者不要求逐字正文，typed effect field 可以證明它明確回傳的語意分類或逐 owner 的指定 include/exclude 結果，但不能證明未回傳的事實或準確正文。若 receipt 已逐 owner 明確回傳所有所需 include/exclude 結果，語意分流即完成，無需再讀正文；否則，在現有 owner 中新增、保留或刪除明確語句，或要求把指定事實排除在 reusable owner 之外時，準確正文就是驗收條件：receipt 沒有回傳正文，就用 fetch 或 read_document 逐一準確讀取受影響的 owner，不能再開 Question 驗證。僅要求保留或接入材料並回傳最終位置時，終態 owner、topology 與 link receipt 已足夠；「保留/接入這份材料」即使含有具體事實條目，仍是一般請求；只有明確要求原樣/逐字、必須包含/刪除，或不得出現在指定 owner 時，才進入 exact-body 驗收。材料細節、最終回覆提及事實、新 Skill，或 Corvio 自然選擇多個新 owner 都不改變這個邊界，不要額外讀取正文。若排除內容已在傳送前移除，且 accepted source receipt 標識了淨化後的輸入，也不需要只為證明這些內容從未傳送而讀取輸出。最終回覆應帶上每個使用者可見結果的 canonical URL；必要的 post-effect 正文讀回若沒有 URL，也不能抹掉前一個終態 receipt 已回傳的連結。Corvio 選擇的標題與使用者的描述性措辭不同，本身不構成新的 owner 歧義；終態 owner/topology 已驗證時，不要因此要求使用者再次核對或提出另一次移動。

一次最窄 owner 讀取已確定主題後，Agent 應保持你的問題不變，再單獨附加最小且完整的 owner/source context。一個已攜帶的 Project handle 通常已能界定跨分支問題，不應複製所有後代 handle。Handle 是證據位址，不是列舉 sibling、替換使用者目標、把目前 Tree 標題改寫成強制比較框架，或規定 Corvio 推理步驟的理由。

若可信的目前任務或先前 receipt 已證明這個宿主在準確 Workspace 使用過已認證官方 CLI，有界 answer-only 續問可以沿用一次前景 corvio ask，並在同一程序回傳終態 Question，避免模型可見輪詢。answer-only 是 CLI 預設值：省略 --allow-actions，且 CLI 沒有 --mode 參數。Agent 不能只為節省輪詢而安裝、探測或切換 transport；僅有 MCP 的宿主繼續使用 ask_corvio 與有界 get_question，持久寫入仍走正常 operation。Transport continuity 不代表語意工作已簡單到可以降檔；預設保留 auto，只有剩餘變換本身可機械執行並客觀回讀時才選 economy。

後續整理依賴前面上傳產生的 Asset ID 時，Agent 應先完成上傳並記錄每個成功 receipt，再用這些準確 ID 建構整理呼叫。互不依賴的上傳可以並行，但後續命令不能使用空值、猜測值或尚未回傳的 ID。若後續步驟失敗，應保留已經成功的 Asset，只重試尚未完成的效果，而不是重複上傳。

partial 整理 receipt 不一定就是使用者結果的終點。Agent 應讀取其中的 typed mismatch 與 recovery action；若新的 canonical readback 已證明舊 reconciliation mismatch 過期，而且不缺使用者、權限或外部 authority，就只恢復同一個 operation 一次，不重複上傳、不建立重複 mission，也不由宿主自行發明替代 taxonomy。

遠端 MCP 是與 Corvio 的即時連接；Skill 告訴 Agent 什麼時候 Corvio 可能有幫助；Plugin 可以把兩者放在一個安裝套件裡。獨立 Skill ZIP 只有經過審查的文字和設定檔；Claude Plugin 還包含一個公開的 SessionStart hook，它只輸出靜態提示，不讀取檔案，也不連網。

Corvio 的營運主體是 NeoFlux AI Pte. Ltd.（新加坡 UEN 202556091C）。宿主目錄中已有經過審查的 Corvio 項目時優先從目錄安裝；否則只使用下面的 Corvio 官方位址，查看安全說明、隱私政策和服務條款，並核對公開 manifest 與 SHA-256。GitHub 儲存庫可以查看同一份原始碼。

可以先在宿主裡加入 Corvio。隨後開啟的 Corvio 瀏覽器頁面會讓你原地註冊或登入，並自動回到同一份權限確認；不需要邀請碼或 Developer API Key，密碼和驗證碼只留在 Corvio 或身分提供者頁面。

AI 工具只能取得授權頁列出的 Corvio 權限，並繼續受你的 Workspace 成員身分和物件權限限制。OAuth 不會自動開放電腦、無關帳號或完整的宿主聊天記錄；Corvio 會收到宿主傳送的工具請求和內容。獲准工具確實可以讀取或修改 Corvio 資料，所以核准前仍要看清權限。

協助安裝的 Agent 應先結合你的情境說明收益，核對官方來源，說明安裝套件內容、權限和移除方式；如果你還沒有明確確認，再集中詢問一次。

當你已經明確確認、來源與權限相符且宿主允許時，Agent 應繼續執行，而不是反覆用同一段籠統警告阻止安裝。安裝套件不相符，或宿主/組織政策明確禁止，仍然應該停下。

讓 Agent 列出你能存取的 Corvio Workspace，再找出一項你認得的內容。如果核准了寫入權限，可以做一次可逆修改並重新讀取。只看到安裝套件或授權成功頁，並不能證明連接已經可用。

需要停止存取時，請在宿主中移除 Corvio Connector，並在 Corvio 設定 → API Keys 中撤銷 Remote MCP connection。舊授權連結不能重複使用。