Comment donner un vrai navigateur à votre agent de code IA avec Chrome DevTools MCP

Laissez votre agent de code IA ouvrir Chrome, lire les erreurs de la console et enregistrer des traces de performance. Installation, configurations et solutions pour Chrome DevTools MCP.

Graphic of a browser window connected to a terminal prompt reading mcp, for a guide to Chrome DevTools MCP

Les agents de code IA savent écrire une page web, mais la plupart ne voient pas ce que fait cette page une fois lancée dans un navigateur. Chrome DevTools MCP, un serveur open source de l’équipe Chrome DevTools, règle ce problème : il permet à un agent comme Claude Code, Cursor, Copilot ou Gemini CLI d’ouvrir Chrome, de lire la console, d’inspecter les requêtes réseau, de faire des captures d’écran et d’enregistrer des traces de performance. Ce guide vous montre comment l’installer, faire un premier test, le connecter à une fenêtre Chrome déjà ouverte et corriger les problèmes de configuration les plus courants.

Au 14 novembre 2026, la dernière version est la 1.13.0, publiée le 11 novembre, et le projet figurait cette semaine dans le classement quotidien des tendances de GitHub.

Ce que fait Chrome DevTools MCP

MCP (Model Context Protocol) est une méthode standard qui permet aux assistants IA d’appeler des outils externes. Le paquet chrome-devtools-mcp est un serveur MCP : votre agent lui envoie des requêtes comme « ouvre cette URL » ou « liste les erreurs de la console », et il les exécute dans un vrai navigateur Chrome grâce à Chrome DevTools et Puppeteer.

Les outils sont regroupés par catégories. L’automatisation des saisies (cliquer, remplir, taper, envoyer un fichier), la navigation, l’émulation, le traçage des performances, l’inspection réseau et le débogage (messages de console, captures d’écran, instantanés de page, audits Lighthouse) sont activés par défaut. Des catégories supplémentaires, comme les simulations réseau (mocks), les extensions et les applications web progressives, restent désactivées tant que vous ne les activez pas avec une option. La version 1.13.0 a ajouté les logpoints et les mocks réseau limités à une page.

Le même paquet inclut aussi un outil en ligne de commande, chrome-devtools, pour piloter le navigateur depuis un terminal, sans aucun agent.

Ce dont vous avez besoin

  • Node.js, en version LTS. Au 14 novembre 2026, le paquet npm indique la prise en charge de Node ^20.19.0 || ^22.12.0 || >=23.
  • npm (fourni avec Node).
  • Google Chrome, version stable actuelle ou plus récente. Le projet ne prend officiellement en charge que Google Chrome et Chrome for Testing ; d’autres navigateurs Chromium peuvent fonctionner, sans garantie.
  • Un agent ou un éditeur compatible MCP, par exemple Claude Code, Cursor, VS Code avec Copilot, Gemini CLI ou Codex.

Vérifiez d’abord votre version de Node :

Terminal
node --version

Étape 1 : vérifier que le serveur démarre

Avant de toucher aux réglages de votre agent, vérifiez que le paquet démarre sur votre machine. Le guide de dépannage officiel recommande ce test :

Terminal
npx chrome-devtools-mcp@latest --help

Vous devriez voir une liste d’options comme --headless, --isolated et --browser-url. Si une erreur apparaît à ce stade, corrigez-la avant d’aller plus loin (voir la section sur les erreurs plus bas).

Étape 2 : l’ajouter à votre agent

La plupart des clients MCP acceptent le même bloc JSON. Voici la configuration standard tirée du README du projet :

Code
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    }
  }
}

Avec @latest, votre client récupère automatiquement les nouvelles versions.

Plusieurs outils proposent aussi une installation en une ligne. Elles proviennent du guide de configuration des clients du projet.

Claude Code :

Code
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest

Gemini CLI :

Code
gemini mcp add chrome-devtools npx chrome-devtools-mcp@latest

OpenAI Codex :

Code
codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

VS Code (macOS et Linux) :

Code
code --add-mcp '{"name":"io.github.ChromeDevTools/chrome-devtools-mcp","command":"npx","args":["-y","chrome-devtools-mcp"],"env":{}}'

Dans Cursor, le guide indique d’aller dans Cursor Settings (réglages de Cursor), puis MCP, puis New MCP Server (nouveau serveur MCP), et de coller la configuration standard. Les noms de menus peuvent changer d’une version à l’autre : si vous ne trouvez pas ce chemin, consultez la documentation MCP de Cursor.

Facultatif : l’installer comme plugin avec des skills

Le projet fournit aussi des « skills », de courts fichiers d’instructions qui apprennent à votre agent à bien utiliser les outils. Dans Claude Code, vous pouvez installer le serveur et les skills d’un coup en lançant /plugin marketplace add ChromeDevTools/chrome-devtools-mcp puis /plugin install chrome-devtools-mcp@chrome-devtools-plugins, avant de redémarrer Claude Code. Si les skills sont nouvelles pour vous, notre guide sur l’installation et l’utilisation des skills d’agent dans Claude Code explique leur fonctionnement.

Étape 3 : lancer votre premier prompt

Redémarrez votre agent pour qu’il charge le nouveau serveur, puis tapez le prompt de test proposé par le projet :

Code
Check the performance of https://developers.chrome.com

Résultat attendu : une fenêtre Chrome s’ouvre, la page se charge et votre agent vous fait un compte rendu d’une trace de performance. Le navigateur ne démarre que lorsque l’agent utilise pour la première fois un outil qui en a besoin : connecter le serveur seul n’ouvrira donc pas Chrome.

Une fois que cela fonctionne, essayez des prompts adaptés à votre propre travail :

Code
Open http://localhost:3000, list any console errors, and tell me which network requests failed.
Code
Take a screenshot of http://localhost:3000 at a mobile viewport and check the page for accessibility problems.

Par défaut, le serveur lance Chrome avec son propre profil, stocké dans $HOME/.cache/chrome-devtools-mcp/chrome-profile sous macOS et Linux. Ce profil est conservé d’une session à l’autre, donc les connexions que vous y faites restent actives.

Étape 4 : modifier le démarrage de Chrome (facultatif)

Vous contrôlez le comportement en ajoutant des options au tableau args. Cet exemple lance Chrome sans fenêtre, utilise un profil temporaire supprimé ensuite et désactive les statistiques d’utilisation de Google, collectées par défaut :

Code
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--headless=true",
        "--isolated=true",
        "--no-usage-statistics"
      ]
    }
  }
}

Deux autres réglages de confidentialité méritent d’être connus. Les outils de performance peuvent envoyer les URL des traces à l’API Chrome UX Report (CrUX) de Google pour récupérer des données d’utilisateurs réels ; ajoutez --no-performance-crux pour l’empêcher. Si vous n’avez besoin que d’une navigation basique, --slim propose un ensemble réduit de trois outils.

Étape 5 : se connecter à une fenêtre Chrome que vous utilisez déjà (facultatif)

Parfois, vous voulez que l’agent travaille dans votre propre navigateur, par exemple sur un site où vous êtes déjà connecté. Au 14 novembre 2026, ce mode de « connexion automatique » nécessite Chrome 144 ou une version plus récente.

  1. Dans Chrome, allez sur chrome://inspect/#remote-debugging et suivez la boîte de dialogue pour autoriser les connexions de débogage entrantes.
  2. Ajoutez --autoConnect à votre configuration :
Code
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
    }
  }
}
  1. Laissez Chrome ouvert et envoyez un prompt. Chrome demande l’autorisation ; cliquez sur Allow (Autoriser).

Le serveur se connecte à votre profil Chrome par défaut et peut voir toutes les fenêtres qui y sont ouvertes. Fermez d’abord les onglets de banque, de messagerie ou contenant d’autres données sensibles. L’avertissement du projet lui-même précise que l’agent peut inspecter et modifier toutes les données du navigateur.

Si votre agent tourne dans un bac à sable (sandbox), l’autre solution consiste à lancer Chrome vous-même avec un port de débogage et un profil séparé (exemple sous macOS ; la documentation donne aussi les chemins pour Linux et Windows) :

Code
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable

Utilisez ensuite "--browser-url=http://127.0.0.1:9222" dans args. Tant que ce port est ouvert, n’importe quelle application de votre machine peut contrôler le navigateur : ne visitez donc pas de sites sensibles dans cette fenêtre.

Erreurs courantes et solutions

  • Error [ERR_MODULE_NOT_FOUND]: Cannot find module ... : généralement une version de Node non prise en charge ou un cache npx corrompu. Mettez Node à jour, videz le cache avec npm cache clean --force et réinstallez. La documentation suggère aussi rm -rf ~/.npm/_npx, qui supprime également les autres outils npx en cache.
  • Target closed : Chrome n’a pas pu démarrer. Vérifiez qu’aucune autre instance de Chrome ne tourne (fermez-les le cas échéant) et que la dernière version stable de Chrome est installée.
  • L’agent ne trouve pas le serveur, alors que le test dans le terminal fonctionne : vérifiez que votre éditeur utilise les mêmes Node et npm que votre terminal.
  • Windows : MCP error -32000: Connection closed : définissez "command": "cmd" et placez "/c", "npx", "-y", "chrome-devtools-mcp@latest" dans args.
  • macOS : --autoConnect échoue avec EPERM: operation not permitted : accordez à votre terminal ou éditeur l’accès à Google Chrome dans System Settings > Privacy & Security > Files & Folders (Réglages Système > Confidentialité et sécurité > Fichiers et dossiers).
  • --autoConnect expire : vérifiez que Chrome 144 ou plus récent est déjà lancé, que le débogage à distance est activé sur chrome://inspect/#remote-debugging, que vous avez accepté la demande et que rien d’autre n’utilise le même port de débogage.
  • Chrome ne démarre pas dans un conteneur ou en CI : Chrome ne fonctionne pas en root. Lancez le serveur avec un utilisateur non root.
  • Travailler dans une VM : Chrome peut refuser les connexions provenant de la machine virtuelle. La documentation suggère un tunnel SSH depuis la VM, par exemple ssh -N -L 127.0.0.1:9222:127.0.0.1:9222 user@server. Notre guide des clés SSH explique la configuration si vous n’avez jamais utilisé SSH.

Pour tout autre problème, lancez le serveur avec un fichier journal et lisez l’erreur :

Code
NODE_DEBUG=* npx chrome-devtools-mcp@latest --log-file=/tmp/chrome-devtools-mcp.log

En résumé

Chrome DevTools MCP permet à votre agent de vérifier lui-même son travail front-end : charger la page, lire les erreurs, consulter l’onglet réseau et mesurer les performances, au lieu de deviner. Commencez par la configuration standard et le prompt de test, ajoutez --isolated ou --headless si vous voulez un navigateur propre et jetable, et n’utilisez la connexion automatique que dans un profil où cela ne vous gêne pas qu’une IA voie tout. Pensez aussi à garder Chrome à jour ; notre explication des failles zero-day de Chrome dit pourquoi c’est important.

Sources

Liens vérifiés pour la dernière fois le 15 novembre 2026.

Écrit par Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

À propos de Mindloop Experience

Réponses

Écrire une réponse

Plus d’articles de Mindloop Experience

Tout voir de Mindloop Experience

Vous pouvez applaudir jusqu’à 50 fois.