chrome-devtools-mcp icon indicating copy to clipboard operation
chrome-devtools-mcp copied to clipboard

docs: enhance troubleshooting guide with detailed solutions

Open claudeaceae opened this issue 3 weeks ago • 2 comments

Summary

This PR significantly improves the troubleshooting documentation to help users diagnose and fix common issues more effectively:

Enhanced error troubleshooting

  • Expanded "Target closed" error section with 5 common causes and their solutions
  • Added --isolated flag example for profile conflicts

New troubleshooting section

  • Added section for configuration file issues
  • Included JSON validation tips and common pitfalls
  • Provided example of valid MCP configuration

Improved debugging instructions

  • Added platform-specific examples for Windows (PowerShell) and Unix/Linux
  • Documented what information debug logs contain
  • Added -y flag to avoid installation prompts during debugging

Changes

  • docs/troubleshooting.md - Enhanced with more detailed solutions and examples

These improvements help users:

  1. Self-diagnose common connection and startup errors without opening an issue
  2. Validate their configuration files correctly
  3. Enable debugging on different operating systems
  4. Understand what information logs provide for bug reports

Impact

This should reduce common support questions and help users get up and running faster.

🤖 Generated with Claude Code

claudeaceae avatar Dec 22 '25 19:12 claudeaceae

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

google-cla[bot] avatar Dec 22 '25 19:12 google-cla[bot]

Please sign the CLA

OrKoN avatar Jan 12 '26 14:01 OrKoN