Chrome DevTools MCP

Chrome DevTools pour agents

Chrome DevTools pour agents (chrome-devtools-mcp) permet à votre agent de codage (tel qu'Antigravity, Claude, Cursor ou Copilot) de contrôler et d'inspecter un navigateur Chrome en direct. Il agit comme un serveur Model-Context-Protocol (MCP), donnant à votre assistant de codage IA l'accès à toute la puissance de Chrome DevTools pour une automatisation fiable, un débogage approfondi et une analyse de performance. Une CLI est également fournie pour une utilisation sans MCP.

Référence des outils | Journal des modifications | Contribuer | Dépannage | Principes de conception

Fonctionnalités clés

• Obtenir des informations sur les performances : Utilise Chrome DevTools pour enregistrer des traces et extraire des informations exploitables sur les performances.
• Débogage avancé du navigateur : Analysez les requêtes réseau, prenez des captures d'écran et vérifiez les messages de la console du navigateur (avec des traces de pile source-mappées).
• Automatisation fiable. Utilise puppeteer pour automatiser des actions dans Chrome et attendre automatiquement les résultats des actions.

Avertissements

chrome-devtools-mcp expose le contenu de l'instance du navigateur aux clients MCP leur permettant d'inspecter, de déboguer et de modifier toute donnée dans le navigateur ou DevTools. Évitez de partager des informations sensibles ou personnelles que vous ne souhaitez pas partager avec les clients MCP.

chrome-devtools-mcp prend officiellement en charge Google Chrome et Chrome for Testing uniquement. D'autres navigateurs basés sur Chromium peuvent fonctionner, mais cela n'est pas garanti, et vous pourriez rencontrer un comportement inattendu. À utiliser à votre propre discrétion. Nous nous engageons à fournir des correctifs et un support pour la dernière version de Extended Stable Chrome.

Les outils de performance peuvent envoyer des URL de trace à l'API Google CrUX pour récupérer des données d'expérience utilisateur réelle. Cela aide à fournir une image holistique de la performance en présentant les données de terrain aux côtés des données de laboratoire. Ces données sont collectées par le Chrome User Experience Report (CrUX). Pour désactiver cela, exécutez avec le drapeau --no-performance-crux.

Statistiques d'utilisation

Google collecte des statistiques d'utilisation (telles que les taux de succès des invocations d'outils, la latence et les informations sur l'environnement) pour améliorer la fiabilité et les performances de Chrome DevTools MCP.

La collecte de données est activée par défaut. Vous pouvez vous désinscrire en passant le drapeau --no-usage-statistics lors du démarrage du serveur :

"args": ["-y", "chrome-devtools-mcp@latest", "--no-usage-statistics"]

Google traite ces données conformément à la Politique de confidentialité de Google.

La collecte de statistiques d'utilisation par Google pour Chrome DevTools MCP est indépendante des statistiques d'utilisation du navigateur Chrome. Se désinscrire des métriques Chrome ne vous désinscrit pas automatiquement de cet outil, et vice-versa.

La collecte est désactivée si les variables d'environnement CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS ou CI sont définies.

Vérifications de mise à jour

Par défaut, le serveur vérifie périodiquement le registre npm pour les mises à jour et enregistre une notification lorsqu'une version plus récente est disponible. Vous pouvez désactiver ces vérifications de mise à jour en définissant la variable d'environnement CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS.

Prérequis

• Node.js version LTS.
• Chrome version stable actuelle ou plus récente.
• npm

Pour commencer

Ajoutez la configuration suivante à votre client MCP :

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

[!NOTE] Utiliser chrome-devtools-mcp@latest garantit que votre client MCP utilisera toujours la dernière version du serveur Chrome DevTools MCP.

Si vous êtes intéressé par des tâches de navigateur de base uniquement, utilisez le mode --slim :

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

Voir Référence des outils Slim.

Configuration du client MCP

amp mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--browser-url=http://127.0.0.1:9222"
      ]
    }
  }
}

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

/plugin marketplace add ChromeDevTools/chrome-devtools-mcp

/plugin install chrome-devtools-mcp@chrome-devtools-plugins

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

[mcp_servers.chrome-devtools]
command = "cmd"
args = [
    "/c",
    "npx",
    "-y",
    "chrome-devtools-mcp@latest",
]
env = { SystemRoot="C:\\Windows", PROGRAMFILES="C:\\Program Files" }
startup_timeout_ms = 20_000

cmd mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest

copilot

/mcp add

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

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

droid mcp add chrome-devtools "npx -y chrome-devtools-mcp@latest"

# Either MCP only:
gemini mcp add chrome-devtools npx chrome-devtools-mcp@latest
# Or as a Gemini extension (MCP+Skills):
gemini extensions install --auto-update https://github.com/ChromeDevTools/chrome-devtools-mcp

gemini mcp add -s user chrome-devtools npx chrome-devtools-mcp@latest

grok mcp add chrome-devtools npx chrome-devtools-mcp@latest

mcp-proxy --transport streamablehttp --port 8080 -- npx -y chrome-devtools-mcp@latest

[[mcp_servers]]
name = "chrome-devtools"
transport = "stdio"
command = "npx"
args = ["chrome-devtools-mcp@latest"]

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "chrome-devtools": {
      "type": "local",
      "command": ["npx", "-y", "chrome-devtools-mcp@latest"]
    }
  }
}

qodercli mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

qodercli mcp add -s user chrome-devtools -- npx chrome-devtools-mcp@latest

Saisissez l'invite suivante dans votre client MCP pour vérifier que tout fonctionne :

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

Votre client MCP devrait ouvrir le navigateur et enregistrer une trace de performance.

[!NOTE] Le serveur MCP démarrera automatiquement le navigateur dès que le client MCP utilisera un outil nécessitant une instance de navigateur en cours d'exécution. La simple connexion au serveur Chrome DevTools MCP ne démarrera pas automatiquement le navigateur.

Outils

Si vous rencontrez des problèmes, consultez notre guide de dépannage.

• Automatisation des entrées (10 outils)
  • click
  • drag
  • fill
  • fill_form
  • handle_dialog
  • hover
  • press_key
  • type_text
  • upload_file
  • click_at
• Automatisation de la navigation (6 outils)
  • close_page
  • list_pages
  • navigate_page
  • new_page
  • select_page
  • wait_for
• Émulation (2 outils)
  • emulate
  • resize_page
• Performance (3 outils)
  • performance_analyze_insight
  • performance_start_trace
  • performance_stop_trace
• Réseau (2 outils)
  • get_network_request
  • list_network_requests
• Débogage (8 outils)
  • evaluate_script
  • get_console_message
  • lighthouse_audit
  • list_console_messages
  • take_screenshot
  • take_snapshot
  • screencast_start
  • screencast_stop
• Mémoire (11 outils)
  • take_heapsnapshot
  • close_heapsnapshot
  • compare_heapsnapshots
  • get_heapsnapshot_class_nodes
  • get_heapsnapshot_details
  • get_heapsnapshot_dominators
  • get_heapsnapshot_duplicate_strings
  • get_heapsnapshot_edges
  • get_heapsnapshot_retainers
  • get_heapsnapshot_retaining_paths
  • get_heapsnapshot_summary
• Extensions (5 outils)
  • install_extension
  • list_extensions
  • reload_extension
  • trigger_extension_action
  • uninstall_extension
• Tiers (2 outils)
  • execute_3p_developer_tool
  • list_3p_developer_tools
• WebMCP (2 outils)
  • execute_webmcp_tool
  • list_webmcp_tools

Configuration

Le serveur Chrome DevTools MCP prend en charge les options de configuration suivantes :

• --autoConnect/ --auto-connect Si spécifié, se connecte automatiquement à un navigateur (Chrome 144+) exécuté localement à partir du répertoire de données utilisateur identifié par le paramètre channel (le canal par défaut est stable). Nécessite que le serveur de débogage à distance soit démarré dans l'instance Chrome via chrome://inspect/#remote-debugging.

  • Type : booléen
  • Par défaut : false

• --browserUrl/ --browser-url, -u Se connecter à une instance Chrome en cours d'exécution et débogable (par ex. http://127.0.0.1:9222). Pour plus de détails, voir : https://github.com/ChromeDevTools/chrome-devtools-mcp#connecting-to-a-running-chrome-instance.

  • Type : chaîne
  • Par défaut : false

• --wsEndpoint/ --ws-endpoint, -w Point de terminaison WebSocket pour se connecter à une instance Chrome en cours d'exécution (par ex., ws://127.0.0.1:9222/devtools/browser/). Alternative à --browserUrl.

  • Type : chaîne
  • Par défaut : false

• --wsHeaders/ --ws-headers En-têtes personnalisés pour la connexion WebSocket au format JSON (par ex., '{"Authorization":"Bearer token"}'). Fonctionne uniquement avec --wsEndpoint.

  • Type : chaîne
  • Par défaut : false

• --headless Indique s'il faut exécuter en mode headless (sans interface utilisateur).

  • Type : booléen
  • Par défaut : false

• --executablePath/ --executable-path, -e Chemin vers l'exécutable Chrome personnalisé.

  • Type : chaîne
  • Par défaut : false

• --isolated Si spécifié, crée un répertoire de données utilisateur temporaire qui est automatiquement nettoyé après la fermeture du navigateur. Par défaut, false.

  • Type : booléen
  • Par défaut : false

• --userDataDir/ --user-data-dir Chemin vers le répertoire de données utilisateur pour Chrome. La valeur par défaut est $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE

  • Type : chaîne
  • Par défaut : false

• --channel Spécifie un canal Chrome différent à utiliser. La valeur par défaut est la version stable du canal.

  • Type : chaîne
  • Choix : canary, dev, beta, stable
  • Par défaut : false

• --logFile/ --log-file Chemin vers un fichier pour écrire les journaux de débogage. Définissez la variable d'environnement DEBUG sur * pour activer les journaux détaillés. Utile pour soumettre des rapports de bogues.

  • Type : chaîne
  • Par défaut : false

• --viewport Taille initiale de la fenêtre d'affichage pour les instances Chrome démarrées par le serveur. Par exemple, 1280x720. En mode headless, la taille maximale est de 3840x2160px.

  • Type : chaîne
  • Par défaut : false

• --proxyServer/ --proxy-server Configuration du serveur proxy pour Chrome, transmise comme --proxy-server lors du lancement du navigateur. Voir https://www.chromium.org/developers/design-documents/network-settings/ pour plus de détails.

  • Type : chaîne
  • Par défaut : false

• --acceptInsecureCerts/ --accept-insecure-certs Si activé, ignore les erreurs relatives aux certificats auto-signés et expirés. À utiliser avec prudence.

  • Type : booléen
  • Par défaut : false

• --experimentalPageIdRouting/ --experimental-page-id-routing Indique s'il faut exposer pageId sur les outils à portée de page et acheminer les requêtes par ID de page (utile pour les sessions d'agent simultanées).

  • Type : booléen
  • Par défaut : false

• --experimentalDevtools/ --experimental-devtools Indique s'il faut activer l'automatisation sur les cibles DevTools

  • Type : booléen
  • Par défaut : false

• --experimentalVision/ --experimental-vision Indique s'il faut activer les outils basés sur les coordonnées tels que click_at(x,y). Nécessite généralement un modèle d'utilisation informatique capable de produire des coordonnées précises en regardant des captures d'écran.

  • Type : booléen
  • Par défaut : false

• --memoryDebugging/ --memory-debugging, -experimentalMemory Indique s'il faut activer les outils de débogage de la mémoire.

  • Type : booléen
  • Par défaut : false

• --experimentalStructuredContent/ --experimental-structured-content Indique s'il faut produire un contenu formaté structuré.

  • Type : booléen
  • Par défaut : false

• --experimentalIncludeAllPages/ --experimental-include-all-pages Indique s'il faut inclure tous les types de pages, comme les webviews ou les pages d'arrière-plan, en tant que pages.

  • Type : booléen
  • Par défaut : false

• --experimentalScreencast/ --experimental-screencast Expose les outils de screencast expérimentaux (nécessite ffmpeg). Installez ffmpeg https://www.ffmpeg.org/download.html et assurez-vous qu'il est disponible dans le PATH du serveur MCP.

  • Type : booléen
  • Par défaut : false

• --experimentalFfmpegPath/ --experimental-ffmpeg-path Chemin vers l'exécutable ffmpeg pour l'enregistrement du screencast.

  • Type : chaîne
  • Par défaut : false

• --categoryExperimentalWebmcp/ --category-experimental-webmcp Définissez sur true pour activer le débogage des outils WebMCP. Nécessite Chrome 149+ avec les indicateurs suivants : --enable-features=WebMCP,DevToolsWebMCPSupport

  • Type : booléen
  • Par défaut : false

• --chromeArg/ --chrome-arg Arguments supplémentaires pour Chrome. S'applique uniquement lorsque Chrome est lancé par chrome-devtools-mcp.

  • Type : tableau
  • Par défaut : false

• --blockedUrlPattern/ --blocked-url-pattern Restreint l'accès réseau du navigateur en bloquant les modèles d'URL spécifiés (utilise https://urlpattern.spec.whatwg.org/). Se détache silencieusement des cibles avec des URL bloquées lors de la connexion et bloque les requêtes d'exécution (y compris les navigations et les sous-ressources). Accepte un tableau de modèles.

  • Type : tableau
  • Par défaut : false

• --allowedUrlPattern/ --allowed-url-pattern Restreint l'accès réseau du navigateur en autorisant uniquement les modèles d'URL spécifiés (utilise https://urlpattern.spec.whatwg.org/). Nécessite Chrome 149+. Se détache silencieusement des cibles avec des URL non autorisées lors de la connexion et bloque les requêtes d'exécution (y compris les navigations et les sous-ressources). Accepte un tableau de modèles.

  • Type : tableau
  • Par défaut : false

• --ignoreDefaultChromeArg/ --ignore-default-chrome-arg Désactive explicitement les arguments par défaut pour Chrome. S'applique uniquement lorsque Chrome est lancé par chrome-devtools-mcp.

  • Type : tableau
  • Par défaut : false

• --categoryEmulation/ --category-emulation Définissez sur false pour exclure les outils liés à l'émulation.

  • Type : booléen
  • Par défaut : true

• --categoryPerformance/ --category-performance Définissez sur false pour exclure les outils liés à la performance.

  • Type : booléen
  • Par défaut : true

• --categoryNetwork/ --category-network Définissez sur false pour exclure les outils liés au réseau.

  • Type : booléen
  • Par défaut : true

• --categoryExtensions/ --category-extensions Définissez sur true pour inclure les outils liés aux extensions. Remarque : Cette fonctionnalité n'est actuellement prise en charge qu'avec une connexion par tube. autoConnect, browserUrl et wsEndpoint ne sont pas pris en charge avec cette fonctionnalité jusqu'à la sortie de la version 149.

  • Type : booléen
  • Par défaut : false

• --categoryExperimentalThirdParty/ --category-experimental-third-party Définissez sur true pour activer les outils de développement tiers exposés par la page inspectée elle-même

  • Type : booléen
  • Par défaut : false

• --performanceCrux/ --performance-crux Définissez sur false pour désactiver l'envoi d'URL à partir des traces de performance vers l'API CrUX afin d'obtenir des données de performance terrain.

  • Type : booléen
  • Par défaut : true

• --usageStatistics/ --usage-statistics Définissez sur false pour refuser la collecte de statistiques d'utilisation. Google collecte des données d'utilisation pour améliorer l'outil, traitées conformément à la politique de confidentialité de Google (https://policies.google.com/privacy). Ceci est indépendant des métriques du navigateur Chrome. Désactivé si les variables d'environnement CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS ou CI sont définies.

  • Type : booléen
  • Par défaut : true

• --screenshotFormat/ --screenshot-format Remplace le format de sortie par défaut utilisé par take_screenshot lorsque l'appelant n'en spécifie pas. JPEG et WebP sont environ 3 à 5 fois plus petits que PNG, ce qui aide à réduire la taille du contexte dans les conversations IA. Non défini conserve la valeur par défaut existante ("png").

  • Type : chaîne
  • Choix : jpeg, png, webp
  • Par défaut : false

• --screenshotQuality/ --screenshot-quality Remplace la qualité de compression par défaut (0-100) utilisée par take_screenshot pour JPEG et WebP lorsque l'appelant n'en spécifie pas. Des valeurs plus faibles signifient des fichiers plus petits. Ignoré pour PNG. Non défini conserve la valeur par défaut de Puppeteer.

  • Type : nombre
  • Par défaut : false

• --screenshotMaxWidth/ --screenshot-max-width Largeur maximale en pixels pour les captures d'écran. Si l'image capturée est plus large, elle est réduite (en conservant le rapport d'aspect) avant d'être renvoyée. Réduit la taille du contexte dans les conversations IA. Non défini signifie aucun redimensionnement.

  • Type : nombre
  • Par défaut : false

• --screenshotMaxHeight/ --screenshot-max-height Hauteur maximale en pixels pour les captures d'écran. Si l'image capturée est plus haute, elle est réduite (en conservant le ratio d'aspect) avant d'être renvoyée. Peut être combiné avec --screenshot-max-width ; le plus petit facteur d'échelle l'emporte. Non défini signifie aucun redimensionnement.

  • Type : number
  • Par défaut : false

• --slim Expose un ensemble « allégé » de 3 outils couvrant uniquement la navigation, l'exécution de scripts et les captures d'écran. Utile pour les tâches de base du navigateur.

  • Type : boolean
  • Par défaut : false

• --redactNetworkHeaders/ --redact-network-headers Si vrai, masque certains en-têtes réseau considérés comme sensibles avant de les renvoyer au client.

  • Type : boolean
  • Par défaut : false

• --allowUnrestrictedPaths/ --allow-unrestricted-paths Si défini, désactive la restriction de chemin par défaut qui s'applique lorsque le client MCP ne négocie pas la capacité « roots ». Par défaut, les outils d'écriture de fichiers sont limités au répertoire temporaire du système d'exploitation lorsqu'aucune racine n'est configurée. Utilisez ceci uniquement lors de la connexion d'un client local de confiance qui n'implémente pas les racines MCP et nécessite un accès à des chemins en dehors du répertoire temporaire.

  • Type : boolean
  • Par défaut : false

Passez-les via la propriété args dans la configuration JSON. Par exemple :

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "chrome-devtools-mcp@latest",
        "--channel=canary",
        "--headless=true",
        "--isolated=true"
      ]
    }
  }
}

Connexion via WebSocket avec des en-têtes personnalisés

Vous pouvez vous connecter directement à un point de terminaison WebSocket Chrome et inclure des en-têtes personnalisés (par exemple, pour l'authentification) :

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "chrome-devtools-mcp@latest",
        "--wsEndpoint=ws://127.0.0.1:9222/devtools/browser/<id>",
        "--wsHeaders={\"Authorization\":\"Bearer YOUR_TOKEN\"}"
      ]
    }
  }
}

Pour obtenir le point de terminaison WebSocket d'une instance Chrome en cours d'exécution, visitez http://127.0.0.1:9222/json/version et recherchez le champ webSocketDebuggerUrl.

Vous pouvez également exécuter npx chrome-devtools-mcp@latest --help pour voir toutes les options de configuration disponibles.

Concepts

Sessions simultanées

La plupart des clients MCP démarrent un serveur Chrome DevTools MCP par conversation. Si votre client partage une seule instance de serveur entre des agents ou sous-agents simultanés, démarrez le serveur avec --experimentalPageIdRouting. Cela expose pageId sur les outils à portée de page afin que chaque agent puisse acheminer les appels d'outils vers l'onglet avec lequel il travaille.

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

Si vous exécutez plusieurs sessions client MCP indépendantes et souhaitez que chaque session lance son propre profil Chrome temporaire, passez également --isolated. Cela évite de partager le répertoire de données utilisateur Chrome DevTools MCP par défaut entre ces instances de serveur.

Répertoire de données utilisateur

chrome-devtools-mcp démarre une instance du canal stable de Chrome en utilisant le répertoire de données utilisateur suivant :

• Linux / macOS : $HOME/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL
• Windows : %HOMEPATH%/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL

Le répertoire de données utilisateur n'est pas effacé entre les exécutions et est partagé entre toutes les instances de chrome-devtools-mcp. Définissez l'option isolated sur true pour utiliser à la place un répertoire de données utilisateur temporaire qui sera automatiquement effacé après la fermeture du navigateur.

Connexion à une instance Chrome en cours d'exécution

Par défaut, le serveur Chrome DevTools MCP démarre une nouvelle instance Chrome avec un profil dédié. Cela peut ne pas être idéal dans toutes les situations :

• Si vous souhaitez conserver le même état d'application lorsque vous alternez entre les tests manuels du site et les tests pilotés par agent.
• Lorsque le MCP doit se connecter à un site Web. Certains comptes peuvent empêcher la connexion lorsque le navigateur est contrôlé via WebDriver (le mécanisme de lancement par défaut du serveur Chrome DevTools MCP).
• Si vous exécutez votre LLM dans un environnement sandbox, mais que vous souhaitez vous connecter à une instance Chrome qui s'exécute en dehors du sandbox.

Dans ces cas, démarrez d'abord Chrome et laissez le serveur Chrome DevTools MCP s'y connecter. Il y a deux façons de le faire :

• Connexion automatique (disponible dans Chrome 144) : idéal pour partager l'état entre les tests manuels et pilotés par agent.
• Connexion manuelle via le port de débogage distant : idéal lors de l'exécution dans un environnement sandbox.

Connexion automatique à une instance Chrome en cours d'exécution

Étape 1 : Configurer le débogage distant dans Chrome

Dans Chrome (>= M144), procédez comme suit pour configurer le débogage distant :

1. Accédez à chrome://inspect/#remote-debugging pour activer le débogage distant.
2. Suivez l'interface de dialogue pour autoriser ou refuser les connexions de débogage entrantes.

Étape 2 : Configurer le serveur Chrome DevTools MCP pour qu'il se connecte automatiquement à une instance Chrome en cours d'exécution

Pour connecter le serveur chrome-devtools-mcp à l'instance Chrome en cours d'exécution, utilisez l'argument de ligne de commande --autoConnect pour le serveur MCP.

L'extrait de code suivant est un exemple de configuration pour gemini-cli :

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

Étape 3 : Tester votre configuration

Assurez-vous que votre navigateur est en cours d'exécution. Ouvrez gemini-cli et exécutez l'invite suivante :

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

[!REMARQUE] L'option autoConnect nécessite que l'utilisateur démarre Chrome. Si l'utilisateur a plusieurs profils actifs, le serveur MCP se connectera au profil par défaut (tel que déterminé par Chrome). Le serveur MCP a accès à toutes les fenêtres ouvertes pour le profil sélectionné.

Le serveur Chrome DevTools MCP essaiera de se connecter à votre instance Chrome en cours d'exécution. Il affiche une boîte de dialogue demandant l'autorisation de l'utilisateur.

Cliquer sur Autoriser amène le serveur Chrome DevTools MCP à ouvrir developers.chrome.com et à prendre une trace de performance.

Connexion manuelle via le transfert de port

Vous pouvez vous connecter à une instance Chrome en cours d'exécution en utilisant l'option --browser-url. Ceci est utile si vous exécutez le serveur MCP dans un environnement sandbox qui ne permet pas de démarrer une nouvelle instance Chrome.

Voici un guide étape par étape sur la façon de se connecter à une instance Chrome en cours d'exécution :

Étape 1 : Configurer le client MCP

Ajoutez l'option --browser-url à la configuration de votre client MCP. La valeur de cette option doit être l'URL de l'instance Chrome en cours d'exécution. http://127.0.0.1:9222 est une valeur par défaut courante.

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "chrome-devtools-mcp@latest",
        "--browser-url=http://127.0.0.1:9222"
      ]
    }
  }
}

Étape 2 : Démarrer le navigateur Chrome

[!AVERTISSEMENT] L'activation du port de débogage distant ouvre un port de débogage sur l'instance de navigateur en cours d'exécution. Toute application sur votre machine peut se connecter à ce port et contrôler le navigateur. Assurez-vous de ne pas naviguer sur des sites Web sensibles lorsque le port de débogage est ouvert.

Démarrez le navigateur Chrome avec le port de débogage distant activé. Assurez-vous de fermer toutes les instances Chrome en cours d'exécution avant d'en démarrer une nouvelle avec le port de débogage activé. Le numéro de port que vous choisissez doit être le même que celui que vous avez spécifié dans l'option --browser-url de la configuration de votre client MCP.

Pour des raisons de sécurité, Chrome vous oblige à utiliser un répertoire de données utilisateur non par défaut lors de l'activation du port de débogage distant. Vous pouvez spécifier un répertoire personnalisé à l'aide de l'indicateur --user-data-dir. Cela garantit que votre profil de navigation habituel et vos données ne sont pas exposés à la session de débogage.

macOS

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

Linux

/usr/bin/google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable

Windows

"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="%TEMP%\chrome-profile-stable"

Étape 3 : Tester votre configuration

Après avoir configuré le client MCP et démarré le navigateur Chrome, vous pouvez tester votre configuration en exécutant une invite simple dans votre client MCP :

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

Votre client MCP doit se connecter à l'instance Chrome en cours d'exécution et recevoir un rapport de performance.

Si vous rencontrez des problèmes de transfert de port VM-hôte, consultez la section « Le débogage distant entre la machine virtuelle (VM) et l'hôte échoue » dans docs/troubleshooting.md.

Pour plus de détails sur le débogage distant, consultez la documentation Chrome DevTools.

Déboguer Chrome sur Android

Veuillez consulter ces instructions.

Limitations connues

Voir Dépannage.

Intégration en tant que sous-agent de navigateur

Si vous développez des outils agentiques et souhaitez fournir un sous-agent de navigateur intégré dans le cadre de votre produit, nous vous recommandons de vous appuyer sur Chrome DevTools pour les agents.

Pour une implémentation de référence, consultez la documentation de l'agent de navigateur Gemini CLI.