Configuratie

Matthias Rohmer

José Luis Zapata

Je kunt Chrome DevTools voor agents configureren om aan te passen hoe de tool communiceert met de browser, welke tools aanstaan en hoe de tool gegevens verwerkt.

Configureer de server door opdrachtregelmarkeringen door te geven in de args-array van je Model Context Protocol-clientconfiguratiebestand (MCP). Dit is meestal het bestand config.json.

Als je Chrome bijvoorbeeld in de modus zonder interface wilt uitvoeren en het Canary-kanaal wilt gebruiken, gebruik je de volgende configuratie:

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

Veelvoorkomende configuratiescenario's

In de volgende scenario's worden veelvoorkomende manieren beschreven om Chrome DevTools voor agents in te stellen.

Uitvoeren in headless-modus

Als je achtergrondtaken wilt uitvoeren zonder een zichtbaar browservenster, voer je Chrome uit in de headless-modus (zonder UI). Voeg de vlag --headless toe aan je serverargumenten.

Verbinding maken met een bestaande browsersessie

DevTools voor agents start standaard een nieuwe Chrome-instantie. Je kunt je agent wel koppelen aan een bestaande browsersessie. Dit is handig als je agent een probleem moet onderzoeken in een sessie die je al bent gestart (bijvoorbeeld als je al bent ingelogd).

Je kunt op 2 manieren verbinding maken met een bestaande sessie:

Automatische verbinding (Chrome 144+)

Als je de vlag --autoConnect gebruikt, maakt de MCP-server automatisch verbinding met een actieve Chrome-instantie.

1. Ga in de actieve Chrome-browser naar chrome://inspect/#remote-debugging en zet Foutopsporing op afstand aan.
2. Voeg --autoConnect toe aan je MCP-configuratie: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
3. Als de agent verbinding probeert te maken, toont Chrome een dialoogvenster waarin om toestemming wordt gevraagd. Klik op Toestaan.

Handmatige verbinding

Als je --autoConnect niet kunt gebruiken (bijvoorbeeld in een sandboxomgeving), kun je Chrome handmatig starten met een foutopsporingspoort en verbinding maken via --browser-url.

1. Start Chrome vanuit de terminal met foutopsporing op afstand aan en een aangepaste gebruikersgegevensmap.
   • 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. Stel je agent in om verbinding te maken met deze poort: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

Bestandstoegang buiten de tijdelijke directory toestaan

Tools die bestanden lezen of schrijven (bijvoorbeeld screenshots of traceringen opslaan of extensies laden), hebben alleen toegang tot paden binnen de geconfigureerde werkruimteroot. De server gebruikt de roots die je MCP-client levert via de MCP-rootsmogelijkheid, plus alle mappen die je doorgeeft met --filesystemRoot (alias --workspace). Als je client geen roots levert en je --filesystemRoot niet instelt, is de bestandstoegang beperkt tot de tijdelijke map van het OS. Verzoeken voor andere paden mislukken met de fout Access denied: ... is not within any of the configured workspace roots.

Als je toegang tot een projectdirectory wilt toestaan, voeg je --filesystemRoot toe aan je serverargumenten. U kunt de vlag herhalen om meerdere directory's toe te staan:

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

Informatie over configuratieopties

In de volgende gedeelten staan de beschikbare configuratievlaggen. Ga naar de GitHub-repository voor Chrome DevTools MCP voor de nieuwste opties en updates.

Koppelingsopties

Gebruik deze opties om in te stellen hoe de server verbinding maakt met Chrome.

Opties voor browserstart

Deze opties zijn van toepassing als de MCP-server Chrome start.

Beveiligings- en privacyopties

Gebruik deze opties om beveiligingsinstellingen en gegevensprivacy te beheren.

Functiecategorieën

Met deze vlaggen kunt u groepen tools aan- of uitzetten.

Screenshotopties

Gebruik deze opties om aan te passen hoe de agent screenshots maakt.

Experimentele opties

Gebruik deze opties om experimentele functies aan te zetten die nog in ontwikkeling zijn.

Andere opties

Gebruik deze opties om logboekregistratie, paginarouting en bronkaarten te configureren of om een vereenvoudigde set tools aan te zetten.

Omgevingsvariabelen

Je kunt ook de volgende omgevingsvariabelen gebruiken om de server te configureren:

• CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: Als deze optie is ingesteld, wordt de verzameling van gebruiksstatistieken uitgezet (gelijk aan --no-usage-statistics).
• CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS: Als deze is ingesteld, worden periodieke controles op updates uitgezet.
• CI: Als deze is ingesteld, wordt de verzameling van gebruiksstatistieken uitgezet.
• NODE_DEBUG: Stel in op * om uitgebreide logboekregistratie voor foutopsporing aan te zetten (werkt in combinatie met --logFile).