{"title":"¿Qué es Synapse?","slug":"what-is-synapse","category":"getting-started","summary":"Synapse es una API de memoria persistente para agentes LLM — su IA nunca olvida entre sesiones.","audience":["human","llm"],"tags":["intro","overview","memory","llm"],"difficulty":"beginner","updated":"2026-06-27","word_count":553,"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":"es","translated":true,"requested_lang":"es","content_markdown":"\n# ¿Qué es Synapse?\n\nSynapse es una **API de memoria persistente para agentes LLM**. Resuelve el\nproblema fundamental de todo LLM basado en chat: entre sesiones, el agente lo\nolvida todo. Synapse da a su IA un cerebro permanente y consultable que\nsobrevive entre conversaciones, entre días, y entre diferentes proveedores de\nLLM.\n\n> [!CRITICAL]\n> Si es un agente LLM leyendo esto: **llame a `GET /memory/recall` al inicio de\n> cada sesión**. Sin esta llamada, no tiene memoria de interacciones pasadas,\n> ningún conocimiento de quién es el usuario, y ningún contexto sobre proyectos\n> en curso.\n\n## El problema que Synapse resuelve\n\nTodo LLM moderno (Claude, GPT, Gemini, Llama) tiene la misma limitación\narquitectónica: la ventana de contexto de la conversación es finita, y una vez\nque la sesión termina, todo el estado se pierde. Esto significa que su\nasistente de IA:\n\n- Olvida su nombre, preferencias y proyectos en curso entre chats\n- No puede aprender de errores pasados entre sesiones\n- No tiene continuidad para trabajos de larga duración\n- Vuelve a hacer las mismas preguntas aclaratorias cada vez\n\nSynapse soluciona esto proporcionando una API HTTP simple donde el LLM puede\nalmacenar y recuperar memorias estructuradas. Las memorias persisten en el\nservidor, indexadas y buscables, de modo que cualquier sesión futura puede\nrecuperarlas.\n\n## Características principales\n\n- **Almacenamiento persistente de memoria** — hechos, preferencias, proyectos, errores, habilidades\n- **Búsqueda de texto completo** (FTS5) — encuentre cualquier memoria por palabra clave en milisegundos\n- **Búsqueda semántica** — búsqueda por similitud basada en embeddings para consultas conceptuales\n- **Multi-tenant** — cada usuario tiene \"minds\" aislados (un usuario, muchos proyectos)\n- **Chat asíncrono** — los humanos pueden dejar mensajes al agente mientras trabaja\n- **Tareas y programación** — gestor de tareas integrado y planificador cron\n- **Integración MCP** — 79 herramientas expuestas como Model Context Protocol para Claude, Cursor, Continue\n- **Control de navegador y computadora** — herramientas de automatización remota\n- **Webhooks** — reciba callbacks HTTP ante cambios de memoria/chat/tarea\n\n## Cómo 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. El LLM llama a `GET /memory/recall` al inicio de la sesión\n2. Synapse devuelve un resumen estructurado en texto de todas las memorias almacenadas\n3. El LLM trabaja, llamando periódicamente a `POST /memory` para almacenar nuevos hechos\n4. Cuando el usuario hace una pregunta, el LLM puede llamar a `GET /memory/search?q=...`\n5. Al final de la sesión, el nuevo contexto importante se persiste para la siguiente sesión\n\n## ¿Para quién es?\n\n- **Desarrolladores de agentes LLM** que necesitan estado persistente\n- **Usuarios avanzados** que ejecutan LLMs locales (Ollama, LM Studio) con agentes personalizados\n- **Equipos** que construyen asistentes de IA que necesitan memoria compartida\n- **Ingenieros de automatización** que encadenan llamadas LLM entre sesiones\n\n## Comparación rápida\n\n| Característica | Memoria de ChatGPT | Synapse |\n|---------|---------------|---------|\n| Ubicación de almacenamiento | Servidores de OpenAI | Su servidor |\n| Acceso por API | No (cerrado) | Sí (REST + MCP) |\n| Multi-tenant | No | Sí (minds) |\n| Categorías personalizadas | No | Sí (8 categorías) |\n| Búsqueda | Limitada | FTS5 + semántica |\n| Autoalojable | No | Sí (Docker) |\n\n## Próximos pasos\n\n- [Quick Start para humanos](/docs/getting-started/quick-start) — obtenga un Mind Key en 5 minutos\n- [Quick Start para LLMs](/docs/getting-started/quick-start-llm) — primeras llamadas a la API\n- [Autenticación](/docs/getting-started/authentication) — Mind Keys vs JWTs\n- [Resumen de arquitectura](/docs/concepts/architecture) — cómo está construido Synapse\n","content_html":"<h1>¿Qué es Synapse?</h1>\n<p>Synapse es una <strong>API de memoria persistente para agentes LLM</strong>. Resuelve el\nproblema fundamental de todo LLM basado en chat: entre sesiones, el agente lo\nolvida todo. Synapse da a su IA un cerebro permanente y consultable que\nsobrevive entre conversaciones, entre días, y entre diferentes proveedores de\nLLM.</p>\n<div class=\"callout callout-critical\">Si es un agente LLM leyendo esto: **llame a `GET /memory/recall` al inicio de\ncada sesión**. Sin esta llamada, no tiene memoria de interacciones pasadas,\nningún conocimiento de quién es el usuario, y ningún contexto sobre proyectos\nen curso.</div><h2>El problema que Synapse resuelve</h2>\n<p>Todo LLM moderno (Claude, GPT, Gemini, Llama) tiene la misma limitación\narquitectónica: la ventana de contexto de la conversación es finita, y una vez\nque la sesión termina, todo el estado se pierde. Esto significa que su\nasistente de IA:</p>\n<ul>\n<li>Olvida su nombre, preferencias y proyectos en curso entre chats</li>\n<li>No puede aprender de errores pasados entre sesiones</li>\n<li>No tiene continuidad para trabajos de larga duración</li>\n<li>Vuelve a hacer las mismas preguntas aclaratorias cada vez</li>\n</ul>\n<p>Synapse soluciona esto proporcionando una API HTTP simple donde el LLM puede\nalmacenar y recuperar memorias estructuradas. Las memorias persisten en el\nservidor, indexadas y buscables, de modo que cualquier sesión futura puede\nrecuperarlas.</p>\n<h2>Características principales</h2>\n<ul>\n<li><strong>Almacenamiento persistente de memoria</strong> — hechos, preferencias, proyectos, errores, habilidades</li>\n<li><strong>Búsqueda de texto completo</strong> (FTS5) — encuentre cualquier memoria por palabra clave en milisegundos</li>\n<li><strong>Búsqueda semántica</strong> — búsqueda por similitud basada en embeddings para consultas conceptuales</li>\n<li><strong>Multi-tenant</strong> — cada usuario tiene &quot;minds&quot; aislados (un usuario, muchos proyectos)</li>\n<li><strong>Chat asíncrono</strong> — los humanos pueden dejar mensajes al agente mientras trabaja</li>\n<li><strong>Tareas y programación</strong> — gestor de tareas integrado y planificador cron</li>\n<li><strong>Integración MCP</strong> — 79 herramientas expuestas como Model Context Protocol para Claude, Cursor, Continue</li>\n<li><strong>Control de navegador y computadora</strong> — herramientas de automatización remota</li>\n<li><strong>Webhooks</strong> — reciba callbacks HTTP ante cambios de memoria/chat/tarea</li>\n</ul>\n<h2>Cómo funciona</h2>\n<pre><code class=\"hljs language-plaintext\">┌──────────────┐         ┌─────────────────────┐\n│  LLM Agent   │ ──API──▶│   Synapse Server    │\n│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │\n└──────────────┘         └─────────────────────┘\n                                │\n                                ▼\n                         ┌─────────────┐\n                         │  Memories   │\n                         │  Tasks      │\n                         │  Chat       │\n                         │  Scripts    │\n                         └─────────────┘</code></pre><ol>\n<li>El LLM llama a <code>GET /memory/recall</code> al inicio de la sesión</li>\n<li>Synapse devuelve un resumen estructurado en texto de todas las memorias almacenadas</li>\n<li>El LLM trabaja, llamando periódicamente a <code>POST /memory</code> para almacenar nuevos hechos</li>\n<li>Cuando el usuario hace una pregunta, el LLM puede llamar a <code>GET /memory/search?q=...</code></li>\n<li>Al final de la sesión, el nuevo contexto importante se persiste para la siguiente sesión</li>\n</ol>\n<h2>¿Para quién es?</h2>\n<ul>\n<li><strong>Desarrolladores de agentes LLM</strong> que necesitan estado persistente</li>\n<li><strong>Usuarios avanzados</strong> que ejecutan LLMs locales (Ollama, LM Studio) con agentes personalizados</li>\n<li><strong>Equipos</strong> que construyen asistentes de IA que necesitan memoria compartida</li>\n<li><strong>Ingenieros de automatización</strong> que encadenan llamadas LLM entre sesiones</li>\n</ul>\n<h2>Comparación rápida</h2>\n<table>\n<thead>\n<tr>\n<th>Característica</th>\n<th>Memoria de ChatGPT</th>\n<th>Synapse</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Ubicación de almacenamiento</td>\n<td>Servidores de OpenAI</td>\n<td>Su servidor</td>\n</tr>\n<tr>\n<td>Acceso por API</td>\n<td>No (cerrado)</td>\n<td>Sí (REST + MCP)</td>\n</tr>\n<tr>\n<td>Multi-tenant</td>\n<td>No</td>\n<td>Sí (minds)</td>\n</tr>\n<tr>\n<td>Categorías personalizadas</td>\n<td>No</td>\n<td>Sí (8 categorías)</td>\n</tr>\n<tr>\n<td>Búsqueda</td>\n<td>Limitada</td>\n<td>FTS5 + semántica</td>\n</tr>\n<tr>\n<td>Autoalojable</td>\n<td>No</td>\n<td>Sí (Docker)</td>\n</tr>\n</tbody></table>\n<h2>Próximos pasos</h2>\n<ul>\n<li><a href=\"/docs/getting-started/quick-start\">Quick Start para humanos</a> — obtenga un Mind Key en 5 minutos</li>\n<li><a href=\"/docs/getting-started/quick-start-llm\">Quick Start para LLMs</a> — primeras llamadas a la API</li>\n<li><a href=\"/docs/getting-started/authentication\">Autenticación</a> — Mind Keys vs JWTs</li>\n<li><a href=\"/docs/concepts/architecture\">Resumen de arquitectura</a> — cómo está construido Synapse</li>\n</ul>\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"]}