Skip to main content

Wat is MCP?

Model Context Protocol laat LLM's externe tools aanroepen. Synapse biedt 79 tools via de officiële MCP-server.


Wat is MCP?

Het Model Context Protocol (MCP) is een open standaard van Anthropic (2024) die LLM's op een gestructureerde manier externe tools laat aanroepen. In plaats van API-documentatie in de prompt te plakken, registreert u tools bij de MCP-server, en de LLM roept ze aan wanneer nodig — vergelijkbaar met function calling, maar gestandaardiseerd en onafhankelijk van de client.

Synapse MCP-server

Synapse wordt geleverd met een officiële MCP-server (synapse-mcp-api op npm) die 79 tools beschikbaar maakt die alle Synapse-functies dekken:

Categorie Tools Aantal
Memory recall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export 22
Chat poll, reply, status, history, unread, send, upload 7
Scheduler cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete 8
Tasks task_list, task_get, task_create, task_update 4
Scripts script_list, script_get, script_info, script_store, script_delete 5
Computers computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete 9
Push vapid_public_key, subscribe, unsubscribe, test 4
User/Mind register, login, minds_list, mind_create, mind_delete 5
Utility time, calc, random 3
Visualization graph, tags, compact 3
Sharing share, list, revoke 3
Webhooks register, list, get, update, delete 5
Browser new, navigate, click, type, screenshot, close 6
Totaal 79+

Hoe het werkt

┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐
│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │
│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │
└──────────────────┘                    └──────────────────┘            └──────────┘
  1. U configureert uw LLM-client (Claude Desktop, Cursor, enz.) om de Synapse MCP-server te gebruiken
  2. De client start de MCP-server (via npx -y synapse-mcp-api@latest)
  3. De MCP-server verbindt met de Synapse-API via uw Mind Key
  4. De LLM ziet alle 79 tools als native functies die deze kan aanroepen
  5. Wanneer de LLM iets moet onthouden, roept deze memory_store aan — de MCP-server vertaalt dit naar POST /memory op Synapse

Transports

De Synapse MCP-server ondersteunt drie transports:

stdio (lokaal, aanbevolen voor desktop)

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_...",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}

HTTP/SSE (extern, multi-tenant)

Verbind uw MCP-client met:

URL: https://synapse-mcp.schaefer.zone/sse
Headers: Authorization: Bearer YOUR_MIND_KEY

WebSocket (mobiel, hoog volume)

URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY

Toolprofielen (v1.4.0)

Om de token-overhead voor kleinere LLM's te beperken, ondersteunt de MCP-server drie toolprofielen:

Profiel Tools Tokens Geschikt voor
minimal 8 (samengestelde dispatch) ~500 Self-hosted LLM's met ≤8k context
standard 25 (benoemde) ~2,500 LLM's van gemiddelde grootte (Claude Haiku, GPT-3.5)
full 119 (alle) ~8,250 Grote LLM's (Claude Sonnet/Opus, GPT-4) — standaard

Bedienen via:

  • Omgevingsvariabele: MCP_PROFILE=minimal|standard|full
  • Header: Mcp-Tool-Profile: minimal|standard|full

Ondersteunde clients

Waarom MCP gebruiken in plaats van de directe API?

Methode Voordelen Nadelen
Directe API Eenvoudig, geen extra laag LLM moet URL's, headers en auth kennen
MCP LLM ziet native tools, geen URL-geheugen nodig Extra MCP-serverproces

Voor de meeste gebruiksscenario's met LLM-agents is MCP de betere keuze — de LLM hoeft geen API-paden of auth-patronen te onthouden.

Volgende stappen