Skip to content

Commit ef29641

Browse files
committed
docs: Enhance troubleshooting guide with 'Tool not found' error, --autoConnect Chrome 144+ requirement, and startup_timeout_ms tip for Windows.
1 parent 0691d71 commit ef29641

1 file changed

Lines changed: 3 additions & 1 deletion

File tree

skills/troubleshooting/SKILL.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ You are acting as a troubleshooting wizard to help the user configure and fix th
1212
Identify the exact error message from the failed tool call or the MCP initialization logs. Look for common errors such as:
1313

1414
- `Target closed`
15+
- "Tool not found" (check if they are using `--slim` which only enables navigation and screenshot tools).
1516
- `ProtocolError: Network.enable timed out` or `The socket connection was closed unexpectedly`
1617
- `Error [ERR_MODULE_NOT_FOUND]: Cannot find module`
1718
- Any sandboxing or host validation errors.
@@ -22,7 +23,7 @@ Read the contents of https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/
2223

2324
- Sandboxing restrictions (macOS Seatbelt, Linux containers).
2425
- WSL requirements.
25-
- `--autoConnect` handshakes, timeouts, and requirements.
26+
- `--autoConnect` handshakes, timeouts, and requirements (requires Chrome 144+).
2627
- Conflicts between `--autoConnect`/`--browser-url` and extension debugging.
2728

2829
### Step 3: Formulate a Configuration
@@ -33,6 +34,7 @@ Based on the exact error and the user's environment (OS, MCP client), formulate
3334
- Remove `--enableCategoryExtensions` if using `--autoConnect`.
3435
- Enable remote debugging in Chrome (`chrome://inspect/#remote-debugging`) and accept the connection prompt.
3536
- Add `--logFile <absolute_path_to_log_file>` to capture debug logs for analysis.
37+
- Increase `startup_timeout_ms` (e.g. to 20000) if using Codex on Windows.
3638

3739
_If you are unsure of the user's configuration, ask the user to provide their current MCP server JSON configuration._
3840

0 commit comments

Comments
 (0)