# Quick Start (Humano)

Este guia conduz você pela criação de uma conta no Synapse, sua primeira Mind
Key e o armazenamento de sua primeira memória. Tempo total: ~5 minutos.

## Passo 1: registre uma conta

Abra a API do Synapse e crie uma conta:

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

Resposta:

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

> [!TIP]
> Salve o JWT em algum lugar seguro — você precisará dele para criar minds. O
> JWT expira após 7 dias; refaça login com o mesmo endpoint para renovar.

## Passo 2: crie seu primeiro mind

Um "mind" é um escopo de memória isolado. A maioria dos usuários começa com um
mind, mas você pode ter múltiplos (ex.: "work", "personal", "project-x"). Cada
mind tem sua própria Mind Key única.

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

Resposta:

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

> [!CRITICAL]
> **Salve a `mind_key` imediatamente.** Ela é exibida apenas uma vez e não
> pode ser recuperada depois. Se você a perder, precisará criar um novo mind.

## Passo 3: armazene sua primeira memória

Agora use a Mind Key para armazenar uma memória:

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

Resposta:

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

## Passo 4: recupere todas as memórias

Para recuperar tudo o que você armazenou:

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

Resposta (texto puro, otimizado para consumo por 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
```

## Passo 5: busque memórias

Encontre memórias específicas por palavra-chave:

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

## Passo 6: conecte seu LLM

A forma mais fácil de dar ao seu LLM acesso ao Synapse é via MCP:

- [Configuração do Claude Desktop](/docs/mcp/claude-desktop) — config em 2 minutos
- [Configuração do Claude Code](/docs/mcp/claude-code) — integração com terminal
- [Configuração do Cursor](/docs/mcp/cursor) — integração com IDE

Após a configuração, seu LLM chamará automaticamente `memory_recall` no início
de cada sessão e persistirá novos fatos via `memory_store`.

## Categorias de memória

O Synapse suporta 8 categorias — escolha a mais específica:

| Categoria | Caso de uso |
|-----------|-------------|
| `identity` | Nome do usuário, papel, contato |
| `preference` | Gostos, desgostos, estilo de trabalho |
| `fact` | Fatos verificáveis (detalhes de projeto, datas) |
| `project` | Status de projeto, marcos, todos |
| `skill` | Coisas em que o usuário é bom |
| `mistake` | Erros passados — evitar repetir |
| `context` | Contexto relevante para a sessão |
| `note` | Notas diversas |

## Níveis de prioridade

- `low` — bom saber
- `normal` — padrão
- `high` — importante
- `critical` — nunca esquecer (identidade do usuário, info jurídica)

## Próximos passos

- [Mergulho profundo em autenticação](/docs/getting-started/authentication)
- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)
- [Referência da API de Memória](/docs/api/memory)
- [Integração MCP](/docs/mcp/what-is-mcp)