Requires Node.js 20.12 or later. The server is published on npm as
@usebruno/mcp. MCP clients run it with npx, so there is nothing to install up front.Let your AI assistant set it up
Copy and send this message to your agent (Claude Code, Codex, Cursor, or any other MCP client).Set up from your terminal
bruno is left as is.
To skip the prompt (for example in a script).
Claude Code
claude mcp list, then open a new session.
Cursor
One-click install
Manual config
Add to~/.cursor/mcp.json.
VS Code
One-click install
Manual config
Add to~/.copilot/mcp-config.json.
Codex
~/.codex/config.toml.
codex mcp list, then start a new session.
Claude Desktop
Add the samebruno entry to
- macOS
~/Library/Application Support/Claude/claude_desktop_config.json - Windows
%APPDATA%\Claude\claude_desktop_config.json
"--collection", "/path/to/collection" to args (see Options).
MCP Inspector
How it finds collections
At startup the server resolves which collections to expose. The first non-empty source wins.- Explicit flags.
--collection/--workspace(both repeatable). A workspace expands to its member collections. - CWD walk-up. Looks for
bruno.json/opencollection.yml/workspace.ymlwalking up from the working directory the client spawned the server in. - Bruno desktop preferences (on by default, use
--no-auto-discoveryto disable). UseslastOpenedWorkspaces,lastOpenedCollections, and the default workspace frompreferences.json.- macOS
~/Library/Application Support/bruno/preferences.json - Windows
%APPDATA%/bruno/preferences.json - Linux
~/.config/bruno/preferences.json
- macOS
Options
Options are passed as CLI flags when the client spawns the server.npx @usebruno/mcp setup is the install command in Set up from your terminal. It takes --client <id> (claude-code, claude-desktop, cursor, vscode, codex, repeatable) and --all.
Example with an explicit collection.