Cursor'ın yerleşik browser aracı lokal uygulamanızı kontrol etmek için yeterli. Sayfaya gider, tıklar, yazar ve screenshot alır. Ama gerçek web'e çıkınca izole bir webview olması sorun çıkarır: kalıcı cookie yok, güvenilir fingerprint yok, anti-bot kontrollerinde tutarlı browser identity yok.
Özet: Cursor'ı CDP (Chrome DevTools Protocol) üzerinden Clawbrowser'a bağlayın. Agent gerçek Chromium kullanır; profiller kalıcıdır, fingerprints yönetilir, proxy routing profile bağlıdır. Kurulum kısa: runtime'ı yükleyin, profil başlatın, Cursor'a lokal endpoint verin.
Cursor'ın yerleşik browserı neden yetmez
Cursor, MCP server extension olarak çalışan sandboxed webview tabanlı bir browser tool sağlar. Localhost için gayet iş görür: navigate, click, type, scroll, screenshot, console output ve network traffic.
Local dışına çıktığınızda sınırlamalar görünür:
| Sınırlama | Ne olur |
|---|---|
| Sandboxed webview | Gerçek Chromium instance değildir. Siteler eksik API'leri ve standart dışı window properties değerlerini görür. |
| Oturum kalıcılığı yok | Cookies ve localStorage workspace'e bağlıdır, koşular arasında güvenilir değildir. |
| Fingerprint yönetimi yok | Aynı canvas hash, WebGL renderer ve navigator properties her istekte görünür. |
| Proxy support yok | Trafik makinenin varsayılan IP'sinden çıkar. Datacenter IP'ler hızla flag alır. |
| Güvenilirlik sorunları | Cursor 2.3.18+ sürümlerinde click, scroll ve element bulma regresyonları yaşandı. |
Agent login yapacak, Cloudflare arkasından veri okuyacak veya production sitede çok adımlı akış yürütecekse yerleşik webview yanlış katmandır.
CDP size ne verir
CDP (Chrome DevTools Protocol), Chromium tabanlı browserları programatik kontrol etmek için standart arayüzdür. Playwright connectOverCDP, Puppeteer puppeteer.connect kullanır; ham CDP client ise debugging portuna WebSocket açar.
Cursor'ı harici browsera CDP ile bağlayınca şunları alırsınız:
- Gerçek browser: tam render engine, extension ve standart API'ler
- Kalıcı oturumlar: cookie ve login state agent koşuları arasında yaşar
- Tam sayfa kontrolü: Playwright ve Puppeteer'ın kullandığı protokolle
- Anti-detection: fingerprint ve proxy aynı identity içinde tutarlı kaldığında
Bağlantı standart bir WebSocket URL'sidir. CDP konuşan her araç, CDP endpoint sunan her browsera bağlanabilir. Clawbrowser her profil için endpoint açar.
Cursor'ı Clawbrowser'a bağlama: adım adım
Gereksinimler
- macOS (Apple Silicon), Linux (x64 veya arm64) ya da Windows
- Cursor kurulu
app.clawbrowser.aiüzerinden Clawbrowser API key
Adım 1: Clawbrowser'ı kurun
clawctl bootstrapper'ını indirin ve çıkarın:
# macOS (Apple Silicon)
archive="clawctl-macos-arm64.tar.gz"
curl -fL --retry 3 -o "$archive" \
"https://github.com/clawbrowser/clawctl/releases/latest/download/${archive}"
tar -xzf "$archive"Linux için clawctl-linux-amd64.tar.gz veya clawctl-linux-arm64.tar.gz kullanın. Docker veya sudo gerekmez.
API key'i ayarlayın:
./clawctl config set api-keyAdım 2: browser profili başlatın
Clawbrowser'ı isimli bir profille başlatın. Her profil kendi fingerprint, cookie storage ve opsiyonel proxy ayarına sahiptir:
# Start a profile and open the verification page
clawctl start --profile cursor-dev --url clawbrowser://verify/ --json
# Get the CDP endpoint for this profile
clawctl endpoint --profile cursor-dev --jsonendpoint komutu http://127.0.0.1:9222 benzeri bir URL döndürür. Cursor agent bu CDP endpoint'e bağlanır.
Adım 3: Cursor'dan MCP ile bağlanın
En basit entegrasyon Clawbrowser'ın yerleşik MCP server'ıdır. Navigation, screenshots, clicks, tab management ve profile startup araçlarını MCP tools olarak Cursor'a sunar. CDP bağlantısını server içeride yönetir.
MCP konfigürasyonunu yazmak için installer'ı çalıştırın:
clawctl install --agent all --jsonCursor bu lokal MCP server'ı konfigürasyondan yükler.
Alternatif: Microsoft Playwright MCP
Microsoft'un resmi Playwright MCP server'ını tercih ediyorsanız, Cursor Settings > MCP > Add Server içinde Clawbrowser CDP endpoint'ini verin:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": [İki yöntem de Cursor'a browser üzerinde yüksek seviyeli araçlar verir. Clawbrowser MCP server bunun üstüne profil ve fingerprint yönetimi ekler.
Adım 4: bağlantıyı doğrulayın
Cursor agent'tan bir test sayfasına gitmesini isteyin:
Navigate to https://browserleaks.com/canvas and take a screenshot. Tell me what canvas fingerprint hash you see.
Bağlantı çalışıyorsa sandboxed webview'in generic hash'i yerine Clawbrowser profilinden gerçek canvas fingerprint görürsünüz.
Koddan direkt CDP bağlantısı
Cursor agent MCP tools yerine script yazıp çalıştırıyorsa Playwright veya Puppeteer ile direkt bağlanın:
Playwright (Python)
from playwright.async_api import async_playwright
async def browse_with_clawbrowser():
async with async_playwright() as p:
# Connect to Clawbrowser's CDP endpointPlaywright (Node.js)
const { chromium } = require('playwright');
const browser = await chromium.connectOverCDP('http://127.0.0.1:9222');
const page = browser.contexts()[0].pages()[0];
Puppeteer
const puppeteer = require('puppeteer');
const browser = await puppeteer.connect({
browserURL: 'http://127.0.0.1:9222'
});Üç framework de aynı CDP endpoint'e bağlanır. Clawbrowser browser identity katmanını altta yönetir: Canvas, WebGL, AudioContext, fontlar, ekran çözünürlüğü, timezone, navigator properties ve proxy routing profil içinde tutarlı kalır.
Cursor agentları için anti-detection neden önemli
Cursor agent standart browser üzerinden gezerken anti-bot sistemler browser identity'yi birçok yüzeyden kontrol eder:
| Sinyal | Kontrol edilen şey | Standard Chrome | Clawbrowser |
|---|---|---|---|
| Canvas hash | GPU rendering fingerprint | Static, matches known automation profiles | Unique per profile, consistent with reported GPU |
| WebGL renderer | Graphics card identifier | Exposes real hardware | Matches the profile's simulated hardware |
| Navigator properties | Browser version, platform, language | Generic Chromium values | Consistent with profile's OS and locale |
| Timezone | System timezone vs IP geo | Mismatches with proxy location | Auto-aligned with proxy geography |
| CDP detection | Runtime.enable traces |
Detectable via leaked CDP artifacts | Engine-level patches suppress CDP signals |
CDP ile bağlanan standart Chromium instance'ları anti-bot sistemlerin saniyeler içinde okuyacağı izler bırakır. Clawbrowser bunu JavaScript override ile değil engine seviyesinde patchler.
Fark budur: Cursor'ı chrome --remote-debugging-port=9222 ile bağlarsanız bloklanır; Clawbrowser ile bağlarsanız tutarlı browser identity sunarsınız.
Birden fazla profil yönetimi
Her Clawbrowser profili izoledir. Farklı hesaplar veya projeler için aynı anda birden çok profil çalıştırabilirsiniz:
# Create three profiles with different locations
clawctl create --profile account-a --location sweden --json
clawctl create --profile account-b --location germany --json
clawctl create --profile account-c --location japan --json
Her profil benzersiz fingerprint, kendi proxy IP'si ve izole storage alır. Platformlar üç farklı ülkede üç farklı makineden gelen bağımsız kullanıcılar görür.
Cursor agent farklı CDP endpoint'lere bağlanarak profil değiştirebilir veya tek script'ten hepsini paralel yönetebilir.
Cursor built-in browser vs CDP vs Clawbrowser
| Cursor built-in | Chrome via CDP | Clawbrowser via CDP | |
|---|---|---|---|
| Browser engine | Sandboxed webview | Real Chromium | Real Chromium (patched) |
| Session persistence | Workspace-scoped | Manual profile dirs | Named profiles with auto-persistence |
| Fingerprint management | None | None | 20+ surfaces managed per profile |
| Proxy support | None | Manual flag | Profile-bound, geo-aligned |
| Anti-bot survival | Blocked instantly | Blocked within minutes | Passes Cloudflare, DataDome, PerimeterX |
| Multi-account | Not possible | Separate --user-data-dir |
Built-in profile isolation |
| Setup complexity | Zero (built in) | Moderate | Three commands |
Yerleşik browser'ı localhost'taki kendi app'inizi incelemek için kullanın. Gerçek web'e dokunan her akışta Clawbrowser via CDP kullanın.
FAQ
Bu Cursor agent mode ile çalışır mı?
Evet. Cursor agent mode, CDP ile harici browsera bağlanan MCP server'lar dahil her MCP server'ı kullanabilir. Action'lar sandboxed webview yerine Clawbrowser içinde çalışır.
Playwright veya Puppeteer kurmam gerekir mi?
Sadece agent otomasyon script'i yazıp çalıştırıyorsa gerekir. MCP tabanlı normal akışta CDP bağlantısını server içeride yönetir.
Login oturumlarını Cursor projeleri arasında yeniden kullanabilir miyim?
Evet. Clawbrowser profilleri cookies, localStorage ve IndexedDB saklar. Bir kez login olun, sonra aynı profili başka workspace'lerde tekrar kullanın.
Cursor'ın browser tool'u harici browser ile karışırsa ne olur?
Settings > Features > Browser altında yerleşik browser'ı kapatabilirsiniz. İkisi paralel de çalışabilir; birbirinden bağımsızdır.
Clawbrowser ücretsiz mi?
Evet. Clawbrowser ücretsiz, open source ve MIT-licensed. Seat ücreti, kullanım limiti veya browser runtime aboneliği yoktur. Kurulumu doğrulamak için app.clawbrowser.ai üzerinden API key gerekir.
Başlayın
Cursor agent'ı gerçek browsera bağlamak için üç komut:
# Install Clawbrowser
clawctl install --json
# Set your API key
clawctl config set api-keyMCP server'ınızı veya Playwright script'inizi dönen endpoint'e yönlendirin. Cursor agent artık yönetilen fingerprints, kalıcı oturumlar ve proxy routing ile web'de gezer.
CDP hakkında daha fazlası için AI agents için CDP browser developer guide yazısını okuyun. Fingerprinting katmanı için Browser fingerprinting: 20 otomasyon sinyali yazısına bakın.
Okumaya devam edin
İlgili yazılar
CDP ve MCP: AI browser kontrolünde hangisini ne zaman kullanmalı
CDP browserı kontrol eder. MCP yapay zekayı bağlar. AI agent browser otomasyonunda Chrome DevTools Protocol ile Model Context Protocol'ü ne zaman kullanacağınızı öğrenin.
Yazıyı oku →
Puppeteer-Extra-Stealth Artık Geçersiz: Modern Otomasyon Ne Kullanıyor
puppeteer-extra-plugin-stealth 2023'ten beri güncellenmedi. Modern Anti-Bot sistemlerine karşı neden başarısız olduğunu ve yerine ne kullanmanız gerektiğini anlatıyoruz.
Yazıyı oku →