{"title":"Quick Start (Humano)","slug":"quick-start","category":"getting-started","summary":"Registre uma conta, crie seu primeiro mind, armazene uma memória — tudo em 5 minutos.","audience":["human"],"tags":["quickstart","human","register","mind-key"],"difficulty":"beginner","updated":"2026-06-27","word_count":401,"read_minutes":2,"lang":"pt","translated":true,"requested_lang":"pt","content_markdown":"\n# Quick Start (Humano)\n\nEste guia conduz você pela criação de uma conta no Synapse, sua primeira Mind\nKey e o armazenamento de sua primeira memória. Tempo total: ~5 minutos.\n\n## Passo 1: registre uma conta\n\nAbra a API do Synapse e crie uma conta:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\"\n }'\n```\n\nResposta:\n\n```json\n{\n \"jwt\": \"eyJhbGci...\",\n \"user\": { \"id\": \"u_abc123\", \"email\": \"you@example.com\" }\n}\n```\n\n> [!TIP]\n> Salve o JWT em algum lugar seguro — você precisará dele para criar minds. O\n> JWT expira após 7 dias; refaça login com o mesmo endpoint para renovar.\n\n## Passo 2: crie seu primeiro mind\n\nUm \"mind\" é um escopo de memória isolado. A maioria dos usuários começa com um\nmind, mas você pode ter múltiplos (ex.: \"work\", \"personal\", \"project-x\"). Cada\nmind tem sua própria Mind Key única.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"My First Mind\",\n \"description\": \"Personal assistant memory\"\n }'\n```\n\nResposta:\n\n```json\n{\n \"id\": \"m_xyz789\",\n \"name\": \"My First Mind\",\n \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> **Salve a `mind_key` imediatamente.** Ela é exibida apenas uma vez e não\n> pode ser recuperada depois. Se você a perder, precisará criar um novo mind.\n\n## Passo 3: armazene sua primeira memória\n\nAgora use a Mind Key para armazenar uma memória:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"My name is Michael\",\n \"tags\": [\"personal\", \"identity\"],\n \"priority\": \"critical\"\n }'\n```\n\nResposta:\n\n```json\n{\n \"id\": \"mem_001\",\n \"status\": \"stored\",\n \"mind_id\": \"m_xyz789\"\n}\n```\n\n## Passo 4: recupere todas as memórias\n\nPara recuperar tudo o que você armazenou:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nResposta (texto puro, otimizado para consumo por LLM):\n\n```\nMind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n user_name\n My name is Michael\n Tags: personal, identity\n Stored: 2026-06-27\n```\n\n## Passo 5: busque memórias\n\nEncontre memórias específicas por palavra-chave:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=michael\"\n```\n\n## Passo 6: conecte seu LLM\n\nA forma mais fácil de dar ao seu LLM acesso ao Synapse é via MCP:\n\n- [Configuração do Claude Desktop](/docs/mcp/claude-desktop) — config em 2 minutos\n- [Configuração do Claude Code](/docs/mcp/claude-code) — integração com terminal\n- [Configuração do Cursor](/docs/mcp/cursor) — integração com IDE\n\nApós a configuração, seu LLM chamará automaticamente `memory_recall` no início\nde cada sessão e persistirá novos fatos via `memory_store`.\n\n## Categorias de memória\n\nO Synapse suporta 8 categorias — escolha a mais específica:\n\n| Categoria | Caso de uso |\n|-----------|-------------|\n| `identity` | Nome do usuário, papel, contato |\n| `preference` | Gostos, desgostos, estilo de trabalho |\n| `fact` | Fatos verificáveis (detalhes de projeto, datas) |\n| `project` | Status de projeto, marcos, todos |\n| `skill` | Coisas em que o usuário é bom |\n| `mistake` | Erros passados — evitar repetir |\n| `context` | Contexto relevante para a sessão |\n| `note` | Notas diversas |\n\n## Níveis de prioridade\n\n- `low` — bom saber\n- `normal` — padrão\n- `high` — importante\n- `critical` — nunca esquecer (identidade do usuário, info jurídica)\n\n## Próximos passos\n\n- [Mergulho profundo em autenticação](/docs/getting-started/authentication)\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Referência da API de Memória](/docs/api/memory)\n- [Integração MCP](/docs/mcp/what-is-mcp)\n","content_html":"

Quick Start (Humano)

\n

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

\n

Passo 1: registre uma conta

\n

Abra a API do Synapse e crie uma conta:

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

Resposta:

\n
{\n  "jwt": "eyJhbGci...",\n  "user": { "id": "u_abc123", "email": "you@example.com" }\n}
Salve o JWT em algum lugar seguro — você precisará dele para criar minds. O\nJWT expira após 7 dias; refaça login com o mesmo endpoint para renovar.

Passo 2: crie seu primeiro mind

\n

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

\n
curl -X POST https://synapse.schaefer.zone/minds \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "name": "My First Mind",\n    "description": "Personal assistant memory"\n  }'

Resposta:

\n
{\n  "id": "m_xyz789",\n  "name": "My First Mind",\n  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",\n  "created_at": "2026-06-27T..."\n}
**Salve a `mind_key` imediatamente.** Ela é exibida apenas uma vez e não\npode ser recuperada depois. Se você a perder, precisará criar um novo mind.

Passo 3: armazene sua primeira memória

\n

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

\n
curl -X POST https://synapse.schaefer.zone/memory \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "category": "identity",\n    "key": "user_name",\n    "content": "My name is Michael",\n    "tags": ["personal", "identity"],\n    "priority": "critical"\n  }'

Resposta:

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

Passo 4: recupere todas as memórias

\n

Para recuperar tudo o que você armazenou:

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

Resposta (texto puro, otimizado para consumo por LLM):

\n
Mind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  My name is Michael\n  Tags: personal, identity\n  Stored: 2026-06-27

Passo 5: busque memórias

\n

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

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

Passo 6: conecte seu LLM

\n

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

\n\n

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

\n

Categorias de memória

\n

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CategoriaCaso de uso
identityNome do usuário, papel, contato
preferenceGostos, desgostos, estilo de trabalho
factFatos verificáveis (detalhes de projeto, datas)
projectStatus de projeto, marcos, todos
skillCoisas em que o usuário é bom
mistakeErros passados — evitar repetir
contextContexto relevante para a sessão
noteNotas diversas
\n

Níveis de prioridade

\n\n

Próximos passos

\n\n","urls":{"html":"/docs/getting-started/quick-start","text":"/docs/getting-started/quick-start?format=text","json":"/docs/getting-started/quick-start?format=json","llm":"/docs/getting-started/quick-start?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}