Logseq MCP: AI ajanlarına graph erişimi vermek

MCP burada yalnız "AI notlarımı okusun" özelliği değil.

Resmî dokümana göre yazma yetkisi de olan bir graph arayüzü.

Bu yüzden erişim sınırı ciddi düşünülmeli.

Desktop kurulum modeli

Belge desktop için üç adım tarif ediyor:

1. Settings > AI içinde MCP Server'ı aç.
2. HTTP Server için authorization token oluştur ve server'ı başlat.
3. Streamable HTTP destekleyen MCP istemcisini endpoint ve Bearer token ile yapılandır.

Doküman örnek olarak Gemini CLI ve LM Studio veriyor.

Bu iki örnek, desteklenen tek istemcilerin bunlar olduğu anlamına gelmez; kaynak yalnız örnek kurulum gösteriyor.

CLI üzerinden de çalışabilir

MCP Server desktop current graph dışında CLI üzerinden de local/current graph'a karşı çalıştırılabilir.

CLI yolunda ilk desktop switch adımı atlanabilir.

Bu, headless veya otomasyon senaryoları için önemli.

[[CLI bölümünde]] terminal tarafını ayrı işleyeceğiz.

Belgelenmiş yetenekler

Resmî DB belgesi şu yetenekleri sayıyor:

• node search
• pages create/list
• tags create/list
• properties create/list
• page'e block ekleme
• block title düzenleme
• batch create/edit
• yeni veya mevcut page/tag/property referansları
• app validation'larının create sırasında uygulanması.

Bu, MCP'nin graph schema'sını da anlayabildiğini gösteriyor.

Pretend seçeneği

En önemli güvenlik davranışlarından biri:

create/edit işlemlerinde pretend seçeneği.

Örneğin ajan birden fazla page veya block eklemeden önce hangi değişikliklerin yapılacağını hesaplatabilirsin.

Bu pattern, write erişimi olan ajanlarda çok değerlidir.

**Önce planlanan değişiklik → sonra gerçek write.**

Undo/redo

Belge current graph üzerinde yapılan değişikliklerin uygulamanın Cmd-Z undo/redo davranışına girebildiğini söylüyor.

Bu geri dönüş alanı verir.

Ama bunu yedek yerine koyma.

Undo oturum içi yanlış değişikliği düzeltebilir.

Backup veri kaybı ve bozulma için ayrı mekanizmadır.

TODO sınırları

Kaynak şu alanları MCP Server için TODO olarak listeliyor:

• pages/tags/properties düzenleme
• herhangi bir node type'a bağlı properties'i okuma/yazma
• block children read/write
• namespaces veya property values ile ilgili bazı işlemler.

Bu liste önemli.

MCP var diye graph'ın bütün veri modelinin eksiksiz API yüzeyi olduğunu varsayma.

Yetki modeli

HTTP Server token'ı erişim anahtarıdır.

Bu yüzden:

• token'ı not içine koyma,
• ekran görüntüsünde paylaşma,
• source control'a commit etme,
• kullanılmayan bağlantıyı kapat,
• agent write yapacaksa önce test graph kullan.

Kaynak bu güvenlik listesini tek tek vermiyor; bunlar token tabanlı write erişiminin doğal operasyon önlemleridir.

Gerçek kullanım

Araştırma

"Graph'ta local-first geçen node'ları bul ve ilgili pages'i listele."

İçerik üretimi

"Research page'e üç yeni child block ekle."

Schema hazırlığı

"Project tag'ini ve gerekli properties'i oluştur; önce pretend sonucu göster."

Üçüncü örnek write yetkisi nedeniyle en dikkatli kullanılması gereken alan.

Karar

Logseq MCP'nin farkı graph'ı yalnız okunabilir bağlam yapmaması.

**Resmî model search + schema create + content write alanına kadar gidiyor.**

Bu güç nedeniyle varsayılan yaklaşımın da güçlü olması gerekir:

test graph → pretend → küçük batch → sonucu kontrol → sonra genişlet.