Konfiguracja

Matthias Rohmer

José Luis Zapata

Możesz skonfigurować Narzędzia deweloperskie w Chrome dla agentów, aby dostosować sposób ich interakcji z przeglądarką, włączone narzędzia i sposób obsługi danych.

Skonfiguruj serwer, przekazując flagi wiersza poleceń w tablicy args pliku konfiguracji klienta Model Context Protocol (MCP). Zazwyczaj jest to plik config.json.

Aby na przykład uruchomić Chrome w trybie bez interfejsu i używać kanału Canary, użyj tej konfiguracji:

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

Typowe scenariusze konfiguracji

Poniższe scenariusze opisują typowe sposoby konfigurowania Narzędzi deweloperskich w Chrome dla agentów.

Uruchamianie w trybie bez interfejsu graficznego

Aby wykonywać zadania w tle bez widocznego okna przeglądarki, uruchom Chrome w trybie bez interfejsu graficznego. Dodaj flagę --headless do argumentów serwera.

Łączenie z istniejącą sesją przeglądarki

Domyślnie narzędzia deweloperskie w Chrome dla agentów uruchamiają nową instancję Chrome. Możesz jednak połączyć agenta z istniejącą sesją przeglądarki. Jest to przydatne, jeśli agent musi zbadać problem w sesji, która została już rozpoczęta (na przykład jeśli jesteś już zalogowany(-a)).

Możesz połączyć się z istniejącą sesją na 2 sposoby:

Automatyczne połączenie (Chrome 144 lub nowszy)

Jeśli użyjesz flagi --autoConnect, serwer MCP automatycznie połączy się z aktywną instancją Chrome.

1. W uruchomionej przeglądarce Chrome otwórz chrome://inspect/#remote-debugging i włącz Zdalne debugowanie.
2. Dodaj --autoConnect do konfiguracji MCP: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
3. Gdy agent próbuje się połączyć, Chrome wyświetla okno z prośbą o zezwolenie. Kliknij Zezwól.

Połączenie ręczne

Jeśli nie możesz użyć --autoConnect (np. w środowisku piaskownicy), możesz ręcznie uruchomić Chrome z portem debugowania i połączyć się za pomocą --browser-url.

1. Uruchom Chrome z terminala z włączonym zdalnym debugowaniem i niestandardowym katalogiem danych użytkownika.
   • 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. Skonfiguruj agenta, aby łączył się z tym portem: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

Zezwalaj na dostęp do plików poza katalogiem tymczasowym

Narzędzia, które odczytują lub zapisują pliki (np. zapisywanie zrzutów ekranu, śladów lub wczytywanie rozszerzeń), mogą uzyskiwać dostęp tylko do ścieżek w skonfigurowanych katalogach głównych obszaru roboczego. Serwer używa katalogów głównych udostępnianych przez klienta MCP za pomocą funkcji MCP roots oraz wszystkich katalogów przekazywanych za pomocą dyrektywy --filesystemRoot (alias --workspace). Jeśli klient nie udostępnia katalogów głównych i nie ustawisz dyrektywy --filesystemRoot, dostęp do plików jest ograniczony do katalogu tymczasowego systemu operacyjnego. Żądania dotyczące innych ścieżek kończą się niepowodzeniem z błędem Access denied: ... is not within any of the configured workspace roots.

Aby zezwolić na dostęp do katalogu projektu, dodaj --filesystemRoot do argumentów serwera. Możesz powtórzyć flagę, aby zezwolić na wiele katalogów:

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

Dokumentacja opcji konfiguracji

W sekcjach poniżej znajdziesz listę dostępnych flag konfiguracji. Najnowsze opcje i aktualizacje znajdziesz w repozytorium GitHub MCP Narzędzi deweloperskich w Chrome.

Opcje połączenia

Użyj tych opcji, aby skonfigurować sposób łączenia się serwera z Chrome.

Opcje uruchamiania przeglądarki

Te opcje mają zastosowanie, gdy serwer MCP uruchamia Chrome.

Opcje zabezpieczeń i prywatności

Użyj tych opcji, aby zarządzać ustawieniami bezpieczeństwa i prywatności danych.

Kategorie funkcji

Za pomocą tych flag możesz włączać i wyłączać grupy narzędzi.

Opcje zrzutu ekranu

Użyj tych opcji, aby dostosować sposób, w jaki agent robi zrzuty ekranu.

Opcje eksperymentalne

Użyj tych opcji, aby włączyć eksperymentalne funkcje, które są w trakcie opracowywania.

Inne opcje

Użyj tych opcji, aby skonfigurować logowanie, routing stron i mapy źródeł lub włączyć uproszczony zestaw narzędzi.

Zmienne środowiskowe

Do skonfigurowania serwera możesz też użyć tych zmiennych środowiskowych:

• CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: jeśli jest ustawiona, wyłącza zbieranie statystyk użytkowania (odpowiednik --no-usage-statistics).
• CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS: jeśli ta zasada jest skonfigurowana, wyłącza okresowe sprawdzanie dostępności aktualizacji.
• CI: jeśli ta opcja jest ustawiona, wyłącza zbieranie statystyk użytkowania.
• NODE_DEBUG: ustaw wartość *, aby włączyć szczegółowe logowanie debugowania (działa w połączeniu z --logFile).