Connecter Gemini CLI à Chrome DevTools MCP

Gemini CLI peut-il piloter une page Chrome ?

Oui, si le projet expose les bons outils et que le compte et les règles autorisent leur utilisation. Gemini CLI est le client MCP. Chrome DevTools MCP lance un navigateur ou s’y connecte, puis expose des actions comme l’ouverture d’une URL et l’instantané d’accessibilité. L’authentification du modèle et la connexion au navigateur sont deux contrôles distincts. Après Connected, vérifiez l’état d’une page connue. Un utilisateur a signalé qu’une ancienne version de Gemini CLI échouait à se connecter alors qu’un autre client y arrivait. Commencez par identifier l’étape qui échoue. GitHub #178

Le catalogue d’extensions Gemini CLI référence Chrome DevTools MCP. Ici, une entrée explicite conserve les versions et les paramètres dans le projet. Guide MCP de Gemini CLI Configuration Chrome DevTools Gemini dans le navigateur

Points clés

• Déclarez Chrome DevTools MCP dans le projet et démarrez avec un profil isolé.

• Contrôlez la connexion avec gemini mcp list, puis les outils avec /mcp desc.

• Vérifiez l’URL finale et le titre dans la réponse de l’outil.

• Vérifiez séparément l’authentification, la confiance du dossier et l’approbation des appels.

Ce que prouvent la recherche et le navigateur

La recherche aide à trouver une annonce. Elle ne montre pas le compte de l’onglet ni son état après un clic. Un instantané montre ce qui est présent à l’écran sans établir qu’il s’agit de la dernière publication officielle. Choisissez l’outil selon le fait à vérifier. Recherche et contrôle du navigateur Rôle d’un agent IA

Fixer les versions dans un petit projet

Cet exemple tiré de la documentation fixe Gemini CLI 0.67.0 et Chrome DevTools MCP 1.12.0. Vérifiez les prérequis Node.js et Chrome, puis gardez le fichier de verrouillage. Chrome DevTools MCP v1.12.0

mkdir browser-mcp-check
cd browser-mcp-check
npm init -y
npm install --save-exact @google/gemini-cli@0.67.0 chrome-devtools-mcp@1.12.0
./node_modules/.bin/gemini --version
./node_modules/.bin/chrome-devtools-mcp --version

Ajoutez l’entrée à .gemini/settings.json. Indiquez le chemin absolu de l’exécutable local. Si le projet possède déjà des paramètres, fusionnez uniquement l’entrée du serveur.

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "/absolute/path/browser-mcp-check/node_modules/.bin/chrome-devtools-mcp",
      "args": ["--headless", "--isolated", "--no-usage-statistics"],
      "includeTools": ["new_page", "take_snapshot", "list_pages", "close_page"],
      "trust": false
    }
  }
}

includeTools filtre les outils exposés dans Gemini CLI. Ce réglage ne limite pas les domaines. --isolated crée un profil temporaire. Commencez par une page que vous contrôlez ou que vous êtes autorisé à consulter. Pour une session existante, configurez la connexion à part et vérifiez le compte. Le Codelab de Google utilise une application entière. Une page au titre et au lien connus suffit pour vérifier le démarrage. Connexion à un navigateur existant Codelab Google

La confiance accordée au dossier permet à Gemini de charger les paramètres du projet. Avec trust: false, les appels restent soumis à la politique active. Démarrez en mode interactif pour vérifier le serveur, l’action et l’URL si Gemini demande une approbation. Une règle ask_user refuse l’appel en mode non interactif. Pour restreindre les URL, configurez séparément Chrome DevTools MCP. L’option --allowed-url-pattern nécessite Chrome 149 ou une version ultérieure. Politique Gemini CLI Configuration de Chrome DevTools MCP

Vérifier la connexion, puis la page

Lancez ./node_modules/.bin/gemini mcp list dans le projet. Les paramètres locaux sont utilisables si le dossier est approuvé. Dans la session Gemini CLI, /mcp desc affiche les outils et leurs arguments. Configurez séparément l’accès au modèle. Authentification

Pour répéter la vérification, ouvrez un second terminal dans le projet et servez une page locale. Le titre attendu est « MCP browser check » et le lien pointe vers #details. Contrôlez les deux éléments dans le résultat de l’outil.

mkdir -p fixture
cat > fixture/index.html <<'HTML'
<!doctype html>
<meta charset="utf-8">
<title>MCP browser check</title>
<h1>MCP browser check</h1>
<a href="#details">Details</a>
<p id="details">Local fixture</p>
HTML
python3 -m http.server 8765 --bind 127.0.0.1 --directory fixture

Avec la version indiquée, transmettez à take_snapshot l’identifiant renvoyé par new_page dans pageId. Une redirection peut modifier l’URL finale. Vérifiez-la dans le résultat. Référence v1.12.0

Utilise le serveur MCP chrome-devtools pour ouvrir http://127.0.0.1:8765/. Donne l’ID de page, l’URL finale, le titre principal et le lien attendu. Prends l’instantané avec l’ID retourné. Si l’accès échoue, indique l’erreur. Ne saisis pas d’identifiants et ne modifie rien.

Situer la panne avant de changer les paramètres

Si le serveur ne se déclare pas, vérifiez portée, version et transport. Une personne a signalé qu’une ancienne version de Gemini CLI ne se connectait pas alors qu’un autre client y parvenait. Sur Apple Silicon, une autre a constaté que son PATH lançait Node pour Intel. Vérifiez l’exécutable utilisé et son architecture. Ces signalements concernent leurs installations. Issue originale Publication Reddit

Si la page s’ouvre mais que l’instantané échoue, lisez le schéma et reprenez l’ID de la réponse. Si une page de connexion apparaît, arrêtez et indiquez l’intervention nécessaire. Contrôler une session connectée

Garder une preuve reproductible

Notez les versions du client, du serveur et du navigateur, le périmètre, le mode, les outils, l’URL, l’ID et le résultat attendu. Indiquez l’étape où survient une validation ou une erreur. Première tâche web Choisir une connexion Le navigateur agentique

Pour lire l’état de Chrome depuis Gemini CLI, configurez le serveur dans le projet et ouvrez une page connue. Pour chaque nouvel outil, définissez un résultat que vous pourrez vérifier.

Secholar.L

Croissance et contenu chez Tabbit

Secholar.L rédige des guides pratiques sur les navigateurs IA et les workflows agentiques, en comparant les outils sur la base de recherches réelles et de sources vérifiables.