skills.rest
sharegpu
sharegpuOFFICIAL
Explore all skills by this author →
WebsiteGitHub

troubleshooting

Diagnose Chrome DevTools MCP configuration and connectivity errors.

Updated Mar 26, 2026
Search Tags:#debugging#troubleshoot#mcp#chrome-devtools-mcp#chromedevtools
One-click install
npx skills add https://github.com/sharegpu/gpushare-plugins --skill troubleshooting-sharegpu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: troubleshooting
Source: https://github.com/sharegpu/gpushare-plugins/tree/main/plugins/chrome-devtools-mcp/skills/troubleshooting
Command: npx skills add https://github.com/sharegpu/gpushare-plugins --skill troubleshooting-sharegpu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Troubleshoots Chrome DevTools MCP server connectivity and target issues using a structured diagnostic approach.

Core Features & Use Cases

  • Step-by-step diagnostic flow to locate and read configuration files, triage common connection errors, and apply known issue fixes.
  • Provides actionable MCP configuration recommendations and diagnostic commands based on the user's environment.
  • Suitable for scenarios where MCP server initialization fails or Chrome debugging connection fails, guiding users to restore normal operation.

Quick Start

Run the troubleshooting wizard whenever list_pages, new_page, navigate_page fail, or the MCP server fails to start.

Frequently Asked Questions about troubleshooting

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

FAQPage Schema
Why does my Chrome DevTools MCP server fail to start with Could not find DevToolsActivePort?▼

The DevToolsActivePort error occurs when Chrome is not running or lacks remote debugging enabled. This troubleshooting skill locates your MCP configuration files, checks if Chrome is running, and guides you through explicit steps to enable remote debugging and validate server connectivity.

How do I configure .mcp.json or .claude/settings.json for Chrome DevTools MCP?▼

To configure Chrome DevTools MCP, this skill reads your .mcp.json, gemini-extension.json, or .claude/settings.json files. It triages common connection errors and formulates an appropriate MCP configuration with diagnostic commands to validate server startup and target connectivity.

What steps fix Chrome DevTools MCP list_pages or navigate_page failures?▼

Fixing list_pages or navigate_page failures involves diagnosing Chrome debugging connections. This skill provides a step-by-step diagnostic flow to locate configuration files, triage connection errors, apply known issue fixes, and propose commands to restore normal MCP server operation.

Does Chrome DevTools MCP troubleshooting work with .vscode/launch.json and .gemini/settings.json?▼

Yes, this troubleshooting skill explicitly locates and reads .vscode/launch.json and .gemini/settings.json files. It checks these configurations to determine whether Chrome is running with remote debugging enabled and guides you to resolve initialization failures across these environments.

What is the best way to diagnose Chrome DevTools MCP connectivity issues?▼

The best way to diagnose Chrome DevTools MCP connectivity issues is using a structured diagnostic flow. This skill locates configuration files, triages errors like DevToolsActivePort, consults known issues, and proposes diagnostic commands to validate server startup and target connectivity.

Related Skills

Explore More Software Engineering Skills→
escarfaceescarface

MCP Integration

Configure MCP servers in Claude Code plugins via .mcp.json or plugin.json.

Community
Intermediate
mvellandimvellandi

troubleshooting

Diagnose Chrome DevTools MCP server connection and target failures.

Community
Advanced
jt302jt302
2

chrome-devtools

Automate browser control and inspection of live Chrome sessions via the chrome-devtools MCP server.

Community
Advanced
dnzengoudnzengou

render-debug

Diagnose Render deployment failures by analyzing logs, metrics, and database state.

Community
Advanced