{"title":"Sorun Giderme SSS","slug":"troubleshooting","category":"faq","summary":"Yaygın Synapse sorunlarına çözümler — kimlik doğrulama, ağ, veri, dağıtım.","audience":["human","llm"],"tags":["faq","troubleshooting","problems","solutions"],"difficulty":"beginner","updated":"2026-06-27","word_count":620,"read_minutes":3,"lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Sorun Giderme SSS\n\nYaygın Synapse sorunlarına çözümler.\n\n## Giriş yapamıyorum\n\n### Belirtiler\n\n- `POST /login` 401 döndürüyor\n- \"Invalid email or password\"\n\n### Çözümler\n\n1. **E-postanın doğru olduğunu doğrulayın** — büyük/küçük harf duyarlı\n2. **Parolayı kontrol edin** — en az 6 karakter\n3. Hesabınız yoksa **önce kaydolun**: `POST /register`\n4. (SMTP yapılandırılmışsa) web arayüzü üzerinden **parola sıfırlayın**\n\n## Mind Key'imi kaybettim\n\n### Belirtiler\n\n- Belleklere erilemiyor\n- Mind Key silinmiş/kaybolmuş\n\n### Çözümler\n\nMind Key'ler kurtarılamaz. Şunları yapmalısınız:\n\n1. JWT almak için giriş: `POST /login`\n2. Mind'leri listele: `GET /minds` (JWT ile)\n3. Yeni mind oluştur: `POST /minds`\n4. Yeni Mind Key'i kaydet\n5. (İsteğe bağlı) Eski mind'i sil: `DELETE /minds/:id`\n\n**Eski mind'deki veriler** Mind Key'i bulamadıkça kaybedilir.\n\n## API çağrıları 401 döndürüyor\n\n### Belirtiler\n\n- Tüm API çağrıları 401 Unauthorized döndürüyor\n- \"Mind Key fehlt oder ungültig\"\n\n### Çözümler\n\n1. **Başlık biçimini doğrulayın**: `Authorization: Bearer mk_...`\n2. **Mind Key'in `mk_` ile başladığını kontrol edin** (JWT olan `eyJ` değil)\n3. **Doğrudan test edin**:\n ```bash\n curl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n ```\n4. **Mind Key iptal edilmiş olabilir** — yeni bir mind oluşturun\n\nBkz. [Kimlik Doğrulama](/docs/getting-started/authentication).\n\n## API çağrıları 404 döndürüyor\n\n### Belirtiler\n\n- 404 Not Found\n- \"Route not found\"\n\n### Çözümler\n\n> [!CRITICAL]\n> Uç nokta yollarını tahmin etmeyin. Yalnızca `GET /endpoints` içindeki yollar mevcuttur.\n\n1. **Geçerli uç noktaları kontrol edin**: `curl https://synapse.schaefer.zone/endpoints`\n2. **URL'yi tam olarak karşılaştırın** — büyük/küçük harf duyarlı, sondaki eğik çizgi yok\n3. **HTTP yöntemini kontrol edin** — `GET /memory` ve `POST /memory` farklıdır\n\n## API çağrıları 429 döndürüyor\n\n### Belirtiler\n\n- 429 Too Many Requests\n- \"Rate limit exceeded\"\n\n### Çözümler\n\n1. **Header kimlik doğrulamasına geçin** (hız sınırı yok):\n ```bash\n # Don't\n curl \".../memory/recall?key=mk_...\"\n \n # Do\n curl -H \"Authorization: Bearer mk_...\" .../memory/recall\n ```\n2. `?key=` kullanmanız gerekiyorsa **`Retry-After` saniye bekleyin**\n\nBkz. [Hız Sınırları](/docs/api/rate-limits).\n\n## Bellek arama sonuç döndürmüyor\n\n### Belirtiler\n\n- `GET /memory/search?q=...` boş döndürüyor\n- Belleklerin var olduğunu biliyorsunuz\n\n### Çözümler\n\n1. **Belleklerin var olduğunu doğrulayın**: `GET /memory/recall`\n2. **Arama sözdizimini kontrol edin** — FTS5'ün özel sözdizimi var\n3. **Daha basit sorgu deneyin** — `?q=docker+swarm+deployment` yerine `?q=docker`\n4. Kavramsal sorgular için **anlamsal arama kullanın**: `GET /memory/semantic-search?q=...`\n\nBkz. [FTS5 Arama](/docs/concepts/fts5-search).\n\n## Bellekler kalıcı olmuyor\n\n### Belirtiler\n\n- POST /memory başarı döndürüyor\n- GET /memory/recall bunları göstermiyor\n\n### Çözümler\n\n1. **Aynı Mind Key'i doğrulayın** — farklı anahtarlar = farklı mind'ler\n2. **Yanıtı kontrol edin** — POST `{ \"id\": \"mem_...\", \"status\": \"stored\" }` döndürür\n3. **/memory/recall (metin) yerine GET /memory (JSON listesi) deneyin**\n4. **Filtreyi kontrol edin** — `?category=` veya `?tag=` onları gizliyor olabilir\n\n## Araçlar Claude Desktop'da görünmüyor\n\n### Belirtiler\n\n- Claude Desktop 0 araç gösteriyor\n- 🔌 simgesi yok\n\n### Çözümler\n\n1. **Claude Desktop'ı tamamen yeniden başlatın** (Cmd+Q)\n2. **Yapılandırma dosyasının** geçerli JSON olduğunu doğrulayın\n3. **Node.js 18+** kurulu olduğunu kontrol edin\n4. **MCP'yi manuel çalıştırın**: `npx -y synapse-mcp-api@latest`\n5. **Logları kontrol edin**: `~/Library/Logs/Claude/mcp.log`\n\nBkz. [MCP Sorun Giderme](/docs/mcp/troubleshooting).\n\n## Synapse çevrimdışı\n\n### Belirtiler\n\n- synapse.schaefer.zone'a ulaşılamıyor\n- curl zaman aşımına uğruyor\n\n### Çözümler\n\n1. **İnternetinizi kontrol edin** — başka bir site deneyin\n2. **Synapse sağlığını kontrol edin**: `curl https://synapse.schaefer.zone/health`\n3. **Bekleyin** — geçici kesinti veya dağıtım olabilir\n4. **Durum sayfasını kontrol edin** (varsa)\n\nSelf-hosted için: Docker konteyner durumunu, veritabanı bağlantısını kontrol edin.\n\n## Veritabanı hataları\n\n### Belirtiler\n\n- 500 Internal Server Error\n- \"Database connection failed\"\n\n### Çözümler\n\nSelf-hosted için:\n\n1. **PostgreSQL'in çalıştığını kontrol edin**: `docker ps | grep postgres`\n2. **Env'de DATABASE_URL'i kontrol edin**\n3. **Migrasyonları kontrol edin**: `npm run migrate:check`\n4. **Disk alanını kontrol edin**: `df -h`\n\nBarındırılan için: desteğe bildirin.\n\n## Webhook tetiklenmiyor\n\n### Belirtiler\n\n- Webhook kaydedildi ama geri arama alınmıyor\n- URL'nize POST yok\n\n### Çözümler\n\n1. **URL'nin erişilebilir olduğunu doğrulayın**: `curl -X POST your-url -d '{}'`\n2. **Olay filtresini kontrol edin** — `memory.*` tüm bellek olaylarını eşleştirir\n3. **Webhook'u test edin**: `POST /webhooks/:id/test`\n4. **Webhook'un etkin olduğunu kontrol edin**: `GET /webhooks/:id`\n5. **SSL'i doğrulayın** — Synapse webhook URL'leri için geçerli HTTPS gerektirir\n\nBkz. [Webhooks API](/docs/api/webhooks).\n\n## Cron işi çalışmıyor\n\n### Belirtiler\n\n- Cron işi oluşturuldu ama tetiklenmiyor\n- `next_run` güncellenmiyor\n\n### Çözümler\n\n1. **Zamanlama sözdizimini kontrol edin** — geçerli 5 alanlı cron veya tamsayı saniye olmalı\n2. **Uç noktanın izin verildiğini doğrulayın** — http(s) olmalı, özel IP yok\n3. **İşin etkin olduğunu kontrol edin**: `GET /cron`\n4. **Sonraki zamanlanmış saati bekleyin** — cron anında değil\n\nBkz. [Cron & Zamanlayıcı](/docs/api/cron).\n\n## Daha Fazla Yardıma mı İhtiyacınız Var?\n\n1. **Mevcut docs'ları kontrol edin**: \n2. **Docs'larda arama**: `GET /docs/search?q=your+question`\n3. **Issue açın**: \n4. **İletişim**: `/support` sayfasına bakın\n\n## Sonraki Adımlar\n\n- [Hatalar & Hata Yönetimi](/docs/api/errors)\n- [API SSS](/docs/faq/api-faq)\n- [MCP Sorun Giderme](/docs/mcp/troubleshooting)\n","content_html":"

Sorun Giderme SSS

\n

Yaygın Synapse sorunlarına çözümler.

\n

Giriş yapamıyorum

\n

Belirtiler

\n\n

Çözümler

\n
    \n
  1. E-postanın doğru olduğunu doğrulayın — büyük/küçük harf duyarlı
    2. \n
  2. Parolayı kontrol edin — en az 6 karakter
    3. \n
  3. Hesabınız yoksa önce kaydolun: POST /register
    4. \n
  4. (SMTP yapılandırılmışsa) web arayüzü üzerinden parola sıfırlayın
    5. \n
\n

Mind Key'imi kaybettim

\n

Belirtiler

\n\n

Çözümler

\n

Mind Key'ler kurtarılamaz. Şunları yapmalısınız:

\n
    \n
  1. JWT almak için giriş: POST /login
    2. \n
  2. Mind'leri listele: GET /minds (JWT ile)
    3. \n
  3. Yeni mind oluştur: POST /minds
    4. \n
  4. Yeni Mind Key'i kaydet
    5. \n
  5. (İsteğe bağlı) Eski mind'i sil: DELETE /minds/:id
    6. \n
\n

Eski mind'deki veriler Mind Key'i bulamadıkça kaybedilir.

\n

API çağrıları 401 döndürüyor

\n

Belirtiler

\n\n

Çözümler

\n
    \n
  1. Başlık biçimini doğrulayın: Authorization: Bearer mk_...
    2. \n
  2. Mind Key'in mk_ ile başladığını kontrol edin (JWT olan eyJ değil)
    3. \n
  3. Doğrudan test edin:
    curl -H "Authorization: Bearer mk_YOUR_KEY" \\\n     https://synapse.schaefer.zone/memory/recall
    4. \n
  4. Mind Key iptal edilmiş olabilir — yeni bir mind oluşturun
    5. \n
\n

Bkz. Kimlik Doğrulama.

\n

API çağrıları 404 döndürüyor

\n

Belirtiler

\n\n

Çözümler

\n
Uç nokta yollarını tahmin etmeyin. Yalnızca `GET /endpoints` içindeki yollar mevcuttur.
    \n
  1. Geçerli uç noktaları kontrol edin: curl https://synapse.schaefer.zone/endpoints
    2. \n
  2. URL'yi tam olarak karşılaştırın — büyük/küçük harf duyarlı, sondaki eğik çizgi yok
    3. \n
  3. HTTP yöntemini kontrol edin — GET /memory ve POST /memory farklıdır
    4. \n
\n

API çağrıları 429 döndürüyor

\n

Belirtiler

\n\n

Çözümler

\n
    \n
  1. Header kimlik doğrulamasına geçin (hız sınırı yok):
    # Don't\ncurl ".../memory/recall?key=mk_..."\n\n# Do\ncurl -H "Authorization: Bearer mk_..." .../memory/recall
    2. \n
  2. ?key= kullanmanız gerekiyorsa Retry-After saniye bekleyin
    3. \n
\n

Bkz. Hız Sınırları.

\n

Bellek arama sonuç döndürmüyor

\n

Belirtiler

\n\n

Çözümler

\n
    \n
  1. Belleklerin var olduğunu doğrulayın: GET /memory/recall
    2. \n
  2. Arama sözdizimini kontrol edin — FTS5'ün özel sözdizimi var
    3. \n
  3. Daha basit sorgu deneyin — ?q=docker+swarm+deployment yerine ?q=docker
    4. \n
  4. Kavramsal sorgular için anlamsal arama kullanın: GET /memory/semantic-search?q=...
    5. \n
\n

Bkz. FTS5 Arama.

\n

Bellekler kalıcı olmuyor

\n

Belirtiler

\n\n

Çözümler

\n
    \n
  1. Aynı Mind Key'i doğrulayın — farklı anahtarlar = farklı mind'ler
    2. \n
  2. Yanıtı kontrol edin — POST { "id": "mem_...", "status": "stored" } döndürür
    3. \n
  3. /memory/recall (metin) yerine GET /memory (JSON listesi) deneyin
    4. \n
  4. Filtreyi kontrol edin — ?category= veya ?tag= onları gizliyor olabilir
    5. \n
\n

Araçlar Claude Desktop'da görünmüyor

\n

Belirtiler

\n\n

Çözümler

\n
    \n
  1. Claude Desktop'ı tamamen yeniden başlatın (Cmd+Q)
    2. \n
  2. Yapılandırma dosyasının geçerli JSON olduğunu doğrulayın
    3. \n
  3. Node.js 18+ kurulu olduğunu kontrol edin
    4. \n
  4. MCP'yi manuel çalıştırın: npx -y synapse-mcp-api@latest
    5. \n
  5. Logları kontrol edin: ~/Library/Logs/Claude/mcp.log
    6. \n
\n

Bkz. MCP Sorun Giderme.

\n

Synapse çevrimdışı

\n

Belirtiler

\n\n

Çözümler

\n
    \n
  1. İnternetinizi kontrol edin — başka bir site deneyin
    2. \n
  2. Synapse sağlığını kontrol edin: curl https://synapse.schaefer.zone/health
    3. \n
  3. Bekleyin — geçici kesinti veya dağıtım olabilir
    4. \n
  4. Durum sayfasını kontrol edin (varsa)
    5. \n
\n

Self-hosted için: Docker konteyner durumunu, veritabanı bağlantısını kontrol edin.

\n

Veritabanı hataları

\n

Belirtiler

\n\n

Çözümler

\n

Self-hosted için:

\n
    \n
  1. PostgreSQL'in çalıştığını kontrol edin: docker ps | grep postgres
    2. \n
  2. Env'de DATABASE_URL'i kontrol edin
    3. \n
  3. Migrasyonları kontrol edin: npm run migrate:check
    4. \n
  4. Disk alanını kontrol edin: df -h
    5. \n
\n

Barındırılan için: desteğe bildirin.

\n

Webhook tetiklenmiyor

\n

Belirtiler

\n\n

Çözümler

\n
    \n
  1. URL'nin erişilebilir olduğunu doğrulayın: curl -X POST your-url -d '{}'
    2. \n
  2. Olay filtresini kontrol edin — memory.* tüm bellek olaylarını eşleştirir
    3. \n
  3. Webhook'u test edin: POST /webhooks/:id/test
    4. \n
  4. Webhook'un etkin olduğunu kontrol edin: GET /webhooks/:id
    5. \n
  5. SSL'i doğrulayın — Synapse webhook URL'leri için geçerli HTTPS gerektirir
    6. \n
\n

Bkz. Webhooks API.

\n

Cron işi çalışmıyor

\n

Belirtiler

\n\n

Çözümler

\n
    \n
  1. Zamanlama sözdizimini kontrol edin — geçerli 5 alanlı cron veya tamsayı saniye olmalı
    2. \n
  2. Uç noktanın izin verildiğini doğrulayın — http(s) olmalı, özel IP yok
    3. \n
  3. İşin etkin olduğunu kontrol edin: GET /cron
    4. \n
  4. Sonraki zamanlanmış saati bekleyin — cron anında değil
    5. \n
\n

Bkz. Cron & Zamanlayıcı.

\n

Daha Fazla Yardıma mı İhtiyacınız Var?

\n
    \n
  1. Mevcut docs'ları kontrol edin: https://synapse.schaefer.zone/docs
    2. \n
  2. Docs'larda arama: GET /docs/search?q=your+question
    3. \n
  3. Issue açın: https://gitlab.com/schaefer-services/synapse/-/issues
    4. \n
  4. İletişim: /support sayfasına bakın
    5. \n
\n

Sonraki Adımlar

\n\n","urls":{"html":"/docs/faq/troubleshooting","text":"/docs/faq/troubleshooting?format=text","json":"/docs/faq/troubleshooting?format=json","llm":"/docs/faq/troubleshooting?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}