Cursor Node
Cursor node'u, SkyStudio workflow'larında Cursor AI kod editörü platformuyla entegrasyon sağlar. Ekip üyelerini listeleyebilir, harcama ve kullanım verilerini sorgulayabilir, analitik raporlar alabilir ve Cursor AI asistanını doğal dil ile sorgulayabilirsiniz. Bağlantı için Cursor API Key kullanılır.
Bağlantı Kurulumu ve Yönetimi
Cursor node'unu kullanabilmek için Cursor hesabınızdan bir API Key almanız ve SkyStudio'ya eklemeniz gerekir.
🎬 Videoyu izlemek için tıklayın → []
Cursor API Key Alma
- Cursor uygulamasını açın.
- Üst menüden Dashboard seçeneğine tıklayın.
- Dashboard'un alt kısmındaki API Key bölümüne gidin.
- New API Key butonuna tıklayın.
- API Key'e bir isim verin ve Kaydet butonuna tıklayın.
- Oluşturulan API Key'i kopyalayın (
key_xxx...formatında).
Not: API Key yalnızca oluşturulduğu anda görüntülenir. Kaydetmeyi unutursanız yeni bir key oluşturmanız gerekir.
SkyStudio'ya Bağlantı Ekleme
- SkyStudio'nun üst menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı butonuna tıklayın.
- Sağlayıcı olarak Cursor seçin.
- Aşağıdaki alanları doldurun:
| Alan | Açıklama |
|---|---|
| Bağlantı Adı | Tanımlayıcı bir isim (örn. Şirket Cursor) |
| API Key | Cursor Dashboard'dan aldığınız API Key (key_xxx... formatında) |
- Kaydet butonuna tıklayın.
Bağlantıyı Node'a Atama
Cursor node'unu canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.
Operasyonlar
Cursor node'u 7 operasyon sunmaktadır:
| Operasyon | Kategori | Açıklama |
|---|---|---|
| Team Üyelerini Getir | Öne Çıkan | Cursor ekibindeki tüm kullanıcıları listeler |
| Harcama Verisi | Öne Çıkan | Kullanıcı bazında harcama verilerini sayfalama destekli getirir |
| Günlük Kullanım | Öne Çıkan | Belirli tarih aralığındaki günlük kullanım istatistiklerini döndürür |
| Analytics (Ekip) | Öne Çıkan | Ekip geneli analitik metriklerini tarih ve kullanıcı filtresiyle getirir |
| Cursor AI Asistan | Öne Çıkan | Doğal dil sorgusuyla Cursor verilerini sorgular |
| Kullanım Olayları (Detay) | Standart | Kullanıcı bazlı detaylı kullanım olaylarını listeler |
| Analytics (Kişi Bazlı) | Standart | Bireysel kullanıcı analitik metriklerini tarih filtresiyle getirir |
Team Üyelerini Getir
Cursor hesabınızdaki tüm ekip üyelerini (isim, e-posta, rol bilgileri) listeler.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Cursor bağlantısı |
Örnek Çıktı
{
"members": [
{
"id": "user_abc123",
"email": "ahmet@sirket.com",
"name": "Ahmet Yılmaz",
"role": "member"
},
{
"id": "user_def456",
"email": "ayse@sirket.com",
"name": "Ayşe Kaya",
"role": "admin"
}
]
}
Harcama Verisi
Kullanıcı bazında harcama verilerini listeler. Belirli bir kullanıcıya göre filtreleyebilir ve sıralama ile sayfalama uygulayabilirsiniz.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Cursor bağlantısı |
| Kullanıcı Filtresi | Hayır | Filtrelenecek kullanıcı bilgisi (örn. kullanıcı e-postası) |
| Sıralama | Hayır | Sonuçların sıralama yönü |
| Sayfa No | Hayır | Sayfalama için sayfa numarası (varsayılan: 1) |
| Sayfa Boyutu | Hayır | Bir sayfada döndürülecek kayıt sayısı |
Örnek Çıktı
{
"data": [
{
"user_email": "ahmet@sirket.com",
"total_cost": 12.50,
"currency": "USD",
"period": "2024-06"
}
],
"total": 15,
"page": 1
}
Günlük Kullanım
Belirtilen tarih aralığındaki günlük Cursor kullanım istatistiklerini döndürür. Hangi günlerde ne kadar kullanım yapıldığını takip etmek için kullanılır.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Cursor bağlantısı |
| Start Date | Hayır | Başlangıç tarihi (örn. 2024-06-01) |
| End Date | Hayır | Bitiş tarihi (örn. 2024-06-30) |
| Sayfa No | Hayır | Sayfalama için sayfa numarası |
| Sayfa Boyutu | Hayır | Bir sayfada döndürülecek kayıt sayısı |
Örnek Çıktı
{
"usage": [
{
"date": "2024-06-15",
"total_requests": 342,
"total_tokens": 128500,
"active_users": 8
}
]
}
Analytics (Ekip)
Ekip genelinde belirli bir metriğe ait analitik verileri tarih aralığı ve kullanıcı filtresiyle getirir.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Cursor bağlantısı |
| Metrik | Hayır | Sorgulanacak analitik metriği (örn. requests, tokens) |
| Start Date | Hayır | Başlangıç tarihi (örn. 2024-06-01) |
| End Date | Hayır | Bitiş tarihi (örn. 2024-06-30) |
| Kullanıcı Filtresi (CSV) | Hayır | Virgülle ayrılmış kullanıcı e-posta listesi (örn. ahmet@sirket.com,ayse@sirket.com) |
| Sayfa No | Hayır | Sayfalama için sayfa numarası |
| Sayfa Boyutu | Hayır | Bir sayfada döndürülecek kayıt sayısı |
Cursor AI Asistan
Doğal dil sorgusuyla Cursor verilerini sorgular. Videoda gösterildiği gibi "bu ay en çok Cursor kullanan 5 kişiyi göster" gibi serbest metin sorguları yazabilirsiniz.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Cursor bağlantısı |
| Query | Evet | Doğal dilde Cursor sorgusu |
| System Prompt | Hayır | AI asistanının davranışını özelleştiren sistem talimatı |
Kullanım Örneği
Query: "Bu ay en çok Cursor kullanan 5 kişiyi göster"
System Prompt: "Yalnızca bu ayki verileri kullan. Sonuçları Türkçe ve kullanım miktarına göre sıralı ver."
Kullanım Olayları (Detay)
Kullanıcı bazlı detaylı Cursor kullanım olaylarını listeler. Belirli bir kullanıcının aktivitelerini incelemek için kullanılır.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Cursor bağlantısı |
| Kullanıcı E-posta (opsiyonel) | Hayır | Olayları filtrelenecek kullanıcının e-postası |
| Sayfa No | Hayır | Sayfalama için sayfa numarası |
| Sayfa Boyutu | Hayır | Bir sayfada döndürülecek kayıt sayısı |
Analytics (Kişi Bazlı)
Bireysel kullanıcılar için analitik metrik verilerini tarih aralığı ve kullanıcı filtresiyle getirir. Ekip içindeki bireysel performans ve kullanım kıyaslamaları için kullanılır.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Cursor bağlantısı |
| Metrik | Hayır | Sorgulanacak analitik metriği |
| Start Date | Hayır | Başlangıç tarihi (örn. 2024-06-01) |
| End Date | Hayır | Bitiş tarihi (örn. 2024-06-30) |
| Kullanıcı Filtresi (CSV) | Hayır | Virgülle ayrılmış kullanıcı e-posta listesi |
| Sayfa No | Hayır | Sayfalama için sayfa numarası |
| Sayfa Boyutu | Hayır | Bir sayfada döndürülecek kayıt sayısı |
Hızlı Başlangıç Örnekleri
Örnek 1: Haftalık Cursor Kullanım Raporu
Ekibin haftalık Cursor kullanımını özetleyip Slack'e gönderen workflow:
Schedule (Her Pazartesi) → Günlük Kullanım → LLM (özetle) → Kanala Mesaj Gönder (Slack)
Günlük Kullanım ayarları:
- Start Date:
{{gecen_hafta_baslangic}} - End Date:
{{gecen_hafta_bitis}}
Örnek 2: En Aktif Cursor Kullanıcıları
Cursor AI Asistan'ı kullanarak en aktif geliştiricileri listeleyen workflow:
Schedule (Aylık) → Cursor AI Asistan → Metin Çıktısı
Cursor AI Asistan ayarları:
- Query:
"Bu ay en çok istek gönderen 10 kullanıcıyı sırala" - System Prompt:
"Sonuçları tablo formatında, Türkçe olarak ver."
Örnek 3: Maliyet Takip Panosu
Aylık harcama verilerini alıp yönetime raporlayan workflow:
Schedule (Ayın 1'i) → Harcama Verisi → LLM (rapor formatla) → Mail Gönder (Outlook)
Harcama Verisi ayarları:
- Sayfa Boyutu:
50 - Sıralama: Harcamaya göre azalan
Örnek 4: Kişisel Kullanım Chatbot'u
Çalışanın kendi Cursor kullanımını sorgulamasını sağlayan chatbot:
Metin Girişi → Cursor AI Asistan → Metin Çıktısı
Cursor AI Asistan ayarları:
- Query:
{{input.text}} - System Prompt:
"Sen Cursor kullanım asistanısın. Kullanıcıya kendi istatistiklerini Türkçe olarak açıkla."
Sık Karşılaşılan Hatalar
| Hata | Olası Neden | Çözüm |
|---|---|---|
401 Unauthorized | API Key geçersiz veya süresi dolmuş | Cursor Dashboard → API Key bölümünden yeni bir key oluşturun ve SkyStudio bağlantısını güncelleyin |
403 Forbidden | API Key'in yetkileri yetersiz | Cursor hesabında yönetici izinlerine sahip olduğunuzdan emin olun |
| Boş veri dönüyor | Tarih aralığında kayıt yok | Start Date / End Date aralığını genişletin |
404 Not Found | Kullanıcı filtresi hatalı | E-posta adresinin Cursor ekibinde kayıtlı olduğunu kontrol edin |
| AI Asistan yanıt vermiyor | Query alanı boş | Query alanına geçerli bir metin sorgusu girin |
Notlar
- Cursor API Key'i
key_xxx...formatındadır. Dashboard'dan oluşturulduğunda yalnızca bir kez görüntülenir; güvenli bir yerde saklayın. - Analytics (Ekip) ve Analytics (Kişi Bazlı) operasyonlarında Kullanıcı Filtresi alanı virgülle ayrılmış birden fazla e-posta kabul eder (örn.
a@sirket.com,b@sirket.com). - Cursor AI Asistan operasyonu, Fireflies AI Asistan'a benzer şekilde çalışır; doğal dil sorgusuyla ekip kullanım verilerini yorumlar.
- Günlük Kullanım ve Harcama Verisi operasyonlarında Start Date / End Date belirtilmezse API tüm geçmiş verileri döndürebilir; büyük ekiplerde sayfalama parametrelerini kullanın.
- API Key'i yenilemeniz gerektiğinde SkyStudio'daki bağlantıyı da güncellemeyi unutmayın.