TabbitBlog

Cómo conectar Gemini CLI a Chrome DevTools MCP

Fija las versiones, registra el servidor en el proyecto y verifica el acceso con una instantánea de la página.

En este artículo
  1. ¿Puede Gemini CLI controlar una página de Chrome?
  2. Puntos clave
  3. Qué demuestran la búsqueda y el navegador
  4. Fija las versiones en un proyecto pequeño
  5. Comprueba la conexión y después la página
  6. Browser Agent nativo o la configuración MCP existente
  7. Usa Tabbit CLI para una sesión Tabbit iniciada en el mismo equipo
  8. Encuentra dónde falla
  9. Guarda un resultado que puedas reproducir

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

Sí, si tu cuenta de Gemini CLI sigue teniendo acceso. La documentación actual describe un Browser Agent integrado experimental respaldado por Chrome DevTools MCP y también permite configurar un servidor MCP independiente. Antes de abrir una página, comprueba qué perfil o sesión de Chrome usa cada ruta. El acceso a Gemini y el inicio de sesión del navegador son distintos. El plazo de algunos planes ya venció, así que confirma tu acceso. Un usuario informó de que una versión anterior de Gemini CLI no conectaba con DevTools MCP aunque otro cliente sí podía. Usa ese caso para localizar la etapa de un fallo. GitHub #178

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

El anuncio de ciclo de vida de Google determina quién puede seguir usando la configuración anterior. A 2026-11-09, ya pasó la fecha del 18 de junio de 2026 en que Gemini CLI dejó de atender a cuentas Google AI Pro/Ultra y al acceso gratuito de Gemini Code Assist for individuals. Google indica que las licencias Standard y Enterprise y las claves API de pago para Gemini o Gemini Enterprise Agent Platform conservan el acceso. Comprueba tu licencia antes de seguir esta guía. La documentación de navegador y MCP sigue disponible para las cuentas admitidas. Aviso de transición de Google Guía de migración

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.

Ilustración de un agente conectado a búsquedas, páginas y documentos
Ilustración de un agente conectado a búsquedas, páginas y documentos.

Qué demuestran la búsqueda y el navegador

PreguntaHerramientaEvidencia
¿Dónde están las notas de versión?Búsqueda webTítulo y enlace de la fuente
¿Qué muestra esta pestaña?MCP de navegadorURL e instantánea
¿Qué campo se modificó?MCP y escritura autorizadaAcción, ID y valor leído
¿Está registrado el MCP?Cliente Gemini CLIEstado en el proyecto correcto

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

EstadoQué confirmaSiguiente paso
Servidor ausente o desconectadoFalta revisar el registro o el transporteComprueba directorio, confianza, ejecutable y argumentos
Conectado sin herramientasEl servidor respondeRevisa el descubrimiento, includeTools y la política
Herramientas visibles pero no se pueden llamarEl cliente las ha descubiertoRevisa autenticación, aprobaciones y reglas
ID e instantánea coincidenteChrome llegó a la página esperadaComprueba URL final, título y enlace

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.

Browser Agent nativo o la configuración MCP existente

La documentación actual de Gemini CLI describe un browser_agent experimental que inicia el Chrome DevTools MCP incluido. Está desactivado de forma predeterminada, requiere Chrome 144 o posterior y pide consentimiento la primera vez. persistent usa un perfil de Gemini CLI, isolated crea uno temporal y existing se conecta a un Chrome en ejecución con la depuración remota activada. Es una ruta más directa que instalar el servidor por separado, pero sigue usando Chrome y no selecciona automáticamente tu perfil de Tabbit. Consulta la guía de Browser Agent y las notas de versión.

RutaQué usaCuándo elegirlaQué comprobar
Browser Agent integradoChrome DevTools MCP incluido y una sesión Chrome configuradaUsuario con acceso vigente a Gemini CLI que necesita sus herramientas oficialesVersión de Chrome, función activa, consentimiento, modo de sesión y cuenta
MCP de proyecto descrito abajoPaquete Chrome DevTools MCP explícito y configuración del proyectoConjunto de herramientas reproducible o servidor específico del proyectoCompatibilidad actual, confianza, aprobaciones y estado del servidor
Tabbit CLI desde un agente localInstrucciones de Tabbit Skill y lanzador Tabbit CLI instalado localmenteTarea en el mismo equipo que necesita una sesión Tabbit iniciadaDescubrimiento del skill, permiso de shell, acceso al lanzador y sesión del sitio

Usa Tabbit CLI para una sesión Tabbit iniciada en el mismo equipo

Si Gemini CLI se ejecuta en el equipo con Tabbit, puede descubrir Agent Skills desde ~/.agents/skills/ del usuario. Compruébalo con /skills list, pide a Gemini CLI que active Tabbit Skill y aprueba el acceso cuando te lo solicite. Esto solo confirma el descubrimiento. El proceso CLI también debe poder ejecutar el lanzador Tabbit local y llegar a la instancia cuya sesión ya está iniciada. Comprueba cada punto por separado. Un Gemini CLI remoto no alcanza automáticamente el Tabbit de tu escritorio; necesita una transferencia local compatible. Descubrimiento de skills de Gemini CLI Configuración de Tabbit CLI

Pide al agente que lea una página pública de notas de versión y deje un borrador. El prompt no depende de un comando /tabbit de Gemini:

Usa el Tabbit Skill instalado y Tabbit CLI desde esta sesión local de Gemini CLI. Abre la página de notas de versión en una pestaña de tarea separada. Lee solo la fecha y las funciones visibles de la versión actual. Crea un borrador llamado "Release notes review — draft 01" con versión, fecha, función, URL fuente y un elemento que requiera confirmación humana. No edites la página ni publiques el borrador. Muéstrame el borrador y los enlaces para revisarlos. Si falta el skill, el shell no puede ejecutar el lanzador Tabbit o la página está desconectada, indica qué comprobación falló y detente.

La pestaña de tarea es independiente de tu ventana normal de Tabbit. En este entorno se verificó que Tabbit CLI reutilizara una sesión iniciada con una página local de prueba; no se ejecutó desde Gemini CLI y no demuestra una integración Gemini-Tabbit. Usa esta vía solo tras comprobar el runtime y la cuenta locales. Para migrar, consulta la guía de Antigravity CLI; su navegador es distinto de la ruta de Tabbit CLI.

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.

Preguntas frecuentes

¿Gemini CLI puede controlar Chrome?

Los usuarios con acceso vigente a Gemini CLI pueden usar el Browser Agent integrado experimental o configurar un servidor MCP de navegador. El agente requiere Chrome 144 o posterior y consentimiento inicial; MCP sigue siendo una opción independiente.

¿La búsqueda web da acceso a una pestaña?

La búsqueda recupera información. El control requiere una herramienta de navegador, una página accesible y la sesión correspondiente.

¿Connected demuestra que Chrome abrió el sitio?

Confirma la conexión MCP. Abre una página y toma una instantánea para verificar que Chrome llegó al destino.

¿Puedo reutilizar mi perfil de Chrome?

El Browser Agent integrado puede conectarse a un Chrome activo en modo `existing` después de activar la depuración remota. Gemini CLI local también puede llamar a Tabbit CLI mediante un skill y un shell autorizados; es una ruta distinta.

¿Qué hago si Gemini CLI da un error de autenticación?

Primero confirma tu acceso actual, porque la transición de Google afectó a algunos planes de consumo. Después configura un método de autenticación compatible. El acceso al modelo y la conexión del navegador son comprobaciones distintas.

Da el siguiente paso

Deja que Tabbit trabaje junto a ti.

Investiga entre pestañas, automatiza el trabajo repetitivo del navegador y mantén todo el contexto al alcance.