Install into Claude Desktop

Preferred: one-click desktop extension

Download the .mcpb bundle, double-click it, and paste your API key when prompted. The bundle ships its own runtime, so you do not need Node installed. This is the recommended path: it eliminates the whole Node and npx class of setup problems.

Manual: paste one JSON block

The manual path needs Node 18+ (check with node -v). No API key in the config — sign in after install with reflex_auth (see below).

claude_desktop_config.json

{
  "mcpServers": {
    "reflex": {
      "command": "npx",
      "args": [
        "-y",
        "reflex-browser@latest",
        "mcp"
      ]
    }
  }
}

Where the config file lives

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop fully: quit it from the menu bar or tray, not just close the window.

Sign in

Ask Claude to run reflex_auth with action: "login". It opens your browser, signs you in, and saves a key locally. For CI or headless setups, add REFLEX_API_KEY to the env block in your config instead.

Platform note: macOS is supported today. Windows is in beta; see troubleshooting for the Windows config path and PowerShell quoting notes.