Cursor, 28 Nisan 2026'da Cursor SDK'yı yayımladı: kendi kodunuzdan, script'lerinizden, CI hatlarınızdan ya da ürünlerinizden Cursor'ın kodlama agent'larını oluşturmanızı, çalıştırmanızı ve yönetmenizi sağlayan bir TypeScript API'si. Agent artık yalnızca bir IDE özelliği değil; çağırabildiğiniz bir headless çalışma zamanı. Bu rehber, CI/CD, otomasyon akışları ve mobil derleme hatları için neyin değiştiğini ve bunu blogda daha önce anlattığımız orkestrasyon desenlerine nasıl bağlayacağınızı adım adım anlatıyor.
Bir yıldır konuşma editörün içindeki daha akıllı kodlama agent'ları üzerineydi. Cursor SDK bunu tersine çeviriyor. IDE'nizde çalışan aynı agent, artık çağrılabilir bir servis. Ona bir görev veriyorsunuz, perde arkasında tam Cursor harness'ı devreye giriyor (kod tabanı indeksleme, MCP sunucuları, skill'ler, hook'lar, alt agent'lar) ve size pull request'e merge'leyebileceğiniz, Slack'e atabileceğiniz ya da bir sonraki akışa besleyebileceğiniz bir sonuç dönüyor. IDE bir gösterimdi. SDK ürün.
30 Saniyelik Özet
Cursor SDK Aslında Ne Yapıyor?
SDK, Cursor agent çalışma zamanı üzerinde ince bir TypeScript yüzeyi. Bir agent başlatıyorsunuz, ona hedef ve repo bağlamı veriyorsunuz, geriye event akışı geliyor. Perde arkasında agent, IDE'deki harness'la aynı şeyi kullanıyor: kod arama ve indeksleme, araçlar için MCP sunucuları, skill'ler, hook'lar ve alt agent'lar. Sizin kodunuzdan bakınca, yapılandırılmış sonuç döndüren bir async fonksiyon gibi görünüyor.
- Bir agent oturumu için programatik create / run / cancel, durum ve event akışıyla.
- Tam Cursor harness'ı: hedef repo'nun indekslenmesi, MCP sunucuları, skill'ler ve hook'lar çalışan agent'a açık.
- Her TypeScript çalışma zamanına takılabilir: bir CI işi, bir Cloudflare Worker, bir n8n custom node'u ya da bir mobil derleme sunucusu.
- Editör koltuğu başına değil, agent çalışması başına kullanım temelli ücretlendirme — fatura birimi iş birimine eşit.
Asıl kayma şu: bir agent çalışması artık birleştirilebilir bir birim. Bir tane başlatıyorsunuz, bekliyorsunuz, sonuca göre dallanıyorsunuz, üç tane daha açıyorsunuz ve çıktıyı bir sonraki aşamaya aktarıyorsunuz. Tam olarak n8n'de ya da CI YAML'ında zaten yazdığınız akışların biçimi bu, ve Cursor sonunda bu biçime oturdu.
Headless Agent Çalışma Zamanları Neden Önemli?
Kodlama agent'ları IDE'lerde yaşıyordu çünkü bağlam orada kolaydı. Bir model elde kod tabanı, imleç konumu ve açık dosyalar olunca yararlı iş çıkarıyor. Bedeli ise her şeyin geliştiricinin editöründe çalışması. Cursor SDK aynı yeteneği sunucu tarafı bir çalışma zamanına itiyor ve bu üç pratik şeyi açıyor:
İnsan döngüde olmadan CI/CD
Kırılan bir test, sallantılı bir derleme ya da rutin bir refactor artık geliştiricinin laptopu açmasını gerektirmiyor. Bir hat adımı agent'ı çağırıyor, agent diff'i ve kırık logları okuyor, taze bir branch'te düzeltme uyguluyor ve incelenmek üzere bir pull request açıyor. İnsanın işi yazmaktan karar vermeye geçiyor.
Kendi ürününüzde gömülü agent'lar
Kod'a dokunan bir SaaS sunuyorsanız (güvenlik tarayıcısı, uyumluluk botu, göç aracı), artık ürünün içine ince bir LLM çağrısı iliştirmek yerine gerçek bir kodlama agent'ı çalıştırabilirsiniz. Harness onunla birlikte geliyor.
Tahmin edilebilir, kullanım temelli ekonomi
Koltuk başına fiyatlandırma, agent bir editör eklentisiyken anlamlıydı. Agent altyapı olunca anlamlı değil. Çalışma başına kullanım temelli fiyat, ekiplerin bugün otomasyona harcama biçimine uyuyor; biçim olarak Lambda, n8n Cloud ya da modern serverless yüklerle aynı.
Kategori tek bir desende toparlanıyor: headless bir agent çalışma zamanı, etrafında programlanabilir bir harness, üstte kullanım temelli fiyat. Codex app-server, Cursor SDK ve VS Code harness çalışmaları aynı yöne işaret ediyor.
Baştan Sona CI/CD Deseni
Cursor, ilk üretim kullanımının en yaygını CI/CD diyor. Pratikte bir akış şöyle görünüyor; agent, daha önce bir junior geliştiricinin elle yaptığı parçaları üstleniyor:
| Hat adımı | Eski (insan) | Yeni (Cursor SDK) |
|---|---|---|
| PR açıldı | İnceleyici diff'i okuyor | Agent, diff'in sade dilde özetini yorum olarak gönderiyor |
| Testler kırıldı | İnceleyici yerelde tekrar üretiyor | Agent log'ları okuyor, mantıksal olarak tekrar üretiyor ve olası nedeni gösteriyor |
| Düzeltme uygulandı | İnceleyici yamayı yazıyor | Agent, alt branch'te aday bir düzeltme bırakıyor |
| PR güncellendi | İnceleyici yeni commit push'luyor | Agent PR'ı düzeltmeyle ve değişiklik notuyla güncelliyor |
| Merge | İnsan onayı | İnsan onayı (bilinçli olarak değişmedi) |
Dikkat edin: insan merge kapısında kalıyor. SDK yargıyı almıyor, yazmayı alıyor. Üretimde her agent kullanımı için doğru çizgi bu; aynı çizgi için LLM kodunu incelemek neden zor yazımızda da savunmuştuk: agent kod yazabilir ama merge'in sahibi insandır.
Halmob Yığınına Nasıl Oturuyor?
Geçimimizi mobil uygulama ve n8n otomasyonu kurmaktan sağlıyoruz; SDK her iki tarafa da oturuyor. Asıl ilginç olan yeni bir aracın çıkması değil; yıl boyu yazdığımız orkestrasyon katmanının — agentik kodlamanın orkestrasyon çağı yazımıza bakın — artık takılacak temiz bir kodlama-agent ilkellik kazanması.
Kodlama agent'ı çağıran n8n akışları
n8n'e bir HTTP düğümü ekleyin: hedef ve repo URL'si ile bir Cursor agent çalışması tetikliyor. Sonuç için bir wait düğümü, ardından özeti Slack'e gönderen ya da PR açan bir yönlendirme düğümü. Diğer her API için kullandığımız desen artık kod için de işliyor. n8n'i ölçekte çalıştırıyorsanız, n8n ECS Fargate yük testi sonuçlarımız bu akışın host tarafının maliyet biçimini veriyor.
Mobil derleme ve yayın hatları
SwiftUI ve Android hatları agent yardımından en çok faydalanan yer. Yayının sıkıcı %30'u — sürüm numaralarını yükseltmek, sürüm notlarını yazmak, sallantılı bir snapshot testini düzeltmek, yerelleştirilmiş metinleri yeniden üretmek — tam olarak bir agent'ın baştan sona yapabileceği iş. iOS geliştirme için Cursor rehberimiz cihaz tarafının resmini çiziyor; SDK ise siz uyurken çalışan sunucu tarafı eşi.
Bir işçi havuzunda yönlendirme
Bir Cursor agent çalışması bir işçi. Üstündeki küçük bir yönlendirici, ne zaman onu, ne zaman daha ucuz bir modeli çağıracağına karar veriyor — Sakana'nın Conductor'ının genel agent'lar için yaptığı gibi. Bu deseni Sakana Conductor çoklu agent orkestrasyonu yazımızda anlatmıştık; SDK ile o havuzdaki "kodlama agent'ı" alanı artık gevşek bir soyutlama değil.
Mobil Otomasyon İçin Neden Önemli?
Beş Pratik Kullanım Senaryosu
Her pull request'i otomatik özetleme
PR açıldığında bir agent diff'i okuyor ve sade dille bir özet artı risk notu paylaşıyor. İnceleyiciler artık göz gezdirmiyor, gerçekten inceliyor. PR başına birkaç sent.
CI'da kırılan testlerin kök neden analizi
Kırmızı build'de agent log'ları okuyor, ilgili dosyaları açıyor, mantıksal olarak hatayı tekrar üretiyor ve olası nedenle birlikte aday düzeltmeyi PR yorumu olarak paylaşıyor. Rutin kırılmalarda yeşile dönüş süresini ciddi biçimde kısaltıyor.
Rutin refactor ve göçler
Bir SDK'nın major sürümünü yükseltmek, kullanım dışına çıkmış bir API'yi değiştirmek, kod tabanında bir alanı yeniden adlandırmak. Tek satırlık bir script'le agent'ı tetikleyip her değişiklik kümesi için bir PR açmasına izin verin; toplu olarak inceleyin.
Mobil yayın hazırlığı
Etiketlenen her sürümde agent, merge edilmiş PR'lardan sürüm notlarını üretiyor; iOS ve Android projelerinde sürüm numaralarını yükseltiyor; yerelleştirilmiş mağaza listelerini güncelliyor. Hat yayınlıyor, agent yazıyor.
Kendi SaaS'ınızda gömülü agent
Ürününüz bir müşterinin kod tabanına dokunuyorsa, SDK genel LLM önerileri yerine gerçek kod-bilinçli aksiyonlar sunmanızı sağlıyor. Harness, indeksleme ve araç çağrıları çalışma zamanında zaten hazır.
Nasıl Başlarsınız?
- 1Bugünkü CI'ınızda sıkıcı, tekrarlayan tek bir hat adımı seçin. PR açıldığında özet, başlamak için en ucuz nokta.
- 2Cursor SDK'yı tek bir agent çalışmasıyla bağlayın; özeti PR yorumu olarak göndersin. İnsan merge kapısına dokunmayın.
- 3Çıktıya güvenmeye başlayınca ikinci bir senaryo ekleyin: kırılan testler için kök neden analizi. Aynı SDK, farklı prompt ve araçlar.
- 4Çalışma başına maliyeti, kazandırılan zamanla yan yana izleyin. Headless agent çalışmaları kullanım temelli olduğu için ROI tartışması her bulut yükündekiyle aynı.
- 5Üç ya da daha fazla agent adımı ortak durum paylaştığında tek seferlik SDK çağrılarından bir n8n akışına geçin. Orkestrasyon orada karşılığını vermeye başlıyor.
Agent yığınının kelimelerini hâlâ harmanlıyorsanız, OpenClaw 101 yeni başlayanlar rehberimiz yapı taşlarını anlatıyor (araçlar, skill'ler, izinler, bellek). Cursor SDK, ek bir tesisat gerektirmeden bu resme oturan, koda özelleşmiş bir işçi veriyor.
Son Söz
2026'da agentik kodlamadaki asıl heyecan verici hikâye daha akıllı bir editör değil. Kodlama agent'larının altyapıya dönüşmesi. Cursor SDK bunun bugüne kadarki en temiz kanıtı: headless çalışma zamanı, programlanabilir harness, kullanım temelli fiyat ve ilk büyük üretim kullanımı olarak CI/CD. Önümüzdeki iki yılın otomasyonunun biçimi bu.
Sonraki sprint'e taşıyacağınız soru basit. Hatlarınızdaki hangi adım hâlâ bir insanın yazmasına bağlı — oysa bir agent çalışması aynı işi gece boyunca bitirebilir, sizse sadece merge'in sahibi olarak kalırdınız?