Corvio 帮助中心 · MCP 与 Agent

Corvio MCP:安装、连接与验证

Corvio MCP 让 AI 宿主在你批准的权限范围内访问 Workspace。用宿主的 Connector 或 MCP 入口获得实时工具,用 Corvio Skill 或 Plugin 补充主动协作方法;只有宿主需要本地文件或项目 Agent 时才需要 CLI。

更新于 2026-09-09

选择正确的 Corvio 安装面

远程 MCP 是实时连接:添加 https://api.corvio.ai/mcp,并通过 Corvio OAuth 登录。Skill 教 Agent 何时读取共享上下文、何时把有价值的结果送回。Plugin 可以把两者打包。可选的 @corvio/cli 只用于本地路径、下载、同步或项目 Agent。

普通的 Claude、ChatGPT、Codex、WorkBuddy、Cursor 或其它交互式 MCP 连接不需要创建 API Key。不要把凭证粘贴到聊天中。

安装并授权

宿主目录中已有 Corvio 条目时优先从目录安装;尚未收录时,直接添加远程 HTTP MCP 地址并完成 Corvio 授权。宿主另有 Skills 入口时也安装 Skill;Claude Cowork 和 Claude Code 则可用 Corvio Plugin 同时携带 Skill 与 MCP 定义。

在 Corvio 页面使用当前提供的任一账号方式登录,检查 scope 后批准。Corvio 随后把控制权交还宿主,由宿主交换一次性授权码。

  1. 打开宿主的 Connector、MCP 或 Plugin 设置。
  2. 添加 https://api.corvio.ai/mcp 或安装 Corvio Plugin。
  3. 完成 Corvio OAuth,不要修改回调地址。
  4. 新建一次宿主会话。

证明整条连接已经完成

调用 list_workspaces,再针对已知文档运行 search 和 fetch。若 Agent 需要写入,做一次可逆编辑或新建测试文档并回读。安装包存在、授权页成功或工具列表可见,都不能单独证明全流程完成。

文件流程要验证完整价值链:最终 Asset、Markdown 直转 Page 或合适的派生载体、终态整理 receipt、来源对账,以及通过证据准入的 Memory/Skill 结果。仅上传不算完成;Skill 策略为 always 时也可以合理返回 evaluated_no_qualifying_skill。

若 Corvio 已批准但宿主仍显示需要认证,请移除旧连接并从宿主重新发起。授权链接和 code 都是单次使用。若云端 Agent 因网络策略无法下载 ZIP,请在普通浏览器中下载,再从宿主的 Plugin 或 Skill UI 上传。

  1. 验证 list_workspaces。
  2. 验证 search 与 fetch。
  3. 需要时验证一次授权写入与回读。
  4. 保留一个不应自动上传的简单或敏感任务作为反例。