# Qu'est-ce que MCP ?

Le **Model Context Protocol (MCP)** est un standard ouvert d'Anthropic (2024) qui
permet aux LLM d'appeler des outils externes de manière structurée. Au lieu de coller
la documentation de l'API dans le prompt, vous enregistrez des outils auprès du
serveur MCP, et le LLM les appelle au besoin — comme du function calling, mais
standardisé et indépendant du client.

## Serveur MCP Synapse

Synapse fournit un serveur MCP officiel (`synapse-mcp-api` sur npm) qui expose
**79 outils** couvrant toutes les fonctionnalités Synapse :

| Catégorie | Outils | Nombre |
|----------|-------|-------|
| 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 |
| **Total** | | **79+** |

## Comment ça marche

```
┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐
│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │
│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │
└──────────────────┘                    └──────────────────┘            └──────────┘
```

1. Vous configurez votre client LLM (Claude Desktop, Cursor, etc.) pour utiliser le serveur MCP Synapse
2. Le client démarre le serveur MCP (via `npx -y synapse-mcp-api@latest`)
3. Le serveur MCP se connecte à l'API Synapse en utilisant votre Mind Key
4. Le LLM voit les 79 outils comme des fonctions natives qu'il peut appeler
5. Quand le LLM a besoin de se souvenir de quelque chose, il appelle `memory_store` — le serveur MCP traduit cela en `POST /memory` sur Synapse

## Transports

Le serveur MCP Synapse prend en charge trois transports :

### stdio (local, recommandé pour 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 (distant, multi-tenant)

Connectez votre client MCP à :

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

### WebSocket (mobile, haut volume)

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

## Tool Profiles (v1.4.0)

Pour réduire la surcharge de tokens pour les LLM plus petits, le serveur MCP prend en
charge trois profils d'outils :

| Profil | Outils | Tokens | Idéal pour |
|---------|-------|--------|----------|
| `minimal` | 8 (dispatch composite) | ~500 | LLM auto-hébergés avec ≤8k de contexte |
| `standard` | 25 (nommés) | ~2 500 | LLM de taille moyenne (Claude Haiku, GPT-3.5) |
| `full` | 119 (tous) | ~8 250 | Grands LLM (Claude Sonnet/Opus, GPT-4) — par défaut |

Contrôlez via :

- Variable d'env : `MCP_PROFILE=minimal|standard|full`
- En-tête : `Mcp-Tool-Profile: minimal|standard|full`

## Clients pris en charge

- [Claude Desktop](/docs/mcp/claude-desktop) — application desktop d'Anthropic
- [Claude Code](/docs/mcp/claude-code) — agent de codage terminal
- [Cursor](/docs/mcp/cursor) — IDE alimenté par IA
- [Continue.dev](/docs/mcp/continue) — assistant de codage IA open source
- [Cline](/docs/mcp/claude-code) — extension VS Code
- Tout client compatible MCP

## Pourquoi utiliser MCP plutôt que l'API directe ?

| Approche | Avantages | Inconvénients |
|----------|------|------|
| API directe | Simple, pas de couche supplémentaire | Le LLM doit connaître les URLs, en-têtes, auth |
| MCP | Le LLM voit des outils natifs, pas de mémorisation d'URL | Processus serveur MCP supplémentaire |

Pour la plupart des cas d'usage d'agents LLM, MCP est le meilleur choix — le LLM n'a
pas besoin de mémoriser les chemins d'API ou les schémas d'auth.

## Prochaines étapes

- [Configuration Claude Desktop](/docs/mcp/claude-desktop) — config en 2 minutes
- [Configuration Claude Code](/docs/mcp/claude-code) — intégration terminal
- [Client MCP personnalisé](/docs/mcp/custom-client) — construisez le vôtre