domains / families / agent-tooling / chrome-mcp-troubleshooting

chrome-mcp-troubleshooting

separate

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.

When to use

• `mcp__claude-in-chrome__*` tools fail with "Browser extension is not connected"
• Browser automation works erratically or times out
• After updating Claude Code or Claude.app
• When switching between Claude Code CLI and Claude.app (Cowork)
• Native host process is running but MCP tools still fail

When not to use

• **Linux or Windows users** - This skill covers macOS-specific paths and tools (`~/Library/Application Support/`, `osascript`)
• General Chrome automation issues unrelated to the Claude extension
• Claude.app desktop issues (not browser-related)
• Network connectivity problems
• Chrome extension installation issues (use Chrome Web Store support)

Skill page

Source