# Mind Key ve JWT — Hangisi Ne Zaman?
SUMMARY: Karar rehberi: ajan veri erişimi için Mind Key, hesap yönetimi için JWT.

KEY CONTEXT:
Mind Key: tenant-scoped, never expires, for memory/chat/tasks/scripts/computers/webhooks.
JWT: user-scoped, 7-day expiry, for /register, /login, /minds (CRUD), /sharing, /push.
Simple rule: if it touches a single mind's data → Mind Key. If it manages the account → JWT.
Exception: /computers/me/* uses Computer Token (not Mind Key or JWT).

Mind Key ve JWT — Hangisi Ne Zaman?
Synapse'te iki kimlik doğrulama token'ı vardır. Yanlış olanı seçmek 401 hatalarına yol açar. Bu rehber size net bir karar çerçevesi verir.
Hızlı Karar Tablosu
| Yapmak istediğiniz... | Kullan |
|----------------|-----|
| Bellekleri sakla / geri çağır | Mind Key |
| Sohbet mesajları gönder / poll | Mind Key |
| Görevleri yönet | Mind Key |
| Betikleri sakla | Mind Key |
| Webhook'ları kaydet | Mind Key |
| Bilgisayarları kontrol et | Mind Key (kullanıcı tarafı) / Computer Token (ajan tarafı) |
| Kullanıcı hesabı kaydet | Yok (herkese açık) |
| Giriş | Yok (herkese açık) |
| Mind oluştur / listele / sil | JWT |
| Bir mind'i başka bir kullanıcıyla paylaş | JWT |
| Web push bildirimlerine abone ol | JWT |
| Denetim günlüğünü görüntüle | Mind Key |
Basit Kural
> [!TIP]
> Tek bir mind'in verisine dokunuyorsa → Mind Key.
> Hesabı veya mind meta verilerini yönetiyorsa → JWT.
Mind Key — Veri Erişim Token'ı
Bir Mind Key, tek bir mind'in verisine erişim sağlar. Asla sona ermeyen (mind silinene kadar) uzun ömürlü bir token'dır. Şunlar için mükemmeldir:
- Oturumlar arasında bellek saklayan LLM ajanları
- Arka plan cron işleri
- MCP sunucu yapılandırması
- Webhook entegrasyonları
- Bellek okuyan mobil uygulamalar
Mind Key ne yapabilir
-  — bu mind'deki tüm bellekleri oku
-  — bellekleri sakla/güncelle
-  — sohbet mesajlarını oku
-  — sohbet mesajları gönder
-  — görevleri listele
-  — görev oluştur
-  — betikler sakla
-  — webhook'lar kaydet
-  — bilgisayar komutları kuyruğa al
Mind Key ne YAPAMAZ
- Mind oluşturma / listeleme / silme (JWT gerekir)
- Mind'i başka kullanıcıyla paylaşma (JWT gerekir)
- Kullanıcı hesap bilgilerini görüntüleme (JWT gerekir)
- Web push'a abone olma (JWT gerekir)
JWT — Hesap Yönetimi Token'ı
Bir JWT, kullanıcı hesabını doğrular. 7 gün sonra sona erer ve birden çok mind'i kapsayan veya diğer kullanıcıları içeren hesap düzeyindeki işlemler için kullanılır.
JWT ne yapabilir
-  — yeni bir mind oluştur (yeni bir Mind Key döndürür)
-  — bu kullanıcı için tüm mind'leri listele
-  — bir mind'i sil
-  — bir mind'i başka bir kullanıcıyla paylaş
-  — web push bildirimlerine abone ol
-  — mind paylaşımlarını listele
JWT ne YAPAMAZ
- Bellekleri okuma / yazma (Mind Key gerekir)
- Sohbet mesajları gönderme (Mind Key gerekir)
- Görevleri yönetme (Mind Key gerekir)
- Webhook'lar kaydetme (Mind Key gerekir)
Özel Durum: Computer Token
 uç noktaları (ajan tarafı, screen-remote-agent için) üçüncü bir token tipi kullanır: Computer Token. Bu token, bir install code kullanıldığında  tarafından döndürülür ve tek bir kayıtlı bilgisayara özeldir.
| Uç Nokta | Kimlik Doğrulama |
|----------|------|
|  | Computer Token |
|  | Computer Token |
|  | Mind Key veya JWT |
|  | Mind Key veya JWT |
Yaygın Desenler
Desen 1: Tek LLM Ajanı
1. Bir kez kaydol → JWT al
2. Tek bir mind oluştur → Mind Key al
3. LLM her şey için Mind Key kullanır
Desen 2: Çok Projeli Ajan
1. Bir kez kaydol → JWT al
2. Birden çok mind oluştur (work, personal, project-x) → birden çok Mind Key al
3. LLM bağlama göre farklı Mind Key yükler
Desen 3: Ekip Paylaşımı
1. Kullanıcı A bir mind oluşturur → Mind Key A alır
2. Kullanıcı A, JWT ile Kullanıcı B'ye paylaşır ()
3. Kullanıcı B artık kendi JWT'si ile erişebilir
4. LLM erişimi için Kullanıcı B'nin kendi Mind Key'ini oluşturması (veya A'nınkini kullanması) gerekir
Desen 4: MCP Sunucusu
MCP sunucuları her zaman Mind Key kullanır ( env değişkeni ile ayarlanır). Bir MCP sunucu örneği = bir mind. Çoklu mind erişimi için birden çok MCP örneği çalıştırın veya istemci tarafı mind değiştirme uygulayın.
Token Biçimi Hile Sayfası
| Token | Biçim | Örnek |
|-------|--------|---------|
| Mind Key |  + 36 karakter |  |
| JWT |  + base64 |  |
| Computer Token |  + 36 karakter |  |
Sonraki Adımlar
- Kimlik Doğrulama — tam kimlik doğrulama rehberi
- User & Minds API — JWT korumalı uç noktalar
- Memory API — Mind Key korumalı uç noktalar