在 Cursor 中添加 Corvio
打开 Cursor MCP 设置，添加一个名为 Corvio 的远程 HTTP server，并填写 Corvio 远程 MCP 地址。
填写 https://api.corvio.ai/mcp。不要把 API Key 放进 MCP 地址、提示词或配置。
- 添加名为 Corvio 的远程 HTTP MCP 或 Connector。
- 填写 https://api.corvio.ai/mcp。
- 在 Corvio 浏览器页面继续，并批准所需权限。
- 授权后重新加载 Cursor 窗口，或新建一次 Agent 对话。
OAuth 才是普通登录方式
普通交互式连接会打开 Corvio 授权页面。你可以使用 Corvio 当前提供的任一账号登录方式，检查请求的 scope 后批准；一次性授权码由宿主自行交换。
CORVIO_API_KEY 只适用于高级 Developer API 或非交互式 CLI。远程 MCP 不要求它；不要把它粘贴到聊天中，也不要用它绕过失败的 OAuth 回调。
验证连接
先调用 list_workspaces，选择有权限的 Workspace，再针对已知文档运行 search 和 fetch。OAuth 页面变绿或 Connector 可见只是设置证据；工具真正返回预期 Corvio URL 才证明连接完成。
若 Corvio 已批准但宿主仍显示需要认证，请移除旧连接，从宿主重新发起，只批准最新请求，并新建会话。不要重复使用旧授权链接。
- 运行 list_workspaces。
- 搜索一个已知项目或文档。
- 读取结果并检查 Corvio URL。
- 需要写权限时，做一次可逆写入并回读。
把文件变成可复用工作
完成上传只证明 Corvio 已保留原始字节、hash、policy 与来源，并不自动证明已理解或整理。符合限制的 UTF-8 Markdown Asset 可以通过 source_asset_id 直接变成可编辑 Page；其它格式或语义重组使用 organize_files 或 ask_corvio，产出最适合读者的 Page、Spreadsheet、Presentation、Code、HTML Artifact 或阅读层。
对一组相关来源，要把 get_file_operation 轮询到终态，并检查 output_document、source_reconciliation 与 skills_evaluation。稳定事实或偏好可以进入 Memory；只有有证据、可迁移的方法、配置、约束或质量标准才成为 Project Skill。skills_extraction_mode=always 强制的是这次判断，也可以合理返回 evaluated_no_qualifying_skill。
- 完成所选 Asset 并核对 ID 与 hash。
- 选择 Markdown 直转 Page，或语义整理/ask 路径。
- 轮询到终态并回读文档或 artifact。
- 只有 Skill 通过准入时才保留其候选身份与资源 receipt。
委托结果，信任终态 receipt
调用 ask_corvio 时，只传用户的自然目标、完整的决策相关 context 和明确约束。除非用户亲自指定，否则不要替 Corvio 发明 taxonomy、文档标题、artifact 数量或内部计划。Corvio 负责认知结构和载体：相关输入可以共享 Project，独立 reader job 仍应分开。
把 get_question 轮询到终态，并原样使用 artifact.url 或 links.primary_artifact：reader_output 是用户结果，structure_container 是层级，sources 是证据，node_id 不是文档 URL。
- 传入自然目标和完整 context。
- 保留用户明确约束，不新增内部方案。
- 把 Question 轮询到终态。
- 原样返回 canonical artifact URL。