Chrome Mcp Windows Survival Guide
БесплатноНе проверенSix real gotchas I hit installing hangwin/mcp-chrome on Windows 11. Diagnostic flow, fixes, scripts, and links to upstream PRs (#345/#346/#347).
Описание
Six real gotchas I hit installing hangwin/mcp-chrome on Windows 11. Diagnostic flow, fixes, scripts, and links to upstream PRs (#345/#346/#347).
README
Nine real gotchas I hit installing and operating hangwin/mcp-chrome on Windows 11 — the MCP server that drives your actual logged-in Chrome (not a fresh sandbox) so AI tools like Claude Code can act on your real accounts, cookies, sessions and bookmarks.
The official README covers the happy path. This guide covers the failure modes you'll hit on Windows 11 — each with the symptom you'll see, the root cause I traced, and the fix that actually worked. Two of them (#5 and #6) are upstream issues I opened and PR'd on 2026-05-18 — the rest are pure operator knowledge.
Audience: anyone using
chrome-mcpwith Claude Code (or any MCP client) on Windows, especially with multiple Chrome profiles or alongside Anthropic's first-party Claude for Chrome extension.
Update 2026-10 — how I run this now. The gotchas below still describe
chrome-mcpas of May 2026, but I no longer use it myself. I moved to Anthropic's Claude in Chrome extension (Claude Code's/chrome) in late May 2026 (since dropped too, see below), and since 2026-10-07 the agent gets its own dedicated Chromium: a separate Chromium install with its own--user-data-dirand--remote-debugging-port=9222(localhost). Both/chrome(extension installed inside that Chromium) and chrome-devtools-mcp (--browserUrl http://127.0.0.1:9222) attach to that one browser. My everyday Chrome has no agent attached at all.Update 2026-10-08: I've turned
/chromeoff as well and removed the extension and its native host.chrome-devtools-mcpnow does all in-page work (including screen recording via its screencast tools plus ffmpeg), and a separate desktop-automation MCP does the few things that need a real OS-level click: user-gesture checks, canvas, native file dialogs, and sites that refuse a debugger connection. Several Claude Code sessions share the one Chromium; each opens its own tab and never touches tabs it didn't open.Why: one browser for every agent tool, and no more crossed wires: the agent driving my personal Chrome, links I clicked landing in the agent's window, or pages opened for me to look at showing up inside the agent's session. A different app icon also makes the windows easy to tell apart. Because it's a non-default data dir, the debug port works (see Gotcha 1); I just log the agent profile into the accounts it needs.
Setup notes: a small launcher starts Chromium with those flags (and quotes
--profile-directory="Profile 1"correctly, since unquoted spaces break the argument). Chromium builds from winget don't auto-update, so the launcher runswinget upgradefirst when Chromium isn't already open. Native Messaging hosts for Chromium are registered underHKCU\Software\Chromium\NativeMessagingHosts, not the Google Chrome key. Start Chromium before the MCP client, orchrome-devtools-mcphas nothing to attach to.
Table of contents
- Quick install — the happy path that does work
- Diagnose first — which gotcha are you hitting?
Install-time gotchas (Chrome + extension + bridge setup):
- Gotcha 1 — Chrome 136+ silently drops --remote-debugging-port
- Gotcha 2 — MCP boot has no auto-retry · install bridge BEFORE Claude CLI starts
- Gotcha 3 — bridge ↔ extension version sync
- Gotcha 4 — Claude for Chrome and chrome-mcp fight over chrome.debugger
- Gotcha 5 — Multi-session orphaning · singleton MCP Server reassigns transport
- Gotcha 6 — Multi-profile port collision · Approach B workaround
Operational gotchas (post-install · runtime · these only surface when actively driving the browser):
- Gotcha 7 — isTrusted=false blocks OAuth · password · file-dialog clicks
- Gotcha 8 — CDP redaction when a password input is in the DOM
- Gotcha 9 — chrome_keyboard text input has surprising parser limits · use insertText instead
- Cost-aware usage · token efficiency hierarchy
- Appendix · Upstream contributions
- Sponsors
Quick install
The path that works on Windows 11 (Chrome 148, Node 22, Claude Code 2.1.x):
# 1. Install the bridge npm package globally
npm install -g mcp-chrome-bridge
# 2. Download the extension from hangwin's releases
# https://github.com/hangwin/mcp-chrome/releases
# Extract to a stable folder (NOT in Downloads — Chrome warns daily about unpacked extensions from temp paths)
# Example: D:\tools\chrome-extensions\mcp-chrome\
# 3. Chrome -> chrome://extensions -> Developer mode ON -> Load unpacked -> select the folder
# Note the extension ID (should be hbdgbgagpkpjffpklnamcljpakneikee if the manifest has the `key` field set)
# 4. Click the extension icon -> Connect
# Bridge process auto-spawns via Native Messaging · listens on 127.0.0.1:12306
# 5. Add the MCP entry to your client config
# For Claude Code: ~/.claude.json (or whatever CLAUDE_CONFIG_DIR points to)
# "chrome-mcp": { "type": "http", "url": "http://127.0.0.1:12306/mcp" }
# 6. Restart Claude CLI · tools should appear under mcp__chrome-mcp__*
Verify with: mcp-chrome-bridge doctor (returns OK once the extension is Connected).
Diagnose: which gotcha are you hitting?
| Symptom | Likely gotcha |
|---|---|
Tried CDP attach mode (--remote-debugging-port=9222) · port never opens · DevToolsActivePort file never appears |
#1 |
Extension popup says "Connected" but Claude CLI reports chrome-mcp as failed/dead at startup · tool calls return "MCP server not available" |
#2 |
Extension and bridge both run · handshake fails silently · mcp-chrome-bridge doctor warns about version mismatch |
#3 |
chrome-mcp tools work until you open a tab where Anthropic's Claude for Chrome extension is active · then that tab returns "Cannot attach debugger" or silently no-ops |
#4 |
Open a second Claude Code session · the first one's chrome-mcp tools stop responding · every context switch needs Disconnect/Connect on the extension popup |
#5 |
| Installed extension in multiple Chrome profiles · only one profile's tools work · the others show "Connected" but fail | #6 |
chrome_click_element succeeds with no error but the click "did nothing" on an OAuth popup / login form / file dialog |
#7 |
chrome_javascript returns "Cannot access a chrome-extension:// URL of different extension" for every call · works on other tabs |
#8 |
chrome_keyboard keys="some_text" returns "Invalid key string or combination" for any text with underscores · single chars work |
#9 |
Gotcha 1 — Chrome 136+ silently drops --remote-debugging-port on the default profile
Symptom
You're trying to drive your real Chrome (the one with your logins) via Chrome DevTools Protocol — adding --remote-debugging-port=9222 to your Chrome shortcut so chrome-devtools-mcp --browser-url=http://127.0.0.1:9222 can attach. The Chrome process command line contains the flag, but:
Get-NetTCPConnection -LocalPort 9222 -State Listenreturns empty%LOCALAPPDATA%\Google\Chrome\User Data\DevToolsActivePortnever gets created- Direct connect to
http://127.0.0.1:9222/jsonfails
Root cause
Chrome 136+ refuses to expose the debug port when --user-data-dir resolves to the default profile location. This was a deliberate Chromium security change (~Q1 2024) to prevent credential theft via an attacker's local process spamming /json/version against your logged-in browser. Even though the flag is parsed, the listener is not started when the data-dir matches default.
Confirmed on Chrome 148 (verified 2026-05-17).
Fix · don't fight Chrome — pivot to the extension model
The clean fix is to stop using CDP attach mode entirely and use hangwin/mcp-chrome instead. It uses Chrome Native Messaging — a different transport that Chrome explicitly trusts because the bridge process is registered under HKCU and the extension manifest lists nativeMessaging permission. No debug port, no security tradeoff.
If you still need CDP attach mode for a specific tool that can't speak MCP:
# Workaround: explicit user-data-dir (NOT default · use a separate Chrome profile dir)
"chrome.exe" --remote-debugging-port=9222 --user-data-dir="D:\chrome-cdp-profile"
This works because the security rule only applies to the default profile dir. The trade-off: that profile starts empty, so you sign in to the accounts the agent needs there instead of reusing your everyday sessions. In May 2026 I treated that as a dealbreaker and went with the extension model; since October 2026 a dedicated agent browser is exactly how I run things (see the update note at the top).
Gotcha 2 — MCP boot has no auto-retry · install the bridge BEFORE Claude CLI starts
Symptom
Extension popup says "Connected" (green badge). mcp-chrome-bridge doctor reports OK. But Claude Code reports chrome-mcp as failed in the MCP list, and tool calls return "MCP server not available". Restarting the bridge doesn't help.
Root cause
Claude CLI does one MCP handshake at boot. If the bridge isn't ready exactly when the CLI fires its HTTP request to 127.0.0.1:12306/mcp, the CLI marks the server permanently dead for that session lifetime. No auto-retry. No backoff. The bridge can come up 100ms later — the CLI doesn't notice.
This is upstream MCP client behavior, not chrome-mcp specific. But chrome-mcp's bridge is lazy-launched via Native Messaging — it only spawns when the extension calls chrome.runtime.connectNative(). Race condition during CLI startup is easy to trigger.
Fix
Boot order matters:
# 1. Start Chrome FIRST
# 2. Click the chrome-mcp extension icon -> Connect -> wait for "Connected" badge
# 3. Verify the bridge is listening:
Get-NetTCPConnection -LocalPort 12306 -State Listen # should show 1 entry
# 4. THEN launch Claude Code
claude # or your wrapper
If you skip step 3 and the CLI starts before the bridge is bound, /exit and restart. There's no in-session recovery.
/mcp reconnect chrome-mcp will revive the connection IF the server was loaded at boot and just dropped. It will NOT load new MCP entries that you added to .claude.json mid-session — those require a full process restart.
Gotcha 3 — Bridge and extension versions must match
Symptom
Both processes appear healthy individually. The bridge is listening on 12306. The extension popup is green. But MCP tool calls return cryptic errors like "Invalid MCP request" or hang indefinitely.
Root cause
The npm mcp-chrome-bridge package and the Chrome extension speak a Native Messaging protocol whose message shape changes between minor versions. Mixing extension v1.0.x with bridge v1.1.x (or vice versa) sometimes works for get_windows_and_tabs but breaks chrome_get_web_content and other tools that use newer message types.
Fix
Pin both to the same release. The extension version is whatever you downloaded; the bridge version is mcp-chrome-bridge --version (or npm list -g mcp-chrome-bridge).
# Check both
npm list -g mcp-chrome-bridge # bridge version
# Extension: chrome://extensions -> Chrome MCP Server card -> version line under name
If they don't match, prefer upgrading both to the latest tagged release on hangwin/mcp-chrome/releases. The bridge installs via npm; the extension is unpacked load — replace the folder contents and click "Reload" on the extension card.
After upgrade: Disconnect/Connect on the popup, then /exit + restart Claude CLI (because of Gotcha 2).
Gotcha 4 — Claude for Chrome and chrome-mcp fight over chrome.debugger per tab
Symptom
chrome-mcp works fine on most tabs. But certain tabs — typically ones you've recently asked Anthropic's official Claude for Chrome extension to look at — return "Cannot attach debugger" on chrome_get_web_content / chrome_screenshot, or silently no-op. The bridge is fine, the extension popup is green; only one specific tab is broken.
Root cause
Both extensions use the chrome.debugger API to read DOM, take screenshots, click elements. Chrome enforces one debugger attachment per tab at a time. Whichever extension attaches first wins; the second gets Cannot attach to the target with an attached client.
The chrome-mcp extension popup shows "Connected" because the bridge ↔ extension native messaging handshake succeeded. The per-tab debugger collision is invisible to the popup state — you have to know to look.
This is distinct from the documented Claude Desktop ↔ Claude Code conflict where two Anthropic products register the same native messaging host name. That's a host-level clash. This one is two different extensions (different IDs, different vendors) fighting over a per-tab Chrome API.
Fix
Pick one of:
| Option | Trade-off |
|---|---|
| Disable Claude for Chrome on tabs you'll drive via chrome-mcp | Easiest · lose Claude for Chrome on those tabs |
| Use a dedicated Chrome profile for chrome-mcp work (no Claude for Chrome installed in that profile) | Cleanest separation · pairs naturally with Gotcha #6 |
| Disable Claude for Chrome globally during chrome-mcp sessions | Heavy-handed · works if you don't need both at once |
| Open the target page in a new tab AFTER chrome-mcp attaches first | Race-condition fragile · not recommended |
There's no Chrome-level fix — the one-debugger-per-tab rule is the API contract.
Gotcha 5 — Multi-session orphaning · singleton MCP Server reassigns transport
Symptom
You open a second Claude Code session (different terminal, same machine). The second session's chrome-mcp works. But the first session's chrome-mcp tool calls now hang or return errors. Disconnect/Connect on the extension popup brings the second session back; the cycle repeats every context switch.
Root cause
I traced this through the bridge source. The HTTP server's transportsMap already routes incoming requests by mcp-session-id header — multi-session capable at the routing layer. But every new MCP initialize request calls getMcpServer().connect(transport) on a singleton MCP Server instance:
// app/native-server/src/mcp/mcp-server.ts
export let mcpServer: Server | null = null;
export const getMcpServer = () => {
if (mcpServer) return mcpServer; // singleton — same instance for every session
mcpServer = new Server({...});
setupTools(mcpServer);
return mcpServer;
};
// server/index.ts, MCP POST init branch
await getMcpServer().connect(transport); // <-- second call replaces _transport
The @modelcontextprotocol/sdk Server.connect(transport) assigns this._transport = transport, replacing whatever was there. So the second client's initialize orphans the first client's transport: requests still arrive at session 1's transport object, but the underlying SDK server writes responses to session 2's transport (which by then may have closed). Session 1 hangs.
Fix (upstream PR pending) · or install patched fork locally
The fix is small — replace the singleton with a factory:
// mcp/mcp-server.ts
export const createMcpServer = () => {
const server = new Server({...});
setupTools(server);
return server;
};
// server/index.ts, in both /mcp POST init and SSE branches
await createMcpServer().connect(transport);
Each session gets its own Server with its own transport binding. setupTools is per-instance pure. The extension-side native messaging pipe already routes by requestId UUIDs, so concurrency at the per-tab boundary stays correct.
I filed this as Issue #345 and put up PR #346 with end-to-end verification. If/when it merges, just npm install -g mcp-chrome-bridge@latest.
Until then, install the patched fork:
git clone https://github.com/MankhongGarden/mcp-chrome.git
cd mcp-chrome
git checkout fix/multi-session-mcp-server
pnpm install --filter mcp-chrome-bridge... --ignore-scripts
pnpm --filter chrome-mcp-shared build
cd app/native-server
pnpm build
npm install -g . # global mcp-chrome-bridge becomes a junction to your local clone
# In Chrome: Disconnect -> Connect on the extension popup
# Restart Claude CLI to re-establish MCP sessions
Revert at any time: npm install -g mcp-chrome-bridge@latest (removes the junction, installs stock).
After the fix is active, two Claude Code sessions can both call chrome-mcp tools without orphaning. Verified with direct HTTP POST simulating a second MCP client mid-call — session 1's tools keep responding correctly.
Gotcha 6 — Multi-profile port collision · Approach B workaround
Symptom
You want chrome-mcp available in multiple Chrome profiles (work, personal, per-project sandbox). You install the extension in each. Only one profile's tools actually work. The others show "Connected" but every tool call fails.
Root cause
Chrome Native Messaging spec: chrome.runtime.connectNative() spawns a new bridge process per profile. So N profiles → N bridge processes. All N processes try to bind 127.0.0.1:12306 (the default). First wins; the rest silently fail their HTTP server bind, but the extension ↔ native host handshake succeeded so the popup still shows green.
Fix (Approach B · workaround until upstream lands a proper solution)
Give each profile a unique port + matching MCP entry in your client. Below is a 5-profile setup. Adapt to however many profiles you have.
1. Plan the mapping:
| Port | Chrome profile slot | MCP entry name |
|---|---|---|
| 12306 | Profile A (e.g. main dev) | chrome-mcp (default) |
| 12307 | Profile B | chrome-mcp-B |
| 12308 | Profile C | chrome-mcp-C |
| 12309 | Profile D | chrome-mcp-D |
| 12310 | Profile E | chrome-mcp-E |
2. In each profile, install the extension once, then open the extension's options / popup and set the bridge port (the extension stores this in chrome.storage.local under nativeServerPort). Click Connect — the bridge for that profile binds the unique port.
3. Add the matching MCP entries to your client config. For Claude Code (~/.claude.json or $CLAUDE_CONFIG_DIR/.claude.json):
{
"mcpServers": {
"chrome-mcp": { "type": "http", "url": "http://127.0.0.1:12306/mcp" },
"chrome-mcp-B": { "type": "http", "url": "http://127.0.0.1:12307/mcp" },
"chrome-mcp-C": { "type": "http", "url": "http://127.0.0.1:12308/mcp" },
"chrome-mcp-D": { "type": "http", "url": "http://127.0.0.1:12309/mcp" },
"chrome-mcp-E": { "type": "http", "url": "http://127.0.0.1:12310/mcp" }
}
}
A PowerShell helper in scripts/add-chrome-mcp-profiles.ps1 does the JSON edit idempotently with auto-backup. Run it via your client's shell-passthrough if your AI agent can't self-modify its own config (Claude Code has a self-modification safety block that prevents the agent from writing .claude.json directly — you the user must invoke the script).
4. Restart your client. New MCP entries load at boot, not on reconnect.
5. Verify. From inside the client, call get_windows_and_tabs from each prefix — each should return a different tab set (matching that profile's Chrome instance).
Tool prefix selection rule
Pick prefix based on which Chrome profile owns the relevant accounts/cookies/sessions for the task. If you have an AI agent making tool calls, keep a mapping in its persistent memory (a markdown file the agent loads at session start) and put a short selection rule there:
"Use
chrome-mcp-{X}for tasks involving project X's accounts. Default tochrome-mcpfor the most-active profile. Never mix prefixes within one task — that drives multiple Chrome windows simultaneously and state diverges."
Long-term: profile-aware bridge proposal
The cleaner architecture is a single bridge process that multiplexes across profiles, with the client selecting a profile via header or session metadata. I filed this as Issue #347 — open to maintainer's preference between two candidate architectures. If/when something like it lands, Approach B's per-profile MCP entries collapse to a single entry with a profile selector.
Gotcha 7 — isTrusted=false blocks OAuth · password · file-dialog clicks
Symptom
You ask the AI to click "Generate Access Token" in an OAuth flow, "Sign in with Google", a password-protected admin panel, or a file picker dialog. chrome_click_element returns success: true. But nothing happens — the popup doesn't open, the form doesn't submit, no console error.
Root cause
Chrome marks DOM events as isTrusted=true (issued by genuine user input — mouse, keyboard, touch) or isTrusted=false (issued by JavaScript — .click(), dispatchEvent, CDP Input.dispatchMouseEvent). For most elements the distinction is invisible. But for security-sensitive UI surfaces, browsers reject isTrusted=false:
- OAuth consent screens and "Generate Token" buttons
- Password reveal toggles · "Save password" prompts
- File picker dialogs (
<input type=file>opening the OS dialog) - "Allow notifications" / "Allow camera" permission prompts
- "Save as PDF" / "Print to PDF" dialog confirmations
- Some payment confirmation buttons (Stripe Elements, vendor 3DS challenge frames)
This isn't a chrome-mcp bug — it's Chrome's user-activation requirement. The CDP Input.dispatchMouseEvent that backs chrome_click_element produces synthetic events that fail Chrome's "must be user activation" check on these surfaces. Verified 2026-05-17 against Meta Graph API Explorer's "Generate Access Token" button and Meta Business Suite's "App Live" publish button.
Fix
There is no programmatic workaround at the chrome-mcp layer — this is enforced by Chrome itself. Options:
| Strategy | When to use |
|---|---|
| Have the user click once, then automate the rest | Best for OAuth · the user clicks "Generate Token" · everything after that (copy token, paste into env var, restart bridge) the agent can do |
| Pre-stage credentials | If the workflow re-triggers an OAuth flow every run, swap to long-lived tokens / personal access tokens / API key auth so the agent never needs to click the consent button |
| Take screenshot, ask user, wait | The agent can present the screenshot, identify the exact pixel coordinates of the button, and ask the user to click it. Slower but unblocks the agent loop |
If the question is "can I detect ahead of time that a click will fail?" — sometimes. Watch for these patterns and treat them as user-action-required:
// In chrome_javascript pre-flight before chrome_click_element:
const el = document.querySelector(selector);
const insideOAuth = !!el?.closest('form[action*="oauth"], form[action*="auth"]');
const isFileInput = el?.type === 'file' || el?.closest('label')?.querySelector('input[type=file]');
const isPasswordContext = !!document.querySelector('input[type=password]:not([disabled])');
if (insideOAuth || isFileInput || isPasswordContext) {
// ask user instead of trying chrome_click_element
}
This is a heuristic, not a contract. The real signal you'll see is success: true + no behavior change.
Gotcha 8 — CDP redaction when a password input is in the DOM
Symptom
chrome_javascript calls suddenly return "Cannot access a chrome-extension:// URL of different extension" for every JS call on a specific tab. The error makes no sense — you're not calling chrome-extension URLs. Other tabs work fine. Refreshing fixes it briefly.
Root cause
Chrome's CDP Runtime.evaluate (which backs chrome_javascript) refuses to run when an <input type="password"> element is present in the page DOM and that page is in a sensitive context (top-level navigation to a login form, an admin panel, etc.). The error message is misleading — it's not actually about chrome-extension URLs. It's Chrome's blanket "do not allow programmatic JS execution while credentials might be on screen" policy.
This often surfaces on Meta Business Suite admin pages, Google Cloud Console, AWS Console, Stripe Dashboard — any place that gates parts of the UI behind a "confirm your password" re-auth interstitial.
Workaround
You can't run JS until the password field leaves the DOM. Options in priority order:
chrome_screenshotinstead ofchrome_javascript— image pixels bypass the CDP block. The agent can read the screenshot (visually) and decide the next move. Caveat: secret values rendered on screen sit in your transcript image; treat the transcript as sensitive.chrome_read_pagefor text — sometimes works whilechrome_javascriptis blocked because the underlying CDP method is different.Navigate away first —
chrome_navigateto a neutral URL, do the JS, then navigate back. Loses the page state.Wait out the re-auth interstitial — Meta / Google's "confirm your password" overlay clears once the user re-authenticates. After that, JS execution resumes.
There's also a related lesser-known mode: input values matching token-shaped patterns (e.g. EAA... for Meta access tokens, long alphanumeric sequences) get masked in chrome_javascript return values even when password fields aren't in the DOM. chrome_screenshot bypasses this too — same caveat about secret-in-transcript.
Gotcha 9 — chrome_keyboard text input has surprising parser limits · use insertText instead
Symptom
You want the agent to type ads_management into a text field. chrome_keyboard keys="ads_management" returns "Invalid key string or combination". Single-character calls work (keys="a" followed by keys="d" ...). React-controlled inputs ignore the keystrokes even when they do go through.
Root cause
chrome_keyboard parses its keys argument as a chord notation (e.g. Ctrl+Shift+P), not as raw text. The _ character is treated as a separator. Many other characters (+, @, :, /) similarly confuse the parser. And for React / Vue / framework-controlled inputs, even successful keystrokes can be silently overwritten by the framework's controlled-value re-render.
Workaround · document.execCommand('insertText')
For any arbitrary text input — paste-like behavior that also triggers React's onChange synthesizer correctly:
// In chrome_javascript:
const el = document.querySelector('input[name="permission"]'); // or any input/textarea
el.focus();
document.execCommand('insertText', false, 'ads_management');
This works because:
insertTextis a real Chrome edit command — producesinputevents that frameworks respect- It accepts arbitrary strings including underscores, punctuation, multi-line content
- React's
onChangefires correctly — the controlled-value gets the new text
For chord shortcuts (Ctrl+S, Cmd+Shift+P), keep using chrome_keyboard — that's what it's designed for. For typing text, prefer insertText.
Cost-aware usage · token efficiency hierarchy
Once chrome-mcp is working, the bigger optimization is how much each tool call costs your model context. Empirically (verified across multi-hour AI-driven browser sessions in 2026-05):
| Tool | Approximate context cost | When to prefer |
|---|---|---|
chrome_javascript |
~50-200 tokens / call | reading values · checking element state · pre-flight checks |
chrome_read_page |
~100-500 tokens / call (depends on page size) | extracting text content · article body · table data |
chrome_get_web_content |
~200-800 tokens / call | structured extraction · returns DOM tree summary |
chrome_click_element |
~30 tokens / call | interaction · cheap |
chrome_fill_or_select |
~50 tokens / call | form input · cheap |
chrome_network_capture |
~200-1500 tokens (depends on request count) | debugging API calls · inspecting XHR/fetch |
chrome_screenshot |
~1500-3000 tokens / image | visual verification · pixel-level checks · CDP-redacted page (Gotcha 8) |
The big one is chrome_screenshot. A single screenshot is roughly 10-30× the cost of a chrome_javascript call. Across a 30-screenshot session, that's ~75K tokens that could have been a few hundred via chrome_javascript + chrome_read_page instead.
Rule of thumb: JS-first. Use chrome_screenshot only when:
- You genuinely need to verify a pixel-level visual (a modal rendered correctly · a chart drew · a color change)
chrome_javascriptis blocked (Gotcha 8 — password input in DOM)- You need to confirm the green checkmark / red error banner that the JS state doesn't expose
For "check that the form value was set" → chrome_javascript returns document.querySelector('input').value. For "check that the form was submitted" → chrome_javascript checks for the success URL change or a confirmation element. Reserve screenshots for the cases where the visual is the source of truth.
Appendix · Upstream contributions
If you want the diagnostic walkthrough rather than the answers, the issue + PR thread tells the full story:
- Issue #345 — initial report with source-level analysis (the singleton-and-replaced-transport hypothesis)
- PR #346 — 14 LoC fix + unit tests proving identity (factory returns distinct instances) and behavior (two transports route correctly)
- Issue #347 — follow-up feature request for profile-aware multi-profile support
The PR description includes a verification comment showing two real MCP clients (one Claude Code session, one direct HTTP POST simulating a second client) operating concurrently against a single bridge with no orphaning. Reproducible if you check out the branch and install with the steps in Gotcha #5.
Sponsors
This guide is free and the patches above are upstream-PR'd. If it saved you the half-day I spent debugging, consider:
- ⭐ Star this repo so others find it (GitHub search ranks by stars)
- ⭐ Star hangwin/mcp-chrome — the actual project doing the heavy lifting
- 💛 GitHub Sponsors — sustains weekend OSS work like this
If you hit a Windows install pain not in this guide, open an issue — I'd rather add a Gotcha 10 than have you debug alone.
License
MIT — see LICENSE. Use anything here however you want.
The scripts in scripts/ are also MIT and have no external dependencies beyond what hangwin/mcp-chrome itself requires (Node 22+, PowerShell 7+ recommended, Chrome 136+).
from github.com/MankhongGarden/chrome-mcp-windows-survival-guide
Установка Chrome Mcp Windows Survival Guide
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/MankhongGarden/chrome-mcp-windows-survival-guideFAQ
Chrome Mcp Windows Survival Guide MCP бесплатный?
Да, Chrome Mcp Windows Survival Guide MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Chrome Mcp Windows Survival Guide?
Нет, Chrome Mcp Windows Survival Guide работает без API-ключей и переменных окружения.
Chrome Mcp Windows Survival Guide — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить Chrome Mcp Windows Survival Guide в Claude Desktop, Claude Code или Cursor?
Открой Chrome Mcp Windows Survival Guide на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
GitHub
PRs, issues, code search, CI status
автор: GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
автор: mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
автор: GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
автор: UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
автор: duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
автор: blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
автор: Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
автор: runapi-aiCompare Chrome Mcp Windows Survival Guide with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории development
