İçeriğe geç
nitorel
7 GÜNSistemine başlaİlk sistemini yedi günde kur
Öğren
YazılarKaynaklı yazı dizileriKavramlarKavram kasası, formatlarSistemlerYöntemler, iş akışlarıKütüphaneKitaplar, kaynaklar
Kullan
AraçlarTarafsız araç atlasıNot DenetçisiÜcretsiz kontrol ↗nitoreldumpZihnini boşalt ↗nitorelhabitAlışkanlık takibi ↗
HakkındaŞablonlar 1 ücretsiz
kasa/yazilar/affine/03-affine-mcp.md

Rehber · Not 105Deneyim

AFFiNE MCP: Claude ve Cursor notlarını okuyabilirse ne değişir?

AFFiNE'in yerleşik MCP sunucusu, Settings → Integrations → MCP Server yolundan açılır. Varsayılan iki aracı yalnız okur: belge araması ve belge okuma. Yazma araçları kademeli geliyor. Sunucu, AI özelliği açık bir bulut ya da kendi sunucu çalışma alanı ister; yalnız cihazdaki çalışma alanına erişmez.

Yazan Ahmet Canal · 5 Ekim 2026

[[affine]][[mcp]][[yapay-zeka]]
Okuma
3 dk
Yayın
5 Ekim 2026
Geri bağlantı
9
Kaynak
4
İçindekiler · 5 bölüm
Ne yapıyorNasıl açılıyorHangi çalışma alanında çalışırTopluluk sunucusuSecond brain değişir mi
Bilgi ağı · 8 bağlantılı not
Dizi · 3 / 24AFFiNE’i Adım Adım Kullanmak
  1. 01AFFiNE nedir? Belge, tahta ve veritabanı tek çalışma alanında
  2. 02AFFiNE'de yazı ve tahta aynı çalışmada
  3. 03AFFiNE MCP: Claude ve Cursor notlarını okuyabilirse ne değişir?
  4. 04AFFiNE'e veri taşımak: Notion, Obsidian, OneNote ve Bear
  5. 05AFFiNE 2026: 0.25, 0.26 ve 0.27 ile ne değişti?
  6. 06AFFiNE nasıl çalışıyor? BlockSuite, CRDT ve local-first mimarinin kökeni
  7. 07AFFiNE'i seçmeden önce: güçlü tarafları, sınırları ve 2026 gerçekliği
  8. 08AFFiNE'i CMS gibi kullanmak: kendi bloglarını nasıl kurdular?
  9. 09AFFiNE local-first: veri gerçekten nerede başlıyor?
  10. 10AFFiNE Cloud, yerel çalışma ve self-host: hangisini seçmelisin?
  11. 11AFFiNE self-host: Docker ile kendi sunucunda çalıştırmak ne kazandırır?
  12. 12AFFiNE self-host etmeden önce: yedek, güncelleme ve geri dönüş planı
  13. 13AFFiNE'de veri yaşam döngüsü: içe aktarma, çalışma, senkronizasyon ve çıkış
  14. 14AFFiNE Database: notları tabloya sıkıştırmadan yapılandırmak
  15. 15AFFiNE Calendar View: Database kayıtlarını takvimde görmek
  16. 16AFFiNE takvim entegrasyonları: Google Calendar ve CalDAV ne yapıyor?
  17. 17AFFiNE AI: bilgi tabanına yapay zekâ eklenince ne değişiyor?
  18. 18AFFiNE BYOK: kendi AI API anahtarını kullanmak ne kazandırıyor?
  19. 19AFFiNE MCP kullanım senaryoları: Claude, Cursor ve ChatGPT notlarına nasıl erişir?
  20. 20AFFiNE'den çıkmak kolay mı? Vendor lock-in testi
  21. 21AFFiNE mobil: iOS ve Android günlük bilgi sistemi için yeterli mi?
  22. 22AFFiNE 2022'den 2026'ya nasıl değişti?
  23. 23AFFiNE kullanmalı mısın? 30 günlük karar testi
  24. 24AFFiNE yedekleme ve kurtarma: sync varken neden yine yedek gerekir?
Kısaca

AFFiNE'in kendi MCP sunucusu **Settings → Integrations → MCP Server** yolundan açılır. Varsayılan iki araç yalnız okur: `doc_search` ve `read_document`. Belge oluşturan ve güncelleyen araçlar kademeli olarak geliyor. Her istemciye ayrı, süreli ve geri alınabilir bir kimlik bilgisi verilir. Sunucu, AI özellikleri açık bir AFFiNE Cloud ya da kendi sunucu çalışma alanında çalışır. Yalnız cihazda duran yerel çalışma alanına bu yoldan erişilmez.

MCP (Model Context Protocol), bir yapay zekâ istemcisinin dış bir kaynağa araçlar üzerinden bağlanmasını sağlayan protokoldür. Obsidian tarafında aynı soru [[Obsidian ve yapay zekâ]] yazısında. Anytype'ın karşılığı Anytype dizisinde: [[Anytype MCP ve API v2]].

Ne yapıyor

AFFiNE'in MCP sayfası araçları iki gruba ayırır (AFFiNE, MCP):

AraçNe yaparDurum
`doc_search`Çalışma alanındaki belgelerde anahtar sözcük ve anlam aramasıVarsayılan, yalnız okur
`read_document`Bir belgenin tam içeriğini kimliğiyle getirirVarsayılan, yalnız okur
`create_document`Belge oluştururKademeli olarak geliyor
`update_document`Belge içeriğini güncellerKademeli olarak geliyor
`update_document_meta`Belgenin üst verisini güncellerKademeli olarak geliyor

Sayfa, belgelerin ve beyaz tahtaların aranabildiğini söyler. Varsayılan durumda yapay zekâ notlarını bulur ve okur, değiştirmez.

Nasıl açılıyor

Sayfanın yazdığı yol ve koşullar (AFFiNE, MCP):

  1. Çalışma alanında **Settings → Integrations → MCP Server**'a gir.
  2. Her istemci için ayrı bir kimlik bilgisi oluştur ve bitiş tarihi ver. Bir bilgiyi istediğin an yenileyebilir ya da iptal edebilirsin.
  3. Kimlik bilgisi tek bir çalışma alanıyla sınırlıdır ve mevcut belge izinlerine uyar.
  4. Sunucu standart "streamable HTTP" konuşur. Sayfa Claude Code, Cursor, Cline ve LobeHub'ı örnek verir. Uzak sunucu için özel başlık gönderemeyen istemciler `mcp-remote` köprüsüyle bağlanır.

Sayfa özelliğin hem bulutta hem kendi sunucunda ücretsiz olduğunu yazar.

Hangi çalışma alanında çalışır

MCP sayfası koşulu açık yazar: AI özellikleri açık AFFiNE Cloud ya da kendi sunucu kurulumları. Kendi sunucunda AI özelliklerinin kurulumda açık olması gerekir (AFFiNE, MCP).

Bunu [[ilk bölümdeki]] iki çalışma alanı türüyle birlikte oku. Local Workspace yalnız o cihazda durur (AFFiNE, Workspaces). MCP sunucusu ise sunucu tarafındadır. Topluluğun yazdığı ayrı bir MCP sunucusunun README'si de aynı sınırı koyar: yalnız sunucuda tutulan çalışma alanlarına erişebilir; tarayıcının yerel deposunda duran çalışma alanları AFFiNE'in sunucu API'lerinden görünmez (DAWNCR0W, README).

Pratik sonuç şudur: Claude'un notlarını okumasını istiyorsan o notların bir sunucuda durması gerekir. AFFiNE Cloud'u ya da [[kendi sunucunu]] seçersin. Notu yalnız cihazda tutmak ile MCP'den okutmak bu sürümde aynı çalışma alanında birleşmez.

Topluluk sunucusu

DAWNCR0W/affine-mcp-server, resmî olmayan, MIT lisanslı bir projedir. README'si 106 araç, stdio ve HTTP bağlantısı, veritabanı ve yorum iş akışları sayar. Aynı README iki sınır da yazar: AFFiNE 0.27 ve sonrası eski kişisel erişim jetonu API'sini kaldırmıştır; AFFiNE Cloud bu dış entegrasyon için tarayıcı oturumuyla kimlik doğrulama ister (DAWNCR0W, README).

Yazma yetkisi geniş bir topluluk aracını kişisel kasana bağlamadan önce kodu kimin yazdığına ve neye eriştiğine bak. Resmî sunucunun varsayılanı bu yüzden daha dar: önce okuma.

Second brain değişir mi

14 Mayıs 2026 yazısı AFFiNE'in üçüncü taraf yapay zekâ ajanlarıyla ve dış otomasyonlarla daha kolay kullanılmasını hedef olarak koyar; veri sahipliğinin kullanıcıda kalması şartıyla (Chen, 2026). Yerleşik MCP sunucusu bu hedefin bugün kullanılabilen parçasıdır.

Notların aynı kalır; değişen, onları kimin okuduğudur. Sorulacak sorular:

SoruNeden önemli
Ajan hangi çalışma alanını görüyor?Kimlik bilgisi tek çalışma alanıyla sınırlı; kişisel ve iş notunu ayır
Yalnız okuyor mu, yazıyor mu?Varsayılan okuma. Yazma araçları gelince ayrı bir karar ver
Bilgi ne zaman bitiyor?Bitiş tarihi koy; kullanmadığın istemcinin bilgisini iptal et
Ajanın cevabını kim denetliyor?Okuduğu nottan çıkardığı özet yanlış olabilir

Son satırın gerekçesi [[yapay zekâ özetlerinde insan denetimi]] yazısında. Ajanın okuyacağı notları nasıl düzenleyeceğin, yani kaynağı ve tarihi belli not, [[ajana hazır kasa]] yazısında.

Diyelim ki ders notların AFFiNE Cloud'da bir çalışma alanında. Claude Code için bir kimlik bilgisi açıp bir hafta süre verirsin. Claude `doc_search` ile "çalışma belleği" geçen notları bulur, `read_document` ile okur ve sana bir tekrar listesi çıkarır. Notlarına dokunmaz. Hafta bitince bilgi kendiliğinden geçersiz olur.

Bu yazıda geçen araçlar

AFFiNEBelge, beyaz tahta ve veritabanını aynı sayfada birleştiren açık kaynak çalışma alanı.Freemium · Yerel + senkron

Araçlar örnek içindir; hiçbiri zorunlu değil. Karşılaştırma için araç atlasına bak.

Kaynaklar

Kaynak profili4 web

  1. AFFiNE. *AFFiNE MCP Server — Connect AI to Your Knowledge Base* (son güncelleme 20 Ağustos 2026). affine.pro/mcp web
  2. AFFiNE. *Workspaces*. docs.affine.pro/core-concepts/elements-of-affine/workspaces web
  3. DAWNCR0W. *affine-mcp-server* (topluluk projesi, README). github.com/DAWNCR0W/affine-mcp-server web
  4. Chen, V. (2026, 14 Mayıs). *AFFiNE's Next Chapter: Open Files, Open Source, and Agent-Ready Workflows*. affine.pro/blog/next-chapter-of-affine 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.

Ahmet Canal

Ahmet Canal

Dijital ürünler geliştiriyor, bilgi mimarisi ve sistem tasarımı üzerine çalışıyorum. Nitorel’i, notlarımı ihtiyaç duyduğum anda yeniden bulma derdinden yola çıkarak yazıyorum.

kaynak-notlari/kaynak-notu-affine-mcp.md#kaynak-notu
Kasana al

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.

Kasan yok mu? Ücretsiz Starter Vault
gelen-kutusu/haftalik-not.md#bülten · haftada bir
Bülten

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.

← Önceki bölümAFFiNE'de yazı ve tahta aynı çalışmadaSonraki bölüm →AFFiNE'e veri taşımak: Notion, Obsidian, OneNote ve Bear
Bu yazıya bağlananlar
←Anytype MCP ve API v2: kasayı programla okumak ve yazmakAnytype←Notlarımı yapay zekâya vermek istemiyorum: BYOK, yerel model ve gizlilikYapay zekâ←AFFiNE mi Anytype mı? Hangi düşünme biçimine hangi araçAraç seçimi←Kendi sunucunda ikinci beyin: AFFiNE ve Anytype'ı self-host etmek mantıklı mı?Yerel öncelik←AFFiNE 2026: 0.25, 0.26 ve 0.27 ile ne değişti?AFFiNE←AFFiNE'i seçmeden önce: güçlü tarafları, sınırları ve 2026 gerçekliğiAFFiNE←AFFiNE resmi kaynak haritası: hangi yazı neyi kanıtlıyor?AFFiNE←AFFiNE AI: bilgi tabanına yapay zekâ eklenince ne değişiyor?AFFiNE
Bu ağda devam et
→Anytype MCP ve API v2: kasayı programla okumak ve yazmakAnytype→Notlarımı yapay zekâya vermek istemiyorum: BYOK, yerel model ve gizlilikYapay zekâ→Obsidian ve Yapay Zekâ 2: MCP, Skill'ler ve Karpathy'nin LLM Wiki YöntemiObsidian→Bağlam Mühendisliği, Yapay Zekâya Hazır Kasa ve Köken BilgisiYapay zekâ→Yapay Zekâ Özetlerinde Güvenlik ve İnsan DenetimiYapay zekâ→AFFiNE nedir? Belge, tahta ve veritabanı tek çalışma alanındaAFFiNE→Kendi sunucunda ikinci beyin: AFFiNE ve Anytype'ı self-host etmek mantıklı mı?Yerel öncelik→AFFiNE mi Anytype mı? Hangi düşünme biçimine hangi araçAraç seçimi
OKUMA İLERLEMESİ0%
İÇİNDEKİLER5
Ne yapıyorNasıl açılıyorHangi çalışma alanında çalışırTopluluk sunucusuSecond brain değişir mi
Bilgi ağı9 not · 16 bağ
bu notAnytype MCP ve API v2: kasayı programla okumak ve yazmakAnytype MCP ve…Notlarımı yapay zekâya vermek istemiyorum: BYOK, yerel model ve gizlilikNotlarımı yapa…Obsidian ve Yapay Zekâ 2: MCP, Skill'ler ve Karpathy'nin LLM Wiki YöntemiObsidian ve Ya…Bağlam Mühendisliği, Yapay Zekâya Hazır Kasa ve Köken BilgisiBağlam Mühendi…Yapay Zekâ Özetlerinde Güvenlik ve İnsan DenetimiYapay Zekâ Öze…AFFiNE nedir? Belge, tahta ve veritabanı tek çalışma alanında…nedirKendi sunucunda ikinci beyin: AFFiNE ve Anytype'ı self-host etmek mantıklı mı?Kendi sunucund…AFFiNE mi Anytype mı? Hangi düşünme biçimine hangi araç…mi Anytype mı

→ verdiği← gelen↔ karşılıklı

AFFiNE MCP: Claude ve Cursor notlarını okuyabilirse ne değişir?Bir notun üstüne gel; bağlarını gör.
BU AĞDA DEVAM ET
01Anytype MCP ve API v2: kasayı programla okumak ve yazmak02Notlarımı yapay zekâya vermek istemiyorum: BYOK, yerel model ve gizlilik03Obsidian ve Yapay Zekâ 2: MCP, Skill'ler ve Karpathy'nin LLM Wiki Yöntemi04Bağlam Mühendisliği, Yapay Zekâya Hazır Kasa ve Köken Bilgisi
Tüm yazılara dön ↗
[[Zettelkasten]][[İkinci Beyin]][[PARA]][[Evergreen notlar]][[Atomik not]][[İçerik Haritası]][[Aşamalı özetleme]][[Haftalık gözden geçirme]][[Obsidian]][[Geri bağlantılar]][[Zettelkasten]][[İkinci Beyin]][[PARA]][[Evergreen notlar]][[Atomik not]][[İçerik Haritası]][[Aşamalı özetleme]][[Haftalık gözden geçirme]][[Obsidian]][[Geri bağlantılar]]
nitorel

Notlarını bir işe yarasın diye tutanlar için. Kişisel bilgi yönetimi üzerine Türkçe yöntemler, rehberler ve sistemler.

İlk notunu bağla
KeşfetBaşlangıçYazılarKavramlarMarkdown SözlüğüFormat Rehberi
UygulaSistemlerAraçlarNot Denetçisi ↗nitoreldump ↗Kütüphane
NitorelHakkındaŞablonlarBülten arşiviDeğişikliklerKünyeİletişim
İçerikler CC BY 4.0 · © 2026 Nitorel · Ürünler ve marka unsurları hariç. Ahmet Canal tarafından tasarlanmıştır. RSS
GizlilikÇerezlerKVKKKoşullarİade
İstanbul --:--Başa dön
Nitorel.