Integrations / AI agent clients / Cline
A browser for Cline, approved call by call.
Cline asks before it uses a tool, which suits a browser well. Add Browz and Cline can open pages, read them and act on them in isolated profiles, while you approve each step and watch the window.
{
"mcpServers": {
"browz": {
"command": "/Applications/Browz.app/Contents/Resources/browz-mcp",
"args": [],
"disabled": false,
"autoApprove": []
}
}
}Setup
Set it up.
Install Browz and open it
Download Browz; the MCP server ships inside it.
Open Cline’s MCP settings
In the Cline panel, click the MCP Servers icon, open the Configure tab and choose Configure MCP Servers. It opens
cline_mcp_settings.json.Add the Browz entry
Keep
autoApproveempty so Cline asks before every Browz tool, or list read-only tools such asbrowz_snapshotthere.cline_mcp_settings.json{ "mcpServers": { "browz": { "command": "/Applications/Browz.app/Contents/Resources/browz-mcp", "args": [], "disabled": false, "autoApprove": [] } } }Check it is connected
Browz appears in the MCP Servers list with its tools. If it shows an error, restart it from there and check that the Browz app is open.
Config format from Cline: configuring MCP servers.
Example
Reproduce a bug report.
Give Cline the steps from an issue and let it try them in a fresh profile, so no cookie of yours changes the result.
Using the browz MCP server: open a throwaway session for "bug repro", go to https://staging.example.com, follow these steps: open Settings, change the language to French, reload. Take a screenshot after each step, tell me whether the language stayed French, then close the session.Good to know
Notes and tips.
- 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 usenpx -y @browz/mcp, which finds it. - This page sets up the local server, which works the same in Cline’s extension and its CLI. For a remote setup, see the hosted agent docs.
- The remote server at
https://mcp.gobrowz.com/mcpis 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_humanand 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
Cline and Browz.
Should I auto-approve Browz tools?
Approve read-only tools (browz_snapshot, browz_screenshot, browz_pages) if you like, and keep tools that act, such as browz_act and browz_navigate, on ask until you trust the task.
Does Cline use its own browser too?
Cline has its own browser feature. The Browz tools are separate: they drive Browz profiles, each with its own fingerprint, proxy and saved sessions.
Can the profile stay signed in between tasks?
Yes. Ask for a persistent session with a stable identity name, such as staging/admin; the next task with that identity comes back signed in.
Get started
Download Browz. Every task, its own browser.
curl -fsSL https://gobrowz.com/agents/install.sh | sh