Chrome DevTools Protocol

Définition

Le Chrome DevTools Protocol (CDP) est l’interface que Chrome expose pour l’outillage : le canal qu’utilisent les outils de développement intégrés, mis à disposition d’autres programmes via un WebSocket local. Avec lui, un programme peut ouvrir des onglets, naviguer, lire le DOM, envoyer des entrées et prendre des captures d’écran.

Depuis Chrome 136, le navigateur ignore les anciens drapeaux de débogage à distance pour son répertoire de données utilisateur par défaut ; un Chrome piloté a donc besoin soit du contrôle de débogage à distance sur la page inspect (Chrome 144+), soit d’un répertoire de données utilisateur dédié avec son propre port.

Sources : Chrome DevTools Protocol · Chrome for Developers: Changes to remote debugging switches · chrome-devtools-mcp: configuration

Exemple

Vous utilisez Chrome 144 ou plus récent. Vous ouvrez chrome://inspect/#remote-debugging, activez le débogage à distance et lancez Chrome DevTools MCP avec --autoConnect. Chrome demande s’il faut autoriser la connexion ; vous l’approuvez dans la fenêtre que vous comptez utiliser, et l’agent peut désormais lister et piloter vos onglets ouverts.

Si vous préférez l’isolation, ou si votre Chrome est plus ancien, vous lancez un second Chrome avec son propre répertoire de données utilisateur sur le port 9222 et pointez le serveur MCP vers http://127.0.0.1:9222. Depuis Chrome 136, l’ancien drapeau seul ne fonctionne plus sur votre profil de tous les jours. Les deux commandes figurent ci-dessous.

# Mode A: Chrome 144+, remote debugging enabled on chrome://inspect/#remote-debugging
npx -y chrome-devtools-mcp@latest --autoConnect

# Mode B: dedicated profile on a loopback port
"<path to Chrome>" --remote-debugging-port=9222 --user-data-dir="$PWD/.browser/chrome" about:blank
npx -y chrome-devtools-mcp@latest --browserUrl=http://127.0.0.1:9222

Pourquoi c’est important pour un lancement sur annuaires

CDP est ce qui transforme le navigateur où vous êtes connecté en quelque chose qu’un agent peut opérer. C’est aussi pourquoi il mérite de la prudence : un port de débogage contrôle tout le navigateur, pages authentifiées comprises. Le garder sur l’adresse loopback, ne jamais le tunneler et le fermer après un lot font partie de la configuration, pas d’un durcissement optionnel.

Comment LaunchRepo le gère

BROWSER-SETUP.md propose deux modes. A : activer le débogage à distance sur chrome://inspect dans Chrome 144+ et laisser Chrome DevTools MCP se connecter automatiquement, en approuvant l’invite de connexion dans la fenêtre voulue. B : lancer un Chrome dédié avec son propre répertoire de données utilisateur sur 127.0.0.1:9222 et pointer le serveur MCP vers cette URL. Jamais les deux à la fois, jamais de port public, et l’onglet visible doit bouger avant qu’un processus en cours compte comme un accès.

Pour aller plus loin

Connecter votre agent de code à votre Chrome →

Les deux modes de connexion pas à pas, le test de fumée sur une page publique et la fermeture du port de débogage après un lot.

Termes liés

Agent navigateur

Un agent qui pilote un navigateur web — navigation, lecture, formulaires, clics — comme produit à part entière ou comme agent de code doté d’un outil navigateur.

Serveur MCP

Un processus qui expose des outils à un agent IA via le Model Context Protocol — pour LaunchRepo, celui qui remet un onglet Chrome à l’agent.

Agent de code IA

Un assistant piloté par un modèle qui lit et modifie des fichiers, exécute des commandes et appelle des outils dans un projet — comme Claude Code, Codex ou Cursor.

Tous les termes du glossaire →