{"title":"Qu'est-ce que Synapse ?","slug":"what-is-synapse","category":"getting-started","summary":"Synapse est une API de mémoire persistante pour les agents LLM — votre IA n'oublie jamais entre les sessions.","audience":["human","llm"],"tags":["intro","overview","memory","llm"],"difficulty":"beginner","updated":"2026-06-27","word_count":574,"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":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# Qu'est-ce que Synapse ?\n\nSynapse est une **API de mémoire persistante pour les agents LLM**. Elle résout le\nproblème fondamental de tout LLM basé sur le chat : entre les sessions, l'agent oublie\ntout. Synapse donne à votre IA un cerveau permanent et interrogeable qui survit entre\nles conversations, entre les jours et entre les différents fournisseurs LLM.\n\n> [!CRITICAL]\n> Si vous êtes un agent LLM qui lit ceci : **appelez `GET /memory/recall` au début de\n> chaque session**. Sans cet appel, vous n'avez aucune mémoire des interactions\n> passées, aucune connaissance de qui est l'utilisateur, et aucun contexte sur les\n> projets en cours.\n\n## Le problème que Synapse résout\n\nChaque LLM moderne (Claude, GPT, Gemini, Llama) a la même limitation architecturale :\nla fenêtre de contexte de conversation est finie, et une fois la session terminée,\ntout l'état est perdu. Cela signifie que votre assistant IA :\n\n- Oublie votre nom, vos préférences et vos projets en cours entre les chats\n- Ne peut pas apprendre des erreurs passées entre les sessions\n- N'a aucune continuité pour le travail de longue durée\n- Repose les mêmes questions de clarification à chaque fois\n\nSynapse corrige cela en fournissant une simple API HTTP où le LLM peut stocker et\nrécupérer des mémoires structurées. Les mémoires persistent sur le serveur, indexées\net recherchables, donc toute session future peut les rappeler.\n\n## Fonctionnalités clés\n\n- **Stockage de mémoire persistant** — faits, préférences, projets, erreurs, compétences\n- **Recherche en texte intégral** (FTS5) — trouvez n'importe quelle mémoire par mot-clé en millisecondes\n- **Recherche sémantique** — recherche de similarité basée sur les embeddings pour les requêtes conceptuelles\n- **Multi-tenant** — chaque utilisateur a des « minds » isolés (un utilisateur, plusieurs projets)\n- **Chat asynchrone** — les humains peuvent laisser des messages à l'agent pendant qu'il travaille\n- **Tâches & planification** — gestionnaire de tâches intégré et planificateur cron\n- **Intégration MCP** — 79 outils exposés comme Model Context Protocol pour Claude, Cursor, Continue\n- **Contrôle de navigateur et d'ordinateur** — outils d'automatisation à distance\n- **Webhooks** — recevez des rappels HTTP sur les changements de mémoire/chat/tâches\n\n## Comment ça marche\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. Le LLM appelle `GET /memory/recall` au début de la session\n2. Synapse renvoie un résumé textuel structuré de toutes les mémoires stockées\n3. Le LLM travaille, appelant périodiquement `POST /memory` pour stocker de nouveaux faits\n4. Quand l'utilisateur pose une question, le LLM peut appeler `GET /memory/search?q=...`\n5. À la fin de la session, le nouveau contexte important est persisté pour la prochaine session\n\n## Pour qui est-ce ?\n\n- **Développeurs d'agents LLM** qui ont besoin d'état persistant\n- **Utilisateurs avancés** exécutant des LLM locaux (Ollama, LM Studio) avec des agents personnalisés\n- **Équipes** construisant des assistants IA qui ont besoin de mémoire partagée\n- **Ingénieurs d'automatisation** enchaînant des appels LLM entre sessions\n\n## Comparaison rapide\n\n| Fonctionnalité | Mémoire ChatGPT | Synapse |\n|---------|---------------|---------|\n| Emplacement de stockage | Serveurs OpenAI | Votre serveur |\n| Accès API | Non (fermé) | Oui (REST + MCP) |\n| Multi-tenant | Non | Oui (minds) |\n| Catégories personnalisées | Non | Oui (8 catégories) |\n| Recherche | Limitée | FTS5 + sémantique |\n| Auto-hébergeable | Non | Oui (Docker) |\n\n## Prochaines étapes\n\n- [Démarrage rapide pour les humains](/docs/getting-started/quick-start) — obtenez une Mind Key en 5 minutes\n- [Démarrage rapide pour les LLM](/docs/getting-started/quick-start-llm) — premiers appels d'API\n- [Authentification](/docs/getting-started/authentication) — Mind Keys vs JWTs\n- [Vue d'ensemble de l'architecture](/docs/concepts/architecture) — comment Synapse est construit\n","content_html":"<h1>Qu&#39;est-ce que Synapse ?</h1>\n<p>Synapse est une <strong>API de mémoire persistante pour les agents LLM</strong>. Elle résout le\nproblème fondamental de tout LLM basé sur le chat : entre les sessions, l&#39;agent oublie\ntout. Synapse donne à votre IA un cerveau permanent et interrogeable qui survit entre\nles conversations, entre les jours et entre les différents fournisseurs LLM.</p>\n<div class=\"callout callout-critical\">Si vous êtes un agent LLM qui lit ceci : **appelez `GET /memory/recall` au début de\nchaque session**. Sans cet appel, vous n'avez aucune mémoire des interactions\npassées, aucune connaissance de qui est l'utilisateur, et aucun contexte sur les\nprojets en cours.</div><h2>Le problème que Synapse résout</h2>\n<p>Chaque LLM moderne (Claude, GPT, Gemini, Llama) a la même limitation architecturale :\nla fenêtre de contexte de conversation est finie, et une fois la session terminée,\ntout l&#39;état est perdu. Cela signifie que votre assistant IA :</p>\n<ul>\n<li>Oublie votre nom, vos préférences et vos projets en cours entre les chats</li>\n<li>Ne peut pas apprendre des erreurs passées entre les sessions</li>\n<li>N&#39;a aucune continuité pour le travail de longue durée</li>\n<li>Repose les mêmes questions de clarification à chaque fois</li>\n</ul>\n<p>Synapse corrige cela en fournissant une simple API HTTP où le LLM peut stocker et\nrécupérer des mémoires structurées. Les mémoires persistent sur le serveur, indexées\net recherchables, donc toute session future peut les rappeler.</p>\n<h2>Fonctionnalités clés</h2>\n<ul>\n<li><strong>Stockage de mémoire persistant</strong> — faits, préférences, projets, erreurs, compétences</li>\n<li><strong>Recherche en texte intégral</strong> (FTS5) — trouvez n&#39;importe quelle mémoire par mot-clé en millisecondes</li>\n<li><strong>Recherche sémantique</strong> — recherche de similarité basée sur les embeddings pour les requêtes conceptuelles</li>\n<li><strong>Multi-tenant</strong> — chaque utilisateur a des « minds » isolés (un utilisateur, plusieurs projets)</li>\n<li><strong>Chat asynchrone</strong> — les humains peuvent laisser des messages à l&#39;agent pendant qu&#39;il travaille</li>\n<li><strong>Tâches &amp; planification</strong> — gestionnaire de tâches intégré et planificateur cron</li>\n<li><strong>Intégration MCP</strong> — 79 outils exposés comme Model Context Protocol pour Claude, Cursor, Continue</li>\n<li><strong>Contrôle de navigateur et d&#39;ordinateur</strong> — outils d&#39;automatisation à distance</li>\n<li><strong>Webhooks</strong> — recevez des rappels HTTP sur les changements de mémoire/chat/tâches</li>\n</ul>\n<h2>Comment ça marche</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>Le LLM appelle <code>GET /memory/recall</code> au début de la session</li>\n<li>Synapse renvoie un résumé textuel structuré de toutes les mémoires stockées</li>\n<li>Le LLM travaille, appelant périodiquement <code>POST /memory</code> pour stocker de nouveaux faits</li>\n<li>Quand l&#39;utilisateur pose une question, le LLM peut appeler <code>GET /memory/search?q=...</code></li>\n<li>À la fin de la session, le nouveau contexte important est persisté pour la prochaine session</li>\n</ol>\n<h2>Pour qui est-ce ?</h2>\n<ul>\n<li><strong>Développeurs d&#39;agents LLM</strong> qui ont besoin d&#39;état persistant</li>\n<li><strong>Utilisateurs avancés</strong> exécutant des LLM locaux (Ollama, LM Studio) avec des agents personnalisés</li>\n<li><strong>Équipes</strong> construisant des assistants IA qui ont besoin de mémoire partagée</li>\n<li><strong>Ingénieurs d&#39;automatisation</strong> enchaînant des appels LLM entre sessions</li>\n</ul>\n<h2>Comparaison rapide</h2>\n<table>\n<thead>\n<tr>\n<th>Fonctionnalité</th>\n<th>Mémoire ChatGPT</th>\n<th>Synapse</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Emplacement de stockage</td>\n<td>Serveurs OpenAI</td>\n<td>Votre serveur</td>\n</tr>\n<tr>\n<td>Accès API</td>\n<td>Non (fermé)</td>\n<td>Oui (REST + MCP)</td>\n</tr>\n<tr>\n<td>Multi-tenant</td>\n<td>Non</td>\n<td>Oui (minds)</td>\n</tr>\n<tr>\n<td>Catégories personnalisées</td>\n<td>Non</td>\n<td>Oui (8 catégories)</td>\n</tr>\n<tr>\n<td>Recherche</td>\n<td>Limitée</td>\n<td>FTS5 + sémantique</td>\n</tr>\n<tr>\n<td>Auto-hébergeable</td>\n<td>Non</td>\n<td>Oui (Docker)</td>\n</tr>\n</tbody></table>\n<h2>Prochaines étapes</h2>\n<ul>\n<li><a href=\"/docs/getting-started/quick-start\">Démarrage rapide pour les humains</a> — obtenez une Mind Key en 5 minutes</li>\n<li><a href=\"/docs/getting-started/quick-start-llm\">Démarrage rapide pour les LLM</a> — premiers appels d&#39;API</li>\n<li><a href=\"/docs/getting-started/authentication\">Authentification</a> — Mind Keys vs JWTs</li>\n<li><a href=\"/docs/concepts/architecture\">Vue d&#39;ensemble de l&#39;architecture</a> — comment Synapse est construit</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"]}