From fc3ae91c93e92673e122d9a4ddc2c11c29994884 Mon Sep 17 00:00:00 2001 From: Alex Rudenko Date: Mon, 22 Sep 2025 16:13:02 +0200 Subject: [PATCH 1/2] docs: document mcp client sandboxing --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index 16cbf7b8..e0e0fcc1 100644 --- a/README.md +++ b/README.md @@ -204,3 +204,14 @@ The user data directory is not cleared between runs and shared across all instances of `chrome-devtools-mcp`. Set the `isolated` option to `true` to use a temporary user data dir instead which will be cleared automatically after the browser is closed. + +## Known limitations + +### Operating system sandboxes + +Some MCP clients allow sandboxing the MCP server using MacOS Seatbelt or linux +containers. If sandboxes are enabled, `chrome-devtools-mcp` is not able to start +Chrome that requires permissions to create its own sandboxes. As a workaround, +either disable sandboxing for `chrome-devtools-mcp` in your MCP client or use +`--connect-url` to connect to a Chrome instance that you start manually outside +of the MCP client sandbox. From 74c1d51b22d644c2f5f80636339e604d3bc48eee Mon Sep 17 00:00:00 2001 From: Alex Rudenko Date: Mon, 22 Sep 2025 16:13:36 +0200 Subject: [PATCH 2/2] Update README.md Co-authored-by: Sebastian Benz --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index e0e0fcc1..1be7ddb0 100644 --- a/README.md +++ b/README.md @@ -209,7 +209,7 @@ the browser is closed. ### Operating system sandboxes -Some MCP clients allow sandboxing the MCP server using MacOS Seatbelt or linux +Some MCP clients allow sandboxing the MCP server using macOS Seatbelt or Linux containers. If sandboxes are enabled, `chrome-devtools-mcp` is not able to start Chrome that requires permissions to create its own sandboxes. As a workaround, either disable sandboxing for `chrome-devtools-mcp` in your MCP client or use