Qu'est-ce que MCP ?
Le Model Context Protocol permet aux LLM d'appeler des outils externes. Synapse expose 79 outils via le serveur MCP officiel.
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 │
└──────────────────┘ └──────────────────┘ └──────────┘- Vous configurez votre client LLM (Claude Desktop, Cursor, etc.) pour utiliser le serveur MCP Synapse
- Le client démarre le serveur MCP (via
npx -y synapse-mcp-api@latest) - Le serveur MCP se connecte à l'API Synapse en utilisant votre Mind Key
- Le LLM voit les 79 outils comme des fonctions natives qu'il peut appeler
- Quand le LLM a besoin de se souvenir de quelque chose, il appelle
memory_store— le serveur MCP traduit cela enPOST /memorysur Synapse
Transports
Le serveur MCP Synapse prend en charge trois transports :
stdio (local, recommandé pour desktop)
{
"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_KEYWebSocket (mobile, haut volume)
URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEYTool 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 — application desktop d'Anthropic
- Claude Code — agent de codage terminal
- Cursor — IDE alimenté par IA
- Continue.dev — assistant de codage IA open source
- Cline — 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 — config en 2 minutes
- Configuration Claude Code — intégration terminal
- Client MCP personnalisé — construisez le vôtre