Integrations / AI agent clients / VS Code (Copilot agent mode)
A browser for Copilot in VS Code.
In agent mode, Copilot can call MCP tools. Add Browz and it can open your app in a real browser, step through a flow and report what it saw, without touching the browser you are signed in to. Each task runs in its own isolated profile.
code --add-mcp '{"name":"browz","type":"stdio","command":"/Applications/Browz.app/Contents/Resources/browz-mcp","args":[]}'Setup
Set it up.
Install Browz and open it
Download Browz; the MCP server ships inside the app.
Add Browz from a terminal
This adds the server to your VS Code user profile, for every workspace.
Terminalcode --add-mcp '{"name":"browz","type":"stdio","command":"/Applications/Browz.app/Contents/Resources/browz-mcp","args":[]}'Or add it to one workspace
Put this in
.vscode/mcp.json. VS Code’s documentation now prefers a portable.mcp.jsonat the workspace root with anmcpServerskey, and says theserversformat below will be removed in February 2027; both are shown..vscode/mcp.json{ "servers": { "browz": { "type": "stdio", "command": "/Applications/Browz.app/Contents/Resources/browz-mcp", "args": [] } } }File:
.vscode/mcp.json.mcp.json (portable format){ "mcpServers": { "browz": { "type": "stdio", "command": "/Applications/Browz.app/Contents/Resources/browz-mcp", "args": [], "tools": [ "*" ] } } }Start it and check
Run MCP: List Servers from the Command Palette, start Browz if it is stopped, then open Chat in agent mode and check that the Browz tools are listed under the tools button.
Remote (beta)
To reach Browz on another computer through the hosted server, VS Code signs you in with your Browz account.
.vscode/mcp.json{ "servers": { "browz": { "type": "http", "url": "https://mcp.gobrowz.com/mcp" } } }File:
.vscode/mcp.json
Config format from VS Code MCP configuration reference, Use MCP servers in VS Code.
Example
Review a pull request’s preview.
With a preview URL from your CI, ask agent mode to look at the changed page. It reads the page as a snapshot, so it can tell you about labels and buttons, not only pixels.
Use the Browz tools: open a throwaway session for "preview review", go to https://preview.example.com/pricing, take a screenshot, list every button label on the page, then close the session.VS Code asks you to allow each Browz tool the first time; allow the ones you expect, such as browz_navigate and browz_snapshot.
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. - 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
VS Code (Copilot agent mode) and Browz.
Does it need GitHub Copilot?
MCP tools in VS Code are used by Copilot’s agent mode, so you need Copilot enabled in VS Code. Browz itself is free for 5 profiles.
Which file should I use, .vscode/mcp.json or .mcp.json?
Both work today. VS Code documents the portable .mcp.json with mcpServers as the format to use going forward, and the .vscode/mcp.json servers format as one it will remove in February 2027.
Can I keep Copilot from running a tool without asking?
Yes. VS Code asks before each tool call unless you allow it; leave tools that change things, such as browz_act, on ask.
Get started
Download Browz. Every task, its own browser.
curl -fsSL https://gobrowz.com/agents/install.sh | sh