Install

Add the extension to Chrome
It connects your browser to the bopbop server on your computer. Edge, Brave and Chromium work too.
Add to Chrome
Add bopbop to your agent
Claude Code
```
claude mcp add -s user bopbop -- npx -y bopbop
```
Codex
```
codex mcp add bopbop -- npx -y bopbop
```
Cursor and other MCP clients: JSON config. Needs Node.js 24 or later.
Ask for something in your browser
```
Use bopbop. Open example.com and tell me the heading.
```
A tab opens in the agent's own tab group. The extension pairs with the server by itself: nothing to paste.

Cursor and other MCP clients

Add this to the client's MCP config. For Cursor it is ~/.cursor/mcp.json.

{
  "mcpServers": {
    "bopbop": { "command": "npx", "args": ["-y", "bopbop"] }
  }
}

Settings go under "env", for example "env": { "BBM_GUARD": "shop-social" }. All settings: Settings.

A short skill tells the agent to batch steps, read tables as data and skip screenshots. It saves tokens on every task.

npx skills add alexsorokoletov/bopbop

Symptom	Fix
`extension did not connect/pair`	Check that the bopbop extension is installed and on, then restart the agent. If it still does not pair, paste the token from `~/.config/bopbop/relay-token` on the extension’s options page.
`all 30 bopbop slots are taken`	30 agent sessions already use this Chrome, or old ones did not exit. Close the sessions you do not use.
`blocked: ... is not in the allowlist (BBM_ALLOW)`	`BBM_ALLOW` is set and does not include that site. Add it.
The agent says the tools are missing	Run `claude mcp list` (or `codex mcp list`): `bopbop` must be connected.

Something else: open an issue.