claude-in-chrome-troubleshooting

Diagnose and fix Claude MCP Chrome extension connectivity issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix Claude in Chrome MCP extension connectivity issues. Use when mcp__claude-in-chrome__* tools fail, return "Browser extension is not connected", or behave erratically.

Core Features & Use Cases

  • Diagnose native host conflicts between Claude.app and Claude Code, identify active sockets and configs.
  • Provide a toggle script to switch MCP backends and a guided reset procedure.
  • Support quick diagnosis and full reset steps to ensure reliable startup of Chrome extension and MCP bridge.

Quick Start

Use the chrome-mcp-toggle function to switch between Claude.app and Claude Code, then restart Chrome and Claude Code.

Frequently Asked Questions about claude-in-chrome-troubleshooting

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

FAQPage Schema
How do I fix the Claude MCP Chrome extension when it says 'Browser extension is not connected'?

To fix the 'Browser extension is not connected' error, use the toggle-based remediation workflow to switch MCP backends between Claude.app and Claude Code, then restart Chrome and Claude Code to ensure native-host alignment and startup synchronization of the MCP bridge.

Why does Claude in Chrome misbehave during Chrome automation tasks?

Claude in Chrome misbehaves during automation when native host conflicts exist between Claude.app and Claude Code. Diagnosing active sockets and applying the guided reset procedure ensures reliable startup of the Chrome extension and MCP bridge.

How do I switch the MCP backend between Claude Code CLI and Claude.app?

To switch the MCP backend between Claude Code CLI and Claude.app, execute the chrome-mcp-toggle function to identify active configs, then restart both Chrome and Claude Code to synchronize the native-host bridge.

How does the native-host connection work for the Claude MCP Chrome extension?

The native-host connection works by maintaining a synchronized MCP bridge between the Chrome extension and either Claude Code or Claude.app, requiring proper socket alignment and startup synchronization to avoid erratic behavior or connection failures.

What should I do if mcp__claude-in-chrome__* tools fail or return errors?

When mcp__claude-in-chrome__* tools fail, run a full diagnostic to identify native host conflicts and active sockets, then apply the guided reset steps to restore reliable Chrome extension and MCP bridge connectivity.

Can I use the Claude MCP Chrome extension with both Claude Code and Claude.app simultaneously?

Using the Claude MCP Chrome extension with both simultaneously causes native host conflicts. Use the toggle script to switch between Claude Code and Claude.app backends, ensuring only one active config runs to maintain a stable MCP bridge.