Chrome DevTools MCP: Tesisatçıya Evin Anahtarını Vermek
Chrome DevTools MCP, ajana tarayıcının konsolunu, ağ isteklerini ve performans izini açıyor. Yerel bir PHP sepet sayfasında varsayılan ayarla oturum çerezi ve Authorization başlığı da modele gitti; LCP ise sepet değil başlık üzerinden yeşil yandı.
Bu yazının İngilizcesi de var →
Mutfakta su sızdırıyor, tesisatçıyı çağırıyorsunuz. Adam geliyor, ama kapıyı ona açarken elinize verdiği şey musluk anahtarı değil, evin bütün anahtarları. Mutfağa da girer, yatak odasındaki çekmeceye de bakar. Kötü niyetli olması gerekmiyor; anahtar ona o kapıları açma imkânı veriyor, o kadar.
Chrome DevTools MCP tam olarak bu anahtar. Kodlama ajanınıza tarayıcının gözünü veriyor: konsolu okuyor, ağ isteklerini açıyor, performans izi çıkarıyor, sayfaya tıklıyor. Google'ın Chrome DevTools ekibinin projesi, GitHub'da 54,7 bin yıldıza ulaşmış ve son sürümü 1.13.0, 11 Kasım 2026'da çıktı. Bu yazıda yerel bir PHP sepet sayfasında çalıştırıp ajanın ne gördüğüne baktım. Gördüğü şeylerden biri, varsayılan ayarlarla oturum çereziniz ve Authorization başlığınızdı.
Chrome DevTools MCP nedir?#
Tek cümleyle: ajanın gerçek bir Chrome'u Puppeteer üzerinden sürmesini ve DevTools'un verisini MCP aracı olarak okumasını sağlayan bir sunucu. Duyuru yazısı (Mathias Bynens ve Michael Hablich, 23.09.2025) sorunu net koyuyor: ajanlar ürettikleri kodun tarayıcıda çalışınca ne yaptığını göremiyor.
Kurulum çoğu istemcide tek satır. İstemci rehberindeki komutlara, aşağıda anlatacağım bayrakları ben ekledim:
# Claude Code
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest --isolated --redactNetworkHeaders --no-performance-crux --no-usage-statistics
# OpenAI Codex
codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest --isolated --redactNetworkHeaders --no-performance-crux --no-usage-statistics
# Gemini CLI
gemini mcp add chrome-devtools npx chrome-devtools-mcp@latest --isolated --redactNetworkHeaders --no-performance-crux --no-usage-statistics
Cursor'da ayarlardaki MCP ekranından, Antigravity'de JSON yapılandırmasıyla ekleniyor; Antigravity rehberi sunucuyu editörün kendi tarayıcısına --browser-url ile bağlıyor. Node.js tarafında ^20.19, ^22.12 ya da 23 üstü isteniyor.
Tezgâhta ne denedim?#
Bulut sandbox'ta 1.13.0'ı kurdum, MCP sunucusunu bir ajanın içinden değil, doğrudan JSON-RPC ile konuşarak çalıştırdım. Tarayıcı olarak Playwright'ın Chromium 153'ünü verdim (--executablePath). Proje resmi desteği Chrome ve Chrome for Testing ile sınırlıyor, bunu baştan not edeyim. Sayfa, PHP 8.3.6'nın yerleşik sunucusunda: session_start() ile çerez basan bir sepet sayfası, tabloyu Authorization: Bearer ... başlığıyla fetch eden bir istek ve 800 ms bekleyip JSON dönen küçük bir api.php.
Ajan tarafından bakınca tablo şöyle:
tools/list33 araç döndü; araç tanımlarının JSON'u 32.302 bayt.--slimile 3 araç (navigate,evaluate,screenshot) ve 1.201 bayt. Bu tanımlar her oturumda bağlama giriyor; context-mode yazısında masaya neyin geldiğini tartışmıştık, burada masaya gelen ilk şey alet çantasının kataloğu.wait_forile "Defter" metni beklendi, 697 ms'de bulundu. Moli'de boş tabloyu çıkış kodu 0 ile almıştık; burada bekleme gerçekten veriyi bekliyor.list_console_messagesfavicon 404'ünü yakaladı, sepet hatası yoktu. Ajan için "konsol temiz mi" sorusu artık tahmin değil.
Anahtarlıkta neler var?#
Çekmece: başlıklar ve çerezler#
Hata: get_network_request ile api.php isteğini açtım. Varsayılan ayarda yanıt, authorization:Bearer gizli-anahtar-123 ve cookie:PHPSESSID=... satırlarını olduğu gibi döndü; ana sayfa isteğinde set-cookie da vardı. Yani modele giden metnin içinde.
Gerçek: --redactNetworkHeaders bayrağıyla aynı satırlar <redacted> geldi. Bayrağın varsayılanı false.
Acı Gerçek: Redaksiyon başlıklarla sınırlı. Aynı çağrı ana sayfanın yanıt gövdesini de döndürüyor ve gövdedeki JavaScript'te duran Bearer gizli-anahtar-123 olduğu gibi göründü. Üstüne evaluate_script ile document.cookie okuttum, oturum kimliği geldi. Başlığı kapatmak, çekmecenin kendisini kilitlemiyor.
Çerez tarafının çaresi zaten PHP'de:
<?php
declare(strict_types=1);
// Oturum çerezini JavaScript'in (ve sayfada script çalıştıran ajanın) gözünden sakla
session_start([
'cookie_httponly' => true,
'cookie_samesite' => 'Lax',
'cookie_secure' => ($_SERVER['HTTPS'] ?? '') === 'on',
'use_strict_mode' => true,
]);
Bununla Set-Cookie satırına HttpOnly; SameSite=Lax eklendi ve aynı evaluate_script çağrısı boş metin döndü. Script çalıştırmayı tamamen kapatmak isterseniz --no-javascript-evaluation araç sayısını 33'ten 31'e indiriyor (evaluate_script ve set_logpoints gidiyor). Ön yüze gömülü anahtarın ise bayrakla bir çaresi yok; o anahtar zaten her ziyaretçinin tarayıcısında. Vibe Coder #5.3'te kodda şifre mayınını konuşmuştuk; bu, aynı mayının tarayıcıdaki hâli.
Kapı: hangi adreslere gidebilir?#
--allowedUrlPattern 'http://127.0.0.1:8099/*' ile başlattığımda yerel sayfa açıldı, https://halityesil.com/ isteği "blocked by blocklist/allowlist rules" hatasıyla reddedildi. Bayrak Chrome 149 ve üstünü istiyor. Staging'de çalışan bir ajanın production paneline sapmaması için en ucuz kilit bu.
Komşuya giden bilgi: CrUX ve kullanım istatistiği#
Teknik Detay: README iki şeyi açık yazıyor. Performans araçları iz URL'lerini gerçek kullanıcı verisi için Google'ın CrUX API'sine gönderebilir (kapatmak için --no-performance-crux). Kullanım istatistiği toplama da varsayılan açık (kapatmak için --no-usage-statistics; CI ortam değişkeni varsa kendiliğinden kapanıyor). Staging adresinizin dışarıya gitmesini istemiyorsanız iki bayrak da yapılandırmada dursun.
Ev sahibinin anahtarı: profil ve --autoConnect#
Varsayılan profil $HOME/.cache/chrome-devtools-mcp/chrome-profile altında kalıcı; bir oturumda girilen panel girişi sonrakine taşınır. --isolated her seferinde geçici profil açıp kapanışta siliyor. --autoConnect ise Chrome 144 ve üstünde, uzak hata ayıklaması açılmış kendi tarayıcınıza bağlanıyor. Bunu denemedim; ama dokümana göre ajan o an açık olan oturumlarınızı görür. Kendi Chrome'unuzu bağlamak, tesisatçıya evin anahtarını değil, cüzdanınızı vermek demek.
Performans izi neyi ölçtü?#
performance_start_trace ile sayfayı yeniden yükleyip iz aldım (--no-performance-crux açık). İki ölçümde LCP 89 ve 93 ms çıktı; performance_analyze_insight LCP öğesinin H1 başlığı olduğunu söyledi. Sepet satırları ise 800 ms bekleyen API'den sonra geliyor. Yani iz yeşil, müşteri ise o sırada boş tablo görüyor. Ölçüm yanlış değil, sorduğumuz soru eksik: musluk açılıyor, sıcak suyun gelip gelmediğini ayrıca sormak gerekiyor. Ajanın raporunda yalnızca LCP varsa, wait_for ile asıl içeriği bekleten bir adım ve ağ listesindeki API süresi de olsun.
Bir yan not: ilk denemede PHP'nin yerleşik sunucusu tek süreçliydi, önceki sayfanın 800 ms'lik isteği kuyrukta beklediği için TTFB 593 ms göründü. PHP_CLI_SERVER_WORKERS=4 ile 3 ms'ye indi. Ajan bu farkı kendisi yorumlamıyor; izi okuyan sizseniz test sunucusunu da hesaba katın.
Kime göre, kime göre değil?#
İşe yaradığı yer: ajanın yaptığı ön yüz düzeltmesini tarayıcıda doğrulamak, konsol ve ağ hatasını tahmin yerine okumak, staging'de Lighthouse ve performans izini otomatik almak. Ağ isteğinin başlığını ve gövdesini görmek, CORS ve 401 ayıklamasında gerçekten zaman kazandırıyor.
İşe yaramadığı yer: production oturumu açık bir tarayıcı, gizli anahtar taşıyan ön yüz ve "LCP iyi, demek ki sayfa hazır" diye karar veren bir ajan. Ayrıca 33 araçlık katalog her işe gerekmiyor; basit gezinme ve ekran görüntüsü için --slim yeter.
Alternatiflerle kısa karşılaştırma#
| Araç | Ne verir | Lisans / sürüm (17.11.2026) | Ne zaman |
|---|---|---|---|
| Chrome DevTools MCP | Konsol, ağ, performans izi, Lighthouse, otomasyon | Apache-2.0, 1.13.0 (11.11.2026) | Ön yüz hatasını ve performansı ajana okutmak |
| Playwright MCP (Microsoft) | Erişilebilirlik ağacıyla tarayıcı otomasyonu | Apache-2.0, 0.0.85 (09.11.2026) | Akış testi, birden fazla tarayıcı motoru |
| Moli | Hafif, Chromium'suz sayfa okuma | Apache-2.0 / MIT | Metin çekmek, düşük kaynak |
| Lighthouse CLI | Ajan olmadan denetim raporu | Apache-2.0, 13.6.0 | CI'da sabit eşikli kontrol |
Bakım durumu ve emeğin sahibi#
Depo ChromeDevTools/chrome-devtools-mcp, Google'ın Chrome DevTools ekibinin. npm paketinin bakımcıları arasında Mathias Bynens ve Alex Rudenko var. İlk npm sürümü 13.05.2025; 8 Haziran - 11 Kasım 2026 arasında 1.2.0'dan 1.13.0'a kadar on üç sürüm çıkmış. 17.11.2026 itibarıyla depoda 54,7 bin yıldız, 83 açık konu ve 49 açık PR var. Sunucu her başlangıçta uyarıyı kendisi basıyor: tarayıcıdaki içerik MCP istemcisine açılıyor, paylaşmak istemediğiniz bilgiyi oraya koymayın.
Anahtarı verirken#
Tesisatçı çağırmak yanlış değil; sızıntıyı tahminle bulmaktan iyidir. Yanlış olan, kapıda anahtarlığı bütün olarak uzatmak. Önerdiğim yapılandırma şu: --isolated, --redactNetworkHeaders, --no-performance-crux, --no-usage-statistics, staging için --allowedUrlPattern, oturum çerezinde HttpOnly. Bunların hiçbiri varsayılan değil.
Ajana gözü verin. Çekmecenin anahtarını cebinizde tutun.
Yorumlar
0 yorum
Yorum yazın