SaaS’ını Cursor ile dizinlerde lanse et

Cursor’ın ihtiyaç duydukları

Çalışma alanın olarak klonlanmış depo

Satın aldıktan sonra özel depoyu Cursor’da aç. Ajan AGENTS.md’yi ve playbook’ları çalışma alanından okur; sen de o çalışırken product.json ve submissions.json’u editörde açık tutarsın.

Python 3.10+ ve Node.js LTS

Python çalışma alanı betiğini, record.py’yi ve paneli Cursor’ın entegre terminalinde çalıştırır. Node.js, tarayıcı sunucusu için npx’i sağlar.

Genel bir ~/.cursor/mcp.json

Cursor MCP sunucularını her proje için ~/.cursor/mcp.json’dan ya da tek bir proje için .cursor/mcp.json’dan okur. Genel dosya, teslim deposunu tam olarak geldiği gibi bırakır.

Araç onayı açık kalsın

Cursor varsayılan olarak her MCP araç çağrısından önce sorar. Form gönderimleri için bunu böyle bırak; authorizations.json bunun üstüne LaunchRepo’nun ürün düzeyindeki kurallarını ekler.

Cursor’ı Chrome’una bağlamak

Sen bir yol eklemedikçe Cursor’ın ajanının oturum açık Chrome’una girişi yoktur. LaunchRepo’nun desteklediği yol, uzaktan hata ayıklama üzerinden Chrome DevTools MCP’dir: Chrome 144 veya daha yenisi, chrome://inspect/#remote-debugging adresinde açılmış uzaktan hata ayıklama ve sunucuda --autoConnect.

Sunucuyu Cursor Settings → MCP → New MCP Server altından ekleyebilir ya da aşağıdaki JSON’u dosyaya yapıştırabilirsin. Her iki durumda da araçlarıyla birlikte MCP listesinde görünür ve silmeden kapatabilirsin.

Deponun tarayıcı rehberindekiyle aynı tanım, ~/.cursor/mcp.json olarak kaydedilmiş hâli:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--autoConnect",
        "--no-usage-statistics",
        "--no-performance-crux"
      ]
    }
  }
}

Biçim cursor.com belgelerine göre, 30 Eylül 2026 tarihinde kontrol edildi. ↗

Ajandan yeni, boş bir sekmede example.com’u açmasını iste. Cursor’da araç çağrısını onayla, Chrome’un istemine izin ver ve görünen sekmenin hareket ettiğini kontrol et. Ardından ilk dizine giriş yap.

Kodlama ajanını Chrome’una bağla →

Başlangıç prompt’u

Depo açıkken START.md’deki herkese açık başlangıç prompt’unu Cursor’ın ajanına yapıştır. Özel çalışma alanını checkout’un yanında oluşturur, paneli başlatır ve bir 127.0.0.1 bağlantısı döndürür.

Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone.

Read AGENTS.md, then follow "Start the dashboard for the owner". Create my private
workspace if I do not have one yet, start the dashboard, and give me the link.
Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of
asking again unless their scope is missing or conflicting. Actually test my visible
existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the
OS fallback if needed. Use one platform/browser worker by default. Build the normal
run only from suitable free-ready routes, keep research separate, and preserve any
draft that needs one exact human CAPTCHA/2FA action. Never claim browser control
bypasses or reduces those challenges.

Playbook’lar ve talimatlar İngilizce Markdown dosyalarıdır; kodlama ajanlarının en iyi işlediği biçim budur. Ürün metinlerin, dizinin kabul ettiği herhangi bir dilde olabilir; ajan da sana kendi dilinde yanıt verir.

Onboarding panelde devam eder. Çalışma alanı dosyaları düz JSON ve Markdown olduğu için bir bilgiyi doğrudan editörde de düzeltebilirsin; ajan bir sonraki platformdan önce dosyaları yeniden okur.

LaunchRepo’yu üç adımda başlat →

Bir çalıştırma nasıl görünür

Cursor’da bir çalıştırmayı iki yerden izlersin: ajan paneli her araç çağrısını argümanlarıyla listeler, Chrome da sayfayı gösterir. Aşağıdaki panel ana sayfadaki örnek grup; gerçek durumlar submissions.json’dan gelir.

Tarayıcı sunucusu Cursor’da başarısız olursa

Cursor, hata veren bir MCP sunucusunu yalıtır; editörün geri kalanı çalışmaya devam eder. Tarayıcıyı genellikle şu üç kontrol geri getirir:

Ajan araçları görmüyor

Output panelini aç (Cmd/Ctrl+Shift+U) ve “MCP Logs”u seç. Sunucunun başlayıp başlamadığını, başarısız olup olmadığını ya da çöktüğünü gösterir. Customize’da kapatılmış bir sunucu hiç yüklenmez.

Eski bir sunucu sürümü çalışmaya devam ediyor

npm tabanlı sunucular için Cursor belgeleri sunucuyu kaldırmayı, npm cache clean --force çalıştırmayı ve yeniden eklemeyi önerir. Ardından Cursor’ı yeniden başlat.

Bir araç çağrısı form ortasında başarısız oldu

Cursor çağrıyı başarısız olarak işaretler. Yeniden denemeden önce sekmeye bak: form gönderilmediyse yeniden dene; gönderildiyse iki kez göndermek yerine ajanın sayfanın gösterdiğini kaydetmesine izin ver.

Tarayıcı araçları --autoConnect ile zaman aşımına uğrarsa dört şeyi kontrol et: Chrome 144 veya daha yenisi zaten çalışıyor olmalı, chrome://inspect/#remote-debugging adresinde uzaktan hata ayıklama açık olmalı, Chrome’un bağlantı istemine izin vermiş olmalısın ve aynı tarayıcıyı başka bir araç tutmamalı. Chrome DevTools MCP her açık sekmeyi yükler; ihtiyacın olmayanları kapat.

Hâlâ sana kalanlar

LaunchRepo bilinçli olarak bir arka plan hizmeti değildir. Şu anlar çalıştırmayı durdurur ve insana devir olarak kaydedilir; ajan asla etraflarından dolaşmaz:

CAPTCHA’lar ve bot kontrolleri

Ajan durur, prepared_needs_human kaydeder ve panel platformu “sana ihtiyaç var” altında listeler. Doğrulamayı Chrome sekmesinde çöz, sonra ajan panelinde ona devam etmesini söyle.

2FA ve doğrulama kodları

Onay e-postaları, bağlı Chrome’da oturumu açık olan posta kutusuna ulaşır. Orada değilse kodu sen iletirsin ve bu bir insana devir olarak kaydedilir.

Ücretli ek teklifler

Yalnızca ücretli yollar deferred_paid olarak kaydedilir. Bir araç çağrısı onaylanmış olsa bile ajan satın almaz, kartla başlayan bir deneme başlatmaz ya da ilgisiz bir teklifi kabul etmez.

“Yayında” olduğunu doğrulamak

Bir platformu, herkese açık URL’sini açtıktan sonra yayında olarak işaretlersin. O zamana kadar taslaklar, makbuzlar ve teşekkür sayfaları kendi durumlarını korur.

Benchmark yok, sıralama yok: Cursor için uyumluluk iddia etmemizin nedeni yukarıdaki iki koşulu karşılaması; onu başka ajanlarla karşılaştırarak ölçmüş olmamız değil.

Sorular