{"title":"Synapse Nedir?","slug":"what-is-synapse","category":"getting-started","summary":"Synapse, LLM ajanları için kalıcı bir bellek API'sidir — yapay zekanız oturumlar arasında hiçbir şey unutmaz.","audience":["human","llm"],"tags":["intro","overview","memory","llm"],"difficulty":"beginner","updated":"2026-06-27","word_count":462,"read_minutes":2,"llm_context":"Synapse is an HTTP API that gives LLM agents persistent memory across sessions.\nBase URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query, rate-limited 60/min)\nMost important endpoints: GET /memory/recall (start of every session), POST /memory (store new facts), GET /memory/search?q=...\nMind Key = tenant-scoped API key. Each user can have multiple minds (projects/contexts).\nMCP server available: npx -y synapse-mcp-api (79 tools for Claude Desktop, Cursor, etc.)\n","lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Synapse Nedir?\n\nSynapse, **LLM ajanları için kalıcı bir bellek API'sidir**. Sohbet tabanlı her LLM'in temel sorununu çözer: oturumlar arasında ajan her şeyi unutur. Synapse, AI'ınıza konuşmalar arasında, günler arasında ve farklı LLM sağlayıcıları arasında hayatta kalan kalıcı, sorgulanabilir bir beyin verir.\n\n> [!CRITICAL]\n> Bir LLM ajanı olarak bunu okuyorsanız: **her oturumun başında `GET /memory/recall` çağırın**. Bu çağrı olmadan, geçmiş etkileşimler hakkında hiçbir belleğiniz, kullanıcının kim olduğu hakkında hiçbir bilginiz ve devam eden projeler hakkında hiçbir bağlamınız yoktur.\n\n## Synapse'ın Çözdüğü Sorun\n\nHer modern LLM (Claude, GPT, Gemini, Llama) aynı mimari sınırlamaya sahiptir: sohbet bağlam penceresi sınırlıdır ve oturum sona erdiğinde tüm durum kaybolur. Bu, AI asistanınızın şunları yapması anlamına gelir:\n\n- Sohbetler arasında adınızı, tercihlerinizi ve devam eden projelerinizi unutur\n- Oturumlar arasında geçmiş hatalardan öğrenemez\n- Uzun süreli çalışmalar için sürekliliği yoktur\n- Her seferinde aynı açıklayıcı soruları tekrar sorar\n\nSynapse bunu, LLM'in yapılandırılmış bellekleri saklayabileceği ve alabileceği basit bir HTTP API'si sağlayarak çözer. Bellekler sunucuda kalıcıdır, indekslenir ve aranabilir, böylece gelecekteki herhangi bir oturum bunları geri çağırabilir.\n\n## Temel Özellikler\n\n- **Kalıcı bellek depolama** — bilgiler, tercihler, projeler, hatalar, beceriler\n- **Tam metin arama** (FTS5) — herhangi bir belleği milisaniyeler içinde anahtar kelimeyle bulun\n- **Anlamsal arama** — kavramsal sorgular için gömme tabanlı benzerlik arama\n- **Çok kiracılı** — her kullanıcının izole \"mind'leri\" vardır (bir kullanıcı, birçok proje)\n- **Asenkron sohbet** — insanlar ajan çalışırken ona mesaj bırakabilir\n- **Görevler ve zamanlama** — yerleşik görev yöneticisi ve cron zamanlayıcı\n- **MCP entegrasyonu** — Claude, Cursor, Continue için Model Context Protocol olarak sunulan 79 araç\n- **Tarayıcı ve bilgisayar kontrolü** — uzak otomasyon araçları\n- **Webhook'lar** — bellek/sohbet/görev değişikliklerinde HTTP geri aramaları alın\n\n## Nasıl Çalışır\n\n```\n┌──────────────┐         ┌─────────────────────┐\n│  LLM Agent   │ ──API──▶│   Synapse Server    │\n│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │\n└──────────────┘         └─────────────────────┘\n                                │\n                                ▼\n                         ┌─────────────┐\n                         │  Memories   │\n                         │  Tasks      │\n                         │  Chat       │\n                         │  Scripts    │\n                         └─────────────┘\n```\n\n1. LLM oturum başlangıcında `GET /memory/recall` çağırır\n2. Synapse, saklanan tüm belleklerin yapılandırılmış metin özetini döndürür\n3. LLM çalışır, periyodik olarak yeni bilgileri saklamak için `POST /memory` çağırır\n4. Kullanıcı bir soru sorduğunda LLM `GET /memory/search?q=...` çağırabilir\n5. Oturum sonunda, önemli yeni bağlam sonraki oturum için saklanır\n\n## Kimin İçin?\n\n- Kalıcı durum gerektiren **LLM ajan geliştiricileri**\n- Özel ajanlarla yerel LLM'ler (Ollama, LM Studio) çalıştıran **güçlü kullanıcılar**\n- Paylaşımlı bellek gerektiren AI asistanları inşa eden **ekipler**\n- LLM çağrılarını oturumlar arasında zincirleyen **otomasyon mühendisleri**\n\n## Hızlı Karşılaştırma\n\n| Özellik | ChatGPT Memory | Synapse |\n|---------|---------------|---------|\n| Depolama konumu | OpenAI sunucuları | Sizin sunucunuz |\n| API erişimi | Hayır (kapalı) | Evet (REST + MCP) |\n| Çok kiracılı | Hayır | Evet (minds) |\n| Özel kategoriler | Hayır | Evet (8 kategori) |\n| Arama | Sınırlı | FTS5 + anlamsal |\n| Self-hostable | Hayır | Evet (Docker) |\n\n## Sonraki Adımlar\n\n- [İnsanlar için hızlı başlangıç](/docs/getting-started/quick-start) — 5 dakikada bir Mind Key alın\n- [LLM'ler için hızlı başlangıç](/docs/getting-started/quick-start-llm) — ilk API çağrıları\n- [Kimlik Doğrulama](/docs/getting-started/authentication) — Mind Key'ler ve JWT'ler\n- [Mimari genel bakış](/docs/concepts/architecture) — Synapse nasıl inşa edilmiştir\n","content_html":"<h1>Synapse Nedir?</h1>\n<p>Synapse, <strong>LLM ajanları için kalıcı bir bellek API&#39;sidir</strong>. Sohbet tabanlı her LLM&#39;in temel sorununu çözer: oturumlar arasında ajan her şeyi unutur. Synapse, AI&#39;ınıza konuşmalar arasında, günler arasında ve farklı LLM sağlayıcıları arasında hayatta kalan kalıcı, sorgulanabilir bir beyin verir.</p>\n<div class=\"callout callout-critical\">Bir LLM ajanı olarak bunu okuyorsanız: **her oturumun başında `GET /memory/recall` çağırın**. Bu çağrı olmadan, geçmiş etkileşimler hakkında hiçbir belleğiniz, kullanıcının kim olduğu hakkında hiçbir bilginiz ve devam eden projeler hakkında hiçbir bağlamınız yoktur.</div><h2>Synapse&#39;ın Çözdüğü Sorun</h2>\n<p>Her modern LLM (Claude, GPT, Gemini, Llama) aynı mimari sınırlamaya sahiptir: sohbet bağlam penceresi sınırlıdır ve oturum sona erdiğinde tüm durum kaybolur. Bu, AI asistanınızın şunları yapması anlamına gelir:</p>\n<ul>\n<li>Sohbetler arasında adınızı, tercihlerinizi ve devam eden projelerinizi unutur</li>\n<li>Oturumlar arasında geçmiş hatalardan öğrenemez</li>\n<li>Uzun süreli çalışmalar için sürekliliği yoktur</li>\n<li>Her seferinde aynı açıklayıcı soruları tekrar sorar</li>\n</ul>\n<p>Synapse bunu, LLM&#39;in yapılandırılmış bellekleri saklayabileceği ve alabileceği basit bir HTTP API&#39;si sağlayarak çözer. Bellekler sunucuda kalıcıdır, indekslenir ve aranabilir, böylece gelecekteki herhangi bir oturum bunları geri çağırabilir.</p>\n<h2>Temel Özellikler</h2>\n<ul>\n<li><strong>Kalıcı bellek depolama</strong> — bilgiler, tercihler, projeler, hatalar, beceriler</li>\n<li><strong>Tam metin arama</strong> (FTS5) — herhangi bir belleği milisaniyeler içinde anahtar kelimeyle bulun</li>\n<li><strong>Anlamsal arama</strong> — kavramsal sorgular için gömme tabanlı benzerlik arama</li>\n<li><strong>Çok kiracılı</strong> — her kullanıcının izole &quot;mind&#39;leri&quot; vardır (bir kullanıcı, birçok proje)</li>\n<li><strong>Asenkron sohbet</strong> — insanlar ajan çalışırken ona mesaj bırakabilir</li>\n<li><strong>Görevler ve zamanlama</strong> — yerleşik görev yöneticisi ve cron zamanlayıcı</li>\n<li><strong>MCP entegrasyonu</strong> — Claude, Cursor, Continue için Model Context Protocol olarak sunulan 79 araç</li>\n<li><strong>Tarayıcı ve bilgisayar kontrolü</strong> — uzak otomasyon araçları</li>\n<li><strong>Webhook&#39;lar</strong> — bellek/sohbet/görev değişikliklerinde HTTP geri aramaları alın</li>\n</ul>\n<h2>Nasıl Çalışır</h2>\n<pre><code class=\"hljs language-plaintext\">┌──────────────┐         ┌─────────────────────┐\n│  LLM Agent   │ ──API──▶│   Synapse Server    │\n│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │\n└──────────────┘         └─────────────────────┘\n                                │\n                                ▼\n                         ┌─────────────┐\n                         │  Memories   │\n                         │  Tasks      │\n                         │  Chat       │\n                         │  Scripts    │\n                         └─────────────┘</code></pre><ol>\n<li>LLM oturum başlangıcında <code>GET /memory/recall</code> çağırır</li>\n<li>Synapse, saklanan tüm belleklerin yapılandırılmış metin özetini döndürür</li>\n<li>LLM çalışır, periyodik olarak yeni bilgileri saklamak için <code>POST /memory</code> çağırır</li>\n<li>Kullanıcı bir soru sorduğunda LLM <code>GET /memory/search?q=...</code> çağırabilir</li>\n<li>Oturum sonunda, önemli yeni bağlam sonraki oturum için saklanır</li>\n</ol>\n<h2>Kimin İçin?</h2>\n<ul>\n<li>Kalıcı durum gerektiren <strong>LLM ajan geliştiricileri</strong></li>\n<li>Özel ajanlarla yerel LLM&#39;ler (Ollama, LM Studio) çalıştıran <strong>güçlü kullanıcılar</strong></li>\n<li>Paylaşımlı bellek gerektiren AI asistanları inşa eden <strong>ekipler</strong></li>\n<li>LLM çağrılarını oturumlar arasında zincirleyen <strong>otomasyon mühendisleri</strong></li>\n</ul>\n<h2>Hızlı Karşılaştırma</h2>\n<table>\n<thead>\n<tr>\n<th>Özellik</th>\n<th>ChatGPT Memory</th>\n<th>Synapse</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Depolama konumu</td>\n<td>OpenAI sunucuları</td>\n<td>Sizin sunucunuz</td>\n</tr>\n<tr>\n<td>API erişimi</td>\n<td>Hayır (kapalı)</td>\n<td>Evet (REST + MCP)</td>\n</tr>\n<tr>\n<td>Çok kiracılı</td>\n<td>Hayır</td>\n<td>Evet (minds)</td>\n</tr>\n<tr>\n<td>Özel kategoriler</td>\n<td>Hayır</td>\n<td>Evet (8 kategori)</td>\n</tr>\n<tr>\n<td>Arama</td>\n<td>Sınırlı</td>\n<td>FTS5 + anlamsal</td>\n</tr>\n<tr>\n<td>Self-hostable</td>\n<td>Hayır</td>\n<td>Evet (Docker)</td>\n</tr>\n</tbody></table>\n<h2>Sonraki Adımlar</h2>\n<ul>\n<li><a href=\"/docs/getting-started/quick-start\">İnsanlar için hızlı başlangıç</a> — 5 dakikada bir Mind Key alın</li>\n<li><a href=\"/docs/getting-started/quick-start-llm\">LLM&#39;ler için hızlı başlangıç</a> — ilk API çağrıları</li>\n<li><a href=\"/docs/getting-started/authentication\">Kimlik Doğrulama</a> — Mind Key&#39;ler ve JWT&#39;ler</li>\n<li><a href=\"/docs/concepts/architecture\">Mimari genel bakış</a> — Synapse nasıl inşa edilmiştir</li>\n</ul>\n","urls":{"html":"/docs/getting-started/what-is-synapse","text":"/docs/getting-started/what-is-synapse?format=text","json":"/docs/getting-started/what-is-synapse?format=json","llm":"/docs/getting-started/what-is-synapse?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}