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, 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 del 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 de 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 activa de Chrome.

1. En el navegador Chrome en ejecución, navega a chrome://inspect/#remote-debugging y habilita Depuración remota.
2. Agrega --autoConnect a la configuración del 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"]

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 de 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 estos parámetros.

Opciones de captura de pantalla

Usa estas opciones para personalizar la forma en que el agente captura capturas de pantalla.

Opciones experimentales

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

Otras opciones

Usa estas opciones para configurar el registro o habilitar un conjunto simplificado de herramientas.

Variables de entorno

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

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