在 Qwen Code 中添加 Corvio
在 Qwen Code 中添加名为 Corvio 的远程 HTTP MCP server,并填写 Corvio 远程 MCP 地址。
填写 https://api.corvio.ai/mcp。不要把 API Key 放进 MCP 地址、提示词或配置。
- 添加名为 Corvio 的远程 HTTP MCP 或 Connector。
- 填写 https://api.corvio.ai/mcp。
- 在 Corvio 浏览器页面继续,并批准所需权限。
- 授权后重启 Qwen Code 会话,让工具列表刷新。
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。