# Synapse-architectuur
SUMMARY: Hoe Synapse is opgebouwd — Fastify, PostgreSQL, FTS5, embeddings, MCP-server.

Synapse-architectuur
Synapse is een multi-tenant memory-API gebouwd op Fastify, PostgreSQL met FTS5,
en een optionele embeddings-service voor semantisch zoeken.
Architectuur op hoog niveau
[CODE BLOCK]
Kerncomponenten
1. Synapse API (Fastify)
De hoofd-HTTP-server. Verwerkt:
- REST-eindpunten (, , , enz.)
- Authenticatie (Mind Key voor agents, JWT voor mensen)
- Ratelimiting (alleen -auth)
- Statische bestandsweergave (web-UI op , , enz.)
- Webhook-dispatch
Gebouwd met Fastify 5 voor prestaties. Draait op poort 12800 in productie.
2. PostgreSQL met FTS5
De primaire datastore. Gebruikt PostgreSQL met de FTS5-extensie voor
volledige-tekst zoekopdrachten.
Belangrijke tabellen:
| Tabel | Doel |
|-------|------|
|  | Gebruikersaccounts |
|  | Mind-scopes (elk heeft een Mind Key) |
|  | Memory-records met FTS5 virtuele tabel |
|  | Taakbeheer |
|  | Chatgeschiedenis |
|  | Permanente scripts |
|  | Webhook-registraties |
|  | Geplande taken |
|  | Key-value-opslag |
|  | Audittrail |
FTS5 maakt sub-milliseconde volledige-tekst zoekopdrachten mogelijk over alle
memory-inhoud. Zie FTS5-zoekopdracht voor details.
3. Embeddings-service (optioneel)
Voor semantisch zoeken genereert Synapse vector-embeddings van memory-inhoud.
Deze worden naast herinneringen opgeslagen en gebruikt voor similariteitszoekopdrachten.
- Provider: configureerbaar (OpenAI, lokaal model, enz.)
- Opgeslagen als -kolom in de -tabel
- Gebruikt door het -eindpunt
- Zie Semantisch zoeken
4. MCP-server (aparte service)
De Synapse MCP-server draait als een apart proces (poort 13100). Deze:
- Stelt 79 tools beschikbaar via Model Context Protocol
- Ondersteunt stdio-, HTTP/SSE- en WebSocket-transporten
- Vertaalt MCP-tool-aanroepen naar Synapse API-aanroepen
- Multi-tenant: één Mind Key per sessie
5. Browser Proxy (aparte service)
Voor browserautomatisering draait een aparte Playwright-gebaseerde service op poort 13000.
De MCP-server kan deze aanroepen voor -tools.
6. SSH Proxy (aparte service)
Voor SSH-gebaseerde commando's op afstand draait een aparte service op poort 12900.
Multi-tenant-model
[CODE BLOCK]
Elke mind is volledig geïsoleerd. Mind Keys verlenen toegang tot precies één mind.
JWT's verlenen toegang tot het gebruikersaccount (voor het beheren van minds).
Zie Multi-tenancy voor details.
Verzoek-flow
Memory-opslagverzoek
[CODE BLOCK]
Memory-zoekverzoek
[CODE BLOCK]
Deployment
Synapse wordt uitgerold als Docker-container. Zie :
[CODE BLOCK]
Prestatiekenmerken
| Bewerking | Latentie | Doorvoer |
|-----------|----------|----------|
| Memory store | 5ms | 1000+ req/s |
| Memory recall | 20ms | 500 req/s |
| FTS5 search | 10ms | 800 req/s |
| Semantic search | 50ms | 200 req/s |
| Chat poll | 5ms | 2000 req/s |
Volgende stappen
- Memory-model
- Multi-tenancy
- FTS5-zoekopdracht