Skip to content

Commit 85870eb

Browse files
feat: add Claude plugin browser URL config
1 parent 728d902 commit 85870eb

2 files changed

Lines changed: 26 additions & 1 deletion

File tree

.claude-plugin/plugin.json

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,19 @@
22
"name": "chrome-devtools-mcp",
33
"version": "0.21.0",
44
"description": "Reliable automation, in-depth debugging, and performance analysis in Chrome using Chrome DevTools and Puppeteer",
5+
"userConfig": {
6+
"browserUrl": {
7+
"description": "Optional URL of a running debuggable Chrome instance, for example http://127.0.0.1:9222. Leave blank to launch Chrome automatically.",
8+
"sensitive": false
9+
}
10+
},
511
"mcpServers": {
612
"chrome-devtools": {
713
"command": "npx",
8-
"args": ["chrome-devtools-mcp@latest"]
14+
"args": [
15+
"chrome-devtools-mcp@latest",
16+
"--browser-url=${user_config.browserUrl}"
17+
]
918
}
1019
}
1120
}

README.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -165,6 +165,22 @@ Then, install the plugin:
165165

166166
Restart Claude Code to have the MCP server and skills load (check with `/skills`).
167167

168+
To connect the plugin to a Chrome instance that is already running with remote debugging, set the plugin's `browserUrl` option in your Claude Code settings:
169+
170+
```json
171+
{
172+
"pluginConfigs": {
173+
"chrome-devtools-mcp@claude-plugins-official": {
174+
"options": {
175+
"browserUrl": "http://127.0.0.1:9222"
176+
}
177+
}
178+
}
179+
}
180+
```
181+
182+
Leave `browserUrl` blank to use the default behavior where Chrome DevTools MCP launches Chrome automatically.
183+
168184
> [!TIP]
169185
> If the plugin installation fails with a `Failed to clone repository` error (e.g., HTTPS connectivity issues behind a corporate firewall), see the [troubleshooting guide](./docs/troubleshooting.md#claude-code-plugin-installation-fails-with-failed-to-clone-repository) for workarounds, or use the CLI installation method above instead.
170186

0 commit comments

Comments
 (0)