# Быстрый старт (человек)

Это руководство проведёт вас через получение аккаунта Synapse, вашего первого
Mind Key и сохранение первого воспоминания. Общее время: ~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"
  }'
```

Ответ:

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