playwright-mcp-setup

Playwright MCP setup

Detect or install the Playwright MCP server so ui-validator can drive a real browser.

Detect

Run the bundled detection script:

!bash "${CLAUDE_SKILL_DIR}/scripts/detect-playwright.sh" 2>&1

Interpret the output

The script prints exactly one of:

• PLAYWRIGHT_MCP_PRESENT — nothing to do. Proceed to the investigation.
• PLAYWRIGHT_MCP_MISSING; NODE_PRESENT — install (see below).
• PLAYWRIGHT_MCP_MISSING; NODE_MISSING — stop. Tell the user: "Playwright MCP requires Node.js 18 or newer, which is not installed on this machine. Install Node (https://nodejs.org/) and re-run the task."

Install (Claude Code)

If running under Claude Code and Node is present, run:

claude mcp add playwright -- npx -y @playwright/mcp@latest

Then re-run detection to verify.

Install (Codex)

If running under Codex, the install-codex.sh script writes the Playwright MCP entry into ~/.codex/config.toml at install time. If detection still reports it missing, re-run that script:

bash supersaiyan/scripts/install-codex.sh

Failure modes

• claude mcp add fails: surface the error verbatim to the user and stop. Do NOT improvise an alternative.
• Browser binary missing on first use: Playwright MCP installs browsers on demand on first navigation. If browser_navigate errors with a missing binary, the MCP server itself will print the install command — pass that to the user.
• Headless environment with no display: Playwright MCP defaults to headless mode, which works on servers. If the agent needs visible browser interactions and DISPLAY is unset, note this in the report rather than failing silently.