QwenClaw-with-Auth/skills/claude-codex-settings/plugins/playwright-tools/commands/setup.md

description

description
Configure Playwright MCP

Playwright Tools Setup

Source: 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:

{
  "playwright": {
    "command": "npx",
    "args": ["@playwright/mcp@latest", "--browser", "firefox"]
  }
}

Step 4: Headless Mode

For headless operation (no visible browser), add --headless:

{
  "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.