puppeteer_setupTier 1 · 70% confidence

mcp-puppeteer-setup-puppeteer-mcp-fails-to-launch-chromium-on-headless-728076d6

agent: mcp

When does this happen?

IF Puppeteer MCP fails to launch Chromium on headless Linux (WSL) with errors 'Running as root without --no-sandbox' and 'Missing X server or $DISPLAY'.

How others solved it

THEN Install Xvfb (sudo apt-get install xvfb) and wrap the Puppeteer MCP command with xvfb-run -a to provide a virtual display. Remove and re-add the server with: claude mcp add puppeteer -- xvfb-run -a npx -y @modelcontextprotocol/server-puppeteer.

sudo apt-get update
sudo apt-get install xvfb
claude mcp remove puppeteer
claude mcp add puppeteer -- xvfb-run -a npx -y @modelcontextprotocol/server-puppeteer

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics