LaunchRepoÖnerilen kurulum: LaunchRepo’dan en iyi sonucu almak için Claude ya da Codex masaüstü uygulaması yerine her zaman bir terminalde Claude Code CLI veya Codex CLI kullanmanı önemle tavsiye ediyoruz. Bu, önerdiğimiz çalışma biçimidir; farklı izinlerin ya da kesintisiz çalışmanın garantisi değildir.
Güncel bir Node.js LTS sürümü, npm ve Google Chrome ile Chrome uzaktan hata ayıklama (remote debugging) üzerinden Chrome DevTools MCP kullan. Yerel panel kayıtlarını saklar; Chrome’u ise ajanın kontrol eder. Tek bir worker ile başla ve çalıştırma boyunca onun MCP bağlantısını açık tut. Tarayıcı eklentisi üzerinden çalışan aktarımları ya da alternatif tarayıcı kontrol entegrasyonlarını kullanma.
Kurulumunu seç
- Chrome 144+: otomatik bağlantı Windows, macOS ve Linux’ta çalışır.
- macOS: Terminal izinlerini gözden geçir.
- Otomatik bağlantı kullanılamıyorsa ya da ayrı bir worker gerekiyorsa: macOS, Windows veya Linux için ayrı bir profil kullan.
- Göndermeden önce: bağlantı testini yap.
node --version, npm --version ve chrome://version çıktılarını kontrol et. Windows’ta yerel Windows Node/npm ve Chrome kullan; WSL ayrı bir bağlantı kurulumu gerektirir.
Mevcut Chrome tarayıcına bağlan
- Chrome 144+ içinde
chrome://inspect/#remote-debuggingsayfasını aç ve uzaktan hata ayıklamayı etkinleştir. Bu ayar görünmüyorsa, izin veriliyorsa aşağıdaki ayrı profil yöntemini kullan. - Chrome DevTools MCP’yi ajanının MCP ayarlarına kaydet. Bu genel JSON örneği macOS/Linux içindir; ajanın farklı bir yapılandırma biçimi kullanıyor olabilir:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest", "--autoConnect", "--no-usage-statistics", "--no-performance-crux"]
}
}
}Windows için "command": "cmd" ve şu argümanları kullan:
["/c", "npx", "-y", "chrome-devtools-mcp@latest", "--autoConnect", "--no-usage-statistics", "--no-performance-crux"]- Zararsız bir tarayıcı işlemi başlat ve Chrome’un bağlantı onayını doğru pencerede ver. Ardından aşağıdaki testi yap.
İlk çağrı paketi indirir. Kurulumdan sonra test ettiğin bir sürümü sabitle. Resmî yapılandırma ve istemci kurulumu belgelerine bak.
Ayrı profil: işletim sistemini seç
Komutları paylaşılan ya da senkronize edilen klasörlerin dışında, özel çalışma alanından çalıştır. Profili Git’in yok saydığı dosyalar arasında tut, çünkü oturum açma bilgilerini içerir. Gerekli hesaplara kendin giriş yap. Chrome 136+, bu hata ayıklama bayrakları için varsayılan olmayan bir profil gerektirir.
macOS
mkdir -p .browser/chrome
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
--remote-debugging-address=127.0.0.1 \
--remote-debugging-port=9222 \
--user-data-dir="$PWD/.browser/chrome" about:blankWindows PowerShell
$launchrepoChrome = @(
"$env:ProgramFiles\Google\Chrome\Application\chrome.exe",
"${env:ProgramFiles(x86)}\Google\Chrome\Application\chrome.exe",
"$env:LOCALAPPDATA\Google\Chrome\Application\chrome.exe"
) | Where-Object { Test-Path $_ } | Select-Object -First 1
if (-not $launchrepoChrome) { throw 'Locate Google Chrome first' }
New-Item -ItemType Directory -Force '.browser/chrome' | Out-Null
$launchrepoProfile = (Resolve-Path '.browser/chrome').Path
Start-Process -FilePath $launchrepoChrome -ArgumentList "--remote-debugging-address=127.0.0.1 --remote-debugging-port=9222 --user-data-dir=`"$launchrepoProfile`" about:blank"Linux
launchrepo_chrome=$(command -v google-chrome || command -v google-chrome-stable)
if [ -z "$launchrepo_chrome" ]; then
echo "Install or locate Google Chrome first."
else
mkdir -p .browser/chrome
"$launchrepo_chrome" \
--remote-debugging-address=127.0.0.1 \
--remote-debugging-port=9222 \
--user-data-dir="$PWD/.browser/chrome" about:blank
fiChrome’u başlattığın terminali açık tut. MCP argümanlarındaki --autoConnect yerine --browserUrl=http://127.0.0.1:9222 yaz; ikisini asla birlikte kullanma. Portu yerel tut ve asla herkese açık bir tünelle dışarı açma. Portu dinleyen süreci kontrol et: macOS’ta lsof -nP -iTCP:9222 -sTCP:LISTEN, Linux’ta ss -ltnp 'sport = :9222', Windows’ta Get-NetTCPConnection -State Listen -LocalPort 9222 | Select-Object LocalAddress, OwningProcess. Yalnızca loopback adresleri kabul edilebilir. Portu başka bir program kullanıyorsa boş bir port seç ve iki yapılandırmayı da güncelle. İlgisiz tarayıcıları asla sonlandırma, etkin profil kilitlerini de silme.
macOS izinleri
MCP’yi başlatan uygulamayı kontrol et: Terminal, iTerm ya da editörün veya ajan uygulaman. macOS korunan Chrome dosyalarına erişimi reddederse:
- Sistem Ayarları → Gizlilik ve Güvenlik → Tam Disk Erişimi (System Settings → Privacy & Security → Full Disk Access) bölümünü aç.
- MCP’yi gerçekten başlatan uygulamayı + ile ekle, kimliğini doğrula ve etkinleştir.
- Uygulamadan tamamen çık, yeniden aç, tekrar bağlan ve testi tekrarla.
Bu bir izin kontrolüdür, evrensel bir CDP gereksinimi değildir. Bağlantı çalışıyorsa gereksiz yere daha geniş erişim verme. Yalnızca CDP kullanan bir bağlantı normalde Erişilebilirlik, Otomasyon ya da Ekran Kaydı izni gerektirmez. Chrome’un bağlantı onayı bunlardan ayrıdır ve yeniden başlatmadan sonra tekrar istenebilir.
Bağlantıyı test et
Ajanından https://example.com adresini yeni bir sekmede açmasını, sayfa başlığını ve ana başlığı okumasını ve hangi sekmede olduğunu söylemesini iste. O pencereyi izle. Yalnızca çalışan bir MCP sürecinin olması hiçbir şey kanıtlamaz. Ardından hedef dizinde oturum aç ve gerçekte hangi hesapla giriş yapıldığını doğrula; OAuth’un başarılı görünmesi tek başına girişin yapıldığını kanıtlamaz. Posta kutunu, üzerinde anlaşılan izinlerin sınırları içinde kontrol et.
Ardından ajanın aynı sekmede navigator.webdriver değerini okumasını isteyin. Değer false olmalıdır. true ise MCP ayarınızda --autoConnect (ayrı profilde --browserUrl) eksiktir ve Chrome DevTools MCP kendi otomasyon Chrome’unu başlatmıştır. Bu durumda Cloudflare Turnstile gibi bot kontrolleri sonsuza kadar “doğrulanıyor” der ve çözebileceğiniz bir sınama hiç göstermez. Ayarı düzeltin, ajan oturumunu yeniden başlatın ve testi tekrarlayın. Bu değeri asla gizlilik (stealth) bayrakları veya betikleriyle gizlemeyin.
onboarding.json ya da SESSION.md dosyasına yalnızca geçti/kaldı sonucunu ve hassas olmayan notları kaydet. Çerezleri, kimlik doğrulama bağlantılarını ya da tarayıcı dökümlerini kopyalama. CAPTCHA ve 2FA adımlarını kendin tamamla. Submit sırasında zaman aşımı olursa, yeniden denemeden önce platformu kontrol et. Yanlış pencere hareket ederse dur ve bağlantıyı kontrol et. Bu talimatlar, bu test yapılmadan senin işletim sistemi ve ajan kombinasyonunda çalıştığını garanti edemez.
İki worker ve pencerelerin kapatılması
Çalıştırma planlayıcısı 10 gönderim ve en fazla 2 worker ile başlar. Her worker’ın ayrı bir platform ataması, Chrome profili, portu ve MCP bağlantısı olmalıdır. Örneğin 9222 portunda .browser/worker-1, 9223 portunda .browser/worker-2 kullan. Her birini ayrı ayrı test et. Ajan uygulaman worker’ları ayrı bağlantılara yönlendiremiyorsa tek worker kullan.
Her gönderime ayrı bir pencere ver. Onaydan sonra kanıtını ve sonucunu kaydet, ardından yalnızca o pencereyi ve ona ait giriş ve doğrulama sekmelerini kapat. Kişisel pencereleri, paylaşılan gelen kutularını, paneli, kaydedilmemiş formları ve sana devredilen adımları açık bırak. MCP pencereyi kapatamıyorsa ona ait sekmeleri kapat ve geriye kalan, senin yapman gereken temizliği not et. Profili koru; son pencereyi kapatmak MCP bağlantısını koparırsa yeniden bağlan. Sonraki adımı onboarding rehberi anlatıyor.