为什么 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 权限都已完成。