chrome-mcp-troubleshooting

Diagnose and resolve Claude Chrome MCP extension connectivity conflicts.

6.5k|561|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/trailofbits/skills --skill chrome-mcp-troubleshooting-trailofbits
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chrome-mcp-troubleshooting
Source: https://github.com/trailofbits/skills/tree/main/plugins/claude-in-chrome-troubleshooting/skills/chrome-mcp-troubleshooting
Command: npx skills add https://github.com/trailofbits/skills --skill chrome-mcp-troubleshooting-trailofbits

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps diagnose and fix connectivity issues with the Claude in Chrome MCP extension, ensuring seamless integration and functionality.

Core Features & Use Cases

  • Connectivity Diagnostics: Identifies and resolves issues causing the "Browser extension is not connected" error.
  • Native Host Conflict Resolution: Provides steps to resolve conflicts between Claude.app and Claude Code CLI native hosts.
  • Quick Diagnosis: Offers a series of commands to quickly identify the root cause of connectivity issues.
  • Full Reset Procedure: A step-by-step guide to perform a full reset of the extension configuration for Claude Code CLI.

Quick Start

Run the chrome-mcp-toggle command to switch between Claude.app and Claude Code CLI, then restart Chrome.

Frequently Asked Questions about chrome-mcp-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix the Chrome MCP extension "Browser extension is not connected" error with Claude?

To fix the Chrome MCP extension connectivity error, run the `chrome-mcp-toggle` command to resolve native host conflicts between Claude.app and Claude Code CLI, then restart Chrome to re-establish the connection.

Why does the Claude in Chrome MCP extension lose connectivity when switching between Claude.app and Claude Code CLI?

The Chrome MCP extension loses connectivity due to native host conflicts when both Claude.app and Claude Code CLI native messaging configurations are active simultaneously, requiring you to disable the conflicting host and restart the applications.

How do I perform a full reset of the Claude in Chrome MCP extension configuration for Claude Code CLI?

Performing a full reset of the Claude Code CLI configuration involves following a step-by-step procedure to clear conflicting native messaging configurations and restart the extension to restore seamless integration.

Does the Claude in Chrome MCP extension work with both Claude Code CLI and Claude.app at the same time?

The Claude in Chrome MCP extension cannot maintain simultaneous connections to both Claude Code CLI and Claude.app due to native host conflicts, requiring users to toggle between configurations using the `chrome-mcp-toggle` command.

What steps are needed to diagnose native host conflicts with the Chrome MCP extension?

Diagnosing native host conflicts with the Chrome MCP extension requires running a series of quick diagnostic commands to identify whether Claude.app or Claude Code CLI is causing the connectivity disruption.