You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: skills/troubleshooting/SKILL.md
+7-5Lines changed: 7 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,16 +7,18 @@ description: Uses Chrome DevTools MCP and documentation to troubleshoot connecti
7
7
8
8
You are acting as a troubleshooting wizard to help the user configure and fix their Chrome DevTools MCP server setup. When this skill is triggered (e.g., because `list_pages`, `new_page`, or `navigate_page` failed, or the server wouldn't start), follow this step-by-step diagnostic process:
9
9
10
-
### Step 1: Read Configuration
10
+
### Step 1: Find and Read Configuration
11
11
12
-
Ask the user to provide their MCP configuration file content (e.g. `.claude/settings.json`, `./gemini/settings.json`, or `.mcp.json`).
12
+
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`, `gemini-extension.json`, `.claude/settings.json`, `.vscode/launch.json`, or `.gemini/settings.json`.
13
13
14
-
Interpret the configuration to identify potential issues such as:
14
+
If you find a configuration file, read and interpret it to identify potential issues such as:
15
15
16
16
- Incorrect arguments or flags.
17
17
- Missing environment variables.
18
18
- Usage of `--autoConnect` in incompatible environments.
19
19
20
+
If you cannot find any of these files, only then should you ask the user to provide their configuration file content.
21
+
20
22
### Step 2: Triage Common Connection Errors
21
23
22
24
Before reading documentation or suggesting configuration changes, check if the error message matches one of the following common patterns.
@@ -72,8 +74,8 @@ _If you are unsure of the user's configuration, ask the user to provide their cu
72
74
73
75
If the issue is still unclear, run diagnostic commands to test the server directly:
74
76
75
-
-`npx chrome-devtools-mcp@latest --help`(to verify the installation and Node.js environment)
76
-
-Ask the user to run `DEBUG=* npx chrome-devtools-mcp@latest --logFile=/tmp/cdm-test.log` to capture verbose logs if they are attempting to run it from an IDE or different environment.
77
+
-Run `npx chrome-devtools-mcp@latest --help` to verify the installation and Node.js environment.
78
+
-If you need more information, run `DEBUG=* npx chrome-devtools-mcp@latest --logFile=/tmp/cdm-test.log` to capture verbose logs. Analyze the output for errors.
0 commit comments