Skip to content

Chrome DevTools for coding agents

docs: improve autoConnect docs (#653)

Sebastian Benz09111cc16464
diff --git a/README.md b/README.md
index 637176e0..f0d0d580 100644
--- a/README.md
+++ b/README.md
@@ -351,7 +351,7 @@ The Chrome DevTools MCP server supports the following configuration option:
<!-- BEGIN AUTO GENERATED OPTIONS -->
- **`--autoConnect`**
- If specified, automatically connects to a browser (Chrome 145+) running in the user data directory identified by the channel param.
+ If specified, automatically connects to a browser (Chrome 145+) running in the user data directory identified by the channel param. Requires remote debugging being enabled in Chrome here: chrome://inspect/#remote-debugging.
- **Type:** boolean
- **Default:** `false`
diff --git a/src/browser.ts b/src/browser.ts
index 63221a3f..181ffe91 100644
--- a/src/browser.ts
+++ b/src/browser.ts
@@ -134,7 +134,7 @@ export async function ensureBrowserConnected(options: {
browser = await puppeteer.connect(connectOptions);
} catch (err) {
throw new Error(
- 'Could not connect to Chrome. Check if Chrome is running and remote debugging is enabled.',
+ 'Could not connect to Chrome. Check if Chrome is running and remote debugging is enabled by going to chrome://inspect/#remote-debugging.',
{
cause: err,
},
diff --git a/src/cli.ts b/src/cli.ts
index 3e25f8d6..db268058 100644
--- a/src/cli.ts
+++ b/src/cli.ts
@@ -11,7 +11,7 @@ export const cliOptions = {
autoConnect: {
type: 'boolean',
description:
- 'If specified, automatically connects to a browser (Chrome 145+) running in the user data directory identified by the channel param.',
+ 'If specified, automatically connects to a browser (Chrome 145+) running in the user data directory identified by the channel param. Requires remote debugging being enabled in Chrome here: chrome://inspect/#remote-debugging.',
conflicts: ['isolated', 'executablePath'],
default: false,
coerce: (value: boolean | undefined) => {