# Quick Start (Manusia)

Panduan ini memandu Anda mendapatkan akun Synapse, Mind Key pertama Anda,
dan menyimpan memori pertama Anda. Total waktu: ~5 menit.

## Langkah 1: Daftarkan Akun

Buka Synapse API dan buat akun:

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

Respons:

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

> [!TIP]
> Simpan JWT di tempat yang aman — Anda akan memerlukannya untuk membuat mind. JWT kedaluwarsa
> setelah 7 hari; login ulang dengan endpoint yang sama untuk menyegarkan.

## Langkah 2: Buat Mind Pertama Anda

"Mind" adalah cakupan memori terisolasi. Sebagian besar pengguna memulai dengan
satu mind, tetapi Anda dapat memiliki beberapa (mis. "kerja", "pribadi",
"proyek-x"). Setiap mind memiliki Mind Key uniknya sendiri.

```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"
  }'
```

Respons:

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

> [!CRITICAL]
> **Simpan `mind_key` segera.** Hanya ditampilkan sekali dan tidak dapat
> diambil kemudian. Jika Anda kehilangannya, Anda harus membuat mind baru.

## Langkah 3: Simpan Memori Pertama Anda

Sekarang gunakan Mind Key untuk menyimpan memori:

```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"
  }'
```

Respons:

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

## Langkah 4: Recall Semua Memori

Untuk mengambil semua yang telah Anda simpan:

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

Respons (teks polos, dioptimalkan untuk konsumsi LLM):

```
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
```

## Langkah 5: Cari Memori

Temukan memori spesifik berdasarkan kata kunci:

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

## Langkah 6: Hubungkan LLM Anda

Cara termudah untuk memberikan LLM Anda akses ke Synapse adalah melalui MCP:

- [Pengaturan Claude Desktop](/docs/mcp/claude-desktop) — konfigurasi 2 menit
- [Pengaturan Claude Code](/docs/mcp/claude-code) — integrasi terminal
- [Pengaturan Cursor](/docs/mcp/cursor) — integrasi IDE

Setelah pengaturan, LLM Anda akan otomatis memanggil `memory_recall` di awal
setiap sesi dan menyimpan fakta baru melalui `memory_store`.

## Kategori Memori

Synapse mendukung 8 kategori — pilih yang paling spesifik:

| Kategori | Kasus Penggunaan |
|----------|----------|
| `identity` | Nama pengguna, peran, info kontak |
| `preference` | Suka, tidak suka, gaya kerja |
| `fact` | Fakta yang dapat diverifikasi (detail proyek, tanggal) |
| `project` | Status proyek, milestone, todo |
| `skill` | Hal-hal yang dikuasai pengguna |
| `mistake` | Error masa lalu — hindari pengulangan |
| `context` | Konteks yang relevan dengan sesi |
| `note` | Catatan lain-lain |

## Level Prioritas

- `low` — bagus untuk diketahui
- `normal` — default
- `high` — penting
- `critical` — tidak boleh dilupakan (identitas pengguna, info hukum)

## Langkah Berikutnya

- [Pelajari autentikasi lebih dalam](/docs/getting-started/authentication)
- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)
- [Referensi Memory API](/docs/api/memory)
- [Integrasi MCP](/docs/mcp/what-is-mcp)