Use Weave with an Agent

Weave connects explicitly authorized local knowledge bases to AI Agents that support the Model Context Protocol (MCP). An Agent can search material, read bounded excerpts with citations, and—after separate grants—submit project observations, AI-derived records, notes, batches of highlights or annotations, and controlled file operations.

The installed app already includes the MCP bridge; there is no separate Server download. Weave Desktop must remain running. The bridge forwards requests to the active local Runtime and never bypasses the desktop app to open the knowledge-base database directly.

Connect in three minutes

1. Open the knowledge base you want to grant.
2. Go to “Manage → AI integrations (MCP).”
3. Enter an Agent name and a stable client fingerprint.
4. Select “Approve read-only access.”
5. Copy the generated Codex, Claude, VS Code, or generic stdio configuration.
6. Add it to the target Agent and fully restart that Agent.

ZX_MCP_BRIDGE_SECRET is shown once. Treat it as a password and never commit it to Git or paste it into tickets or chat.

Verify the connection

Start with a read-only request:

List the knowledge bases I have authorized through Weave, then stop. Do not perform a write operation.

A connected Agent calls zhixi_list_knowledge_bases and sees only the knowledge bases granted to that client.

Before you connect

• The current connection uses local stdio, so the Agent must be able to launch a local process on the same computer.
• A cloud-only Agent that cannot run a local MCP Server cannot connect directly.
• Initial pairing is read-only. Every other capability is granted separately in Weave.
• After an Agent receives tool output, it may send excerpts to its cloud model. Review both the Agent and model provider data policies.