# troubleshooting

> Claude/Codex skill by [@chromedevtools](https://omgskills.com/library/chromedevtools/index.md) · 54k stars · Updated 2026-10-18

Uses Chrome DevTools MCP and documentation to troubleshoot connection and target issues. Trigger this skill when list\_pages, new\_page, or navigate\_page fail, or when the server initialization fails.

Tags: browser, chrome, chrome-devtools, debugging, devtools, mcp, mcp-server, puppeteer

## Install

```sh
git clone https://github.com/ChromeDevTools/chrome-devtools-mcp /tmp/chrome-devtools-mcp && ln -s /tmp/chrome-devtools-mcp/skills/troubleshooting ~/.claude/skills/troubleshooting
```

## From README

Troubleshooting Wizard You are acting as a troubleshooting wizard to help the user configure and fix their Chrome DevTools MCP server . When this skill is triggered (e.g., because listpages, newpage, or navigatepage failed, or the server wouldn't start), follow this step-by-step diagnostic process: Step 1: Find and Read Configuration Your first action should be to locate and read the MCP configuration file. Search for the following files in the user's workspace: .mcp.json, .vscode/mcp.json, gemini-extension.json, or .gemini/settings.json (or user-scoped files such as /.claude.json if accessible). If you find a configuration file, read and interpret it to identify potential issues such as: Incorrect arguments or flags. Missing environment variables. of --autoConnect in incompatible environments. If you cannot find any of these files, only then should you ask the user to provide their configuration file content.

## Links

- HTML page: https://omgskills.com/skills/chromedevtools/chrome-devtools-mcp/troubleshooting/
- GitHub: https://github.com/ChromeDevTools/chrome-devtools-mcp
- Author: [@chromedevtools](https://omgskills.com/library/chromedevtools/index.md)

## More from this repo

- [chrome-devtools](https://omgskills.com/skills/chromedevtools/chrome-devtools-mcp/chrome-devtools/index.md) — Uses Chrome DevTools via MCP for efficient debugging, troubleshooting and browser automation.
   - [@chromedevtools](https://omgskills.com/library/chromedevtools/index.md) · 54k stars
- [a11y-debugging](https://omgskills.com/skills/chromedevtools/chrome-devtools-mcp/a11y-debugging/index.md) — Uses Chrome DevTools MCP for accessibility (a11y) debugging and auditing based on web.dev guidelines.
   - [@chromedevtools](https://omgskills.com/library/chromedevtools/index.md) · 54k stars
- [chrome-devtools-cli](https://omgskills.com/skills/chromedevtools/chrome-devtools-mcp/chrome-devtools-cli/index.md) — Used to write shell scripts or run shell commands to automate tasks in the browser or otherwise use Chrome DevTools via...
   - [@chromedevtools](https://omgskills.com/library/chromedevtools/index.md) · 54k stars