MCP for agents

Doc Bridge MCP tools return the same deterministic handoffs as the CLI — ownership, start files, edit roots, and checks.

One-command install

ak-docs mcp install --cursor    # writes .cursor/mcp.json
ak-docs mcp install --claude    # merges Claude Desktop config (macOS)

Then index your repo:

ak-docs index

Optional skill text: skills/doc-bridge.md

Manual config

{
  "mcpServers": {
    "ak-docs": {
      "command": "npx",
      "args": ["ak-docs", "mcp"],
      "cwd": "/absolute/path/to/your/repo"
    }
  }
}

Run MCP from the repository root (or ensure config discovery resolves there).

Tools

Prefer handoff.resolve before any multi-file edit.

Agent loop

1. Resolve ownership via MCP or ak-docs query … --agent
2. Read startHere
3. Edit only editRoots
4. Run checks
5. Re-index when docs change

Related

• For agents
• Index and query
• MCP deep dive
• Chat and RAG — optional intelligence plane