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:

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

Resposta:

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

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.

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:

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

Passo 3: armazene sua primeira memória

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

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:

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

Passo 4: recupere todas as memórias

Para recuperar tudo o que você armazenou:

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:

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 — config em 2 minutos
• Configuração do Claude Code — integração com terminal
• Configuração do 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:

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
• Mind Key vs JWT
• Referência da API de Memória
• Integração MCP