Zephr Docs

Configure your client

Add Zephr to your client's MCP server list. Claude Code reads this shape from its settings file; Cursor reads the same shape from its own MCP settings.

{
  "mcpServers": {
    "zephr": {
      "command": "node",
      "args": ["/absolute/path/to/zephr/apps/mcp/dist/main.cjs", "--stdio"],
      "env": {
        "ZEPHR_DB_PATH": "/absolute/path/to/zephr.sqlite"
      }
    }
  }
}

Rules

  • Both paths must be absolute.
  • ZEPHR_DB_PATH is optional — without it the server falls back to an in-memory store, useful for a smoke test but discarded on exit.
  • No npx-published package or global install exists yet, so the command points at the built apps/mcp/dist/main.cjs.

Admission

Remember: zephr-mcp is admission-scoped. Before this configuration is useful, admit a connection to a worktree with the trusted launcher (see Connect your client).