Integrations / AI agent clients / Zed
A browser for Zed’s agent panel.
Zed calls MCP servers context servers. Add Browz as one and the agent panel can open real pages, read them as snapshots, click through them and take screenshots, in isolated profiles that never share your own sessions.
{
"context_servers": {
"browz": {
"command": "/Applications/Browz.app/Contents/Resources/browz-mcp",
"args": [],
"env": {}
}
}
}Setup
Set it up.
Install Browz and open it
Download Browz; the MCP server ships inside it.
Open your settings
Run zed: open settings file from the command palette. Use a project’s
.zed/settings.jsoninstead to add Browz to one project only.Add Browz under context_servers
Add the entry, keeping the rest of the file, and save. Zed starts the server.
settings.json{ "context_servers": { "browz": { "command": "/Applications/Browz.app/Contents/Resources/browz-mcp", "args": [], "env": {} } } }Check it is running
Open Settings › AI › MCP Servers (or the agent panel’s settings): a green dot and “Server is active” next to Browz means it started.
Remote (beta)
Zed runs the MCP sign-in flow itself when a URL server has no headers, so you sign in with your Browz account.
settings.json, remote{ "context_servers": { "browz": { "url": "https://mcp.gobrowz.com/mcp" } } }
Config format from Zed MCP docs.
Example
Ask the agent to look at a page.
In the agent panel, a prompt like this uses the Browz tools.
Use Browz: open a throwaway session for "docs check", open https://example.com, take a screenshot and summarise the page in two sentences, 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. - 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
Zed and Browz.
Why is it called a context server?
That is Zed’s name for an MCP server. The Browz server is the same one other clients use.
Can I add it from the UI instead?
Yes. Settings › AI › MCP Servers has an Add Server button for a local or remote server; it writes the same entry.
Which profiles can the agent open?
Any profile in your Browz, unless you lock it. For a narrower set, give the server its own local agent key, limited to the profiles and sites it needs.
Get started
Download Browz. Every task, its own browser.
curl -fsSL https://gobrowz.com/agents/install.sh | sh