Niccolounmolested73/chrome-mcp-windows-survival-guide

O que chrome-mcp-windows-survival-guide faz?

Corrige erros comuns ao executar o servidor chrome-mcp no Windows 11 para conectar seu navegador Chrome ativo e cookies ao Claude Code e outros clientes MCP.

Pré-requisitos

• Node.js versão 18 ou superior
• Google Chrome ou Chromium (recomenda-se o Chrome Canary para estabilidade)
• Windows 11 (embora funcione parcialmente no Windows 10)

Instalação

npm install -g @anthropic-ai/chrome-mcp

Configuração

1. Defina a variável de ambiente CHROME_PATH apontando para o executável do Chrome:

$env:CHROME_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"

2. (Opcional) Defina o diretório de dados do usuário para preservar cookies e sessões:

$env:CHROME_USER_DATA_DIR="$env:LOCALAPPDATA\Google\Chrome\User Data"

Erros comuns e soluções

1. "socket hang up" ou "Connection refused"

Causa: O Chrome não está sendo iniciado corretamente no modo depuração remota.

Solução:

• Feche todas as instâncias do Chrome.
• Execute o Chrome manualmente com a flag de depuração:

& "C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222

• Verifique se a porta 9222 está escutando:

netstat -ano | findstr :9222

2. "Failed to connect to Chrome"

Causa: O chrome-mcp não está conseguindo encontrar o endpoint WebSocket do Chrome.

Solução:

• Confirme se a variável CHROME_WS_URL não está definida incorretamente.
• Use o endpoint correto:

CHROME_WS_URL=ws://127.0.0.1:9222/devtools/browser/<id_do_navegador>

• Descubra o ID do navegador acessando http://127.0.0.1:9222/json/version no navegador.

3. "Chrome process exited unexpectedly"

Causa: Conflito entre instâncias do Chrome ou falta de permissão.

Solução:

• Mate todos os processos do Chrome:

Get-Process chrome | Stop-Process -Force

• Inicie o Chrome Canary (mais estável para automação):

& "$env:LOCALAPPDATA\Google\Chrome SxS\Application\chrome.exe" --remote-debugging-port=9222

4. Cookies não estão sendo compartilhados

Causa: Diretório de dados do usuário incorreto ou permissões insuficientes.

Solução:

• Defina CHROME_USER_DATA_DIR explicitamente.
• Execute o terminal como administrador.

Uso com o Claude Code

Adicione ao seu arquivo claude_desktop_config.json:

{
  "mcpServers": {
    "chrome": {
      "command": "node",
      "args": ["-e", "require('@anthropic-ai/chrome-mcp')"],
      "env": {
        "CHROME_PATH": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
        "CHROME_USER_DATA_DIR": "%LOCALAPPDATA%\\Google\\Chrome\\User Data",
        "CHROME_WS_URL": "ws://127.0.0.1:9222/devtools/browser/<id_do_navegador>"
      }
    }
  }
}

Depuração avançada

Ative logs detalhados:

$env:DEBUG="chrome-mcp:*"
npx @anthropic-ai/chrome-mcp

Notas finais

• Sempre use a versão mais recente do Node.js e do Chrome.
• Se o Chrome Canary resolver seus problemas, considere mantê-lo como padrão.
• Para feedback, abra uma issue no repositório original: https://github.com/anthropics/chrome-mcp