Configuration

Matthias Rohmer

José Luis Zapata

Vous pouvez configurer les outils de développement Chrome pour que les agents personnalisent leur interaction avec le navigateur, les outils activés et la façon dont les données sont traitées.

Configurez le serveur en transmettant des indicateurs de ligne de commande dans le tableau args de votre fichier de configuration du client MCP (Model Context Protocol). Il s'agit généralement du fichier config.json.

Par exemple, pour exécuter Chrome en mode headless et utiliser le canal Canary, utilisez la configuration suivante :

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

Scénarios de configuration courants

Les scénarios suivants décrivent les méthodes courantes de configuration des outils pour les développeurs Chrome pour les agents.

Exécuter en mode sans interface graphique

Pour effectuer des tâches en arrière-plan sans fenêtre de navigateur visible, exécutez Chrome en mode headless (sans interface utilisateur). Ajoutez l'option --headless aux arguments de votre serveur.

Se connecter à une session de navigateur existante

Par défaut, les Outils de développement pour les agents démarrent une nouvelle instance Chrome. Toutefois, vous pouvez connecter votre agent à une session de navigateur existante. Cela est utile si votre agent doit examiner un problème dans une session que vous avez déjà démarrée (par exemple, si vous êtes déjà connecté).

Vous pouvez vous connecter à une session existante de deux manières :

Connexion automatique (Chrome 144 et versions ultérieures)

Si vous utilisez l'option --autoConnect, le serveur MCP se connecte automatiquement à une instance Chrome active.

1. Dans votre navigateur Chrome en cours d'exécution, accédez à chrome://inspect/#remote-debugging et activez le débogage à distance.
2. Ajoutez --autoConnect à votre configuration MCP : json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
3. Lorsque l'agent tente de se connecter, Chrome affiche une boîte de dialogue demandant l'autorisation. Cliquez sur Autoriser.

Connexion manuelle

Si vous ne pouvez pas utiliser --autoConnect (par exemple, dans un environnement de bac à sable), vous pouvez démarrer Chrome manuellement avec un port de débogage et vous connecter à l'aide de --browser-url.

1. Démarrez Chrome à partir du terminal avec le débogage à distance activé et un répertoire de données utilisateur personnalisé.
   • macOS : shell /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
   • Windows : shell start chrome --remote-debugging-port=9222 --user-data-dir=%TEMP%\chrome-profile-stable
   • Linux : shell google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
2. Configurez votre agent pour qu'il se connecte à ce port : json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

Autoriser l'accès aux fichiers en dehors du répertoire temporaire

Les outils qui lisent ou écrivent des fichiers (par exemple, pour enregistrer des captures d'écran, des traces ou charger des extensions) ne peuvent accéder qu'aux chemins d'accès situés dans les racines de l'espace de travail configuré. Le serveur utilise les racines fournies par votre client MCP via la fonctionnalité de racines MCP, ainsi que tous les répertoires que vous transmettez avec --filesystemRoot (alias --workspace). Si votre client ne fournit pas de racines et que vous ne définissez pas --filesystemRoot, l'accès aux fichiers est limité au répertoire temporaire de l'OS. Les requêtes pour d'autres chemins d'accès échouent avec une erreur Access denied: ... is not within any of the configured workspace roots.

Pour autoriser l'accès à un répertoire de projet, ajoutez --filesystemRoot aux arguments de votre serveur. Vous pouvez répéter l'option pour autoriser plusieurs répertoires :

"args": ["chrome-devtools-mcp@latest", "--filesystemRoot=/path/to/project"]

Documentation de référence sur les options de configuration

Les sections suivantes listent les options de configuration disponibles. Pour connaître les dernières options et mises à jour, consultez le dépôt GitHub des outils pour les développeurs Chrome MCP.

Options de connexion

Utilisez ces options pour configurer la façon dont le serveur se connecte à Chrome.

Options de lancement du navigateur

Ces options s'appliquent lorsque le serveur MCP démarre Chrome.

Options de sécurité et de confidentialité

Utilisez ces options pour gérer les paramètres de sécurité et la confidentialité des données.

Catégories de fonctionnalités

Vous pouvez activer ou désactiver des groupes d'outils à l'aide de ces options.

Options de capture d'écran

Utilisez ces options pour personnaliser la façon dont l'agent effectue des captures d'écran.

Options expérimentales

Utilisez ces options pour activer les fonctionnalités expérimentales en cours de développement.

Autres options

Utilisez ces options pour configurer la journalisation, le routage des pages et les cartes sources, ou pour activer un ensemble d'outils simplifiés.

Variables d'environnement

Vous pouvez également utiliser les variables d'environnement suivantes pour configurer le serveur :

• CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS : si cette option est définie, la collecte des statistiques d'utilisation est désactivée (équivaut à --no-usage-statistics).
• CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS : si cette option est définie, les vérifications périodiques des mises à jour sont désactivées.
• CI : si cette option est définie, la collecte des statistiques d'utilisation est désactivée.
• NODE_DEBUG : définissez la valeur sur * pour activer la journalisation détaillée du débogage (fonctionne avec --logFile).