troubleshooting

Diagnoses and fixes Chrome DevTools MCP server connection and configuration issues.

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/rithm84/Manor --skill troubleshooting-rithm84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshooting
Source: https://github.com/rithm84/Manor/tree/main/.agents/skills/browser-related/chrome-devtools-mcp/troubleshooting
Command: npx skills add https://github.com/rithm84/Manor --skill troubleshooting-rithm84

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When the Chrome DevTools MCP server fails to start, cannot connect to a running Chrome instance, or exposes only a limited set of tools, this Skill walks through a structured diagnostic process to identify the root cause and produce a working configuration. ## Core Features & Use Cases - Configuration Inspection: Locates and reads MCP config files such as .mcp.json, .claude/settings.json, or .vscode/launch.json to detect incorrect flags, missing environment variables, or typos like --autoBronnect. - Error Triage: Maps common errors like "Could not find DevToolsActivePort", "Target closed", and missing tools to specific fixes, including enabling remote debugging at chrome://inspect or disabling read-only mode in the MCP client. - Configuration Generation: Produces corrected MCP server JSON snippets, recommending --browser-url for sandboxed environments, --logFile for debug capture, or increased startup_timeout_ms on Windows. - Use Case: If list_pages fails after setup, the Skill verifies Chrome is running with remote debugging enabled, retries list_pages, and escalates to log analysis or GitHub issue searches only if needed. ## Quick Start Ask the assistant to troubleshoot why the Chrome DevTools MCP server fails when calling list_pages or new_page.

Frequently Asked Questions about troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix the Could not find DevToolsActivePort error in chrome-devtools-mcp?

This error means the --autoConnect feature cannot find a running debuggable Chrome instance. Confirm the correct Chrome version is running, then open chrome://inspect/#remote-debugging and enable remote debugging. After that, call list_pages to verify the connection.

Why does chrome-devtools-mcp only show 9 tools?

A limited tool set usually means the MCP client is enforcing read-only mode, which hides tools annotated with readOnlyHint: false such as click and navigate_page. Disable read-only mode in your client, for example by exiting Plan Mode in Gemini CLI.

Should I use --autoConnect or --browserUrl with chrome-devtools-mcp?

Use --autoConnect when a locally running Chrome 144+ instance has remote debugging enabled. Use --browser-url=http://127.0.0.1:9222 instead in sandboxed environments like Claude Desktop where the auto-connect handshake cannot complete.

Why do Chrome extensions fail to load with chrome-devtools-mcp?

Extension tools require the --categoryExtensions flag in the server configuration. Additionally, Chrome before version 149 cannot load extensions when connecting to an existing instance via --autoConnect or --browserUrl, so the server must launch Chrome itself.

How do I capture debug logs from chrome-devtools-mcp?

Add --logFile with an absolute path to the server configuration, or run DEBUG=* npx chrome-devtools-mcp@latest --logFile=/tmp/cdm-test.log directly. The verbose output helps identify sandboxing, timeout, or module resolution errors.