troubleshooting
An official Chrome DevTools for agents skill for when the Chrome DevTools MCP server will not start or cannot reach the browser, for example when listing, opening or navigating pages fails.
What the skill teaches
An official Chrome DevTools for agents skill for when the Chrome DevTools MCP server will not start or cannot reach the browser, for example when listing, opening or navigating pages fails. The agent works through a fixed order: find and read the MCP configuration file in the workspace (such as .mcp.json or the VS Code and Gemini settings), look for wrong flags, missing environment variables or auto-connect used where it cannot work, match the error against common connection failures, and then consult the project's troubleshooting documentation before proposing a fix.
Capabilities
- Read and check the MCP client configuration
- Diagnose server start-up and browser connection errors
- Suggest configuration fixes from the project docs
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tools | Chrome DevTools, Debugging | |
| Publisher | ChromeDevTools | source |
| Official status | Officialshipped in the official ChromeDevTools repository that Chrome's docs link to | source |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | Apache-2.0 | source |
| Pricing | Not stated in its documentation | |
| Activity | No commit dataDownload data not available (not on npm or PyPI) | |
| Links | Repository |
More from ChromeDevTools
1 server · 8 skills
- Chrome DevTools MCP (MCP server)
- chrome-devtools (Skill)
- chrome-devtools-cli (Skill)
- a11y-debugging (Skill)
- debug-optimize-lcp (Skill)
- memory-leak-debugging (Skill)
Also listed under: Debugging
Sources
- Skill file (SKILL.md)github.com/ChromeDevTools/chrome-devtools-mcpNov 12, 2026
- GitHub repositorygithub.com/ChromeDevTools/chrome-devtools-mcp · Backs: PublisherNov 12, 2026
- Licence file (LICENSE)github.com/ChromeDevTools/chrome-devtools-mcp · Backs: LicenceNov 12, 2026
- Web pagedeveloper.chrome.com · Backs: Official statusNov 12, 2026
- Folder in the repository (troubleshooting)github.com/ChromeDevTools/chrome-devtools-mcp · Backs: Includes scriptsNov 12, 2026