{"title":"Hızlı Başlangıç (İnsan)","slug":"quick-start","category":"getting-started","summary":"Bir hesap kaydedin, ilk mind'inizi oluşturun, bir bellek saklayın — hepsi 5 dakikada.","audience":["human"],"tags":["quickstart","human","register","mind-key"],"difficulty":"beginner","updated":"2026-06-27","word_count":340,"read_minutes":2,"lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Hızlı Başlangıç (İnsan)\n\nBu rehber, bir Synapse hesabı, ilk Mind Key'iniz ve ilk belleğinizi saklamanız için size yol gösterir. Toplam süre: ~5 dakika.\n\n## Adım 1: Hesap Kaydetme\n\nSynapse API'sini açın ve bir hesap oluşturun:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\"\n }'\n```\n\nYanıt:\n\n```json\n{\n \"jwt\": \"eyJhbGci...\",\n \"user\": { \"id\": \"u_abc123\", \"email\": \"you@example.com\" }\n}\n```\n\n> [!TIP]\n> JWT'yi güvenli bir yere kaydedin — mind oluşturmak için gerekecek. JWT 7 gün sonra sona erer; yenilemek için aynı uç nokta ile tekrar giriş yapın.\n\n## Adım 2: İlk Mind'inizi Oluşturun\n\n\"Mind\" izole bir bellek kapsamıdır. Çoğu kullanıcı tek bir mind ile başlar, ancak birden fazla olabilir (örn. \"work\", \"personal\", \"project-x\"). Her mind'in kendine özgü benzersiz Mind Key'i vardır.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"My First Mind\",\n \"description\": \"Personal assistant memory\"\n }'\n```\n\nYanıt:\n\n```json\n{\n \"id\": \"m_xyz789\",\n \"name\": \"My First Mind\",\n \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> **`mind_key`'i hemen kaydedin.** Yalnızca bir kez gösterilir ve daha sonra geri alınamaz. Kaybederseniz yeni bir mind oluşturmanız gerekir.\n\n## Adım 3: İlk Belleğinizi Saklayın\n\nŞimdi bir bellek saklamak için Mind Key'i kullanın:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"My name is Michael\",\n \"tags\": [\"personal\", \"identity\"],\n \"priority\": \"critical\"\n }'\n```\n\nYanıt:\n\n```json\n{\n \"id\": \"mem_001\",\n \"status\": \"stored\",\n \"mind_id\": \"m_xyz789\"\n}\n```\n\n## Adım 4: Tüm Bellekleri Geri Çağırın\n\nSakladığınız her şeyi almak için:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nYanıt (düz metin, LLM tüketimi için optimize edilmiş):\n\n```\nMind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n user_name\n My name is Michael\n Tags: personal, identity\n Stored: 2026-06-27\n```\n\n## Adım 5: Bellekleri Arama\n\nAnahtar kelimeye göre belirli bellekleri bulun:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=michael\"\n```\n\n## Adım 6: LLM'inizi Bağlayın\n\nLLM'inize Synapse erişimi sağlamanın en kolay yolu MCP üzerinden:\n\n- [Claude Desktop kurulumu](/docs/mcp/claude-desktop) — 2 dakikalık yapılandırma\n- [Claude Code kurulumu](/docs/mcp/claude-code) — terminal entegrasyonu\n- [Cursor kurulumu](/docs/mcp/cursor) — IDE entegrasyonu\n\nKurulumdan sonra LLM'iniz her oturumun başında otomatik olarak `memory_recall` çağırır ve yeni bilgileri `memory_store` ile saklar.\n\n## Bellek Kategorileri\n\nSynapse 8 kategori destekler — en spesifik olanı seçin:\n\n| Kategori | Kullanım Senaryosu |\n|----------|----------|\n| `identity` | Kullanıcı adı, rol, iletişim bilgisi |\n| `preference` | Beğeniler, beğenmemeler, çalışma tarzı |\n| `fact` | Doğrulanabilir bilgiler (proje detayları, tarihler) |\n| `project` | Proje durumu, kilometre taşları, yapılacaklar |\n| `skill` | Kullanıcının iyi olduğu şeyler |\n| `mistake` | Geçmiş hatalar — tekrarlamaktan kaçının |\n| `context` | Oturumla ilgili bağlam |\n| `note` | Çeşitli notlar |\n\n## Öncelik Düzeyleri\n\n- `low` — bilmek güzel\n- `normal` — varsayılan\n- `high` — önemli\n- `critical` — asla unutulmamalı (kullanıcı kimliği, yasal bilgiler)\n\n## Sonraki Adımlar\n\n- [Kimlik doğrulama derinlemesine](/docs/getting-started/authentication)\n- [Mind Key ve JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Memory API referansı](/docs/api/memory)\n- [MCP entegrasyonu](/docs/mcp/what-is-mcp)\n","content_html":"

Hızlı Başlangıç (İnsan)

\n

Bu rehber, bir Synapse hesabı, ilk Mind Key'iniz ve ilk belleğinizi saklamanız için size yol gösterir. Toplam süre: ~5 dakika.

\n

Adım 1: Hesap Kaydetme

\n

Synapse API'sini açın ve bir hesap oluşturun:

\n
curl -X POST https://synapse.schaefer.zone/register \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "email": "you@example.com",\n    "password": "your-secure-password"\n  }'

Yanıt:

\n
{\n  "jwt": "eyJhbGci...",\n  "user": { "id": "u_abc123", "email": "you@example.com" }\n}
JWT'yi güvenli bir yere kaydedin — mind oluşturmak için gerekecek. JWT 7 gün sonra sona erer; yenilemek için aynı uç nokta ile tekrar giriş yapın.

Adım 2: İlk Mind'inizi Oluşturun

\n

"Mind" izole bir bellek kapsamıdır. Çoğu kullanıcı tek bir mind ile başlar, ancak birden fazla olabilir (örn. "work", "personal", "project-x"). Her mind'in kendine özgü benzersiz Mind Key'i vardır.

\n
curl -X POST https://synapse.schaefer.zone/minds \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "name": "My First Mind",\n    "description": "Personal assistant memory"\n  }'

Yanıt:

\n
{\n  "id": "m_xyz789",\n  "name": "My First Mind",\n  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",\n  "created_at": "2026-06-27T..."\n}
**`mind_key`'i hemen kaydedin.** Yalnızca bir kez gösterilir ve daha sonra geri alınamaz. Kaybederseniz yeni bir mind oluşturmanız gerekir.

Adım 3: İlk Belleğinizi Saklayın

\n

Şimdi bir bellek saklamak için Mind Key'i kullanın:

\n
curl -X POST https://synapse.schaefer.zone/memory \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "category": "identity",\n    "key": "user_name",\n    "content": "My name is Michael",\n    "tags": ["personal", "identity"],\n    "priority": "critical"\n  }'

Yanıt:

\n
{\n  "id": "mem_001",\n  "status": "stored",\n  "mind_id": "m_xyz789"\n}

Adım 4: Tüm Bellekleri Geri Çağırın

\n

Sakladığınız her şeyi almak için:

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/recall

Yanıt (düz metin, LLM tüketimi için optimize edilmiş):

\n
Mind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  My name is Michael\n  Tags: personal, identity\n  Stored: 2026-06-27

Adım 5: Bellekleri Arama

\n

Anahtar kelimeye göre belirli bellekleri bulun:

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=michael"

Adım 6: LLM'inizi Bağlayın

\n

LLM'inize Synapse erişimi sağlamanın en kolay yolu MCP üzerinden:

\n\n

Kurulumdan sonra LLM'iniz her oturumun başında otomatik olarak memory_recall çağırır ve yeni bilgileri memory_store ile saklar.

\n

Bellek Kategorileri

\n

Synapse 8 kategori destekler — en spesifik olanı seçin:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
KategoriKullanım Senaryosu
identityKullanıcı adı, rol, iletişim bilgisi
preferenceBeğeniler, beğenmemeler, çalışma tarzı
factDoğrulanabilir bilgiler (proje detayları, tarihler)
projectProje durumu, kilometre taşları, yapılacaklar
skillKullanıcının iyi olduğu şeyler
mistakeGeçmiş hatalar — tekrarlamaktan kaçının
contextOturumla ilgili bağlam
noteÇeşitli notlar
\n

Öncelik Düzeyleri

\n\n

Sonraki Adımlar

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