Verbind je codingagent met je Chrome

Aanbevolen setup: Voor de beste resultaten met LaunchRepo raden we sterk aan om altijd Claude Code CLI of Codex CLI in een terminal te gebruiken, en niet de desktop-app van Claude of Codex. Dit is onze aanbevolen workflow, geen garantie op andere rechten of ononderbroken uitvoering.

Gebruik Chrome DevTools MCP via remote debugging in Chrome, met een actuele LTS-versie van Node.js, npm en Google Chrome. Het lokale dashboard bewaart je records; je agent bestuurt Chrome. Begin met één worker en houd zijn MCP-verbinding tijdens de hele run open. Gebruik geen transports via browserextensies en geen alternatieve integraties voor browserbesturing.

Kies je setup

• Chrome 144+: auto-connect werkt op Windows, macOS en Linux.
• macOS: controleer de rechten van Terminal.
• Auto-connect niet beschikbaar, of een aparte worker nodig: gebruik een apart profiel voor macOS, Windows of Linux.
• Voordat je indient: voer de verbindingstest uit.

Controleer node --version, npm --version en chrome://version. Gebruik op Windows de native Windows-versies van Node/npm en Chrome; WSL vraagt om een aparte verbindingssetup.

Verbind je bestaande Chrome

1. Open in Chrome 144+ chrome://inspect/#remote-debugging en schakel remote debugging in. Ontbreekt die optie, gebruik dan een toegestaan apart profiel zoals hieronder beschreven.
2. Registreer Chrome DevTools MCP in de MCP-instellingen van je agent. Dit algemene JSON-voorbeeld is voor macOS/Linux; je agent gebruikt mogelijk een ander configuratieformaat:

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

Gebruik voor Windows "command": "cmd" en deze argumenten:

["/c", "npx", "-y", "chrome-devtools-mcp@latest", "--autoConnect", "--no-usage-statistics", "--no-performance-crux"]

3. Laat de agent een onschuldige browseractie uitvoeren en keur de verbindingsvraag van Chrome goed in het juiste venster. Voer daarna de test hieronder uit.

Bij de eerste aanroep wordt het pakket gedownload. Zet na de setup een geteste versie vast. Zie de officiële documentatie over configuratie en clientsetup.

Apart profiel: kies je besturingssysteem

Voer dit uit vanuit je privéwerkruimte, buiten gedeelde of gesynchroniseerde mappen. Laat Git het profiel negeren: het bevat je inlogsessies. Log zelf in op de benodigde accounts. Chrome 136+ vereist voor deze debugging-flags een ander profiel dan het standaardprofiel.

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

$launchrepoChrome = @(
  "$env:ProgramFiles\Google\Chrome\Application\chrome.exe",
  "${env:ProgramFiles(x86)}\Google\Chrome\Application\chrome.exe",
  "$env:LOCALAPPDATA\Google\Chrome\Application\chrome.exe"
) | Where-Object { Test-Path $_ } | Select-Object -First 1
if (-not $launchrepoChrome) { throw 'Locate Google Chrome first' }
New-Item -ItemType Directory -Force '.browser/chrome' | Out-Null
$launchrepoProfile = (Resolve-Path '.browser/chrome').Path
Start-Process -FilePath $launchrepoChrome -ArgumentList "--remote-debugging-address=127.0.0.1 --remote-debugging-port=9222 --user-data-dir=`"$launchrepoProfile`" about:blank"

Linux

launchrepo_chrome=$(command -v google-chrome || command -v google-chrome-stable)
if [ -z "$launchrepo_chrome" ]; then
  echo "Install or locate Google Chrome first."
else
  mkdir -p .browser/chrome
  "$launchrepo_chrome" \
    --remote-debugging-address=127.0.0.1 \
    --remote-debugging-port=9222 \
    --user-data-dir="$PWD/.browser/chrome" about:blank
fi

Laat de terminal waarmee je Chrome hebt gestart open. Vervang --autoConnect in de MCP-argumenten door --browserUrl=http://127.0.0.1:9222; combineer die twee nooit. Houd de poort lokaal en stel hem nooit via een tunnel openbaar beschikbaar. Controleer de listener: lsof -nP -iTCP:9222 -sTCP:LISTEN op macOS, ss -ltnp 'sport = :9222' op Linux of Get-NetTCPConnection -State Listen -LocalPort 9222 | Select-Object LocalAddress, OwningProcess op Windows. Alleen loopback-adressen zijn acceptabel. Bezet een ander programma de poort, kies dan een vrije poort en werk beide configuraties bij. Beëindig nooit browsers die er niets mee te maken hebben en verwijder nooit actieve profielvergrendelingen.

macOS-rechten

Controleer de app die MCP start: Terminal, iTerm of je editor- of agent-app. Weigert macOS de toegang tot beschermde Chrome-bestanden:

1. Open Systeeminstellingen → Privacy en beveiliging → Volledige schijftoegang.
2. Voeg precies die host-app toe via +, authenticeer je en schakel hem in.
3. Sluit de app volledig af, open hem opnieuw, maak opnieuw verbinding en herhaal de test.

Dit is een controle van rechten, geen algemene vereiste voor CDP. Werkt de verbinding, geef dan niet onnodig ruimere toegang. Een verbinding die alleen CDP gebruikt, heeft normaal gesproken geen rechten voor Toegankelijkheid, Automatisering of Schermopname nodig. De verbindingsgoedkeuring van Chrome staat daar los van en kan na een herstart opnieuw verschijnen.

Test de verbinding

Vraag je agent om https://example.com in een nieuw tabblad te openen, de paginatitel en de hoofdkop te lezen en aan te geven welk tabblad het is. Houd dat venster in de gaten. Een draaiend MCP-proces op zich bewijst niets. Log daarna in bij de beoogde directory en controleer met welke identiteit je daar werkelijk bent ingelogd; een geslaagde OAuth-stap alleen bewijst nog niet dat je bent ingelogd. Controleer je mailbox binnen de afgesproken rechten.

Laat de agent daarna navigator.webdriver op hetzelfde tabblad evalueren. Dat moet false zijn. Is het true, dan mist je MCP-configuratie --autoConnect (of --browserUrl bij een apart profiel) en heeft Chrome DevTools MCP een eigen automatiserings-Chrome gestart. Botcontroles zoals Cloudflare Turnstile blijven dan eindeloos “verifiëren” en tonen nooit een uitdaging die je zelf kunt oplossen. Herstel de configuratie, start de agentsessie opnieuw en herhaal de test. Verberg de vlag nooit met stealth-flags of -scripts.

Sla alleen geslaagd/mislukt en niet-gevoelige notities op in onboarding.json of SESSION.md. Kopieer geen cookies, authenticatielinks of browsertranscripten. Los CAPTCHA en 2FA zelf op. Krijg je een time-out na Submit, controleer dan eerst het platform voordat je het opnieuw probeert. Beweegt het verkeerde venster, stop dan en controleer de verbinding. Zonder deze test kunnen deze instructies niet garanderen dat jouw specifieke combinatie van besturingssysteem en agent werkt.

Twee workers en vensters opruimen

De runplanner begint met 10 inzendingen en maximaal 2 workers. Elke worker heeft een eigen platformtoewijzing, Chrome-profiel, poort en MCP-verbinding nodig. Gebruik bijvoorbeeld .browser/worker-1 op 9222 en .browser/worker-2 op 9223. Test elke worker afzonderlijk. Kan de host workers niet naar aparte verbindingen routeren, gebruik er dan één.

Geef elke inzending een eigen venster. Sla na de bevestiging het bewijs en de uitkomst op en sluit dan alleen dat venster en de login- en verificatietabbladen die erbij horen. Laat persoonlijke vensters, gedeelde inboxen, het dashboard, niet-opgeslagen formulieren en overdrachten aan jou open. Kan MCP het venster niet sluiten, sluit dan de bijbehorende tabbladen en noteer wat de eigenaar nog moet opruimen. Behoud het profiel; maak opnieuw verbinding als MCP de verbinding verliest doordat het laatste venster is gesloten. De onboardinggids legt de volgende stap uit.