Skip to content

Commit f2d5a6e

Browse files
committed
docs: Clarify that Chrome 144+ must be running for --autoConnect and add a verification step for remote debugging.
1 parent ef29641 commit f2d5a6e

2 files changed

Lines changed: 3 additions & 3 deletions

File tree

docs/troubleshooting.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ Possible workarounds include:
104104

105105
If you are using the `--autoConnect` flag and tools like `list_pages`, `new_page`, or `navigate_page` fail with a timeout (e.g., `ProtocolError: Network.enable timed out` or `The socket connection was closed unexpectedly`), this usually means the MCP server cannot handshake with the running Chrome instance correctly. Ensure:
106106

107-
1. Chrome 144+ is running.
107+
1. Chrome 144+ is **already** running.
108108
2. Remote debugging is enabled in Chrome via `chrome://inspect/#remote-debugging`.
109109
3. You have allowed the remote debugging connection prompt in the browser.
110110
4. There is no other MCP server or tool trying to connect to the same debugging port.

skills/troubleshooting/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Read the contents of https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/
2323

2424
- Sandboxing restrictions (macOS Seatbelt, Linux containers).
2525
- WSL requirements.
26-
- `--autoConnect` handshakes, timeouts, and requirements (requires Chrome 144+).
26+
- `--autoConnect` handshakes, timeouts, and requirements (requires **running** Chrome 144+).
2727
- Conflicts between `--autoConnect`/`--browser-url` and extension debugging.
2828

2929
### Step 3: Formulate a Configuration
@@ -32,7 +32,7 @@ Based on the exact error and the user's environment (OS, MCP client), formulate
3232

3333
- Pass `--browser-url=http://127.0.0.1:9222` instead of `--autoConnect` (e.g. if they are in a sandboxed environment like Claude Desktop).
3434
- Remove `--enableCategoryExtensions` if using `--autoConnect`.
35-
- Enable remote debugging in Chrome (`chrome://inspect/#remote-debugging`) and accept the connection prompt.
35+
- Enable remote debugging in Chrome (`chrome://inspect/#remote-debugging`) and accept the connection prompt. **Ask the user to verify this is enabled if using `--autoConnect`.**
3636
- Add `--logFile <absolute_path_to_log_file>` to capture debug logs for analysis.
3737
- Increase `startup_timeout_ms` (e.g. to 20000) if using Codex on Windows.
3838

0 commit comments

Comments
 (0)