# 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)

```json
{
  "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

- [Claude Desktop](/docs/mcp/claude-desktop) — desktop-app van Anthropic
- [Claude Code](/docs/mcp/claude-code) — terminal-coding-agent
- [Cursor](/docs/mcp/cursor) — AI-aangedreven IDE
- [Continue.dev](/docs/mcp/continue) — open-source AI-coding-assistant
- [Cline](/docs/mcp/claude-code) — VS Code-extensie
- Elke MCP-compatibele client

## 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

- [Claude Desktop-instellatie](/docs/mcp/claude-desktop) — configuratie in 2 minuten
- [Claude Code-instellering](/docs/mcp/claude-code) — terminal-integratie
- [Eigen MCP-client](/docs/mcp/custom-client) — bouw uw eigen client