# Quick Start (Human)

คู่มือนี้นำคุณผ่านการสมัครบัญชี Synapse, Mind Key แรก และเก็บ memory แรก เวลารวม: ~5 นาที

## ขั้นตอนที่ 1: สมัครบัญชี

เปิด Synapse API และสร้างบัญชี:

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

Response:

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

> [!TIP]
> บันทึก JWT ไว้ที่ปลอดภัย — คุณต้องใช้เพื่อสร้าง mind JWT หมดอายุหลัง 7 วัน; ล็อกอินใหม่ด้วย endpoint เดียวกันเพื่อ refresh

## ขั้นตอนที่ 2: สร้าง Mind แรกของคุณ

"mind" คือ scope memory ที่แยกออก ผู้ใช้ส่วนใหญ่เริ่มด้วย mind เดียว แต่คุณสามารถมีหลาย mind ได้ (เช่น "work", "personal", "project-x") แต่ละ mind มี Mind Key ที่ไม่ซ้ำกัน

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

Response:

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

> [!CRITICAL]
> **บันทึก `mind_key` ทันที** แสดงเพียงครั้งเดียวและดึงคืนไม่ได้ หากคุณสูญเสีย ต้องสร้าง mind ใหม่

## ขั้นตอนที่ 3: เก็บ Memory แรกของคุณ

ตอนนี้ใช้ Mind Key เพื่อเก็บ memory:

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

Response:

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

## ขั้นตอนที่ 4: Recall Memory ทั้งหมด

เพื่อดึงทุกสิ่งที่คุณเก็บไว้:

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

Response (plain text, ปรับให้เหมาะกับการบริโภคของ 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
```

## ขั้นตอนที่ 5: ค้นหา Memory

หา memory เฉพาะตาม keyword:

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

## ขั้นตอนที่ 6: เชื่อมต่อ LLM ของคุณ

วิธีที่ง่ายที่สุดในการให้ LLM เข้าถึง Synapse คือผ่าน MCP:

- [Claude Desktop setup](/docs/mcp/claude-desktop) — config 2 นาที
- [Claude Code setup](/docs/mcp/claude-code) — integration terminal
- [Cursor setup](/docs/mcp/cursor) — integration IDE

หลังตั้งค่า LLM ของคุณจะเรียก `memory_recall` โดยอัตโนมัติที่จุดเริ่มต้นของทุก session และเก็บ fact ใหม่ผ่าน `memory_store`

## Memory Category

Synapse รองรับ 8 category — เลือกอันที่เฉพาะเจาะจงที่สุด:

| Category | กรณีใช้งาน |
|----------|----------|
| `identity` | ชื่อผู้ใช้, role, ข้อมูลติดต่อ |
| `preference` | สิ่งที่ชอบ/ไม่ชอบ, สไตล์การทำงาน |
| `fact` | fact ที่ตรวจสอบได้ (รายละเอียดโปรเจกต์, วันที่) |
| `project` | สถานะโปรเจกต์, milestone, todo |
| `skill` | สิ่งที่ผู้ใช้ทำได้ดี |
| `mistake` | error ในอดีต — หลีกเลี่ยงการทำซ้ำ |
| `context` | context ที่เกี่ยวข้องกับ session |
| `note` | note อื่น ๆ |

## ระดับ Priority

- `low` — รู้ไว้ก็ดี
- `normal` — ค่าเริ่มต้น
- `high` — สำคัญ
- `critical` — ต้องไม่ลืมเด็ดขาด (ตัวตนผู้ใช้, ข้อมูลทางกฎหมาย)

## ขั้นตอนถัดไป

- [Authentication deep-dive](/docs/getting-started/authentication)
- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)
- [Memory API reference](/docs/api/memory)
- [MCP integration](/docs/mcp/what-is-mcp)