Setup

Connecting Editz to Claude Desktop

Desktop speaks a different transport, so we bridge through mcp-remote.

Claude Desktop talks to MCP servers over stdio, not HTTP — so instead of pointing it at the URL directly, we use a small bridge tool (mcp-remote) that Desktop can launch itself.

Open Settings → Developer → Edit Config in Claude Desktop, and add:

{
  "mcpServers": {
    "editz": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://127.0.0.1:9317/mcp"]
    }
  }
}

Restart Claude Desktop after saving. It will spawn mcp-remote on demand, which forwards everything to the Editz bridge on port 9317 — you don't need to run anything extra yourself, just keep npx @editz/editz running.

← Connecting Editz to Codex CLI Troubleshooting: it won't connect →