Montar um laboratório que você pode jogar fora

# A tentativa que quase todo material antigo ensina: abrir a porta de
# depuração remota no Chrome de uso diário, que já está logado em tudo.

# Windows (PowerShell)
& "C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222

# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

# Linux
google-chrome --remote-debugging-port=9222

# Conferência: se a porta tivesse subido, este endpoint responderia um JSON
# com a versão do navegador e o endereço do WebSocket de depuração.
curl http://127.0.0.1:9222/json/version

# Do Chrome 136 em diante, apontando para o perfil padrão, isso não responde.

# Conferência rápida do ambiente antes de instalar o servidor.
node --version   # precisa ser a LTS mais recente
npm --version

# Versão do Chrome instalado (macOS e Linux)
google-chrome --version

# Windows (PowerShell): lê a versão do executável sem abrir o navegador
(Get-Item "C:\Program Files\Google\Chrome\Application\chrome.exe").VersionInfo.ProductVersion

# Caminho 1: plugin (o que a documentação oficial descreve para o Claude Code).
# Rode os dois comandos DENTRO da sessão do Claude Code.
/plugin marketplace add ChromeDevTools/chrome-devtools-mcp
/plugin install chrome-devtools-mcp@chrome-devtools-plugins

# Caminho 2: registrar o servidor MCP pelo CLI, no escopo do usuário.
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest

// Configuração canônica para qualquer cliente que aceite "mcpServers".
// O "--isolated" é o que torna esta sessão descartável: o servidor cria um
// diretório de dados temporário e o joga fora quando o navegador fecha.
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--isolated"
      ]
    }
  }
}

# Perfil de auditoria: diretório próprio, fora do padrão do Chrome.
# Crie uma vez, logue à mão uma vez, e não use para mais nada.

# macOS e Linux
mkdir -p ~/lab-chrome-auditoria
google-chrome \
  --user-data-dir="$HOME/lab-chrome-auditoria" \
  --remote-debugging-port=9222

# Windows (PowerShell)
New-Item -ItemType Directory -Force "$HOME\lab-chrome-auditoria" | Out-Null
& "C:\Program Files\Google\Chrome\Application\chrome.exe" `
  --user-data-dir="$HOME\lab-chrome-auditoria" `
  --remote-debugging-port=9222

# Agora a porta responde, porque o alvo não é o diretório de dados padrão.
curl http://127.0.0.1:9222/json/version

// Conectar o servidor ao Chrome de auditoria que você acabou de subir.
// Repare: aqui NÃO existe "--isolated". Você está entregando ao agente uma
// sessão real, e essa troca precisa ser uma decisão anotada no runbook.
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--browserUrl",
        "http://127.0.0.1:9222"
      ]
    }
  }
}

// Laboratório com as duas saídas de dados desligadas por decisão explícita.
// As flags cobrem a sessão; as variáveis de ambiente cobrem também a checagem
// automática de atualização, útil em máquina sem saída livre para a internet.
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--isolated",
        "--no-usage-statistics",
        "--no-performance-crux"
      ],
      "env": {
        "CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS": "1",
        "CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS": "1"
      }
    }
  }
}

# Runbook do laboratório de browser

Última revisão: 2026-07-19 · Responsável: <seu nome>

## Perfil de auditoria (persistente)
- Diretório de dados: `~/lab-chrome-auditoria`
- Canal do Chrome: estável
- Modo do servidor: `--browserUrl http://127.0.0.1:9222`
- Logado aqui: apenas `qa-lab@exemplo.com` (conta de teste, sem permissão de escrita em produção)

## Perfil descartável
- Modo do servidor: `--isolated`
- Estado: nasce vazio, é descartado ao fechar o navegador
- Uso: navegação em site desconhecido e qualquer exercício deste curso

## Jamais logar em nenhum dos dois
- E-mail pessoal
- Banco e qualquer serviço financeiro
- Gestor de senhas
- Painel administrativo de produção

## Saídas de dados
- Estatísticas de uso: DESLIGADAS (`--no-usage-statistics`)
- Envio de URL de trace para a base pública de performance: DESLIGADO (`--no-performance-crux`)

## Como derrubar tudo
1. Fechar a janela do Chrome de laboratório (o perfil isolado some sozinho).
2. Conferir que a porta 9222 não responde mais.
3. Se precisar zerar o perfil persistente, apagar o diretório de dados inteiro e logar de novo à mão.