在 Agent 中使用 Weave

Weave 可以把你明确授权的本地知识库连接到支持 Model Context Protocol（MCP）的 AI Agent。Agent 可以检索资料、读取带引用的有限片段，并在你额外授权后提交项目观察、AI 派生记录、笔记、批量高亮/批注或受控文件操作。

安装版已经包含 MCP bridge，不需要单独下载 Server。Weave Desktop 必须保持运行，因为 bridge 只把请求转发给已经运行的本地 Runtime，不会绕过桌面端直接打开知识库数据库。

三分钟接入

1. 打开需要授权的知识库。
2. 进入“管理 → AI 集成（MCP）”。
3. 填写 Agent 名称和稳定的客户端指纹。
4. 点击“批准只读访问”。
5. 选择 Codex、Claude、VS Code 或通用 stdio 配置并复制。
6. 把配置加入目标 Agent，然后完全重启 Agent。

配置中的 ZX_MCP_BRIDGE_SECRET 只显示一次。请把它视为密码，不要提交到 Git、工单或聊天记录。

验证连接

先让 Agent 执行一个只读任务：

列出我通过 Weave 授权给你的知识库，然后停止，不要执行写操作。

连接成功时，Agent 会调用 zhixi_list_knowledge_bases，并且只能看到当前客户端获准访问的知识库。

使用前需要知道

• 当前连接是本地 stdio，Agent 必须能够在同一台电脑上启动本地进程。
• 纯云端且不能运行本地 MCP Server 的 Agent 无法直接连接。
• 初始配对只有读取权限；其他能力必须在 Weave 中单独授予。
• Agent 获得工具结果后，可能把片段发送给其使用的云模型，请同时检查 Agent 和模型提供方的数据政策。