Configuración

Matthias Rohmer

José Luis Zapata

Puedes configurar las Herramientas para desarrolladores de Chrome para que los agentes personalicen la forma en que interactúan con el navegador, qué herramientas están habilitadas y cómo se controlan los datos.

Configura el servidor pasando marcas de línea de comandos en el array args de tu archivo de configuración del cliente del Protocolo de contexto del modelo (MCP). Por lo general, este es el archivo config.json.

Por ejemplo, para ejecutar Chrome en modo sin interfaz gráfica y usar el canal Canary, usa la siguiente configuración:

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

Situaciones de configuración comunes

En las siguientes situaciones, se describen formas comunes de configurar las Herramientas para desarrolladores de Chrome para agentes.

Ejecutar en modo sin interfaz gráfica

Para realizar tareas en segundo plano sin una ventana del navegador visible, ejecuta Chrome en modo sin interfaz gráfica (sin IU). Agrega la marca --headless a los argumentos del servidor.

Conéctate a una sesión de navegador existente

De forma predeterminada, las Herramientas para desarrolladores para agentes inician una nueva instancia de Chrome. Sin embargo, puedes conectar tu agente a una sesión del navegador existente. Esto es útil si el agente necesita investigar un problema en una sesión que ya iniciaste (por ejemplo, si ya accediste).

Puedes conectarte a una sesión existente de dos maneras:

Conexión automática (Chrome 144 y versiones posteriores)

Si usas la marca --autoConnect, el servidor de MCP se conecta automáticamente a una instancia de Chrome activa.

1. En el navegador Chrome en ejecución, navega a chrome://inspect/#remote-debugging y habilita Remote Debugging.
2. Agrega --autoConnect a tu configuración de MCP: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
3. Cuando el agente intenta conectarse, Chrome muestra un diálogo en el que se solicita permiso. Haz clic en Permitir.

Conexión manual

Si no puedes usar --autoConnect (por ejemplo, en un entorno de zona de pruebas), puedes iniciar Chrome de forma manual con un puerto de depuración y conectarte con --browser-url.

1. Inicia Chrome desde la terminal con la depuración remota habilitada y un directorio de datos del usuario personalizado.
   • macOS: shell /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
   • Windows: shell start chrome --remote-debugging-port=9222 --user-data-dir=%TEMP%\chrome-profile-stable
   • Linux: shell google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
2. Configura tu agente para que se conecte a este puerto: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

Permite el acceso a archivos fuera del directorio temporal

Las herramientas que leen o escriben archivos (por ejemplo, guardar capturas de pantalla, registros o cargar extensiones) solo pueden acceder a rutas dentro de las raíces del espacio de trabajo configurado. El servidor usa las raíces que tu cliente de MCP proporciona a través de la capacidad de raíces de MCP, además de los directorios que pasas con --filesystemRoot (alias --workspace). Si tu cliente no proporciona raíces y no configuras --filesystemRoot, el acceso a los archivos se limita al directorio temporal del SO. Las solicitudes de otras rutas de acceso fallan con un error Access denied: ... is not within any of the configured workspace roots.

Para permitir el acceso a un directorio del proyecto, agrega --filesystemRoot a los argumentos del servidor. Puedes repetir la marca para permitir varios directorios:

"args": ["chrome-devtools-mcp@latest", "--filesystemRoot=/path/to/project"]

Referencia de las opciones de configuración

En las siguientes secciones, se enumeran las marcas de configuración disponibles. Para conocer las opciones y actualizaciones más recientes, consulta el repositorio de GitHub del MCP de las Herramientas para desarrolladores de Chrome.

Opciones de conexión

Usa estas opciones para configurar cómo se conecta el servidor a Chrome.

Opciones de inicio del navegador

Estas opciones se aplican cuando el servidor de MCP inicia Chrome.

Opciones de seguridad y privacidad

Usa estas opciones para administrar la configuración de seguridad y la privacidad de los datos.

Categorías de funciones

Puedes habilitar o inhabilitar grupos de herramientas con estas marcas.

Opciones de captura de pantalla

Usa estas opciones para personalizar la forma en que el agente captura las pantallas.

Opciones experimentales

Usa estas opciones para habilitar las funciones experimentales que están en desarrollo.

Otras opciones

Usa estas opciones para configurar el registro, el enrutamiento de páginas y los mapas de origen, o bien para habilitar un conjunto de herramientas simplificado.

Variables de entorno

También puedes usar las siguientes variables de entorno para configurar el servidor:

• CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: Si se establece, inhabilita la recopilación de estadísticas de uso (equivalente a --no-usage-statistics).
• CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS: Si se establece, inhabilita las verificaciones periódicas de actualizaciones.
• CI: Si se configura, inhabilita la recopilación de estadísticas de uso.
• NODE_DEBUG: Se establece en * para habilitar el registro de depuración detallado (funciona junto con --logFile).