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 de Protocolo de Contexto de Modelo (MCP), brindando 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 uso sin MCP.

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

Características clave

• Obtén información de rendimiento: Utiliza Chrome DevTools para grabar trazas y extraer información de rendimiento accionable.
• Depuración avanzada del navegador: Analiza solicitudes de red, toma capturas de pantalla y revisa mensajes de la consola del navegador (con seguimientos de pila con mapas de origen).
• Automatización confiable. Utiliza puppeteer para automatizar acciones en Chrome y espera 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 desees compartir con los clientes MCP.

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

Las herramientas de rendimiento pueden enviar URLs de trazas a la API de Google CrUX para obtener datos de experiencia de usuarios reales. Esto ayuda a proporcionar una imagen de rendimiento holística al presentar datos de campo junto con datos de laboratorio. Estos datos son recopilados por el Chrome User Experience Report (CrUX). Para deshabilitar 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 de forma predeterminada. 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 está deshabilitada si se establecen las variables de entorno CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS o CI.

Verificaciones de actualizaciones

De forma predeterminada, el servidor verifica periódicamente el registro npm en busca de actualizaciones y registra una notificación cuando hay una versión más reciente disponible. Puedes deshabilitar estas verificaciones de actualizaciones estableciendo 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

Agrega la siguiente configuración a tu cliente MCP:

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

[!NOTA] Usar chrome-devtools-mcp@latest garantiza que tu cliente MCP siempre utilice la última versión del servidor Chrome DevTools MCP.

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

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

Consulta la Referencia de herramientas reducida.

Configuración del cliente MCP

Para instrucciones de configuración específicas de tu editor o agente (por ejemplo, Antigravity, Claude Code, Cursor, VS Code), consulta nuestra Guía de configuraciones de clientes.

Tu primer prompt

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.

[!NOTA] El servidor MCP iniciará el navegador automáticamente una vez que el cliente MCP utilice una herramienta que requiera una instancia de 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. Consulta la Referencia de herramientas completa para obtener una lista completa de todas las capacidades MCP compatibles.

Configuración

Encuentra la lista completa de parámetros del servidor (por ejemplo, --headless, --isolated, --slim) y cómo configurar conexiones WebSocket en la Guía de configuración.

Uso avanzado

Para funciones avanzadas como manejo de sesiones concurrentes, directorios de datos de usuario persistentes, conexión a una instancia de Chrome en ejecución en lugar de iniciar una nueva, o depuración en Android, consulta nuestra Guía de uso avanzado.

Integración como subagente de navegador

Si estás desarrollando herramientas de agentes y deseas proporcionar un subagente de navegador integrado como parte de tu producto, recomendamos construir sobre Chrome DevTools para agentes.

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