Rehber · Not 126Deneyim
AFFiNE MCP kullanım senaryoları: Claude, Cursor ve ChatGPT notlarına nasıl erişir?
AFFiNE'in yerleşik MCP sunucusunu gerçek iş akışlarıyla açıklar: workspace arama, belge okuma, whiteboard bağlamı, Claude Code, Cursor ve ChatGPT bağlantısı. Read-only varsayılanını ve kademeli read/write rollout'unu ayırır.
Yazan Ahmet Canal · 5 Ekim 2026
- Okuma
- 3 dk
- Yayın
- 5 Ekim 2026
- Geri bağlantı
- 2
- Kaynak
- 3
İçindekiler · 12 bölüm
Bilgi ağı · 4 bağlantılı not
Serinin üçüncü bölümünde MCP'nin ne olduğunu ve AFFiNE'e nasıl geldiğini anlattık.
Bu bölümde asıl soru:
Bağladıktan sonra ne yaparsın?
Güncel MCP modeli
AFFiNE'in güncel MCP sayfası sunucuyu:
- resmî,
- workspace'e bağlı,
- HTTP üzerinden erişilen,
- credential ile doğrulanan
bir entegrasyon olarak tarif ediyor.
Varsayılan erişim read-only.
Bağlı asistan:
- workspace'te arama yapabilir,
- ilgili belgeleri okuyabilir,
- whiteboard içeriğini arama bağlamına dahil edebilir.
Güncel sayfa, read-and-write modun kademeli olarak dağıtıldığını da belirtiyor.
Bu ayrım güvenlik açısından önemli.
"Agent bağlandı" cümlesi otomatik olarak "notlarımı değiştirebilir" anlamına gelmez.
Senaryo 1 — eski kararın kaynağını bul
Bir proje reposunda çalışıyorsun.
Claude Code'a sor:
"Payment retry kararını neden 3 denemeyle sınırlamıştık? AFFiNE workspace'teki ilgili notu bul."
MCP akışı:
- asistan AFFiNE search aracını çağırır,
- ilgili dokümanı bulur,
- içeriği okur,
- yanıtını gerçek nottaki bağlama dayandırır.
Buradaki kazanç kopyala-yapıştır azaltmak.
Modelin hafızasına güvenmek yerine çalışma alanını sorgularsın.
Senaryo 2 — kod ile ürün kararını birleştir
Cursor açık.
Bir feature üzerinde çalışırken:
"Bu ekran için AFFiNE'deki onboarding kararlarını bul ve mevcut komponentle çelişen maddeleri listele."
Bu senaryo kod tabanı ile ürün bilgisini aynı konuşmada buluşturur.
MCP'nin değeri burada API sayısından çok bağlam taşıma maliyetini azaltmasıdır.
Senaryo 3 — toplantı öncesi hazırlık
Claude Desktop veya ChatGPT gibi desteklenen MCP istemcisinde:
"Acme ile son üç görüşmenin notlarını bul. Açık kararları ve cevaplanmamış soruları çıkar."
Doğru workspace ve yetki sınırları içinde asistan notları arayıp özetleyebilir.
Burada dikkat:
Asistanın çıktısı kaynak notların yerine geçmez.
Toplantıdan önce kritik maddeleri açıp kontrol et.
Senaryo 4 — whiteboard içeriğini bulmak
AFFiNE'in güncel MCP açıklaması dokümanlarla birlikte whiteboard aramasını da vurguluyor.
Bu, AFFiNE'i yalnız metin deposu olarak kullanan MCP entegrasyonlarından ayıran ilginç taraf.
Örneğin:
"Checkout akışının whiteboard'unda hangi alternatifler vardı?"
gibi bir soru, görsel düşünme yüzeyini de bilgi erişiminin parçası yapabilir.
Credential başına istemci
Ağustos 2026 resmî MCP rehberi iyi bir operasyon alışkanlığı öneriyor:
Her istemci için ayrı credential.
Örneğin:
- Claude Code
- Cursor
- ChatGPT
için ayrı erişim bilgisi.
Bunun avantajı:
Bir istemciyi kapatmak istediğinde diğer bağlantıları bozmadan yalnız o credential'ı iptal edebilirsin.
Read-only neden iyi başlangıç?
İlk aşamada AI'nın şunları yapması yeterli olabilir:
- ara,
- oku,
- özetle,
- karşılaştır.
Yazma yetkisi eklenince risk alanı büyür:
- yanlış dokümanı güncelleme,
- metadata değiştirme,
- kaynağı bozma,
- istemeden içerik üretme.
Bu yüzden write erişimi açıldığında bile önce dar bir workspace ve geri döndürülebilir görevlerle test et.
Claude, Cursor ve ChatGPT
AFFiNE'in Ağustos 2026 rehberi:
- Claude Code için remote HTTP MCP bağlantısını,
- Claude Desktop için Connectors yolunu,
- Cursor için MCP JSON yapılandırmasını,
- ChatGPT için remote connector yaklaşımını
anlatıyor.
Arayüz adımları zamanla değişebilir. Güncel client dokümanını bağlantı sırasında kontrol et.
Nitorel açısından önemli olan ortak mimari:
tek AFFiNE workspace → standart MCP endpoint → farklı AI istemcileri.
MCP ile AI özelliğini ayır
AFFiNE AI ve AFFiNE MCP aynı şey değil.
AFFiNE AI
AI, AFFiNE arayüzünün içinde.
AFFiNE MCP
Dış AI istemcisi AFFiNE bilgisine erişiyor.
Bu yüzden seçim şöyle olabilir:
- notun içindeyken yardım istiyorsan AFFiNE AI,
- kod yazarken notlarına erişmek istiyorsan MCP,
- farklı ajanları aynı bilgi kaynağına bağlamak istiyorsan MCP.
Karar
MCP'nin en iyi kullanımı "AI her şeyi yapsın" değil.
Doğru bağlamı doğru araca gerektiği anda taşı.
AFFiNE bu konuda güçlü bir avantaj sunuyor: bilgi tabanını tek bir model sağlayıcısına bağlamak yerine standart protokol üzerinden farklı istemcilere açabiliyor.
Başlangıç yetkisi için read-only daha güvenli varsayımdır.
Bu yazıda geçen araçlar
Araçlar örnek içindir; hiçbiri zorunlu değil. Karşılaştırma için araç atlasına bak.
Kaynaklar
Kaynak profili3 web
- AFFiNE. AFFiNE MCP Server — Connect AI to Your Knowledge Base. affine.pro/mcp web
- Toeverything. (2026, 19 Ağustos). How to Add MCP Servers to Claude Code and Claude Desktop. affine.pro/blog/claude-code-mcp-setup web
- Allen. (2025, 2 Aralık). What's New: Dec Update — AFFiNE 0.25. affine.pro/blog/whats-new-dec-update web
Deneyim: Editöryal pratik ve kitaplara dayanıyor; birincil araştırma içermiyor. Türler kaynak metninden otomatik çıkarılır. Tüm kaynaklar ve onları anan yazılar Kütüphane’de.
Bu notu kasana al.
Yazının özeti, başlıkları, devam yazıları ve kaynakları Obsidian’a hazır bir kaynak notu olarak iner. “Kendi notum” bölümünü sen doldurursun; okuduğun yazı böylece kasanda bir bağlantıya dönüşür.
Haftada bir not, gelen kutuna bağlansın.
Yeni yazılar ve uygulanabilir tek bir fikir. Reklam yok, istediğin an tek tıkla ayrılırsın.