Skip to main content

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      │
└──────────────────┘                    └──────────────────┘            └──────────┘
  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)

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

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