Cómo conectar Gemini CLI a Chrome DevTools MCP

¿Puede Gemini CLI controlar una página de Chrome?

Sí, si el proyecto expone las herramientas y la cuenta y la política permiten utilizarlas. Gemini CLI actúa como cliente. Chrome DevTools MCP abre o conecta el navegador y ofrece acciones como abrir URL y tomar instantáneas de accesibilidad. La autenticación del modelo y la conexión del navegador son comprobaciones distintas. Después de ver Connected, comprueba el estado de una página conocida. Un usuario informó de que una versión anterior de Gemini CLI no conectaba con el servidor, aunque otro cliente sí podía. Comprueba primero dónde falla la conexión. GitHub #178

El catálogo de extensiones de Gemini CLI incluye Chrome DevTools MCP. Aquí se usa una entrada de servidor explícita que deja visibles las versiones y los parámetros. Guía MCP de Gemini CLI Configuración de Chrome DevTools Gemini en el navegador

Puntos clave

• Registra Chrome DevTools MCP en el proyecto y usa un perfil aislado.

• Comprueba la conexión con gemini mcp list y las herramientas con /mcp desc.

• Contrasta la URL final y el título con el resultado de la herramienta.

• Verifica por separado la autenticación, la confianza del proyecto y los permisos de herramientas.

Qué demuestran la búsqueda y el navegador

Un resultado de búsqueda ayuda a encontrar un anuncio. No indica la cuenta de una pestaña ni su estado tras un clic. Una instantánea muestra el estado visible sin decidir si la fuente es la última versión oficial. Define qué quieres comprobar antes de elegir la herramienta. Búsqueda y control del navegador Qué hace un agente

Fija las versiones en un proyecto pequeño

Este ejemplo, basado en la documentación, fija Gemini CLI 0.67.0 y Chrome DevTools MCP 1.12.0. Consulta los requisitos de Node.js y Chrome y conserva el archivo de bloqueo. 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

Añade esta entrada a .gemini/settings.json. Sustituye la ruta por la ruta absoluta del ejecutable local. Si ya hay otros ajustes, incorpora solo la entrada del servidor.

{
  "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 limita las herramientas visibles en Gemini CLI, sin restringir los dominios. --isolated crea un perfil temporal. Empieza por una página bajo tu control o con acceso autorizado. Para usar una sesión existente, configura esa conexión aparte y verifica la cuenta. El Codelab de Google usa una aplicación completa; para comprobar el arranque basta una página con título y enlace conocidos. Conectar una sesión existente Codelab de Google

La confianza del espacio de trabajo permite cargar los ajustes del proyecto. Con trust: false, cada llamada sigue sujeta a la política activa. Empieza en modo interactivo y revisa el servidor, la acción y la URL si se solicita aprobación. Una regla ask_user deniega la llamada en modo no interactivo. Para restringir las URL, configura Chrome DevTools MCP por separado. La opción --allowed-url-pattern requiere Chrome 149 o posterior. Política de Gemini CLI Configuración de Chrome DevTools MCP

Comprueba la conexión y después la página

Ejecuta ./node_modules/.bin/gemini mcp list en el proyecto. Los ajustes del proyecto pueden cargar el servidor si confías en ese directorio. En Gemini CLI, escribe /mcp desc para consultar herramientas y argumentos. Configura el acceso al modelo por separado. Autenticación

Para repetir la comprobación, abre una segunda terminal en el proyecto y sirve una página local. El encabezado esperado es «MCP browser check» y el enlace apunta a #details. Comprueba ambos en la respuesta de la herramienta.

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

Con la versión fijada, pasa a take_snapshot el ID de new_page como pageId. Si hay una redirección, comprueba la URL final y el título devueltos. Referencia v1.12.0

Usa el servidor MCP chrome-devtools para abrir http://127.0.0.1:8765/. Devuelve el ID, la URL final, el título principal y el enlace esperado. Toma la instantánea con el ID devuelto. Si falla el acceso, devuelve el error. No introduzcas credenciales, envíes formularios ni cambies datos.

Encuentra dónde falla

Si no se registra, revisa alcance, versión y transporte. Un usuario comunicó que una versión antigua de Gemini CLI no conectaba mientras otro cliente sí. Otro usuario, en Apple Silicon, descubrió que el MCP arrancaba con Node para Intel debido a su PATH. Comprueba el ejecutable y su arquitectura antes de cambiar la configuración. Son casos de instalaciones concretas. Issue original Publicación original

Si la página abre pero falla la instantánea, comprueba el esquema y toma el ID de la respuesta. Si aparece una pantalla de inicio de sesión, detén el trabajo y registra la intervención necesaria. Verificar una sesión iniciada

Guarda un resultado que puedas reproducir

Anota versiones del cliente, servidor y navegador, alcance, modo, herramientas, URL, ID y resultado esperado. Indica en qué paso hubo una aprobación o un fallo. Primera tarea web Elegir una conexión Qué es un navegador agéntico

Para leer el estado de Chrome desde Gemini CLI, empieza por registrar el servidor en el proyecto y abrir una página conocida. Define un resultado verificable para cada herramienta que añadas.

Secholar.L

Crecimiento y contenido en Tabbit

Secholar.L escribe guías prácticas sobre navegadores con IA y flujos de trabajo con agentes, comparando herramientas con investigación real y fuentes verificables.