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_PATHis 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 builtapps/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).