---
title: "Chrome MCP troubleshooting: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/trailofbits-chrome-mcp-troubleshooting/
description: "Pins the macOS Chrome skill that refuses to leave both Claude native hosts active and says a fix does not apply until Chrome and Claude Code restart."
---

# Chrome MCP troubleshooting: review, setup & limitations · Undominated.ai

> Pins the macOS Chrome skill that refuses to leave both Claude native hosts active and says a fix does not apply until Chrome and Claude Code restart.

[← Explore all skills](/skills/)

BROWSER EXTENSION CONNECTIVITY / Trail of Bits

# Chrome MCP troubleshooting

Pins the macOS Chrome skill that refuses to leave both Claude native hosts active and says a fix does not apply until Chrome and Claude Code restart.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/trailofbits/skills/tree/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/chrome-mcp-troubleshooting/skills/chrome-mcp-troubleshooting)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 4 linked sources
 Publisher Trail of Bits
 Licence [CC-BY-SA-4.0 ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE)
 Revision 8e54050ae63c
 [Read what was—and wasn’t—checked ↓](#review)

“Refuses to leave both Claude native hosts active, limits the steps to macOS, and says MCP connects only at startup.”

 [Trail of Bits · upstream description ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/chrome-mcp-troubleshooting/skills/chrome-mcp-troubleshooting/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - The file says the two native hosts cannot be used at the same time and tells the operator to disable the one that is not in use.
- It refuses the procedure on Linux and Windows, limits the extension to one Chrome profile and one Claude Code session, and says a fix requires restarting Chrome and Claude Code because MCP connects at startup.

### A good fit for

 - Diagnosing a macOS Claude in Chrome connection failure when both native hosts may be registered

### Weigh up before choosing

 - The resource was not executed.
- `/plugin install chrome-mcp-troubleshooting@trailofbits` installs the chrome-mcp-troubleshooting plugin. The plugin README says that plugin ships this skill. It was not run.
- `/plugin marketplace add trailofbits/skills` adds the marketplace, not this skill. It appears in the plugin README and the repository README.
- The reset and toggle steps move a native-messaging config aside, stop the host, remove sockets, and quit Chrome. The file does not show a dry-run or a confirmation prompt before those changes.
- The file says not to use it for general Chrome automation, Claude.app issues that are not about the browser, network failures, or extension-install problems.
- Paths and osascript calls are macOS-specific. This review did not check a live machine.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - plugins/chrome-mcp-troubleshooting/skills/chrome-mcp-troubleshooting/SKILL.md
- plugins/chrome-mcp-troubleshooting/README.md
- README.md
- LICENSE

### Our findings

 - The two native hosts cannot be used together; the unused native-messaging config is the one that gets disabled.
- Linux and Windows are out of scope because the paths and tools are macOS-specific.
- MCP connects at startup, so a corrected config still needs Chrome and Claude Code to be restarted.
- The extension is limited to one Chrome profile, and the file says to run only one Claude Code session at a time.
- A stale hardcoded version in the wrapper is called out as a failed diagnosis, with a dynamic lookup described as the replacement.
- The file says an unset TMPDIR makes Claude Code look in the wrong place for the socket.

### Not established by this review

 - The resource was not executed.
- No native-messaging config was moved, no process was stopped, and Chrome was not restarted.
- The steps were not checked on macOS, Linux, or Windows.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/chrome-mcp-troubleshooting/README.md)

DOCUMENTED COMMAND

 /plugin install chrome-mcp-troubleshooting@trailofbits Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - The plugin README shows `/plugin marketplace add trailofbits/skills`. That adds the marketplace, not this skill.
- The next line in that README is `/plugin install chrome-mcp-troubleshooting@trailofbits`. That installs the chrome-mcp-troubleshooting plugin, which the same README says ships this skill.
- Neither line was run.

### Before you start

 - Claude Code on macOS, because the skill refuses Linux and Windows paths
- Google Chrome with the Claude extension; this review did not open a browser

### Compatibility

Claude Code · Claude.app · Google Chrome

### Implementation

Bash

### Local skill text; the reset changes a macOS Chrome profile only if an operator runs it

 - Read the skill text
- Disable a native-messaging host, stop a process, or quit Chrome only if the operator runs those steps
- Do not leave both native hosts enabled

### Cost model

CC-BY-SA-4.0; no install or Chrome reset was run. Share-alike applies to a redistributed adaptation.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [chrome-mcp-troubleshooting SKILL.md ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/chrome-mcp-troubleshooting/skills/chrome-mcp-troubleshooting/SKILL.md) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/chrome-mcp-troubleshooting/skills/chrome-mcp-troubleshooting/SKILL.md Supports: One native host at a time, macOS-only scope, and restart because MCP connects at startup
- [chrome-mcp-troubleshooting README ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/chrome-mcp-troubleshooting/README.md) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/chrome-mcp-troubleshooting/README.md Supports: Marketplace add line, plugin install line, and the CC-BY-SA-4.0 statement
- [Repository README ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md Supports: Marketplace install line and the CC-BY-SA-4.0 statement
- [Repository LICENSE ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE Supports: Attribution-ShareAlike 4.0 International Public License

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Anthropic Claude API ↗ Routes Claude API work to language-specific SDK guidance and distinguishes self-hosted tool loops from managed agent execution.](/skills/anthropics-claude-api/)[### Build an MCP App (Interactive UI Widgets) ↗ Adds interactive UI widgets (forms, pickers, confirm dialogs, charts) to an MCP server: the tool declares a ui:// resource, the server serves the widget HTML, and the host renders it in a sandboxed iframe in the chat.](/skills/anthropic-build-mcp-app/)[### Build an MCP Server ↗ Interviews the developer about an MCP server before any code, recommends one deployment model and a tool-design pattern, then scaffolds a remote or local stdio server or hands off to the MCP app or MCPB skill.](/skills/anthropic-build-mcp-server/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
