# Швидкий старт (людина)

Цей посібник проведе вас через отримання облікового запису Synapse, вашого
першого Mind Key та збереження першого спогаду. Загальний час: ~5 хвилин.

## Крок 1: Зареєструйте обліковий запис

Відкрийте API Synapse та створіть обліковий запис:

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

Відповідь:

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

> [!TIP]
> Збережіть JWT у безпечному місці — він потрібен для створення mind-ів. JWT
> закінчується через 7 днів; повторно увійдіть через ту саму кінцеву точку для
> оновлення.

## Крок 2: Створіть свій перший mind

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

Відповідь:

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

> [!CRITICAL]
> **Збережіть `mind_key` негайно.** Воно показується лише один раз і не може
> бути отримане пізніше. Якщо втратите, доведеться створити новий mind.

## Крок 3: Збережіть свій перший спогад

Тепер використовуйте Mind Key для збереження спогаду:

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

Відповідь:

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

## Крок 4: Відкличайте всі спогади

Щоб отримати все, що ви зберегли:

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

Відповідь (звичайний текст, оптимізований для споживання 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: Пошук спогадів

Знайдіть конкретні спогади за ключовим словом:

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

## Крок 6: Підключіть ваш LLM

Найпростіший спосіб дати вашому LLM доступ до Synapse — через MCP:

- [Налаштування Claude Desktop](/docs/mcp/claude-desktop) — конфігурація за 2 хвилини
- [Налаштування Claude Code](/docs/mcp/claude-code) — інтеграція з терміналом
- [Налаштування Cursor](/docs/mcp/cursor) — інтеграція з IDE

Після налаштування ваш LLM автоматично викликатиме `memory_recall` на початку
кожної сесії та зберігатиме нові факти через `memory_store`.

## Категорії спогадів

Synapse підтримує 8 категорій — оберіть найбільш конкретну:

| Категорія | Варіант використання |
|----------|----------|
| `identity` | Ім'я, роль, контактна інформація користувача |
| `preference` | Подобання, антипатії, стиль роботи |
| `fact` | Перевірювані факти (деталі проєкту, дати) |
| `project` | Статус проєкту, етапи, завдання |
| `skill` | Те, у чому користувач сильний |
| `mistake` | Минулі помилки — уникайте повторення |
| `context` | Контекст, релевантний сесії |
| `note` | Різні нотатки |

## Рівні пріоритету

- `low` — корисно знати
- `normal` — за замовчуванням
- `high` — важливо
- `critical` — ніколи не забувати (ідентичність користувача, юридична інформація)

## Наступні кроки

- [Поглиблено про автентифікацію](/docs/getting-started/authentication)
- [Mind Key проти JWT](/docs/getting-started/mind-key-vs-jwt)
- [Довідник Memory API](/docs/api/memory)
- [Інтеграція MCP](/docs/mcp/what-is-mcp)