Guía de instalación

Tres partes funcionan juntas: la extensión de Chrome, un servidor en tu propio equipo y el comando wcr (CLI y servidor MCP). Todo se ejecuta en local.

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

Acceso anticipado

WebCodeReview todavía no se puede instalar públicamente. La herramienta de línea de comandos wcr (paquete npm @webcodereview/cli) y la ficha de Chrome Web Store llegarán pronto. Los usuarios de acceso anticipado reciben las instrucciones de instalación por correo: únete a la lista de espera. El resto de esta página sirve como referencia para cuando hayas instalado ambas partes.

1. El servidor y `wcr`

Requiere Node.js 20 o posterior. El servidor escucha solo en 127.0.0.1:8787. En la primera ejecución genera un token de emparejamiento y lo guarda en ~/.config/webcodereview/token. wcr lee el token de WCR_TOKEN o de ese archivo, e inicia el servidor en segundo plano (registro: ~/.config/webcodereview/server.log) cuando nada responde en WCR_PORT (por defecto 8787), por ejemplo con wcr status. También puedes ejecutarlo en primer plano con wcr serve.

2. La extensión de Chrome

Instala la extensión en el perfil de Chrome en el que tienes sesión iniciada en los sitios de IA que quieres usar y luego inicia sesión en cada uno de esos sitios en ese mismo perfil. En la primera instalación, la extensión abre una página de bienvenida.

3. Empareja la extensión con el servidor

Ejecuta wcr setup en una terminal. Inicia el servidor si hace falta y abre Chrome en la página de emparejamiento de la extensión. Si no puede abrir Chrome por ti, te indica qué hacer.
El token de emparejamiento llega a la extensión dentro de la dirección de la página, después de #, así que nunca se envía por la red. No tienes que copiar ni pegar nada.
Entonces la ventana emergente muestra «Conectado a wcr en este equipo».

Si el token ya no es válido, la ventana emergente muestra «El emparejamiento ya no es válido»: ejecuta wcr setup de nuevo. Puedes comprobar la conexión con:

wcr status

Solo puede estar conectado un navegador o perfil a la vez. Si se conecta un segundo, el primero se desactiva; su ventana emergente muestra «Otro navegador tomó el control» y un botón «Usar este navegador».

4. Pregunta: `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

Proveedores: chatgpt, gemini, claude, deepseek y grok. El tiempo de espera predeterminado es de 180 segundos por proveedor. Si un proveedor falla (sin sesión iniciada, desafío de verificación, tiempo de espera agotado), los demás igualmente devuelven su respuesta y el código de salida es distinto de cero.

Los cinco proveedores (ChatGPT, Gemini, Claude, DeepSeek y Grok) se verificaron en los sitios reales el 2026-10-12. Los sitios de chat cambian sus páginas con frecuencia, así que un proveedor puede dejar de funcionar hasta que se actualice la extensión.

5. Úsalo desde tu asistente de programación con IA (MCP)

wcr mcp es un servidor MCP estándar por stdio, así que cualquier cliente MCP puede ejecutarlo. Herramientas:

Herramienta	Uso
`wcr_review_submit` + `wcr_review_result`	Inicia una revisión con varios proveedores y luego consulta el resultado (cada consulta espera hasta 50 s). Úsala por defecto.
`wcr_ask`, `wcr_ask_many`	Versiones bloqueantes, de 30 a 180 s por llamada. Solo para clientes con un tiempo de espera de herramienta largo.
`wcr_automate`	Automatización del navegador; `allowDomains` es obligatorio. Debe haber iniciado sesión en WebCodeReview en la extensión.
`wcr_status`	¿Está conectada la extensión?

Lo que importa es el tiempo de espera por llamada de herramienta del cliente, porque una revisión con 3 proveedores puede tardar hasta unos 270 s. Los trabajos de revisión viven en la memoria del servidor: un reinicio los pierde y no se pueden cancelar de forma individual.

La navegación automatizada requiere iniciar sesión

Revisar código no requiere una cuenta. La navegación automatizada es la única función que sí la requiere. Abre la ventana emergente de la extensión; en la fila «Navegación automatizada» (indica «Disponible tras iniciar sesión» hasta que inicies sesión) haz clic en «Continuar con Google» y elige tu cuenta de Google en la propia ventana de Chrome. Después activa el interruptor «Navegación automatizada»; Chrome te pide permiso para acceder a todos los sitios web. También puedes iniciar sesión desde el chip «Iniciar sesión» del encabezado de la ventana emergente. Si el inicio de sesión con un clic no funciona, usa «Iniciar sesión en el sitio web» y aprueba el navegador en webcodereview.com/device. Desactivar el interruptor detiene la automatización, pero no retira ese permiso; para revocarlo por completo, abre chrome://extensions, elige WebCodeReview y cambia «Acceso al sitio».

Claude Code (probado)

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

Probado de extremo a extremo con una llamada de herramienta real. Una llamada de herramienta de 330 s se completó con normalidad (medido en Claude Code v2.1.222).

Codex (aún no verificado)

codex mcp add wcr -- wcr mcp

o en ~/.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)

Solo se volvió a leer la configuración; no se ha probado una llamada de herramienta a través de Codex. El tiempo de espera predeterminado de 60 s procede de su documentación y no se ha medido. Usa wcr_review_submit y wcr_review_result para las revisiones con varios proveedores.

Cursor (aún no verificado)

Añade a ~/.cursor/mcp.json (o .cursor/mcp.json en un proyecto):

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

Completamente sin probar. Según informes de foros, Cursor corta las llamadas a los 60 s aproximadamente y esto no se puede configurar; eso no se ha medido. Usa wcr_review_submit y wcr_review_result para las revisiones con varios proveedores.

Dile a tu agente cuándo usarlo

Las revisiones tardan de 30 a 180 s y usan tus cuentas de chat, así que pide a tu agente que las use para cambios de alto impacto o sensibles para la seguridad, no en cada edición. Pon todo el material en el prompt, nunca secretos, y trata las respuestas como opiniones independientes que hay que comprobar, no como hallazgos verificados. Si un resultado indica que el prompt puede haberse enviado ya, no lo reenvíes sin preguntar. El repositorio del servidor incluye un texto ya preparado para tu CLAUDE.md, AGENTS.md o regla de Cursor: agent-guide.md.

Notas de seguridad

El servidor se enlaza solo a loopback y exige el token de emparejamiento en cada llamada.
Rechaza las solicitudes que llevan un encabezado Origin de navegador, los POST que no son JSON y los encabezados Host inesperados, de modo que una página web que visites no pueda controlarlo.
La navegación automatizada necesita una lista de dominios permitidos explícita y un permiso adicional que concedes en la ventana emergente de la extensión.
Consulta la política de privacidad para saber qué hace la extensión con los datos.