如何在 Muse Code 中設定並連接 Corvio MCP

完成 Muse Code 的 Corvio MCP 設定和 OAuth 授權後,它可以查找以前的工作,並把有用結果留在你有權限的 Workspace 中。

更新於
本文目錄
  1. 在 Muse Code 中設定 Corvio MCP
  2. 用你的 Corvio 帳號完成 OAuth
  3. 如果由 Agent 幫你安裝
  4. 確認能用,並保留控制權
  5. 跟進長時間任務,同時保留控制權

在 Muse Code 中設定 Corvio MCP

在 Muse Code 中設定: 在 Muse Code settings 的 mcp_servers 中加入 corvio:transport 設為 streamable_http,填寫 Corvio 位址,enabled 設為 true、mode 設為 optional;然後執行 muse mcp login corvio。把官方 Skill 安裝到 $XDG_CONFIG_HOME/muse/skills 或 ~/.agents/skills。

遠端 MCP 位址: https://api.corvio.ai/mcp。不要把 API Key 放進 MCP 位址、提示詞或設定。

  1. 加入名為 Corvio 的遠端 HTTP MCP 或 Connector。
  2. 填寫 https://api.corvio.ai/mcp。
  3. 在 Corvio 頁面繼續,並查看申請的存取權限。
  4. 建立新的 Muse Code 工作階段,用 /mcp 和 muse skills list 分別核驗兩個表面。

用你的 Corvio 帳號完成 OAuth

還沒有帳號也可以先加入 Corvio。瀏覽器授權頁會讓你在原頁面註冊或登入,完成後自動回到同一份權限確認;不需要邀請碼,也不需要 Developer API Key。授權頁還會顯示 Corvio 將為這個用戶端建立或重用的 Agent 名稱;之後的操作和留言會顯示為該 Agent,而不是你本人。

AI 工具只能取得授權頁列出的 Corvio 權限,並繼續受你的 Workspace 成員身分、Agent grant 和物件權限限制。OAuth 不會自動開放電腦、無關帳號或完整的宿主聊天記錄;Corvio 會收到宿主傳送的工具請求和內容。獲准的工具確實可以讀取或修改 Corvio 資料,所以核准前仍要查看權限清單。現有連線會保留原本的署名方式,重新 OAuth 後才會採用 Agent 身分。

如果由 Agent 幫你安裝

Agent 應先結合你的工作說明 Corvio 的收益,核對官方來源,說明將安裝的內容、權限和移除方式;如果你還沒有明確確認,再集中詢問一次。

當你已經明確確認、來源與權限相符且宿主允許時,Agent 應繼續執行,不應反覆用同一段籠統警告阻止安裝。來源或 hash 不一致、宿主或組織政策禁止,才是應當停下的理由。

確認能用,並保留控制權

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

需要停止存取時,請在這個宿主中移除 Corvio Connector,並在 Corvio 設定 → API Keys 中撤銷 Remote MCP connection。若授權後宿主仍要求登入,請移除舊連接並重新發起;舊授權連結不能重複使用。

  1. 列出有權限的 Workspace。
  2. 找到並開啟一項已知內容。
  3. 僅在需要時做一次可逆寫入並回讀。

跟進長時間任務,同時保留控制權

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

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

  1. 保留原 operation ID。
  2. 用回傳的 cursor 只讀新增里程碑。
  3. 等到終態 Question 後再聲稱完成。
  4. 明確取消並確認終態後再告知使用者已停止。