@@ -12,6 +12,7 @@ You are acting as a troubleshooting wizard to help the user configure and fix th
1212Identify 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