Yapılandırma

Matthias Rohmer

José Luis Zapata

Ajanlar için Chrome Geliştirici Araçları'nı yapılandırarak tarayıcıyla etkileşimini, hangi araçların etkinleştirildiğini ve verileri nasıl işlediğini özelleştirebilirsiniz.

Model Context Protocol (MCP) istemci yapılandırma dosyanızın args dizisinde 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, temsilciler için Chrome Geliştirici Araçları'nı yapılandırmanın yaygın yolları açıklanmaktadır.

Başsız modda çalıştır

Arka plan görevlerini görünür bir tarayıcı penceresi olmadan gerçekleştirmek için Chrome'u başsız (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, temsilciler için Geliştirici Araçları yeni bir Chrome örneği başlatır. Ancak temsilcinizi mevcut bir tarayıcı oturumuna bağlayabilirsiniz. Bu, temsilcinizin daha önce başlattığınız bir oturumdaki sorunu araştırması gerektiğinde (örneğin, zaten oturum açtıysanız) yararlıdır.

Mevcut bir oturuma iki şekilde bağlanabilirsiniz:

Otomatik bağlantı (Chrome 144+)

--autoConnect işaretini kullanırsanız MCP sunucusu etkin bir Chrome örneğine otomatik olarak 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 aracını 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. Chrome'u, uzaktan hata ayıklama etkinleştirilmiş ve özel bir kullanıcı verileri diziniyle 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"]

Geçici dizinin dışındaki dosyalara erişime izin ver

Dosya okuyan veya yazan araçlar (ör. ekran görüntülerini, izleri kaydetme veya uzantıları yükleme) yalnızca yapılandırılmış çalışma alanı köklerindeki yollara erişebilir. Sunucu, MCP istemcinizin MCP kökleri özelliği aracılığıyla sağladığı kökleri ve --filesystemRoot (takma ad --workspace) ile ilettiğiniz dizinleri kullanır. İstemciniz kök sağlamıyorsa ve --filesystemRoot değerini ayarlamazsanız dosya erişimi, işletim sisteminin geçici diziniyle sınırlı olur. Diğer yollar için yapılan istekler Access denied: ... is not within any of the configured workspace roots hatasıyla başarısız olur.

Bir proje dizinine erişime izin vermek için sunucu bağımsız değişkenlerinize --filesystemRoot ekleyin. Birden fazla dizine izin vermek için işareti tekrarlayabilirsiniz:

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

Yapılandırma seçenekleri referansı

Aşağıdaki bölümlerde, kullanılabilen 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.

Tarayıcı başlatma seçenekleri

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

Güvenlik ve gizlilik seçenekleri

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

Özellik kategorileri

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

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.

Deneysel seçenekler

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

Diğer seçenekler

Günlüğü, sayfa yönlendirmeyi ve kaynak haritaları yapılandırmak ya da basitleştirilmiş bir araç setini etkinleştirmek için bu seçenekleri kullanın.

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.
• NODE_DEBUG: Ayrıntılı hata ayıklama günlük kaydını etkinleştirmek için * olarak ayarlayın (--logFile ile birlikte çalışır).