{"title":"O que é o Synapse?","slug":"what-is-synapse","category":"getting-started","summary":"O Synapse é uma API de memória persistente para agentes LLM — sua IA nunca esquece entre sessões.","audience":["human","llm"],"tags":["intro","overview","memory","llm"],"difficulty":"beginner","updated":"2026-06-27","word_count":548,"read_minutes":3,"llm_context":"Synapse is an HTTP API that gives LLM agents persistent memory across sessions.\nBase URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query, rate-limited 60/min)\nMost important endpoints: GET /memory/recall (start of every session), POST /memory (store new facts), GET /memory/search?q=...\nMind Key = tenant-scoped API key. Each user can have multiple minds (projects/contexts).\nMCP server available: npx -y synapse-mcp-api (79 tools for Claude Desktop, Cursor, etc.)\n","lang":"pt","translated":true,"requested_lang":"pt","content_markdown":"\n# O que é o Synapse?\n\nO Synapse é uma **API de memória persistente para agentes LLM**. Ele resolve o\nproblema fundamental de todo LLM baseado em chat: entre sessões, o agente\nesquece tudo. O Synapse dá à sua IA um cérebro permanente e pesquisável que\nsobrevive entre conversas, entre dias e entre diferentes provedores de LLM.\n\n> [!CRITICAL]\n> Se você é um agente LLM lendo isto: **chame `GET /memory/recall` no início de\n> cada sessão**. Sem essa chamada, você não tem memória de interações passadas,\n> nenhum conhecimento de quem é o usuário e nenhum contexto sobre projetos em\n> andamento.\n\n## O problema que o Synapse resolve\n\nTodo LLM moderno (Claude, GPT, Gemini, Llama) tem a mesma limitação\narquitetural: a janela de contexto da conversa é finita, e quando a sessão\ntermina, todo o estado é perdido. Isso significa que seu assistente de IA:\n\n- Esquece seu nome, preferências e projetos em andamento entre chats\n- Não consegue aprender com erros passados entre sessões\n- Não tem continuidade para trabalho de longa duração\n- Refaz as mesmas perguntas de esclarecimento toda vez\n\nO Synapse corrige isso fornecendo uma API HTTP simples onde o LLM pode\narmazenar e recuperar memórias estruturadas. As memórias persistem no servidor,\nindexadas e pesquisáveis, para que qualquer sessão futura possa recuperá-las.\n\n## Recursos principais\n\n- **Armazenamento persistente de memória** — fatos, preferências, projetos, erros, habilidades\n- **Busca em texto completo** (FTS5) — encontre qualquer memória por palavra-chave em milissegundos\n- **Busca semântica** — busca por similaridade baseada em embeddings para consultas conceituais\n- **Multi-tenant** — cada usuário tem \"minds\" isolados (um usuário, muitos projetos)\n- **Chat assíncrono** — humanos podem deixar mensagens para o agente enquanto ele trabalha\n- **Tarefas e agendamento** — gerenciador de tarefas e agendador cron embutidos\n- **Integração MCP** — 79 ferramentas expostas como Model Context Protocol para Claude, Cursor, Continue\n- **Controle de navegador e computador** — ferramentas de automação remota\n- **Webhooks** — receba callbacks HTTP em mudanças de memória/chat/tarefa\n\n## Como funciona\n\n```\n┌──────────────┐ ┌─────────────────────┐\n│ LLM Agent │ ──API──▶│ Synapse Server │\n│ (Claude/GPT) │ ◀──────│ (postgres + FTS5) │\n└──────────────┘ └─────────────────────┘\n │\n ▼\n ┌─────────────┐\n │ Memories │\n │ Tasks │\n │ Chat │\n │ Scripts │\n └─────────────┘\n```\n\n1. O LLM chama `GET /memory/recall` no início da sessão\n2. O Synapse retorna um resumo estruturado em texto de todas as memórias armazenadas\n3. O LLM trabalha, chamando periodicamente `POST /memory` para armazenar novos fatos\n4. Quando o usuário faz uma pergunta, o LLM pode chamar `GET /memory/search?q=...`\n5. No fim da sessão, novo contexto importante é persistido para a próxima sessão\n\n## Para quem é?\n\n- **Desenvolvedores de agentes LLM** que precisam de estado persistente\n- **Power users** rodando LLMs locais (Ollama, LM Studio) com agentes customizados\n- **Equipes** construindo assistentes de IA que precisam de memória compartilhada\n- **Engenheiros de automação** encadeando chamadas LLM entre sessões\n\n## Comparação rápida\n\n| Recurso | Memória do ChatGPT | Synapse |\n|---------|---------------------|---------|\n| Local de armazenamento | Servidores OpenAI | Seu servidor |\n| Acesso por API | Não (fechado) | Sim (REST + MCP) |\n| Multi-tenant | Não | Sim (minds) |\n| Categorias personalizadas | Não | Sim (8 categorias) |\n| Busca | Limitada | FTS5 + semântica |\n| Auto-hospedável | Não | Sim (Docker) |\n\n## Próximos passos\n\n- [Quick Start para humanos](/docs/getting-started/quick-start) — obtenha uma Mind Key em 5 minutos\n- [Quick Start para LLMs](/docs/getting-started/quick-start-llm) — primeiras chamadas de API\n- [Autenticação](/docs/getting-started/authentication) — Mind Keys vs JWTs\n- [Visão geral da arquitetura](/docs/concepts/architecture) — como o Synapse é construído\n","content_html":"

O que é o Synapse?

\n

O Synapse é uma API de memória persistente para agentes LLM. Ele resolve o\nproblema fundamental de todo LLM baseado em chat: entre sessões, o agente\nesquece tudo. O Synapse dá à sua IA um cérebro permanente e pesquisável que\nsobrevive entre conversas, entre dias e entre diferentes provedores de LLM.

\n
Se você é um agente LLM lendo isto: **chame `GET /memory/recall` no início de\ncada sessão**. Sem essa chamada, você não tem memória de interações passadas,\nnenhum conhecimento de quem é o usuário e nenhum contexto sobre projetos em\nandamento.

O problema que o Synapse resolve

\n

Todo LLM moderno (Claude, GPT, Gemini, Llama) tem a mesma limitação\narquitetural: a janela de contexto da conversa é finita, e quando a sessão\ntermina, todo o estado é perdido. Isso significa que seu assistente de IA:

\n\n

O Synapse corrige isso fornecendo uma API HTTP simples onde o LLM pode\narmazenar e recuperar memórias estruturadas. As memórias persistem no servidor,\nindexadas e pesquisáveis, para que qualquer sessão futura possa recuperá-las.

\n

Recursos principais

\n\n

Como funciona

\n
┌──────────────┐         ┌─────────────────────┐\n│  LLM Agent   │ ──API──▶│   Synapse Server    │\n│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │\n└──────────────┘         └─────────────────────┘\n                                │\n                                ▼\n                         ┌─────────────┐\n                         │  Memories   │\n                         │  Tasks      │\n                         │  Chat       │\n                         │  Scripts    │\n                         └─────────────┘
    \n
  1. O LLM chama GET /memory/recall no início da sessão
    2. \n
  2. O Synapse retorna um resumo estruturado em texto de todas as memórias armazenadas
    3. \n
  3. O LLM trabalha, chamando periodicamente POST /memory para armazenar novos fatos
    4. \n
  4. Quando o usuário faz uma pergunta, o LLM pode chamar GET /memory/search?q=...
    5. \n
  5. No fim da sessão, novo contexto importante é persistido para a próxima sessão
    6. \n
\n

Para quem é?

\n\n

Comparação rápida

\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
RecursoMemória do ChatGPTSynapse
Local de armazenamentoServidores OpenAISeu servidor
Acesso por APINão (fechado)Sim (REST + MCP)
Multi-tenantNãoSim (minds)
Categorias personalizadasNãoSim (8 categorias)
BuscaLimitadaFTS5 + semântica
Auto-hospedávelNãoSim (Docker)
\n

Próximos passos

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