Yapılandırma

Matthias Rohmer
José Luis Zapata

Ajanlar için Chrome Geliştirici Araçları'nı, tarayıcıyla etkileşim şeklini, hangi araçların etkinleştirileceğini ve verileri nasıl işleyeceğini özelleştirmek için yapılandırabilirsiniz.

Model Context Protocol (MCP) istemci yapılandırma dosyanızın args dizisine komut satırı işaretleri ileterek sunucuyu yapılandırın. Bu genellikle config.json dosyasıdır.

Örneğin, Chrome'u gözetimsiz modda çalıştırmak ve Canary kanalını kullanmak için aşağıdaki yapılandırmayı kullanın:

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

Sık karşılaşılan yapılandırma senaryoları

Aşağıdaki senaryolarda, Chrome Geliştirici Araçları'nın temsilciler için nasıl yapılandırılacağı açıklanmaktadır.

Gözetimsiz modda çalıştırma

Arka plan görevlerini görünür bir tarayıcı penceresi olmadan gerçekleştirmek için Chrome'u gözetimsiz (kullanıcı arayüzü yok) modda çalıştırın. Sunucu bağımsız değişkenlerinize --headless işaretini ekleyin.

Mevcut bir tarayıcı oturumuna bağlanma

Varsayılan olarak, aracıların Geliştirici Araçları yeni bir Chrome örneği başlatır. Ancak aracınızı mevcut bir tarayıcı oturumuna bağlayabilirsiniz. Bu özellik, temsilcinizin daha önce başlattığınız bir oturumdaki sorunu (ör. oturumunuz zaten açıksa) araştırması gerektiğinde faydalıdır.

Mevcut bir oturuma iki şekilde bağlanabilirsiniz:

Otomatik bağlantı (Chrome 144 ve sonraki sürümler)

--autoConnect işaretini kullanırsanız MCP sunucusu otomatik olarak etkin bir Chrome örneğine bağlanır.

  1. Çalışan Chrome tarayıcınızda chrome://inspect/#remote-debugging simgesine gidin ve Uzaktan Hata Ayıklama'yı etkinleştirin.
  2. MCP yapılandırmanıza --autoConnect ekleyin: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
  3. Aracı bağlanmaya çalıştığında Chrome, izin isteyen bir iletişim kutusu gösterir. İzin ver'i tıklayın.

Manuel bağlantı

--autoConnect kullanamıyorsanız (ör. korumalı alan ortamında) Chrome'u hata ayıklama bağlantı noktasıyla manuel olarak başlatabilir ve --browser-url kullanarak bağlanabilirsiniz.

  1. Uzak hata ayıklama etkin ve özel bir kullanıcı verileri diziniyle Chrome'u terminalden başlatın.
    • 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. Aracınızı bu bağlantı noktasına bağlanacak şekilde yapılandırın: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

Yapılandırma seçenekleri referansı

Aşağıdaki bölümlerde kullanılabilir yapılandırma işaretleri listelenmiştir. En son seçenekler ve güncellemeler için Chrome Geliştirici Araçları MCP GitHub deposuna bakın.

Bağlantı seçenekleri

Sunucunun Chrome'a nasıl bağlanacağını yapılandırmak için bu seçenekleri kullanın.

İşaret Tür Varsayılan Açıklama
--autoConnect veya --auto-connect boole false Yerel olarak çalışan bir Chrome (144+) örneğine otomatik olarak bağlanır. chrome://inspect/#remote-debugging kullanılarak uzaktan hata ayıklamanın etkinleştirilmesi gerekir.
--browserUrl veya --browser-url
-u		 dize false Çalışan ve hata ayıklanabilir bir Chrome örneğine (örneğin, http://127.0.0.1:9222) bağlanın.
--wsEndpoint veya --ws-endpoint
-w		 dize false Çalışan bir Chrome örneğine bağlanmak için WebSocket uç noktası (örneğin, ws://127.0.0.1:9222/devtools/browser/<id>). --browserUrl'e alternatiftir.
--wsHeaders veya --ws-headers dize false JSON biçiminde WebSocket bağlantısı için özel başlıklar (örneğin, '{"Authorization":"Bearer token"}'). Yalnızca --wsEndpoint ile çalışır.

Tarayıcı başlatma seçenekleri

Bu seçenekler, MCP sunucusu Chrome'u başlattığında geçerlidir.

İşaret Tür Varsayılan Açıklama
--headless boole false Chrome'u gözetimsiz (kullanıcı arayüzü yok) modda çalıştırır.
--channel dize stable Kullanılacak Chrome kanalını belirtir. Seçenekler: canary, dev, beta ve stable.
--executablePath veya --executable-path
-e		 dize false Özel Chrome yürütülebilir dosyasının yolu.
--userDataDir veya --user-data-dir dize Açıklamayı göster Kullanıcı verileri dizininin yolu. $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE varsayılandır.
--isolated boole false Tarayıcı kapatıldığında otomatik olarak temizlenen geçici bir kullanıcı verileri dizini oluşturur.
--viewport dize false İlk görüntü alanı boyutu (örneğin, 1280x720). Gözetimsiz modda maksimum boyut 3840x2160'dir.
--proxyServer veya --proxy-server dize false Proxy sunucu yapılandırması Chrome'a iletilir.
--chromeArg veya --chrome-arg dizi false Chrome'a geçirilecek ek bağımsız değişkenler.
--ignoreDefaultChromeArg veya --ignore-default-chrome-arg dizi false Chrome için varsayılan bağımsız değişkenleri açıkça devre dışı bırakın.

Güvenlik ve gizlilik seçenekleri

Güvenlik ayarlarını ve veri gizliliğini yönetmek için bu seçenekleri kullanın.

İşaret Tür Varsayılan Açıklama
--acceptInsecureCerts veya --accept-insecure-certs boole false Kendinden imzalı ve süresi dolmuş sertifikalarla ilgili hataları yoksayar. Dikkatli kullanın.
--blockedUrlPattern veya --blocked-url-pattern dizi false Belirtilen URL kalıplarını engelleyerek ağ erişimini kısıtlar (URLPattern kullanılır). Gezinmeleri ve alt kaynakları engeller.
--allowedUrlPattern veya --allowed-url-pattern dizi false Yalnızca belirtilen URL kalıplarına izin vererek ağ erişimini kısıtlar. Chrome 149 veya sonraki sürümler gerekir.
--redactNetworkHeaders veya --redact-network-headers boole false Hassas ağ başlıklarını istemciye döndürmeden önce çıkartır.
--usageStatistics veya --usage-statistics boole true Aracı iyileştirmek için kullanım istatistiklerinin toplanmasını sağlar. CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS veya CI ortam değişkenleri kullanılarak da devre dışı bırakılabilir.
--performanceCrux veya --performance-crux boole true Gerçek kullanıcı deneyimi verilerini getirmek için performans izlerindeki URL'leri Google CrUX API'ye gönderir.

Özellik kategorileri

Bu işaretleri kullanarak araç gruplarını etkinleştirebilir veya devre dışı bırakabilirsiniz.

İşaret Tür Varsayılan Açıklama
--categoryEmulation veya --category-emulation boole true Emülasyonla ilgili araçları etkinleştirir.
--categoryNetwork veya --category-network boole true Ağla ilgili araçları etkinleştirir.
--categoryPerformance veya --category-performance boole true Performansla ilgili araçları etkinleştirir.
--categoryExtensions veya --category-extensions boole false Uzantılarla ilgili araçları etkinleştirir. Yalnızca boru bağlantısıyla desteklenir.
--categoryExperimentalThirdParty veya --category-experimental-third-party boole false İncelenen sayfa tarafından kullanıma sunulan üçüncü taraf geliştirici araçlarını etkinleştirir.
--categoryExperimentalWebmcp veya --category-experimental-webmcp boole false WebMCP araçlarında hata ayıklamayı etkinleştirir. WebMCP özellikleri etkin olan Chrome 149 veya sonraki bir sürümün yüklü olması gerekir.
--memoryDebugging veya --memory-debugging boole false Bellek hata ayıklama araçlarını etkinleştirir.

Ekran görüntüsü seçenekleri

Aracının ekran görüntülerini nasıl alacağını özelleştirmek için bu seçenekleri kullanın.

İşaret Tür Varsayılan Açıklama
--screenshotFormat veya --screenshot-format dize false Varsayılan çıkış biçimini (png) geçersiz kılar. Seçenekler: jpeg, png ve webp. jpeg ve webp biçimleri daha küçüktür. Bu da yapay zeka sohbetlerindeki bağlam boyutunu azaltmaya yardımcı olur.
--screenshotQuality veya --screenshot-quality sayı false jpeg ve webp için sıkıştırma kalitesini (0-100) geçersiz kılar.
--screenshotMaxWidth veya --screenshot-max-width sayı false Piksel cinsinden maksimum genişlik. Daha büyük ekran görüntüleri küçültülür.
--screenshotMaxHeight veya --screenshot-max-height sayı false Piksel cinsinden maksimum yükseklik. Daha büyük ekran görüntüleri küçültülür.

Deneysel seçenekler

Geliştirme aşamasındaki deneysel özellikleri etkinleştirmek için bu seçenekleri kullanın.

İşaret Tür Varsayılan Açıklama
--experimentalPageIdRouting veya --experimental-page-id-routing boole false Eşzamanlı aracı oturumlarında istekleri yönlendirmek için sayfa kapsamlı araçlarda pageId simgesini gösterir.
--experimentalDevtools veya --experimental-devtools boole false Geliştirici Araçları hedefleri üzerinde otomasyonu etkinleştirir.
--experimentalVision veya --experimental-vision boole false Koordinat tabanlı araçları (ör. click_at) etkinleştirir. Genellikle ekran görüntülerine bakarak doğru koordinatlar oluşturabilen bir bilgisayar kullanım modeli gerektirir.
--experimentalStructuredContent veya --experimental-structured-content boole false Yapılandırılmış biçimlendirilmiş içerik çıkışı verir.
--experimentalIncludeAllPages veya --experimental-include-all-pages boole false Her tür sayfayı (ör. web görünümleri ve arka plan sayfaları) içerir.
--experimentalScreencast veya --experimental-screencast boole false Ekran video kaydı araçlarını kullanıma sunar (PATH'te ffmpeg gerektirir).
--experimentalFfmpegPath veya --experimental-ffmpeg-path dize false ffmpeg yürütülebilir dosyasının yolu.

Diğer seçenekler

Günlük kaydını yapılandırmak veya basitleştirilmiş bir araç grubunu etkinleştirmek için bu seçenekleri kullanın.

İşaret Tür Varsayılan Açıklama
--slim boole false Üç araçtan (gezinme, komut dosyası yürütme ve ekran görüntüleri) oluşan küçük bir set sunar. Temel tarayıcı görevleri için yararlıdır.
--logFile veya --log-file dize false Hata ayıklama günlüklerinin yazılacağı dosyanın yolu.

Ortam değişkenleri

Sunucuyu yapılandırmak için aşağıdaki ortam değişkenlerini de kullanabilirsiniz:

  • CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: Ayarlanırsa kullanım istatistiklerinin toplanmasını devre dışı bırakır (--no-usage-statistics ile eşdeğerdir).
  • CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS: Ayarlanırsa güncellemeler için düzenli kontroller devre dışı bırakılır.
  • CI: Ayarlanırsa kullanım istatistiklerinin toplanması devre dışı bırakılır.
  • DEBUG: Ayrıntılı hata ayıklama günlük kaydını etkinleştirmek için * olarak ayarlayın (--logFile ile birlikte çalışır).