Adding and editing servers

You can add servers from the desktop UI (MCP screen) or by editing mcp.json directly.

Add/Edit Server screen (UI)

The form adapts to the selected transport:

• **STDIO**: command, args, environment variables.
• **HTTP Streamable / HTTP SSE / WebSocket**: URL and optional headers.

Optional fields:

• **Icon**: custom icon for the server card (stored in ~/.config/broxy/icons).
• **OAuth**: handled automatically for supported HTTP/WS servers (see OAuth, discovery, and dynamic client registration).

Typical UI flow

1. Click the + button in the MCP screen.
2. Enter a Name.
3. Choose a Transport.
4. Fill in the transport-specific fields.
5. Save the server.

If you edit configuration files

STDIO example:

{
  "mcpServers": {
    "github": {
      "name": "GitHub MCP",
      "transport": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Streamable HTTP example:

{
  "mcpServers": {
    "docs": {
      "name": "Docs MCP",
      "transport": "http",
      "url": "http://localhost:8080/mcp",
      "headers": {
        "X-Client": "broxy"
      }
    }
  }
}

Editing and disabling

• Toggle a server off in the UI to disable it without deleting the entry.
• Remove the server entry from mcp.json to delete it entirely.
• Changes are hot-reloaded while the proxy is running.