Solução de Problemas do Claude no Chrome MCP

Use esta habilidade quando as ferramentas do Claude no Chrome MCP falharem ao conectar ou funcionarem de forma não confiável.

Quando Usar

• As ferramentas mcp__claude-in-chrome__* falham com "A extensão do navegador não está conectada"
• A automação do navegador funciona erraticamente ou expira
• Após atualizar o Claude Code ou o Claude.app
• Ao alternar entre o Claude Code CLI e o Claude.app (Cowork)
• O processo nativo do host está em execução, mas as ferramentas do MCP ainda falham

Quando NÃO Usar

• Usuários de Linux ou Windows - Esta habilidade cobre caminhos e ferramentas específicos do macOS (~/Library/Application Support/, osascript)
• Problemas gerais de automação do Chrome não relacionados à extensão do Claude
• Problemas do aplicativo de desktop Claude.app (não relacionados ao navegador)
• Problemas de conectividade de rede
• Problemas de instalação da extensão do Chrome (use o suporte da Chrome Web Store)

O Conflito Claude.app vs Claude Code (Problema Principal)

Contexto: Quando o Claude.app adicionou suporte ao Cowork (automação do navegador a partir do aplicativo de desktop), ele introduziu um host de mensagens nativo concorrente que entra em conflito com o Claude Code CLI.

Dois Hosts Nativos, Dois Formatos de Socket

Por Que Eles Entram em Conflito

1. Ambos registram configurações de mensagens nativas no Chrome:

   • com.anthropic.claude_browser_extension.json → Helper do Claude.app
   • com.anthropic.claude_code_browser_extension.json → Wrapper do Claude Code

2. A extensão do Chrome solicita um host nativo pelo nome

3. Se a configuração errada estiver ativa, o binário errado é executado

4. O binário errado cria sockets em um formato/localização que o cliente MCP não espera

5. Resultado: "A extensão do navegador não está conectada", mesmo que tudo pareça estar em execução

A Correção: Desativar o Host Nativo do Claude.app

Se você usa o Claude Code CLI para automação do navegador (não Cowork):

# Disable the Claude.app native messaging config
mv ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_browser_extension.json \
   ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_browser_extension.json.disabled

# Ensure the Claude Code config exists and points to the wrapper
cat ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json

Se você usa o Cowork (Claude.app) para automação do navegador:

# Disable the Claude Code native messaging config
mv ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json \
   ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json.disabled

Você não pode usar ambos simultaneamente. Escolha um e desative o outro.

Script de Alternância

Adicione isso a ~/.zshrc ou execute diretamente:

chrome-mcp-toggle() {
    local CONFIG_DIR=~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts
    local CLAUDE_APP="$CONFIG_DIR/com.anthropic.claude_browser_extension.json"
    local CLAUDE_CODE="$CONFIG_DIR/com.anthropic.claude_code_browser_extension.json"

    if [[ -f "$CLAUDE_APP" && ! -f "$CLAUDE_APP.disabled" ]]; then
        # Currently using Claude.app, switch to Claude Code
        mv "$CLAUDE_APP" "$CLAUDE_APP.disabled"
        [[ -f "$CLAUDE_CODE.disabled" ]] && mv "$CLAUDE_CODE.disabled" "$CLAUDE_CODE"
        echo "Switched to Claude Code CLI"
        echo "Restart Chrome and Claude Code to apply"
    elif [[ -f "$CLAUDE_CODE" && ! -f "$CLAUDE_CODE.disabled" ]]; then
        # Currently using Claude Code, switch to Claude.app
        mv "$CLAUDE_CODE" "$CLAUDE_CODE.disabled"
        [[ -f "$CLAUDE_APP.disabled" ]] && mv "$CLAUDE_APP.disabled" "$CLAUDE_APP"
        echo "Switched to Claude.app (Cowork)"
        echo "Restart Chrome to apply"
    else
        echo "Current state unclear. Check configs:"
        ls -la "$CONFIG_DIR"/com.anthropic*.json* 2>/dev/null
    fi
}

Uso: chrome-mcp-toggle e, em seguida, reinicie o Chrome (e o Claude Code se estiver alternando para o CLI).

Diagnóstico Rápido

# 1. Qual binário de host nativo está em execução?
ps aux | grep chrome-native-host | grep -v grep

…