Conecta tu agente de código a tu Chrome

El tracker nunca toca un navegador. Rellenar formularios de directorios es tarea de tu agente de código, y para eso necesita una integración que maneje un Chrome que puedas ver y supervisar. El BROWSER-SETUP.md del kit describe dos formas de establecer esa conexión; esta guía resume ambas, los permisos de macOS que pueden aparecer y la prueba de humo que te dice que la conexión es real. El principio en todo momento: un agente, un producto, una pestaña asignada, una conexión duradera por lote.

Modo A: conectar el Chrome que ya usas

Este modo necesita Chrome 144 o más reciente.

1. Comprueba chrome://version, luego abre chrome://inspect/#remote-debugging en la instancia de Chrome que quieres que use el agente y activa ahí la depuración remota. Si ese control no aparece, no busques un flag oculto: usa el modo B.
2. Configura la integración MCP de tu agente para ejecutar Chrome DevTools MCP con --autoConnect. Como definición genérica de servidor MCP queda así; el archivo y el formato de configuración de tu agente pueden variar, así que sigue su propia interfaz:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest", "--autoConnect", "--no-usage-statistics", "--no-performance-crux"]
    }
  }
}

3. Lanza desde el agente una acción inofensiva en el navegador y aprueba el aviso de conexión de Chrome en la ventana prevista. Un proceso MCP en ejecución no demuestra nada por sí solo; una pestaña visible que se mueve, sí.

Si falta npx, instala Node.js. La primera llamada descarga el paquete; cuando todo funcione, fija la versión que probaste. Como esta integración controla un navegador con sesiones iniciadas, cierra antes las pestañas sensibles ajenas, nunca copies el perfil a otra máquina y nunca hagas commit de cookies. Si tu agente ya tiene una integración de navegador que funciona, quédate con ella.

Modo B: un perfil CDP local dedicado

Algunas integraciones quieren un endpoint HTTP que hable el Chrome DevTools Protocol en lugar de auto-connect. Para ellas, lanza un Chrome aparte con su propio directorio de datos de usuario dentro de tu espacio de trabajo privado. En macOS:

mkdir -p .browser/chrome
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --remote-debugging-address=127.0.0.1 \
  --remote-debugging-port=9222 \
  --user-data-dir="$PWD/.browser/chrome" about:blank

Windows (PowerShell), desde tu workspace:

$chrome = Join-Path $env:ProgramFiles "Google/Chrome/Application/chrome.exe"
if (!(Test-Path $chrome)) { $chrome = Join-Path ${env:ProgramFiles(x86)} "Google/Chrome/Application/chrome.exe" }
if (!(Test-Path $chrome)) { $chrome = Join-Path $env:LOCALAPPDATA "Google/Chrome/Application/chrome.exe" }
$profile = Join-Path (Get-Location) ".browser/chrome"
& $chrome --remote-debugging-address=127.0.0.1 --remote-debugging-port=9222 "--user-data-dir=$profile" about:blank

En Linux, sustituye el binario de Chrome instalado. Inicia sesión tú mismo en esa ventana en las cuentas de directorios, Google y buzón que necesites. El directorio aparte no es opcional: desde Chrome 136, los flags de depuración heredados se ignoran para el perfil por defecto. En la configuración MCP, sustituye --autoConnect por --browserUrl=http://127.0.0.1:9222; nunca combines los dos modos.

Mantén el puerto local: nunca lo expongas, lo tuneles ni reutilices el endpoint de otra persona, y comprueba que el listener está ligado a 127.0.0.1. Cierra este Chrome al terminar la sesión; el perfil conserva tus sesiones para la próxima vez. Si el 9222 está ocupado, averigua qué programa lo tiene: no mates navegadores ajenos ni borres bloqueos de perfil para forzar una conexión.

Permisos de macOS, solo donde hagan falta

Una conexión solo CDP normalmente no necesita permisos extra. Si tu agente hace clic de forma nativa o usa AppleScript, macOS preguntará en Ajustes del Sistema → Privacidad y seguridad: Automatización para que la app anfitriona controle Chrome, Accesibilidad para entrada nativa de teclado y ratón, Grabación de pantalla solo si la integración captura la pantalla. Aprueba la aplicación anfitriona real (terminal, editor o app del agente), y cuenta con que la propia aprobación de depuración remota de Chrome vuelva a aparecer tras cada reconexión: es un control independiente, y ninguna configuración puede prometer «permitir una vez para siempre».

La prueba de humo antes de cualquier envío

Antes de que el agente toque un formulario real, pídele que abra una pestaña en blanco nueva, navegue a la portada pública de un directorio, lea el titular principal y te diga qué pestaña ha usado. Mira la misma ventana. Después inicia sesión en un directorio objetivo y haz que el agente inspeccione el menú de la cuenta para confirmar la identidad correcta: completar OAuth no demuestra que haya sesión iniciada en el destino. Registra solo apto/no apto y una nota no sensible en onboarding.json o SESSION.md, nunca una transcripción del navegador.

Para los formularios, las reglas son las que usaría una persona cuidadosa: leer las etiquetas actuales antes de localizar campos, rellenar valores aprobados, quitar el foco y releer, revisar los contadores de caracteres, y nunca tratar una llamada de herramienta exitosa como prueba de que la página guardó.

Cuando algo sale mal

El kit incluye una tabla de resolución de problemas; los casos más frecuentes son:

• Se mueve la ventana de Chrome equivocada: para, verifica la instancia seleccionada y el modo de conexión.
• Aparece un aviso en cada acción: la herramienta probablemente se reinicia en cada llamada; reutiliza una sola conexión.
• OAuth funciona pero el sitio te muestra como anónimo: inspecciona la cuenta del destino antes de enviar nada.
• CAPTCHA o 2FA: lo completas tú; el agente registra prepared_needs_human y no intenta evadirlo.
• Timeout tras enviar: busca primero en el panel del directorio y por el nombre de tu producto; un timeout describe el navegador, no el servidor.

La comparación con un agente de navegador independiente está en el artículo sobre las tres vías; la configuración por agente está en las páginas de Claude Code, Codex y Cursor.