Configure your client

Claude Desktop, Cursor, Gemini CLI, Cline and Cascade use an mcpServers object with this command and these arguments. Where each one keeps it is listed below.

{
  "mcpServers": {
    "braus": {
      "command": "/Applications/Braus.app/Contents/Helpers/braus-bridge",
      "args": [
        "mcp-bridge",
        "--connection",
        "/Users/YOUR_USERNAME/Library/Application Support/Braus/MCP/CLIENT_UUID.connection.json"
      ]
    }
  }
}

No URL, API key, OAuth login or environment variable is needed for this bridge. Braus creates and rotates the local connection credential; your client’s own model login stays separate.

Claude Code

Prefer Copy Claude Code command in Braus. The equivalent template:

claude mcp add --scope user --transport stdio braus -- \
  "/Applications/Braus.app/Contents/Helpers/braus-bridge" \
  mcp-bridge --connection \
  "/Users/YOUR_USERNAME/Library/Application Support/Braus/MCP/CLIENT_UUID.connection.json"

Check the registration with claude mcp get braus, then start a new Claude Code session and use /mcp to check the live connection. User scope makes the configuration available across your projects. If braus already exists, inspect and update that entry instead of adding a duplicate. Reference: Claude Code MCP configuration.

Codex CLI and IDE extension

Prefer Copy Codex command in Braus. The equivalent template:

codex mcp add braus -- \
  "/Applications/Braus.app/Contents/Helpers/braus-bridge" \
  mcp-bridge --connection \
  "/Users/YOUR_USERNAME/Library/Application Support/Braus/MCP/CLIENT_UUID.connection.json"

Alternatively, add this to ~/.codex/config.toml:

[mcp_servers.braus]
command = "/Applications/Braus.app/Contents/Helpers/braus-bridge"
args = [
  "mcp-bridge",
  "--connection",
  "/Users/YOUR_USERNAME/Library/Application Support/Braus/MCP/CLIENT_UUID.connection.json"
]

Use codex mcp list to check the registration and /mcp inside Codex to inspect active servers. Restart an existing client session after changing the configuration.

ChatGPT desktop or Codex desktop host

For desktop versions that expose local MCP settings, open Settings → MCP servers → Add server, choose STDIO and enter:

Save and restart the server. Desktop, Codex CLI and IDE configuration is shared for the same Codex host, so avoid duplicate entries. Reference for Codex and this host: OpenAI MCP configuration.

Claude Desktop

Open Settings → Developer → Edit Config and merge the shared JSON template into ~/Library/Application Support/Claude/claude_desktop_config.json. Quit Claude Desktop completely and reopen it. Check Braus’ connection status in Developer settings and confirm its tools appear in the conversation’s tool controls.

This is the local MCP setup for Claude Desktop. It does not install a hosted connector for claude.ai or establish Cowork compatibility. Reference: MCP local-server setup for Claude Desktop.

Cursor

Merge the shared JSON template into your personal configuration, ~/.cursor/mcp.json. Open Cursor’s MCP settings, enable or reload the server and confirm its tools are available to the agent. A project configuration can override a personal entry with the same name, so inspect it if Cursor uses an unexpected path. Reference: Cursor MCP configuration.

VS Code with GitHub Copilot

Open the Command Palette and run MCP: Open User Configuration. VS Code’s MCP configuration uses servers rather than mcpServers:

{
  "servers": {
    "braus": {
      "type": "stdio",
      "command": "/Applications/Braus.app/Contents/Helpers/braus-bridge",
      "args": [
        "mcp-bridge",
        "--connection",
        "/Users/YOUR_USERNAME/Library/Application Support/Braus/MCP/CLIENT_UUID.connection.json"
      ]
    }
  }
}

Save, use MCP: List Servers to start or restart Braus, and select its tools in Copilot’s agent workflow. Keep the server in the local user configuration: a container or remote host cannot use this Mac’s executable and loopback connection. Reference: VS Code MCP configuration.

Gemini CLI

Merge the shared JSON template into ~/.gemini/settings.json, keeping any existing authentication and model settings. Start a new Gemini CLI session and check the server with gemini mcp list. Use /mcp inside Gemini CLI to inspect available servers and tools, and keep the client’s normal tool-approval settings. Reference: Gemini CLI MCP configuration.

Cline

In the extension, open MCP Servers → Configure → Configure MCP Servers and merge this into its settings file:

{
  "mcpServers": {
    "braus": {
      "command": "/Applications/Braus.app/Contents/Helpers/braus-bridge",
      "args": [
        "mcp-bridge",
        "--connection",
        "/Users/YOUR_USERNAME/Library/Application Support/Braus/MCP/CLIENT_UUID.connection.json"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

For Cline CLI, the configuration file is ~/.cline/mcp.json. Enable or restart the server through Cline’s MCP controls. The empty autoApprove list leaves tool approvals with the client. Reference: Cline MCP documentation.

Windsurf or Cascade

Use Cascade’s MCP controls to Open MCP config file, then merge the shared JSON template under mcpServers. Enable the server and check its tools in Cascade.

Use the file your installed editor opens. The current documentation redirects to Devin Desktop and lists ~/.config/devin/mcp_config.json; older Windsurf installations can use a different location. Reference: Cascade MCP configuration.

Other local MCP clients

A client that can launch a local STDIO server uses the same values:

Transport: stdio
Command:   /Applications/Braus.app/Contents/Helpers/braus-bridge
Arguments:
  mcp-bridge
  --connection
  /Users/YOUR_USERNAME/Library/Application Support/Braus/MCP/CLIENT_UUID.connection.json

If a client requires one array with the whole command, put the executable first, followed by the three arguments. Follow that client’s configuration schema: not every client uses an mcpServers wrapper.

If the interface only accepts a server URL, this local configuration cannot be pasted there. Braus provides no public HTTP or SSE endpoint and no hosted OAuth connector, so a direct web or cloud connection needs a separate integration: this is not ChatGPT web, claude.ai or cloud-agent support.