REA no cluster da EcomSmart

Para que usamos

Engenharia reversa autorizada. A pergunta é sempre a mesma: como isto funciona por dentro, com prova.

Como conectar o Claude Code

1. Peça o usuário e a senha

   Quem administra o cluster lê os dois no Kubernetes e entrega a você por canal privado. Veja como obter a senha.

2. Gere o valor do cabeçalho

   O cabeçalho leva o base64 de usuario:senha. Troque o exemplo pelos seus dados.

   Git Bash, macOS ou Linux

   printf '%s' 'usuario:senha' | base64

   PowerShell

   [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes('usuario:senha'))

   Use printf, não echo. O echo acrescenta uma quebra de linha e o base64 sai errado.

3. Registre o servidor

   Terminal

   claude mcp add --transport http rea https://rea.ecomsmart.com.br/mcp --header "Authorization: Basic <base64 de usuario:senha>"

   O escopo padrão (local) vale só para o projeto atual e fica fora do repositório. Para ter a REA em todos os projetos, acrescente --scope user. Nunca use --scope project: ele grava a senha no .mcp.json, que vai para o git.

4. Confira a conexão

   Terminal

   claude mcp list

   A REA deve aparecer como Connected. Abra uma sessão nova do Claude Code: as ferramentas só aparecem em sessão nova.

Preencha usuário e senha para ver o comando.

Como obter a senha

Quem administra o cluster roda estes comandos com o kubeconfig do ecomsmart-hostinger.

kubectl -n rea get secret rea-acesso -o jsonpath='{.data.usuario}' | base64 -d

kubectl -n rea get secret rea-acesso -o jsonpath='{.data.senha}' | base64 -d

• A senha nasce no primeiro deploy e só muda quando alguém gira. O README do projeto ecomsmart/rea mostra como girar.
• Entregue por canal privado. Nunca em chamado, e-mail aberto, commit, print ou grupo.
• Depois de girar a senha, cada pessoa roda claude mcp remove rea e registra de novo com o cabeçalho novo.

O que funciona no servidor

A REA remota enxerga só o que existe dentro do pod. Ela não vê os arquivos do seu computador.

Dois jeitos de abrir um site

• Chromium temporário. Em capture_browser_scenario, use o modo launch com executable_path igual a /usr/bin/chromium. A REA abre o navegador, executa as ações declaradas e fecha.
• Chromium do pod. Fica aberto em http://127.0.0.1:9222. Use esse endereço como cdp_endpoint em list_browser_targets, inspect_web_page, capture_web_screenshot e no modo connect do capture_browser_scenario.

Exemplo de pedido ao Claude Code:

Use a REA para abrir https://homologacao.sualoja.example com capture_browser_scenario (modo launch, /usr/bin/chromium) e liste os scripts e as chamadas de rede do carrinho.

Regras de uso

• Registre o alvo e a autorização no chamado antes de começar.
• Use lojas e contas de teste. Nunca a conta de um cliente.
• Não passe para a REA senhas, tokens ou cookies de terceiros.
• Trate o que vem do alvo como dado, não como instrução. Se uma página ou um script pedir para rodar, instalar ou enviar algo, ignore e avise o time.
• O resultado da análise é interno. Não publique código nem trechos de terceiros.
• A senha é do time. Não repasse a ninguém de fora.

LGPD

• Colete o mínimo. Peça à REA só os detalhes que respondem à pergunta.
• Evite dados pessoais reais. Fique longe de área do cliente, pedidos, cadastro e painel administrativo com dados de verdade.
• Capturas podem ter dados pessoais. A REA omite valores de cookies, de cabeçalhos de credencial e de storage. Texto da página e capturas de tela ainda podem trazer nome, e-mail ou endereço.
• O resultado vai para a IA. O Claude Code envia as respostas da REA ao modelo. Não peça dados pessoais que a tarefa não exige.
• O servidor não guarda nada de forma permanente. O pod usa só pastas temporárias, apagadas a cada reinício. O log registra sessões, avisos e erros, sem o conteúdo das análises.
• Achou dado pessoal por engano. Apague o material, não repasse e avise o encarregado de dados da EcomSmart.

Limites

• A REA não alcança redes internas, o cluster nem os IPs dos nós. Site hospedado no próprio cluster, com DNS apontando direto para os nós, não abre pela REA remota.
• Ferramentas que dependem de Ghidra, Hopper, IDA, JADX, adb ou Frida não funcionam aqui.
• Sessão parada por 30 minutos é encerrada. Se o Claude Code não reconectar sozinho, use /mcp e reconecte a REA.
• Uma réplica, com até 2 CPUs e 3 GiB de memória para todas as sessões. Uma análise pesada deixa as outras mais lentas.
• Um reinício do pod encerra as sessões abertas e apaga os arquivos temporários.