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

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.

## Adım 1: Hesap Kaydetme

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

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

Yanıt:

```json
{
  "jwt": "eyJhbGci...",
  "user": { "id": "u_abc123", "email": "you@example.com" }
}
```

> [!TIP]
> 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

"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.

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

Yanıt:

```json
{
  "id": "m_xyz789",
  "name": "My First Mind",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}
```

> [!CRITICAL]
> **`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

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

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

Yanıt:

```json
{
  "id": "mem_001",
  "status": "stored",
  "mind_id": "m_xyz789"
}
```

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

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

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

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

```
Mind: My First Mind
Memories: 1 total (1 verified)

[001] identity (CRITICAL)
  user_name
  My name is Michael
  Tags: personal, identity
  Stored: 2026-06-27
```

## Adım 5: Bellekleri Arama

Anahtar kelimeye göre belirli bellekleri bulun:

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

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

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

- [Claude Desktop kurulumu](/docs/mcp/claude-desktop) — 2 dakikalık yapılandırma
- [Claude Code kurulumu](/docs/mcp/claude-code) — terminal entegrasyonu
- [Cursor kurulumu](/docs/mcp/cursor) — IDE entegrasyonu

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

## Bellek Kategorileri

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

| Kategori | Kullanım Senaryosu |
|----------|----------|
| `identity` | Kullanıcı adı, rol, iletişim bilgisi |
| `preference` | Beğeniler, beğenmemeler, çalışma tarzı |
| `fact` | Doğrulanabilir bilgiler (proje detayları, tarihler) |
| `project` | Proje durumu, kilometre taşları, yapılacaklar |
| `skill` | Kullanıcının iyi olduğu şeyler |
| `mistake` | Geçmiş hatalar — tekrarlamaktan kaçının |
| `context` | Oturumla ilgili bağlam |
| `note` | Çeşitli notlar |

## Öncelik Düzeyleri

- `low` — bilmek güzel
- `normal` — varsayılan
- `high` — önemli
- `critical` — asla unutulmamalı (kullanıcı kimliği, yasal bilgiler)

## Sonraki Adımlar

- [Kimlik doğrulama derinlemesine](/docs/getting-started/authentication)
- [Mind Key ve JWT](/docs/getting-started/mind-key-vs-jwt)
- [Memory API referansı](/docs/api/memory)
- [MCP entegrasyonu](/docs/mcp/what-is-mcp)