105 lines
2.0 KiB
Markdown
105 lines
2.0 KiB
Markdown
---
|
|
description: Configure Playwright MCP
|
|
---
|
|
|
|
# Playwright Tools Setup
|
|
|
|
**Source:** [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp)
|
|
|
|
Check Playwright MCP status and configure browser dependencies if needed.
|
|
|
|
## Step 1: Test Current Setup
|
|
|
|
Run `/mcp` command to check if playwright server is listed and connected.
|
|
|
|
If playwright server shows as connected: Tell user Playwright is configured and working.
|
|
|
|
If playwright server is missing or shows connection error: Continue to Step 2.
|
|
|
|
## Step 2: Browser Installation
|
|
|
|
Tell the user:
|
|
|
|
```
|
|
Playwright MCP requires browser binaries. Install them with:
|
|
|
|
npx playwright install
|
|
|
|
This installs Chromium, Firefox, and WebKit browsers.
|
|
|
|
For a specific browser only:
|
|
npx playwright install chromium
|
|
npx playwright install firefox
|
|
npx playwright install webkit
|
|
```
|
|
|
|
## Step 3: Browser Options
|
|
|
|
The MCP server supports these browsers via the `--browser` flag in `.mcp.json`:
|
|
|
|
- `chrome` (default)
|
|
- `firefox`
|
|
- `webkit`
|
|
- `msedge`
|
|
|
|
Example `.mcp.json` for Firefox:
|
|
|
|
```json
|
|
{
|
|
"playwright": {
|
|
"command": "npx",
|
|
"args": ["@playwright/mcp@latest", "--browser", "firefox"]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Step 4: Headless Mode
|
|
|
|
For headless operation (no visible browser), add `--headless`:
|
|
|
|
```json
|
|
{
|
|
"playwright": {
|
|
"command": "npx",
|
|
"args": ["@playwright/mcp@latest", "--headless"]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Step 5: Restart
|
|
|
|
Tell the user:
|
|
|
|
```
|
|
After making changes:
|
|
1. Exit Claude Code
|
|
2. Run `claude` again
|
|
|
|
Changes take effect after restart.
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
If Playwright MCP fails:
|
|
|
|
```
|
|
Common fixes:
|
|
1. Browser not found - Run `npx playwright install`
|
|
2. Permission denied - Check file permissions on browser binaries
|
|
3. Display issues - Use `--headless` flag for headless mode
|
|
4. Timeout errors - Increase timeout with `--timeout-navigation 120000`
|
|
```
|
|
|
|
## Alternative: Disable Plugin
|
|
|
|
If user doesn't need browser automation:
|
|
|
|
```
|
|
To disable this plugin:
|
|
1. Run /mcp command
|
|
2. Find the playwright server
|
|
3. Disable it
|
|
|
|
This prevents errors from missing browser binaries.
|
|
```
|