Chrome DevTools MCP

Chrome DevTools para agentes

Chrome DevTools para agentes (chrome-devtools-mcp) permite que tu agente de codificación (como Antigravity, Claude, Cursor o Copilot) controle e inspeccione un navegador Chrome en vivo. Actúa como un servidor del Protocolo de Contexto de Modelo (MCP), dando a tu asistente de codificación con IA acceso a todo el poder de Chrome DevTools para automatización confiable, depuración en profundidad y análisis de rendimiento. También se proporciona una CLI para usar sin MCP.

Referencia de herramientas | Registro de cambios | Contribuciones | Solución de problemas | Principios de diseño

Características principales

• Obtén información de rendimiento: Usa Chrome DevTools para grabar trazas y extraer información procesable sobre el rendimiento.
• Depuración avanzada del navegador: Analiza solicitudes de red, toma capturas de pantalla y revisa los mensajes de la consola del navegador (con trazas de pila mapeadas al código fuente).
• Automatización confiable. Usa puppeteer para automatizar acciones en Chrome y esperar automáticamente los resultados de las acciones.

Avisos legales

chrome-devtools-mcp expone el contenido de la instancia del navegador a los clientes MCP permitiéndoles inspeccionar, depurar y modificar cualquier dato en el navegador o DevTools. Evita compartir información sensible o personal que no quieras compartir con los clientes MCP.

chrome-devtools-mcp solo es compatible oficialmente con Google Chrome y Chrome for Testing. Otros navegadores basados en Chromium pueden funcionar, pero no está garantizado, y podrías encontrar comportamientos inesperados. Úsalo bajo tu propia discreción. Estamos comprometidos a proporcionar correcciones y soporte para la última versión de Extended Stable Chrome.

Las herramientas de rendimiento pueden enviar URLs de trazas a la API de Google CrUX para obtener datos de experiencia de usuario real. Esto ayuda a proporcionar una imagen holística del rendimiento al presentar datos de campo junto con datos de laboratorio. Estos datos son recopilados por el https://developer.chrome.com/docs/crux. Para desactivar esto, ejecuta con la bandera --no-performance-crux.

Estadísticas de uso

Google recopila estadísticas de uso (como tasas de éxito de invocación de herramientas, latencia e información del entorno) para mejorar la confiabilidad y el rendimiento de Chrome DevTools MCP.

La recopilación de datos está habilitada por defecto. Puedes optar por no participar pasando la bandera --no-usage-statistics al iniciar el servidor:

"args": ["-y", "chrome-devtools-mcp@latest", "--no-usage-statistics"]

Google maneja estos datos de acuerdo con la Política de Privacidad de Google.

La recopilación de estadísticas de uso de Google para Chrome DevTools MCP es independiente de las estadísticas de uso del navegador Chrome. Optar por no participar en las métricas de Chrome no te excluye automáticamente de esta herramienta, y viceversa.

La recopilación se desactiva si las variables de entorno CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS o CI están configuradas.

Verificaciones de actualización

Por defecto, el servidor verifica periódicamente el registro de npm en busca de actualizaciones y registra una notificación cuando una versión más reciente está disponible. Puedes desactivar estas verificaciones de actualización configurando la variable de entorno CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS.

Requisitos

• Node.js versión LTS.
• Chrome versión estable actual o más reciente.
• npm

Primeros pasos

Añade la siguiente configuración a tu cliente MCP:

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

[!NOTE] Usar chrome-devtools-mcp@latest asegura que tu cliente MCP siempre usará la última versión del servidor MCP de Chrome DevTools.

Si solo te interesa realizar tareas básicas de navegador, usa el modo --slim:

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

Consulta la Referencia de herramientas Slim.

Configuración del cliente MCP

amp mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--browser-url=http://127.0.0.1:9222"
      ]
    }
  }
}

claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest

/plugin marketplace add ChromeDevTools/chrome-devtools-mcp

/plugin install chrome-devtools-mcp@chrome-devtools-plugins

codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

[mcp_servers.chrome-devtools]
command = "cmd"
args = [
    "/c",
    "npx",
    "-y",
    "chrome-devtools-mcp@latest",
]
env = { SystemRoot="C:\\Windows", PROGRAMFILES="C:\\Program Files" }
startup_timeout_ms = 20_000

cmd mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest

copilot

/mcp add

code --add-mcp '{"name":"io.github.ChromeDevTools/chrome-devtools-mcp","command":"npx","args":["-y","chrome-devtools-mcp"],"env":{}}'

code --add-mcp '{"""name""":"""io.github.ChromeDevTools/chrome-devtools-mcp""","""command""":"""npx""","""args""":["""-y""","""chrome-devtools-mcp"""]}'

droid mcp add chrome-devtools "npx -y chrome-devtools-mcp@latest"

# Either MCP only:
gemini mcp add chrome-devtools npx chrome-devtools-mcp@latest
# Or as a Gemini extension (MCP+Skills):
gemini extensions install --auto-update https://github.com/ChromeDevTools/chrome-devtools-mcp

gemini mcp add -s user chrome-devtools npx chrome-devtools-mcp@latest

grok mcp add chrome-devtools npx chrome-devtools-mcp@latest

mcp-proxy --transport streamablehttp --port 8080 -- npx -y chrome-devtools-mcp@latest

[[mcp_servers]]
name = "chrome-devtools"
transport = "stdio"
command = "npx"
args = ["chrome-devtools-mcp@latest"]

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "chrome-devtools": {
      "type": "local",
      "command": ["npx", "-y", "chrome-devtools-mcp@latest"]
    }
  }
}

qodercli mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

qodercli mcp add -s user chrome-devtools -- npx chrome-devtools-mcp@latest

Ingresa el siguiente prompt en tu Cliente MCP para verificar que todo funcione:

Check the performance of https://developers.chrome.com

Tu cliente MCP debería abrir el navegador y grabar una traza de rendimiento.

[!NOTE] El servidor MCP iniciará el navegador automáticamente una vez que el cliente MCP use una herramienta que requiera una instancia del navegador en ejecución. Conectarse al servidor Chrome DevTools MCP por sí solo no iniciará el navegador automáticamente.

Herramientas

Si encuentras algún problema, consulta nuestra guía de solución de problemas.

• Automatización de entrada (10 herramientas)
  • click
  • drag
  • fill
  • fill_form
  • handle_dialog
  • hover
  • press_key
  • type_text
  • upload_file
  • click_at
• Automatización de navegación (6 herramientas)
  • close_page
  • list_pages
  • navigate_page
  • new_page
  • select_page
  • wait_for
• Emulación (2 herramientas)
  • emulate
  • resize_page
• Rendimiento (3 herramientas)
  • performance_analyze_insight
  • performance_start_trace
  • performance_stop_trace
• Red (2 herramientas)
  • get_network_request
  • list_network_requests
• Depuración (8 herramientas)
  • evaluate_script
  • get_console_message
  • lighthouse_audit
  • list_console_messages
  • take_screenshot
  • take_snapshot
  • screencast_start
  • screencast_stop
• Memoria (12 herramientas)
  • take_heapsnapshot
  • close_heapsnapshot
  • compare_heapsnapshots
  • get_heapsnapshot_class_nodes
  • get_heapsnapshot_details
  • get_heapsnapshot_dominators
  • get_heapsnapshot_duplicate_strings
  • get_heapsnapshot_edges
  • get_heapsnapshot_object_details
  • get_heapsnapshot_retainers
  • get_heapsnapshot_retaining_paths
  • get_heapsnapshot_summary
• Extensiones (5 herramientas)
  • install_extension
  • list_extensions
  • reload_extension
  • trigger_extension_action
  • uninstall_extension
• Terceros (2 herramientas)
  • execute_3p_developer_tool
  • list_3p_developer_tools
• WebMCP (2 herramientas)
  • execute_webmcp_tool
  • list_webmcp_tools

Configuración

El servidor Chrome DevTools MCP admite las siguientes opciones de configuración:

• --autoConnect/ --auto-connect Si se especifica, se conecta automáticamente a un navegador (Chrome 144+) que se ejecuta localmente desde el directorio de datos de usuario identificado por el parámetro de canal (el canal predeterminado es estable). Requiere que el servidor de depuración remota esté iniciado en la instancia de Chrome a través de chrome://inspect/#remote-debugging.

  • Tipo: boolean
  • Predeterminado: false

• --browserUrl/ --browser-url, -u Conectarse a una instancia de Chrome en ejecución y depurable (p. ej., http://127.0.0.1:9222). Para más detalles, consulta: https://github.com/ChromeDevTools/chrome-devtools-mcp#connecting-to-a-running-chrome-instance.

  • Tipo: string
  • Predeterminado: false

• --wsEndpoint/ --ws-endpoint, -w Endpoint WebSocket para conectarse a una instancia de Chrome en ejecución (p. ej., ws://127.0.0.1:9222/devtools/browser/). Alternativa a --browserUrl.

  • Tipo: string
  • Predeterminado: false

• --wsHeaders/ --ws-headers Cabeceras personalizadas para la conexión WebSocket en formato JSON (p. ej., '{"Authorization":"Bearer token"}'). Solo funciona con --wsEndpoint.

  • Tipo: string
  • Predeterminado: false

• --headless Si se ejecuta en modo headless (sin interfaz de usuario).

  • Tipo: boolean
  • Predeterminado: false

• --executablePath/ --executable-path, -e Ruta al ejecutable de Chrome personalizado.

  • Tipo: string
  • Predeterminado: false

• --isolated Si se especifica, crea un directorio temporal de datos de usuario que se limpia automáticamente después de cerrar el navegador. El valor predeterminado es false.

  • Tipo: boolean
  • Predeterminado: false

• --userDataDir/ --user-data-dir Ruta al directorio de datos de usuario para Chrome. El valor predeterminado es $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE

  • Tipo: string
  • Predeterminado: false

• --channel Especifica un canal de Chrome diferente que se debe usar. El valor predeterminado es la versión del canal estable.

  • Tipo: string
  • Opciones: canary, dev, beta, stable
  • Predeterminado: false

• --logFile/ --log-file Ruta a un archivo para escribir registros de depuración. Establece la variable de entorno DEBUG a * para habilitar registros detallados. Útil para enviar informes de errores.

  • Tipo: string
  • Predeterminado: false

• --viewport Tamaño de ventana inicial para las instancias de Chrome iniciadas por el servidor. Por ejemplo, 1280x720. En modo headless, el tamaño máximo es 3840x2160px.

  • Tipo: string
  • Predeterminado: false

• --proxyServer/ --proxy-server Configuración del servidor proxy para Chrome, pasada como --proxy-server al iniciar el navegador. Consulta https://www.chromium.org/developers/design-documents/network-settings/ para más detalles.

  • Tipo: string
  • Predeterminado: false

• --acceptInsecureCerts/ --accept-insecure-certs Si está habilitado, ignora los errores relativos a certificados autofirmados y caducados. Úsalo con precaución.

  • Tipo: boolean
  • Predeterminado: false

• --experimentalPageIdRouting/ --experimental-page-id-routing Si se expone pageId en las herramientas con ámbito de página y se enrutan las solicitudes por ID de página (útil para sesiones de agente concurrentes).

  • Tipo: boolean
  • Predeterminado: false

• --experimentalDevtools/ --experimental-devtools Si se habilita la automatización sobre los objetivos de DevTools

  • Tipo: boolean
  • Predeterminado: false

• --experimentalVision/ --experimental-vision Si se habilitan herramientas basadas en coordenadas como click_at(x,y). Normalmente requiere un modelo de uso de computadora capaz de producir coordenadas precisas al observar capturas de pantalla.

  • Tipo: boolean
  • Predeterminado: false

• --memoryDebugging/ --memory-debugging, -experimentalMemory Si se habilitan las herramientas de depuración de memoria.

  • Tipo: boolean
  • Predeterminado: false

• --experimentalStructuredContent/ --experimental-structured-content Si se debe generar contenido con formato estructurado.

  • Tipo: boolean
  • Predeterminado: false

• --experimentalIncludeAllPages/ --experimental-include-all-pages Si se deben incluir todo tipo de páginas, como webviews o páginas en segundo plano, como páginas.

  • Tipo: boolean
  • Predeterminado: false

• --experimentalScreencast/ --experimental-screencast Expone herramientas experimentales de screencast (requiere ffmpeg). Instala ffmpeg https://www.ffmpeg.org/download.html y asegúrate de que esté disponible en el PATH del servidor MCP.

  • Tipo: boolean
  • Predeterminado: false

• --experimentalFfmpegPath/ --experimental-ffmpeg-path Ruta al ejecutable de ffmpeg para la grabación de screencast.

  • Tipo: string
  • Predeterminado: false

• --categoryExperimentalWebmcp/ --category-experimental-webmcp Establécelo en true para habilitar la depuración de herramientas WebMCP. Requiere Chrome 149+ con los siguientes flags: --enable-features=WebMCP,DevToolsWebMCPSupport

  • Tipo: boolean
  • Predeterminado: false

• --chromeArg/ --chrome-arg Argumentos adicionales para Chrome. Solo se aplica cuando Chrome es iniciado por chrome-devtools-mcp.

  • Tipo: array
  • Predeterminado: false

• --blockedUrlPattern/ --blocked-url-pattern Restringe el acceso de red del navegador bloqueando los patrones de URL especificados (usa https://urlpattern.spec.whatwg.org/). Se desconecta silenciosamente de los objetivos con URLs bloqueadas al conectarse y bloquea las solicitudes en tiempo de ejecución (incluidas las navegaciones y los subrecursos). Acepta un array de patrones.

  • Tipo: array
  • Predeterminado: false

• --allowedUrlPattern/ --allowed-url-pattern Restringe el acceso de red del navegador permitiendo solo los patrones de URL especificados (usa https://urlpattern.spec.whatwg.org/). Requiere Chrome 149+. Se desconecta silenciosamente de los objetivos con URLs no permitidas al conectarse y bloquea las solicitudes en tiempo de ejecución (incluidas las navegaciones y los subrecursos). Acepta un array de patrones.

  • Tipo: array
  • Predeterminado: false

• --ignoreDefaultChromeArg/ --ignore-default-chrome-arg Deshabilita explícitamente los argumentos predeterminados para Chrome. Solo se aplica cuando Chrome es iniciado por chrome-devtools-mcp.

  • Tipo: array
  • Predeterminado: false

• --categoryEmulation/ --category-emulation Establécelo en false para excluir las herramientas relacionadas con la emulación.

  • Tipo: boolean
  • Predeterminado: true

• --categoryPerformance/ --category-performance Establécelo en false para excluir las herramientas relacionadas con el rendimiento.

  • Tipo: boolean
  • Predeterminado: true

• --categoryNetwork/ --category-network Establécelo en false para excluir las herramientas relacionadas con la red.

  • Tipo: boolean
  • Predeterminado: true

• --categoryExtensions/ --category-extensions Establécelo en true para incluir herramientas relacionadas con las extensiones. Nota: Esta función actualmente solo es compatible con una conexión de tubería. autoConnect, browserUrl y wsEndpoint no son compatibles con esta función hasta que se lance la versión 149.

  • Tipo: boolean
  • Predeterminado: false

• --categoryExperimentalThirdParty/ --category-experimental-third-party Establécelo en true para habilitar las herramientas de desarrollo de terceros expuestas por la propia página inspeccionada

  • Tipo: boolean
  • Predeterminado: false

• --performanceCrux/ --performance-crux Establécelo en false para deshabilitar el envío de URLs desde las trazas de rendimiento a la API de CrUX para obtener datos de rendimiento de campo.

  • Tipo: boolean
  • Predeterminado: true

• --usageStatistics/ --usage-statistics Establécelo en false para optar por no participar en la recopilación de estadísticas de uso. Google recopila datos de uso para mejorar la herramienta, gestionados bajo la Política de Privacidad de Google (https://policies.google.com/privacy). Esto es independiente de las métricas del navegador Chrome. Se deshabilita si las variables de entorno CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS o CI están configuradas.

  • Tipo: boolean
  • Predeterminado: true

• --screenshotFormat/ --screenshot-format Anula el formato de salida predeterminado utilizado por take_screenshot cuando el llamante no especifica uno. JPEG y WebP son ~3-5 veces más pequeños que PNG, lo que ayuda a reducir el tamaño del contexto en las conversaciones de IA. Dejarlo sin configurar conserva el valor predeterminado existente ("png").

  • Tipo: string
  • Opciones: jpeg, png, webp
  • Predeterminado: false

• --screenshotQuality/ --screenshot-quality Anula la calidad de compresión predeterminada (0-100) utilizada por take_screenshot para JPEG y WebP cuando el llamante no especifica una. Los valores más bajos significan archivos más pequeños. Se ignora para PNG. Dejarlo sin configurar conserva el valor predeterminado de Puppeteer.

  • Tipo: number
  • Predeterminado: false

• --screenshotMaxWidth/ --screenshot-max-width Ancho máximo en píxeles para las capturas de pantalla. Si la imagen capturada es más ancha, se reduce (conservando la relación de aspecto) antes de ser devuelta. Reduce el tamaño del contexto en las conversaciones de IA. Dejarlo sin configurar significa que no se redimensiona.

  • Tipo: number
  • Predeterminado: false

• --screenshotMaxHeight/ --screenshot-max-height Altura máxima en píxeles para las capturas de pantalla. Si la imagen capturada es más alta, se reduce (conservando la relación de aspecto) antes de devolverla. Se puede combinar con --screenshot-max-width; gana el factor de escala más pequeño. Sin establecer significa que no se redimensiona.

  • Tipo: number
  • Por defecto: false

• --slim Expone un conjunto "reducido" de 3 herramientas que cubren solo navegación, ejecución de scripts y capturas de pantalla. Útil para tareas básicas del navegador.

  • Tipo: boolean
  • Por defecto: false

• --redactNetworkHeaders/ --redact-network-headers Si es true, oculta algunas de las cabeceras de red consideradas sensibles antes de devolverlas al cliente.

  • Tipo: boolean
  • Por defecto: false

• --allowUnrestrictedPaths/ --allow-unrestricted-paths Si se establece, desactiva la restricción de ruta predeterminada que se aplica cuando el cliente MCP no negocia la capacidad de raíces. Por defecto, las herramientas de escritura de archivos están restringidas al directorio temporal del sistema operativo cuando no se configuran raíces. Úselo solo cuando conecte un cliente local de confianza que no implemente raíces MCP y requiera acceso a rutas fuera del directorio temporal.

  • Tipo: boolean
  • Por defecto: false

Páselos a través de la propiedad args en la configuración JSON. Por ejemplo:

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

Conexión mediante WebSocket con cabeceras personalizadas

Puede conectarse directamente a un endpoint WebSocket de Chrome e incluir cabeceras personalizadas (por ejemplo, para autenticación):

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "chrome-devtools-mcp@latest",
        "--wsEndpoint=ws://127.0.0.1:9222/devtools/browser/<id>",
        "--wsHeaders={\"Authorization\":\"Bearer YOUR_TOKEN\"}"
      ]
    }
  }
}

Para obtener el endpoint WebSocket de una instancia de Chrome en ejecución, visite http://127.0.0.1:9222/json/version y busque el campo webSocketDebuggerUrl.

También puede ejecutar npx chrome-devtools-mcp@latest --help para ver todas las opciones de configuración disponibles.

Conceptos

Sesiones concurrentes

La mayoría de los clientes MCP inician un servidor Chrome DevTools MCP por conversación. Si su cliente comparte una única instancia de servidor entre agentes o subagentes concurrentes, inicie el servidor con --experimentalPageIdRouting. Esto expone pageId en las herramientas de ámbito de página para que cada agente pueda enrutar las llamadas a la herramienta a la pestaña con la que está trabajando.

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--experimentalPageIdRouting"
      ]
    }
  }
}

Si ejecuta múltiples sesiones de cliente MCP independientes y desea que cada sesión lance su propio perfil temporal de Chrome, pase también --isolated. Esto evita compartir el directorio de datos de usuario predeterminado de Chrome DevTools MCP entre esas instancias de servidor.

Directorio de datos de usuario

chrome-devtools-mcp inicia una instancia del canal estable de Chrome utilizando el siguiente directorio de datos de usuario:

• Linux / macOS: $HOME/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL
• Windows: %HOMEPATH%/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL

El directorio de datos de usuario no se limpia entre ejecuciones y se comparte entre todas las instancias de chrome-devtools-mcp. Establezca la opción isolated a true para usar en su lugar un directorio de datos de usuario temporal que se limpiará automáticamente después de que se cierre el navegador.

Conexión a una instancia de Chrome en ejecución

Por defecto, el servidor Chrome DevTools MCP iniciará una nueva instancia de Chrome con un perfil dedicado. Esto podría no ser ideal en todas las situaciones:

• Si desea mantener el mismo estado de la aplicación al alternar entre pruebas manuales del sitio y pruebas dirigidas por agentes.
• Cuando el MCP necesita iniciar sesión en un sitio web. Algunas cuentas pueden impedir el inicio de sesión cuando el navegador se controla mediante WebDriver (el mecanismo de lanzamiento predeterminado para el servidor Chrome DevTools MCP).
• Si está ejecutando su LLM dentro de un entorno aislado (sandbox), pero desea conectarse a una instancia de Chrome que se ejecuta fuera del entorno aislado.

En estos casos, inicie Chrome primero y permita que el servidor Chrome DevTools MCP se conecte a él. Hay dos maneras de hacerlo:

• Conexión automática (disponible en Chrome 144): mejor para compartir el estado entre pruebas manuales y dirigidas por agentes.
• Conexión manual mediante puerto de depuración remota: mejor cuando se ejecuta dentro de un entorno aislado.

Conexión automática a una instancia de Chrome en ejecución

Paso 1: Configurar la depuración remota en Chrome

En Chrome (>= M144), haga lo siguiente para configurar la depuración remota:

1. Navegue a chrome://inspect/#remote-debugging para habilitar la depuración remota.
2. Siga la interfaz de usuario del diálogo para permitir o rechazar las conexiones de depuración entrantes.

Paso 2: Configurar el servidor Chrome DevTools MCP para que se conecte automáticamente a una instancia de Chrome en ejecución

Para conectar el servidor chrome-devtools-mcp a la instancia de Chrome en ejecución, use el argumento de línea de comandos --autoConnect para el servidor MCP.

El siguiente fragmento de código es un ejemplo de configuración para gemini-cli:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
    }
  }
}

Paso 3: Probar su configuración

Asegúrese de que su navegador esté en ejecución. Abra gemini-cli y ejecute el siguiente prompt:

Check the performance of https://developers.chrome.com

[!NOTE] La opción autoConnect requiere que el usuario inicie Chrome. Si el usuario tiene múltiples perfiles activos, el servidor MCP se conectará al perfil predeterminado (según lo determine Chrome). El servidor MCP tiene acceso a todas las ventanas abiertas para el perfil seleccionado.

El servidor Chrome DevTools MCP intentará conectarse a su instancia de Chrome en ejecución. Muestra un diálogo solicitando permiso al usuario.

Al hacer clic en Permitir, el servidor Chrome DevTools MCP abrirá developers.chrome.com y realizará un trazado de rendimiento.

Conexión manual mediante reenvío de puertos

Puede conectarse a una instancia de Chrome en ejecución utilizando la opción --browser-url. Esto es útil si está ejecutando el servidor MCP en un entorno aislado que no permite iniciar una nueva instancia de Chrome.

Aquí tiene una guía paso a paso sobre cómo conectarse a una instancia de Chrome en ejecución:

Paso 1: Configurar el cliente MCP

Añada la opción --browser-url a la configuración de su cliente MCP. El valor de esta opción debe ser la URL de la instancia de Chrome en ejecución. http://127.0.0.1:9222 es un valor predeterminado común.

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "chrome-devtools-mcp@latest",
        "--browser-url=http://127.0.0.1:9222"
      ]
    }
  }
}

Paso 2: Iniciar el navegador Chrome

[!WARNING] Habilitar el puerto de depuración remota abre un puerto de depuración en la instancia del navegador en ejecución. Cualquier aplicación en su máquina puede conectarse a este puerto y controlar el navegador. Asegúrese de no estar navegando por sitios web sensibles mientras el puerto de depuración esté abierto.

Inicie el navegador Chrome con el puerto de depuración remota habilitado. Asegúrese de cerrar cualquier instancia de Chrome en ejecución antes de iniciar una nueva con el puerto de depuración habilitado. El número de puerto que elija debe ser el mismo que especificó en la opción --browser-url en la configuración de su cliente MCP.

Por razones de seguridad, Chrome requiere que use un directorio de datos de usuario no predeterminado al habilitar el puerto de depuración remota. Puede especificar un directorio personalizado usando la bandera --user-data-dir. Esto asegura que su perfil de navegación habitual y sus datos no estén expuestos a la sesión de depuración.

macOS

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable

Linux

/usr/bin/google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable

Windows

"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="%TEMP%\chrome-profile-stable"

Paso 3: Probar su configuración

Después de configurar el cliente MCP e iniciar el navegador Chrome, puede probar su configuración ejecutando un prompt simple en su cliente MCP:

Check the performance of https://developers.chrome.com

Su cliente MCP debería conectarse a la instancia de Chrome en ejecución y recibir un informe de rendimiento.

Si tiene problemas de reenvío de puertos de VM a host, consulte la sección "La depuración remota entre la máquina virtual (VM) y el host falla" en docs/troubleshooting.md.

Para más detalles sobre la depuración remota, consulte la documentación de Chrome DevTools.

Depuración de Chrome en Android

Consulte estas instrucciones.

Limitaciones conocidas

Consulte Solución de problemas.

Integración como subagente de navegador

Si está desarrollando herramientas agénticas y desea proporcionar un subagente de navegador integrado como parte de su producto, recomendamos construir sobre Chrome DevTools para agentes.

Para una implementación de referencia, consulte la documentación del agente de navegador de Gemini CLI.