Chrome DevTools MCP
Esta es una bifurcación de aprendizaje personal de ChromeDevTools/chrome-devtools-mcp. Añade un tutorial en lenguaje sencillo y una demostración del mundo real que te guían a través de la herramienta desde cero; no se requiere conocimiento previo de Chrome, DevTools, MCP o la CLI.
¿Eres nuevo aquí? Empieza con
demo-health-check/↓
✦ Añadido en esta bifurcación: dos demostraciones de extremo a extremo
Si términos como servidor MCP, Protocolo Chrome DevTools, seguimiento de rendimiento o Lighthouse te resultan desconocidos, no estás solo y estás en el lugar correcto.
Esta bifurcación añade dos demostraciones independientes; juntas cubren 26 de las 29 herramientas de chrome-devtools-mcp.
Demostración 1 — demo-health-check/ — Auditoría de salud de un sitio web (CNN.com)
Archivo | Qué es | Empieza aquí si… |
Un proyecto práctico: genera un Informe de Salud del Sitio Web real usando 7 de las 29 herramientas, con 6 instrucciones de copiar y pegar | Quieres aprender haciendo | |
Un informe de salud completo para CNN.com — Core Web Vitals, 52 proveedores externos, 3906ms de layout thrashing, problemas de caché, errores de consola | Quieres ver cómo es el resultado | |
Guía paso a paso anotada: cada herramienta utilizada, cada entrada/salida, cada obstáculo — la historia completa detrás del informe | Quieres entender cómo funciona | |
Referencia completa de las 29 herramientas, arquitectura, modos de conexión, demonio/CLI y configuración | Quieres la imagen completa |
Demostración 2 — demo-shopping/ — Flujo de trabajo de compras con agentes (saucedemo.com)
Un agente de IA ejecuta un flujo completo de compra de comercio electrónico de forma autónoma: inicio de sesión → navegación → comparación entre pestañas → carrito → emulación móvil → pago → confirmación de pedido. Cubre las 18 herramientas de interacción no utilizadas en la Demostración 1.
Archivo | Qué es |
Hallazgos: telemetría rota, peculiaridad de eventos de React, línea base de memoria heap, pedido de $140.34 | |
Guía completa anotada de las 18 herramientas con entradas, salidas y obstáculos | |
Captura de pantalla de "¡Gracias por su pedido!" | |
Volcado de memoria V8 de 6.7 MB — abrir en Chrome DevTools → Memory |
¿Qué más puedes construir con esto? → use-cases.md
Más de 50 flujos de trabajo de agentes en QA, rendimiento, SEO, comercio electrónico, investigación, seguridad y productividad personal, con las herramientas específicas que utiliza cada uno y por qué CDP supera a las alternativas.
Qué hace realmente esta herramienta
chrome-devtools-mcp le da a tu asistente de IA (Claude, Gemini, Cursor, Copilot…) la capacidad de controlar e inspeccionar un navegador Chrome real. En lugar de solo leer y escribir archivos de texto, tu IA puede:
Abrir páginas web y tomar capturas de pantalla
Leer la estructura de la página como un lector de pantalla
Recopilar errores de consola en vivo y solicitudes de red
Ejecutar auditorías de Lighthouse (accesibilidad, SEO, mejores prácticas)
Registrar seguimientos de rendimiento y medir Core Web Vitals (LCP, CLS, INP)
Interactúas con ella mediante lenguaje sencillo — "Comprueba el rendimiento de esta página" — y la IA determina cuál de las 29 herramientas llamar.
No se necesita experiencia
La demostración fue diseñada para alguien que nunca ha abierto Chrome DevTools, nunca ha usado un servidor MCP y apenas ha comenzado a usar un asistente de codificación de IA. Cada concepto se explica desde los principios básicos antes de ser utilizado.
Chrome DevTools MCP
chrome-devtools-mcp permite que tu agente de codificación (como Gemini, Claude, Cursor o Copilot) controle e inspeccione un navegador Chrome en vivo. Actúa como un servidor de Protocolo de Contexto de Modelo (MCP), dando a tu asistente de codificación de IA acceso a todo el poder de Chrome DevTools para una automatización confiable, depuración profunda y análisis de rendimiento.
Referencia de herramientas | Registro de cambios | Contribución | Solución de problemas | Principios de diseño
Características clave
Obtén información sobre el rendimiento: Utiliza Chrome DevTools para registrar seguimientos y extraer información de rendimiento procesable.
Depuración avanzada del navegador: Analiza solicitudes de red, toma capturas de pantalla y comprueba mensajes de la consola del navegador (con seguimientos de pila mapeados por fuente).
Automatización confiable. Utiliza puppeteer para automatizar acciones en Chrome y esperar automáticamente los resultados de las acciones.
Descargos de responsabilidad
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 admite oficialmente solo Google Chrome y Chrome for Testing. Otros navegadores basados en Chromium pueden funcionar, pero esto no está garantizado y podrías encontrar un comportamiento inesperado. Úsalo bajo tu propia discreción. Nos comprometemos a proporcionar correcciones y soporte para la última versión de Extended Stable Chrome.
Las herramientas de rendimiento pueden enviar URL de seguimiento a la API de Google CrUX para obtener datos de experiencia de usuario real. 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 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 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 se deshabilita si se establecen las variables de entorno CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS o CI.
Requisitos
Node.js v20.19 o una versión LTS de mantenimiento más reciente.
Chrome versión estable actual o más reciente.
Primeros pasos
Agrega la siguiente configuración a tu cliente MCP:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}Usarchrome-devtools-mcp@latest asegura que tu cliente MCP siempre usará la última versión del servidor Chrome DevTools MCP.
Si estás interesado en realizar solo 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 Slim.
Configuración del cliente MCP
amp mcp add chrome-devtools -- npx chrome-devtools-mcp@latestPara usar el servidor Chrome DevTools MCP, sigue las instrucciones de la documentación de Antigravity para instalar un servidor MCP personalizado. Agrega la siguiente configuración a la configuración de servidores MCP:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": [
"chrome-devtools-mcp@latest",
"--browser-url=http://127.0.0.1:9222",
"-y"
]
}
}
}Esto hará que el servidor Chrome DevTools MCP se conecte automáticamente al navegador que está usando Antigravity. Si no estás usando el puerto 9222, asegúrate de ajustarlo en consecuencia.
Chrome DevTools MCP no iniciará la instancia del navegador automáticamente usando este enfoque porque el servidor Chrome DevTools MCP se conecta al navegador integrado de Antigravity. Si el navegador aún no se está ejecutando, debes iniciarlo primero haciendo clic en el icono de Chrome en la esquina superior derecha.
Instalar vía CLI (solo MCP)
Usa la CLI de Claude Code para agregar el servidor Chrome DevTools MCP (guía):
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latestInstalar como complemento (MCP + Skills)
Si ya tenías instalado Chrome DevTools MCP anteriormente para Claude Code, asegúrate de eliminarlo primero de tus archivos de instalación y configuración.
Para instalar Chrome DevTools MCP con habilidades, agrega el registro del mercado en Claude Code:
/plugin marketplace add ChromeDevTools/chrome-devtools-mcpLuego, instala el complemento:
/plugin install chrome-devtools-mcpReinicia Claude Code para que se carguen el servidor MCP y las habilidades (verifica con /skills).
Si la instalación del complemento falla con un errorFailed to clone repository (por ejemplo, problemas de conectividad HTTPS detrás de un firewall corporativo), consulta la guía de solución de problemas para obtener soluciones alternativas, o usa el método de instalación CLI anterior.
codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latestEn Windows 11
Configura la ubicación de instalación de Chrome y aumenta el tiempo de espera de inicio actualizando .codex/config.toml y agregando los siguientes parámetros env y startup_timeout_ms:
[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_000Inicia Copilot CLI:
copilotInicia el diálogo para agregar un nuevo servidor MCP ejecutando:
/mcp addConfigura los siguientes campos y presiona CTRL+S para guardar la configuración:
Nombre del servidor:
chrome-devtoolsTipo de servidor:
[1] LocalComando:
npx -y chrome-devtools-mcp@latest
Haz clic en el botón para instalar:
O instala manualmente:
Sigue la guía de instalación de MCP, con la configuración estándar anterior. También puedes instalar el servidor Chrome DevTools MCP usando la CLI de VS Code:
Para macOS y Linux:
code --add-mcp '{"name":"io.github.ChromeDevTools/chrome-devtools-mcp","command":"npx","args":["-y","chrome-devtools-mcp"],"env":{}}'Para Windows (PowerShell):
code --add-mcp '{"""name""":"""io.github.ChromeDevTools/chrome-devtools-mcp""","""command""":"""npx""","""args""":["""-y""","""chrome-devtools-mcp"""]}'Haz clic en el botón para instalar:
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/az9713/chrome-devtools-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server