Configuratie

Matthias Rohmer

José Luis Zapata

Je kunt Chrome DevTools voor agents configureren om aan te passen hoe het met de browser communiceert, welke tools zijn ingeschakeld en hoe het met gegevens omgaat.

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

Om bijvoorbeeld Chrome in headless-modus uit te voeren en het Canary-kanaal te gebruiken, kunt u de volgende configuratie gebruiken:

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

Veelvoorkomende configuratiescenario's

De volgende scenario's beschrijven veelvoorkomende manieren om Chrome DevTools voor agents te configureren.

Draaien in headless-modus

Om achtergrondtaken uit te voeren zonder een zichtbaar browservenster, start u Chrome in de headless-modus (zonder gebruikersinterface). Voeg de vlag --headless toe aan uw serverargumenten.

Verbinden met een bestaande browsersessie

Standaard start DevTools voor agents een nieuwe Chrome-instantie. Je kunt je agent echter ook verbinden met 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 twee 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 je actieve Chrome-browser naar chrome://inspect/#remote-debugging en schakel ' Externe foutopsporing' in.
2. Voeg --autoConnect toe aan je MCP-configuratie: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
3. Wanneer de agent probeert verbinding te maken, toont Chrome een dialoogvenster waarin om toestemming wordt gevraagd. Klik op Toestaan .

Handmatige aansluiting

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

1. Start Chrome vanuit de terminal met externe foutopsporing ingeschakeld 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. Configureer uw agent om verbinding te maken met deze poort: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

Referentie voor configuratieopties

In de volgende secties worden de beschikbare configuratievlaggen weergegeven. Voor de meest recente opties en updates kunt u de Chrome DevTools MCP GitHub-repository raadplegen.

Verbindingsopties

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

Opties voor het starten van de browser

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

Beveiligings- en privacyopties

Gebruik deze opties om de beveiligingsinstellingen en gegevensprivacy te beheren.

Functiecategorieën

Met deze vlaggen kunt u groepen tools in- of uitschakelen.

Screenshot-opties

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

Experimentele opties

Gebruik deze opties om experimentele functies in te schakelen die in ontwikkeling zijn.

Andere opties

Gebruik deze opties om logboekregistratie te configureren of om een ​​vereenvoudigde set hulpmiddelen in te schakelen.

Omgevingsvariabelen

Je kunt de server ook configureren met behulp van de volgende omgevingsvariabelen:

• CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS : Indien ingesteld, wordt het verzamelen van gebruiksstatistieken uitgeschakeld (gelijk aan --no-usage-statistics ).
• CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS : Indien ingesteld, worden periodieke controles op updates uitgeschakeld.
• CI : Indien ingesteld, wordt het verzamelen van gebruiksstatistieken uitgeschakeld.
• DEBUG : Stel in op * om uitgebreide foutopsporingslogboekregistratie in te schakelen (werkt in combinatie met --logFile ).