Integrations / AI agent clients / Claude Desktop

Give Claude Desktop a browser of its own.

Claude Desktop can browse for you in Browz instead of in your everyday browser. Each task runs in its own isolated profile, with its own fingerprint, proxy and cookies, and you can watch the window and take over at any point.

claude_desktop_config.json{ "mcpServers": { "browz": { "command": "/Applications/Browz.app/Contents/Resources/browz-mcp", "args": [] } } }

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

Setup

Set it up.

  1. Install Browz and open it

    Download Browz. The extension starts the MCP server that ships inside the app, so the app has to be installed and open.

  2. Install the extension

    Download browz.mcpb and double-click it, or drag it onto Settings › Extensions in Claude Desktop. Claude asks you to confirm.

  3. Or edit the config file

    In Claude Desktop open Settings › Developer › Edit Config, add the browz entry under mcpServers (keep any servers already there), save, and quit and reopen Claude.

    claude_desktop_config.json{ "mcpServers": { "browz": { "command": "/Applications/Browz.app/Contents/Resources/browz-mcp", "args": [] } } }

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

  4. Check it is connected

    Open a new chat and look for Browz and its tools in the chat’s tools menu. If it is missing, Settings › Developer lists each local server with its status.

  5. Or connect through the hosted server (beta)

    Customize › Connectors › Add › Add custom connector, name it Browz, paste this URL and sign in with your Browz account. Use it when Claude runs on a different computer from Browz.

    Connector URLhttps://mcp.gobrowz.com/mcp

Config format from Connect to local MCP servers, MCP Bundles.

Example

Compare a page from two places.

With two proxies saved in Browz, one in each country, ask Claude to look at the same page through each. Each profile’s timezone and language follow its own proxy.

PromptUsing Browz, list my proxies. Open one throwaway session on the proxy in Germany and one on the proxy in Australia, open https://example.com in both, and take a screenshot of each. Tell me what differs, then close both sessions.

Claude calls browz_proxy_list, then browz_session_open with a proxyId for each, and closes both sessions at the end.

Good to know

Notes and tips.

  • Claude Desktop reads the config only at start, so quit it fully (not just the window) after editing.
  • The snippets use the macOS path of the server inside Browz. On Windows it is %LOCALAPPDATA%\Programs\Browz\browz-mcp.exe, on Linux /usr/lib/browz/browz-mcp; or use npx -y @browz/mcp, which finds it.
  • The remote server at https://mcp.gobrowz.com/mcp is in free public beta: it needs the Browz app open with Remote control on, on a computer with a hardware security chip, and offers the profile, tab and page tools. See what it needs and what it offers.
  • Browz has to be installed and open on the same computer: the local MCP server drives the app’s own profiles through its local API, and reads the app’s credentials itself, so no token goes in the config.
  • A person completes sign-ins, 2FA codes and CAPTCHAs. The agent can pause with browz_request_human and hand you the profile’s window, then carry on in the same session. Browz never solves or bypasses CAPTCHAs.
  • Use agents only where each site’s terms allow automated use, on accounts you are entitled to use. Our acceptable use policy applies to agents the same as to people.
  • The MCP server is on every plan, Free included (5 profiles). How many agent sessions can be open at once depends on the plan: see pricing.

FAQ

Claude Desktop and Browz.

Where is claude_desktop_config.json?

On macOS in ~/Library/Application Support/Claude/, on Windows in %APPDATA%\Claude\ and on Linux in ~/.config/Claude/. Settings › Developer › Edit Config opens it for you.

Is the extension safe to install?

It is a small bundle that starts the MCP server already inside Browz. It holds no token and downloads nothing; Browz has to be installed and open for it to work.

Can Claude see my passwords or my own browser?

No. Claude works only in Browz profiles. When a site asks for a password or a code, you type it yourself in the profile’s window, or store the sign-in in Browz so it is filled without Claude seeing it.

Get started

Download Browz. Every task, its own browser.

Then, on macOS or Linux, put the MCP server on your PATHcurl -fsSL https://gobrowz.com/agents/install.sh | sh

For Mac, Windows and Linux. Free for 5 profiles. Paid plans from $4.99 a month, with a 14-day refund on your first payment.