# Sorun Giderme SSS
SUMMARY: Yaygın Synapse sorunlarına çözümler — kimlik doğrulama, ağ, veri, dağıtım.

Sorun Giderme SSS
Yaygın Synapse sorunlarına çözümler.
Giriş yapamıyorum
Belirtiler
-  401 döndürüyor
- "Invalid email or password"
Çözümler
1. E-postanın doğru olduğunu doğrulayın — büyük/küçük harf duyarlı
2. Parolayı kontrol edin — en az 6 karakter
3. Hesabınız yoksa önce kaydolun: 
4. (SMTP yapılandırılmışsa) web arayüzü üzerinden parola sıfırlayın
Mind Key'imi kaybettim
Belirtiler
- Belleklere erilemiyor
- Mind Key silinmiş/kaybolmuş
Çözümler
Mind Key'ler kurtarılamaz. Şunları yapmalısınız:
1. JWT almak için giriş: 
2. Mind'leri listele:  (JWT ile)
3. Yeni mind oluştur: 
4. Yeni Mind Key'i kaydet
5. (İsteğe bağlı) Eski mind'i sil: 
Eski mind'deki veriler Mind Key'i bulamadıkça kaybedilir.
API çağrıları 401 döndürüyor
Belirtiler
- Tüm API çağrıları 401 Unauthorized döndürüyor
- "Mind Key fehlt oder ungültig"
Çözümler
1. Başlık biçimini doğrulayın: 
2. Mind Key'in  ile başladığını kontrol edin (JWT olan  değil)
3. Doğrudan test edin:
   [CODE BLOCK]
4. Mind Key iptal edilmiş olabilir — yeni bir mind oluşturun
Bkz. Kimlik Doğrulama.
API çağrıları 404 döndürüyor
Belirtiler
- 404 Not Found
- "Route not found"
Çözümler
> [!CRITICAL]
> Uç nokta yollarını tahmin etmeyin. Yalnızca  içindeki yollar mevcuttur.
1. Geçerli uç noktaları kontrol edin: 
2. URL'yi tam olarak karşılaştırın — büyük/küçük harf duyarlı, sondaki eğik çizgi yok
3. HTTP yöntemini kontrol edin —  ve  farklıdır
API çağrıları 429 döndürüyor
Belirtiler
- 429 Too Many Requests
- "Rate limit exceeded"
Çözümler
1. Header kimlik doğrulamasına geçin (hız sınırı yok):
   [CODE BLOCK]
2.  kullanmanız gerekiyorsa  saniye bekleyin
Bkz. Hız Sınırları.
Bellek arama sonuç döndürmüyor
Belirtiler
-  boş döndürüyor
- Belleklerin var olduğunu biliyorsunuz
Çözümler
1. Belleklerin var olduğunu doğrulayın: 
2. Arama sözdizimini kontrol edin — FTS5'ün özel sözdizimi var
3. Daha basit sorgu deneyin —  yerine 
4. Kavramsal sorgular için anlamsal arama kullanın: 
Bkz. FTS5 Arama.
Bellekler kalıcı olmuyor
Belirtiler
- POST /memory başarı döndürüyor
- GET /memory/recall bunları göstermiyor
Çözümler
1. Aynı Mind Key'i doğrulayın — farklı anahtarlar = farklı mind'ler
2. Yanıtı kontrol edin — POST  döndürür
3. /memory/recall (metin) yerine GET /memory (JSON listesi) deneyin
4. Filtreyi kontrol edin —  veya  onları gizliyor olabilir
Araçlar Claude Desktop'da görünmüyor
Belirtiler
- Claude Desktop 0 araç gösteriyor
- 🔌 simgesi yok
Çözümler
1. Claude Desktop'ı tamamen yeniden başlatın (Cmd+Q)
2. Yapılandırma dosyasının geçerli JSON olduğunu doğrulayın
3. Node.js 18+ kurulu olduğunu kontrol edin
4. MCP'yi manuel çalıştırın: 
5. Logları kontrol edin: 
Bkz. MCP Sorun Giderme.
Synapse çevrimdışı
Belirtiler
- synapse.schaefer.zone'a ulaşılamıyor
- curl zaman aşımına uğruyor
Çözümler
1. İnternetinizi kontrol edin — başka bir site deneyin
2. Synapse sağlığını kontrol edin: 
3. Bekleyin — geçici kesinti veya dağıtım olabilir
4. Durum sayfasını kontrol edin (varsa)
Self-hosted için: Docker konteyner durumunu, veritabanı bağlantısını kontrol edin.
Veritabanı hataları
Belirtiler
- 500 Internal Server Error
- "Database connection failed"
Çözümler
Self-hosted için:
1. PostgreSQL'in çalıştığını kontrol edin: 
2. Env'de DATABASEURL'i kontrol edin
3. Migrasyonları kontrol edin: 
4. Disk alanını kontrol edin: 
Barındırılan için: desteğe bildirin.
Webhook tetiklenmiyor
Belirtiler
- Webhook kaydedildi ama geri arama alınmıyor
- URL'nize POST yok
Çözümler
1. URL'nin erişilebilir olduğunu doğrulayın: 
2. Olay filtresini kontrol edin —  tüm bellek olaylarını eşleştirir
3. Webhook'u test edin: 
4. Webhook'un etkin olduğunu kontrol edin: 
5. SSL'i doğrulayın — Synapse webhook URL'leri için geçerli HTTPS gerektirir
Bkz. Webhooks API.
Cron işi çalışmıyor
Belirtiler
- Cron işi oluşturuldu ama tetiklenmiyor
-  güncellenmiyor
Çözümler
1. Zamanlama sözdizimini kontrol edin — geçerli 5 alanlı cron veya tamsayı saniye olmalı
2. Uç noktanın izin verildiğini doğrulayın — http(s) olmalı, özel IP yok
3. İşin etkin olduğunu kontrol edin: 
4. Sonraki zamanlanmış saati bekleyin — cron anında değil
Bkz. Cron & Zamanlayıcı.
Daha Fazla Yardıma mı İhtiyacınız Var?
1. Mevcut docs'ları kontrol edin: <https://synapse.schaefer.zone/docs>
2. Docs'larda arama: 
3. Issue açın: <https://gitlab.com/schaefer-services/synapse/-/issues>
4. İletişim:  sayfasına bakın
Sonraki Adımlar
- Hatalar & Hata Yönetimi
- API SSS
- MCP Sorun Giderme