MCP setup

Connect Claude Desktop to Strazh

stdio only — needs a bridge to reach Strazh's HTTP endpoint

The endpoint URL and auth token are specific to your own local Strazh install — they live in Settings → Connect inside the app, not on this page. Copy them from there when a step below asks for them.

1Why this needs a bridge

Strazh’s MCP server speaks JSON-RPC 2.0 over plain HTTP (a single POST /mcp route on the same local server the desktop app talks to) rather than the stdio transport Claude Desktop expects its MCP servers to use. Reaching it from Claude Desktop means going through a stdio↔HTTP bridge — such as mcp-remote — the same way any stdio-only client reaches any local HTTP MCP server. Strazh doesn’t run a second, stdio-flavored server of its own.

2Get your endpoint and token

Open Strazh, go to Settings → Connect, and copy the endpoint URL and auth token shown there. Both are specific to your own local install — they aren’t reproduced here, since a static page can’t show a live value or a secret.

3Configure the bridge

Point mcp-remote (or whichever stdio↔HTTP bridge you use) at the endpoint URL, with the X-Strazh-Token header set to your auth token. The exact invocation depends on the bridge tool’s own current usage — check its documentation for the current flag/config shape rather than relying on a copy-pasted example here going stale.

Available tools

Every tool call funnels through the exact same gate every other Strazh entry point uses — capped, allow-listed, and audited identically:

  • dispatch — Dispatch a coding agent (claude_code, codex, cursor, or devin) against an allow-listed repository, through Strazh's safety gate.
  • list_allowed_roots — List the directories currently on Strazh's dispatch allow-list.
  • add_allowed_root — Add a directory to Strazh's dispatch allow-list.
  • remove_allowed_root — Remove a directory from Strazh's dispatch allow-list.
  • list_agents — List the coding agents Strazh knows about and whether each is available.
  • get_usage — Current license tier and today's dispatch usage against the tier cap.
← Back to install & setup
Connect Claude Desktop to Strazh's MCP server