Clients

What the Clients screen does

• Detects supported client configuration files on disk.
• Adds or removes a Broxy MCP entry without touching other entries.
• Shows a notice when a config is missing or points at a different port.

Universal connection snippets

Use these when your client expects a generic MCP configuration file.

STDIO

{
  "mcpServers": {
    "broxy": {
      "command": "/Applications/broxy.app/Contents/MacOS/broxy",
      "args": ["--stdio-proxy"]
    }
  }
}

HTTP

{
  "mcpServers": {
    "broxy": {
      "url": "http://localhost:{port}/mcp"
    }
  }
}

SSE

{
  "mcpServers": {
    "broxy": {
      "url": "http://localhost:{port}/sse"
    }
  }
}

Supported clients and config locations

Broxy connects by editing local configuration files. Paths below use ~ for your home directory.

Codex

• File: ~/.codex/config.toml
• Broxy writes a [mcp_servers.broxy] block with the current HTTP endpoint.

LM Studio

• File: ~/.lmstudio/mcp.json
• Uses the HTTP endpoint at /mcp.

Claude Desktop

• File: ~/Library/Application Support/Claude/claude_desktop_config.json
• Uses the STDIO command entry.

Claude Code

• File: ~/.claude.json
• The app must create this file first; Broxy only updates mcpServers.
• Claude Code requires a type field set to broxy alongside the URL.

Gemini CLI

• File: ~/.gemini/settings.json
• The app must create this file first; Broxy only updates mcpServers.
• Gemini CLI uses the SSE endpoint at /sse.

Cursor

• File: ~/.cursor/mcp.json

Google Antigravity

• File: ~/.gemini/antigravity/mcp_config.json

Roo Code

• File: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json

KILO CODE

• File: ~/Library/Application Support/Code/User/globalStorage/kilocode.kilo-code/settings/mcp_settings.json

Cline

• File: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Windsurf

• File: ~/.codeium/windsurf/mcp_config.json

Visual Studio Code

• File: ~/Library/Application Support/Code/User/mcp.json
• Uses servers as the map key instead of mcpServers.

Kiro

• File: ~/.kiro/settings/mcp.json

Connection behavior and safety

• Connect and Disconnect only modify the broxy entry; other entries are preserved.
• If a config directory is missing, the Clients screen disables Connect and shows a warning.
• If the configured port differs from the current app port, Broxy shows a notice but still allows Connect.