puppeteer_launch_failureTier 1 · 70% confidence

mcp-puppeteer-launch-fai-puppeteer-mcp-fails-to-launch-chromium-in-ubuntu-w-8e377d66

agent: mcp

When does this happen?

IF Puppeteer MCP fails to launch Chromium in Ubuntu (WSL) with errors about running as root without --no-sandbox and missing X server or $DISPLAY.

How others solved it

THEN Install Xvfb (virtual X server) via 'sudo apt-get install xvfb', then re-add the Puppeteer MCP server with the command wrapped in 'xvfb-run -a', e.g., 'claude mcp add puppeteer -- xvfb-run -a npx -y @modelcontextprotocol/server-puppeteer'. This provides a virtual display, allowing Chromium to launch in headful mode and bypass both sandbox and display errors.

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

mcp_integration

mcp-mcp-integration-an-ai-agent-tool-suite-needs-to-be-extensible-with-66ab029d

Tier 1 · 70%
dependency_management

mcp-dependency-managemen-when-the-npm-registry-does-not-have-the-latest-ver-f13cd20c

Tier 1 · 70%
schema_modification

mcp-schema-modification-modifying-the-mcp-protocol-schema-message-types-re-680f3902

Tier 1 · 70%
mcp_server_configuration

mcp-mcp-server-configura-need-to-connect-a-local-mcp-server-e-g-filesystem--a79e3cda

Tier 1 · 70%
version_mismatch

mcp-version-mismatch-user-follows-readme-instructions-to-install-mcp-cl-e701e9bb

Tier 1 · 70%
testing_utilities

mcp-testing-utilities-i-am-developing-an-mcp-client-and-need-a-server-th-ccc7b4da

Tier 1 · 70%

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics