# Quick Start (Con người)

Hướng dẫn này dẫn bạn qua việc lấy tài khoản Synapse, Mind Key đầu tiên và lưu
bộ nhớ đầu tiên. Tổng thời gian: ~5 phút.

## Bước 1: Đăng ký tài khoản

Mở Synapse API và tạo tài khoản:

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

Phản hồi:

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

> [!TIP]
> Lưu JWT ở nơi an toàn — bạn sẽ cần nó để tạo mind. JWT hết hạn sau 7 ngày;
> đăng nhập lại với cùng endpoint để làm mới.

## Bước 2: Tạo Mind đầu tiên của bạn

"Mind" là phạm vi bộ nhớ tách biệt. Hầu hết người dùng bắt đầu với một mind,
nhưng bạn có thể có nhiều (ví dụ "work", "personal", "project-x"). Mỗi mind có
Mind Key duy nhất riêng.

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

Phản hồi:

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

> [!CRITICAL]
> **Lưu `mind_key` ngay lập tức.** Nó chỉ hiển thị một lần và không thể lấy lại
> sau. Nếu bạn mất nó, bạn sẽ cần tạo mind mới.

## Bước 3: Lưu bộ nhớ đầu tiên

Bây giờ sử dụng Mind Key để lưu bộ nhớ:

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

Phản hồi:

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

## Bước 4: Thu hồi tất cả bộ nhớ

Để truy xuất mọi thứ bạn đã lưu:

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

Phản hồi (văn bản thuần, tối ưu cho tiêu thụ 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
```

## Bước 5: Tìm kiếm bộ nhớ

Tìm bộ nhớ cụ thể theo từ khóa:

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

## Bước 6: Kết nối LLM của bạn

Cách dễ nhất để cấp cho LLM truy cập Synapse là qua MCP:

- [Thiết lập Claude Desktop](/docs/mcp/claude-desktop) — cấu hình 2 phút
- [Thiết lập Claude Code](/docs/mcp/claude-code) — tích hợp terminal
- [Thiết lập Cursor](/docs/mcp/cursor) — tích hợp IDE

Sau khi thiết lập, LLM của bạn sẽ tự động gọi `memory_recall` ở đầu mỗi phiên và
lưu trữ sự kiện mới qua `memory_store`.

## Danh mục bộ nhớ

Synapse hỗ trợ 8 danh mục — chọn cái cụ thể nhất:

| Danh mục | Trường hợp sử dụng |
|----------|----------|
| `identity` | Tên người dùng, vai trò, thông tin liên hệ |
| `preference` | Thích, không thích, phong cách làm việc |
| `fact` | Sự kiện có thể kiểm chứng (chi tiết dự án, ngày tháng) |
| `project` | Trạng thái dự án, cột mốc, todo |
| `skill` | Những thứ người dùng giỏi |
| `mistake` | Lỗi trong quá khứ — tránh lặp lại |
| `context` | Ngữ cảnh liên quan phiên |
| `note` | Ghi chú linh tinh |

## Mức ưu tiên

- `low` — tốt nếu biết
- `normal` — mặc định
- `high` — quan trọng
- `critical` — không bao giờ được quên (nhận dạng người dùng, thông tin pháp lý)

## Bước tiếp theo

- [Xác thực chuyên sâu](/docs/getting-started/authentication)
- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)
- [Tham chiếu Memory API](/docs/api/memory)
- [Tích hợp MCP](/docs/mcp/what-is-mcp)