Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 12 additions & 3 deletions agent-cli/commands/attach.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,8 @@ Connect to an existing browser instead of launching a new one.
| `attach --cdp=<channel>` | Connect to a running browser by channel name |
| `attach --cdp=<url>` | Connect via Chrome DevTools Protocol endpoint |
| `attach --endpoint=<url>` | Connect to a Playwright server endpoint |
| `attach --extension` | Connect via Playwright MCP Bridge extension |
| `attach --extension` | Connect via Playwright Extension (defaults to Chrome) |
| `attach --extension=<channel>` | Connect via Playwright Extension to a specific channel |

## Attach by channel name

Expand Down Expand Up @@ -70,14 +71,22 @@ playwright-cli snapshot

## Browser extension

Connect to your existing browser tabs using the [Playwright MCP Bridge extension](https://github.com/microsoft/playwright-mcp/blob/main/packages/extension/README.md). This lets you reuse your logged-in sessions, cookies, and installed extensions.
Connect to your existing browser tabs using the [Playwright Extension](https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm). This lets you reuse your logged-in sessions, cookies, and installed extensions.

<img src="/img/mcp/chrome-bridge-extension.png" width="662" height="427" alt="Playwright MCP Bridge extension in Chrome Web Store" />
<img src="/img/mcp/chrome-bridge-extension.png" width="662" height="427" alt="Playwright Extension in Chrome Web Store" />

```bash
# Attach to Chrome (default)
playwright-cli attach --extension

# Attach to a specific channel
playwright-cli attach --extension=chrome-canary
playwright-cli attach --extension=msedge
playwright-cli attach --extension=msedge-dev
```

If no channel is specified, the extension attaches to Chrome by default.

### When to use extension mode

- **SSO / 2FA** — skip complex login flows by reusing your authenticated session
Expand Down
4 changes: 2 additions & 2 deletions mcp/configuration/browser-extension.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -56,9 +56,9 @@ Works with Chrome/Chromium with `--remote-debugging-port`, Edge, Electron apps,

## Connect via browser extension

The [Playwright MCP Bridge extension](https://github.com/microsoft/playwright-mcp/blob/main/packages/extension/README.md) connects to your existing browser tabs, reusing your logged-in sessions, cookies, and installed extensions.
The [Playwright Extension](https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm) connects to your existing browser tabs, reusing your logged-in sessions, cookies, and installed extensions.

<img src="/img/mcp/chrome-bridge-extension.png" width="662" height="427" alt="Playwright MCP Bridge extension in Chrome Web Store" />
<img src="/img/mcp/chrome-bridge-extension.png" width="662" height="427" alt="Playwright Extension in Chrome Web Store" />

1. Install the extension in Chrome or Edge
2. Configure the MCP server:
Expand Down
Loading