Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Connecter votre agent IA à votre navigateur personnel avec la connexion automatique

Matthias Rohmer

José Luis Zapata

Connectez votre agent d'IA directement à votre instance de navigateur active grâce à la fonctionnalité de connexion automatique. Votre agent peut ainsi contourner les limites du bac à sable en héritant de vos onglets actuels, de vos extensions de navigateur et de l'état de votre application en direct.

En héritant du contexte de votre workflow, votre agent peut passer de l'écriture de code au débogage de l'état de votre navigateur en direct sans perdre les données de session. Cela est utile lorsque vous avez déjà atteint un état d'application spécifique (tel qu'un processus de paiement complexe ou une erreur reproduite manuellement) et que vous souhaitez que votre agent prenne en charge l'investigation technique sans avoir à réexécuter ces étapes manuellement.

Avant d'activer la connexion automatique, tenez compte des points suivants :

Sécurité et confidentialité : lorsque la connexion automatique est active, votre agent a accès à toutes les données de votre profil de navigateur, y compris les onglets ouverts, le stockage de session, le stockage local, les cookies et d'autres données exposées via les API JavaScript.
Données envoyées à Google : le serveur Chrome DevTools pour les agents s'exécute en tant que processus local. Toutefois, par défaut, il envoie les données suivantes à Google, quel que soit le mode de connexion :
- Statistiques d'utilisation, telles que les taux de réussite des appels d'outils, la latence, et les informations sur l'environnement. Pour désactiver cette option, utilisez l'option --no-usage-statistics ou définissez la variable d'environnement CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS.
- URL des traces de performances, qui sont envoyées à l'API rapport UX Chrome (CrUX) pour récupérer les données d'expérience utilisateur réelles. Pour désactiver cette option, utilisez l'option --no-performance-crux.
Pour en savoir plus, consultez Options de sécurité et de confidentialité.
Confiance et invites : n'utilisez ce mode qu'avec les agents auxquels vous faites confiance et soyez prudent avec les informations que vous incluez dans les invites.

Prérequis

Avant d'utiliser la fonctionnalité de connexion automatique, assurez-vous de disposer des éléments suivants :

Chrome 144 ou version ultérieure : la connexion automatique nécessite des protocoles de débogage modernes disponibles dans les versions actuelles de Chrome.
Canal Chrome approprié : votre agent se connecte à la version stable de Chrome par défaut. Pour utiliser Canary ou Beta, spécifiez le canal dans votre configuration.
Débogage à distance activé : activez manuellement le pont entre votre navigateur et l'agent.
Configuration correcte : vous devez mettre à jour la configuration MCP pour inclure l'option --autoConnect. Pour en savoir plus, consultez Configuration.

Configurer la connexion automatique

Pour configurer la fonctionnalité de connexion automatique sur votre serveur MCP, procédez comme suit :

Dans votre navigateur Chrome en cours d'exécution, accédez à chrome://inspect/#remote-debugging et activez le débogage à distance.
Mettez à jour votre configuration MCP pour inclure l'option --autoConnect :
```
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
    }
  }
}
```
Pour désactiver l'envoi de statistiques d'utilisation et d'URL de traces de performances à Google, ajoutez également les options --no-usage-statistics et --no-performance-crux à args.
Demandez à votre agent d'interagir avec votre application Chrome ouverte. Lorsque Chrome vous demande l'autorisation d'autoriser la session, cliquez sur Autoriser.

Votre agent utilise désormais le serveur MCP pour interagir avec votre application Chrome en cours d'exécution. Pour en savoir plus sur les options de configuration, consultez le guide de configuration.

Cas d'utilisation de la connexion automatique

La connexion automatique vous permet d'utiliser des outils ou des états qui ne peuvent pas être utilisés sur des sessions Chrome en bac à sable. Par exemple, au lieu de demander à votre agent de se connecter, ce qui échoue souvent, vous pouvez accéder vous-même à la page et vous connecter. Ensuite, demandez à votre agent de prendre le relais.

Les sections suivantes incluent quelques exemples de cas d'utilisation de la fonctionnalité de connexion automatique.

Déboguer les tableaux de bord authentifiés

Les outils internes et les tableaux de bord privés se trouvent souvent derrière des couches complexes d'authentification unique (SSO) ou de réseau privé virtuel (VPN). Un navigateur en bac à sable nécessite généralement une connexion que votre agent ne peut pas contourner. Avec la connexion automatique, votre agent hérite de votre session active.

Exemple de prompt :

I have my company's staging dashboard open in the next tab. Can you look at the
User Analytics chart, find the SVG element for the Friday data point, and tell
me why the tooltip isn't appearing on hover?

Exemple d'exécution de l'agent : votre agent identifie votre processus Chrome existant, trouve l'onglet actif et inspecte l'arborescence d'accessibilité pour localiser les éléments. Il peut également utiliser des API JavaScript pour évaluer des conflits spécifiques.

Corriger en direct votre onglet actuel

Évitez de reproduire manuellement les erreurs. Au lieu de traduire les étapes de reproduction en un nouveau prompt pour un agent en bac à sable, vous pouvez demander à votre agent de corriger le bug sur la page active où vous l'avez déjà rencontré.