Guide d'installation

Trois parties fonctionnent ensemble : l'extension Chrome, un serveur sur votre propre ordinateur, et la commande wcr (CLI et serveur MCP). Tout s'exécute en local.

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

Accès anticipé

WebCodeReview n'est pas encore installable publiquement. L'outil en ligne de commande wcr (paquet npm @webcodereview/cli) et la fiche du Chrome Web Store arrivent bientôt. Les utilisateurs de l'accès anticipé reçoivent les instructions d'installation par e-mail : rejoignez la liste d'attente. Le reste de cette page sert de référence une fois les deux parties installées.

1. Le serveur et `wcr`

Nécessite Node.js 20 ou plus récent. Le serveur n'écoute que sur 127.0.0.1:8787. Au premier lancement, il génère un jeton d'appairage et l'enregistre dans ~/.config/webcodereview/token. wcr lit le jeton depuis WCR_TOKEN ou depuis ce fichier, et démarre le serveur en arrière-plan (journal : ~/.config/webcodereview/server.log) lorsque rien ne répond sur WCR_PORT (8787 par défaut), par exemple avec wcr status. Vous pouvez aussi le lancer au premier plan avec wcr serve.

2. L'extension Chrome

Installez l'extension dans le profil Chrome où vous êtes connecté aux sites d'IA que vous voulez utiliser, puis connectez-vous à chacun de ces sites dans ce même profil. À la première installation, l'extension ouvre une page de bienvenue.

3. Appairer l'extension avec le serveur

Exécutez wcr setup dans un terminal. Il démarre le serveur si nécessaire et ouvre Chrome sur la page d'appairage de l'extension. S'il ne peut pas ouvrir Chrome à votre place, il vous indique quoi faire.
Le jeton d'appairage parvient à l'extension dans l'adresse de la page, après #, et n'est donc jamais envoyé sur le réseau. Vous n'avez rien à copier ni à coller.
La fenêtre contextuelle affiche ensuite « Connecté à wcr sur cet ordinateur ».

Si le jeton n'est plus valide, la fenêtre contextuelle affiche « L’appairage n’est plus valide » : exécutez de nouveau wcr setup. Vous pouvez vérifier la connexion avec :

wcr status

Un seul navigateur ou profil peut être connecté à la fois. Si un second se connecte, le premier est désactivé ; sa fenêtre contextuelle affiche « Un autre navigateur a pris le relais » et un bouton « Utiliser ce navigateur ».

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

Fournisseurs : chatgpt, gemini, claude, deepseek et grok. Le délai d'attente par défaut est de 180 secondes par fournisseur. Si un fournisseur échoue (non connecté, vérification demandée, délai dépassé), les autres répondent quand même, et le code de sortie est non nul.

Les cinq fournisseurs (ChatGPT, Gemini, Claude, DeepSeek et Grok) ont été vérifiés sur les sites réels le 2026-10-12. Les sites de chat modifient souvent leurs pages, donc un fournisseur peut cesser de fonctionner jusqu'à la mise à jour de l'extension.

5. L'utiliser depuis votre assistant de programmation IA (MCP)

wcr mcp est un serveur MCP stdio standard, donc n'importe quel client MCP peut le lancer. Outils :

Outil	Usage
`wcr_review_submit` + `wcr_review_result`	Démarrer une revue multi-fournisseurs, puis interroger le résultat (chaque interrogation attend jusqu'à 50 s). À utiliser par défaut.
`wcr_ask`, `wcr_ask_many`	Versions bloquantes, de 30 à 180 s par appel. Uniquement pour les clients dont le délai d'attente d'outil est long.
`wcr_automate`	Automatisation du navigateur ; `allowDomains` est obligatoire. Vous devez être connecté à WebCodeReview dans l'extension.
`wcr_status`	L'extension est-elle connectée ?

Ce qui compte, c'est le délai d'attente d'outil par appel du client, car une revue avec 3 fournisseurs peut prendre jusqu'à environ 270 s. Les tâches de revue vivent dans la mémoire du serveur : un redémarrage les perd, et elles ne peuvent pas être annulées individuellement.

La navigation automatisée nécessite une connexion

La revue de code ne nécessite aucun compte. La navigation automatisée est la seule fonctionnalité qui en demande un. Ouvrez la fenêtre contextuelle de l'extension ; dans la ligne « Navigation automatisée » (elle indique « Disponible après connexion » tant que vous n'êtes pas connecté), cliquez sur « Continuer avec Google » et choisissez votre compte Google dans la fenêtre propre à Chrome. Activez ensuite l'interrupteur « Navigation automatisée » ; Chrome vous demande d'autoriser l'accès à tous les sites web. Vous pouvez aussi lancer la connexion depuis la pastille « Se connecter » de l'en-tête de la fenêtre contextuelle. Si la connexion en un clic ne fonctionne pas, utilisez « Se connecter plutôt sur le site » et approuvez le navigateur sur webcodereview.com/device. Désactiver l'interrupteur arrête l'automatisation, mais ne retire pas cette autorisation ; pour la révoquer complètement, ouvrez chrome://extensions, choisissez WebCodeReview et modifiez « Accès au site ».

Claude Code (testé)

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

Testé de bout en bout avec un véritable appel d'outil. Un appel d'outil de 330 s s'est terminé normalement (mesuré sur Claude Code v2.1.222).

Codex (pas encore vérifié)

codex mcp add wcr -- wcr mcp

ou dans ~/.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)

Seule la configuration a été relue ; un appel d'outil via Codex n'a pas été testé. Le délai par défaut de 60 s vient de sa documentation et n'a pas été mesuré. Utilisez wcr_review_submit et wcr_review_result pour les revues multi-fournisseurs.

Cursor (pas encore vérifié)

Ajoutez à ~/.cursor/mcp.json (ou .cursor/mcp.json dans un projet) :

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

Totalement non testé. Des messages de forum disent que Cursor coupe les appels vers 60 s et que ce n'est pas configurable ; cela n'a pas été mesuré. Utilisez wcr_review_submit et wcr_review_result pour les revues multi-fournisseurs.

Dire à votre agent quand l'utiliser

Les revues prennent de 30 à 180 s et utilisent vos comptes de chat ; demandez donc à votre agent de s'en servir pour les changements à fort impact ou sensibles du point de vue de la sécurité, pas pour chaque modification. Mettez tout le contenu dans le prompt, jamais de secrets, et considérez les réponses comme des avis indépendants à vérifier, pas comme des constats vérifiés. Si un résultat indique que le prompt a peut-être déjà été soumis, ne le renvoyez pas sans demander. Le dépôt du serveur fournit un texte prêt à l'emploi pour votre CLAUDE.md, AGENTS.md ou règle Cursor : agent-guide.md.

Notes de sécurité

Le serveur n'écoute que sur la boucle locale et exige le jeton d'appairage à chaque appel.
Il rejette les requêtes qui portent un en-tête Origin de navigateur, les POST non JSON et les en-têtes Host inattendus, de sorte qu'une page web que vous visitez ne peut pas le piloter.
La navigation automatisée exige une liste de domaines autorisés explicite et une autorisation supplémentaire que vous accordez dans la fenêtre contextuelle de l'extension.
Voir la politique de confidentialité pour ce que l'extension fait des données.