docs: enhance troubleshooting guide with detailed solutions
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
--isolatedflag 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
-yflag to avoid installation prompts during debugging
Changes
-
docs/troubleshooting.md- Enhanced with more detailed solutions and examples
These improvements help users:
- Self-diagnose common connection and startup errors without opening an issue
- Validate their configuration files correctly
- Enable debugging on different operating systems
- 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
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.
Please sign the CLA