Guia de configuração

Três partes trabalham juntas: a extensão do Chrome, um servidor no seu próprio computador e o comando wcr (CLI e servidor MCP). Tudo roda localmente.

your AI assistant / script ──▶ wcr ──HTTP──▶ local server ◀──WebSocket── Chrome extension ──▶ ChatGPT, Gemini, …
                                          127.0.0.1:8787

Acesso antecipado

O WebCodeReview ainda não pode ser instalado publicamente. A ferramenta de linha de comando wcr (pacote npm @webcodereview/cli) e a página na Chrome Web Store chegarão em breve. Quem tem acesso antecipado recebe as instruções de instalação por e-mail: entre na lista de espera. O restante desta página é referência para depois que você tiver instalado as duas partes.

1. O servidor e o `wcr`

Requer Node.js 20 ou superior. O servidor escuta apenas em 127.0.0.1:8787. Na primeira execução, ele gera um token de pareamento e o salva em ~/.config/webcodereview/token. O wcr lê o token de WCR_TOKEN ou desse arquivo e inicia o servidor em segundo plano (log: ~/.config/webcodereview/server.log) quando nada responde em WCR_PORT (padrão 8787), por exemplo em wcr status. Você também pode executá-lo em primeiro plano com wcr serve.

2. A extensão do Chrome

Instale a extensão no perfil do Chrome em que você está logado nos sites de IA que quer usar e, depois, faça login em cada um desses sites nesse mesmo perfil. Na primeira instalação, a extensão abre uma página de boas-vindas.

3. Pareie a extensão com o servidor

Execute wcr setup em um terminal. Ele inicia o servidor, se necessário, e abre o Chrome na página de pareamento da extensão. Quando não puder abrir o Chrome por você, ele diz o que fazer.
O token de pareamento chega à extensão dentro do endereço da página, depois do #, e por isso nunca é enviado pela rede. Você não precisa copiar nem colar nada.
Em seguida, o popup mostra “Conectado ao wcr neste computador”.

Se o token não for mais válido, o popup mostra “O pareamento não é mais válido”: execute wcr setup novamente. Você pode verificar a conexão com:

wcr status

Somente um navegador ou perfil pode estar conectado por vez. Se um segundo se conectar, o primeiro é desligado; o popup dele mostra “Outro navegador assumiu” e um botão “Usar este navegador”.

4. Pergunte: `wcr ask`

# one provider
wcr ask claude "Review this function for race conditions: ..."

# several providers in parallel (comma-separated), prompt from a file
wcr ask chatgpt,gemini,claude -f review.md

# prompt from stdin, per-provider timeout in seconds, raw JSON output
git diff | wcr ask chatgpt,deepseek -t 240 --json

Provedores: chatgpt, gemini, claude, deepseek e grok. O tempo limite padrão é de 180 segundos por provedor. Se um provedor falhar (sem login, desafio de verificação, tempo esgotado), os outros ainda retornam, e o código de saída é diferente de zero.

Os cinco provedores (ChatGPT, Gemini, Claude, DeepSeek e Grok) foram verificados nos sites reais em 2026-10-12. Os sites de chat mudam suas páginas com frequência, então um provedor pode parar de funcionar até a extensão ser atualizada.

5. Use-o a partir do seu assistente de código com IA (MCP)

wcr mcp é um servidor MCP stdio padrão, então qualquer cliente MCP pode executá-lo. Ferramentas:

Ferramenta	Uso
`wcr_review_submit` + `wcr_review_result`	Inicia uma revisão com vários provedores e depois consulta o resultado (cada consulta espera até 50 s). Use esta por padrão.
`wcr_ask`, `wcr_ask_many`	Versões bloqueantes, de 30 a 180 s por chamada. Apenas para clientes com tempo limite de ferramenta longo.
`wcr_automate`	Automação do navegador; `allowDomains` é obrigatório. Você precisa estar logado no WebCodeReview na extensão.
`wcr_status`	A extensão está conectada?

O que importa é o tempo limite de chamada de ferramenta do cliente, porque uma revisão com 3 provedores pode levar até cerca de 270 s. Os trabalhos de revisão ficam na memória do servidor: uma reinicialização os perde, e eles não podem ser cancelados individualmente.

A navegação automatizada exige login

A revisão de código não precisa de conta. A navegação automatizada é o único recurso que precisa. Abra o popup da extensão; na linha “Navegação automatizada” (que mostra “Disponível depois de entrar” até você entrar), clique em “Continuar com o Google” e escolha sua conta do Google na janela do próprio Chrome. Depois ative a chave “Navegação automatizada”; o Chrome pede permissão para acessar todos os sites. Você também pode iniciar o login pelo chip “Entrar” no cabeçalho do popup. Se o login com um clique não funcionar, use “Entrar pelo site” e aprove o navegador em webcodereview.com/device. Desativar a chave interrompe a automação, mas não retira essa permissão; para revogá-la por completo, abra chrome://extensions, escolha WebCodeReview e altere Acesso ao site.

Claude Code (testado)

claude mcp add wcr -- wcr mcp
# add --scope user to make it available in every project

Testado de ponta a ponta com uma chamada de ferramenta real. Uma chamada de ferramenta de 330 s retornou normalmente (medido no Claude Code v2.1.222).

Codex (ainda não verificado)

codex mcp add wcr -- wcr mcp

ou em ~/.codex/config.toml:

[mcp_servers.wcr]
command = "wcr"
args = ["mcp"]
tool_timeout_sec = 120   # optional: the 60 s default is enough for wcr_review_result (waits <= 50 s)

Apenas a configuração foi lida de volta; uma chamada de ferramenta pelo Codex não foi testada. O tempo limite padrão de 60 s vem da documentação dele e não foi medido. Use wcr_review_submit e wcr_review_result para revisões com vários provedores.

Cursor (ainda não verificado)

Adicione a ~/.cursor/mcp.json (ou .cursor/mcp.json em um projeto):

{ "mcpServers": { "wcr": { "command": "wcr", "args": ["mcp"] } } }

Completamente não testado. Relatos em fóruns dizem que o Cursor interrompe as chamadas em cerca de 60 s e que isso não é configurável; isso não foi medido. Use wcr_review_submit e wcr_review_result para revisões com vários provedores.

Diga ao seu agente quando usá-lo

As revisões levam de 30 a 180 s e usam suas contas de chat, então peça ao seu agente que as use em mudanças de alto impacto ou sensíveis do ponto de vista de segurança, e não a cada edição. Coloque todo o material no prompt, nunca segredos, e trate as respostas como opiniões independentes a conferir, não como achados verificados. Se um resultado disser que o prompt pode já ter sido enviado, não reenvie sem perguntar. O repositório do servidor traz um texto pronto para o seu CLAUDE.md, AGENTS.md ou regra do Cursor: agent-guide.md.

Notas de segurança

O servidor escuta apenas no loopback e exige o token de pareamento em toda chamada.
Ele rejeita requisições que levam um cabeçalho Origin de navegador, POSTs que não sejam JSON e cabeçalhos Host inesperados, de modo que uma página web que você visite não consegue controlá-lo.
A navegação automatizada exige uma lista explícita de domínios permitidos e uma permissão extra que você concede no popup da extensão.
Veja a política de privacidade para saber o que a extensão faz com os dados.