FAQ MCP

Questions courantes sur le serveur MCP Synapse.

Qu'est-ce que MCP ?

MCP (Model Context Protocol) est un standard ouvert d'Anthropic pour l'intégration LLM-outil. Au lieu de coller la documentation de l'API dans les prompts, vous enregistrez des outils auprès d'un serveur MCP, et le LLM les appelle comme des fonctions natives.

Voir Qu'est-ce que MCP ?.

Combien d'outils le MCP Synapse expose-t-il ?

79 outils répartis en 12 catégories : memory, chat, scheduler, tasks, scripts, computers, push, user, utility, visualization, sharing, webhooks, browser.

Voir Qu'est-ce que MCP ? pour la liste complète.

Quels clients MCP sont pris en charge ?

• Claude Desktop (macOS, Windows)
• Claude Code (terminal)
• Cursor (IDE)
• Continue.dev (VS Code, JetBrains)
• Cline (VS Code)
• Tout client compatible MCP

Voir Configuration Claude Desktop pour des exemples de configuration.

Quels transports sont pris en charge ?

1. stdio (local, recommandé pour desktop)
2. HTTP/SSE (distant, multi-tenant)
3. WebSocket (mobile, haut volume)

Comment configurer Claude Desktop ?

Éditez claude_desktop_config.json :

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

Voir Configuration Claude Desktop.

Pourquoi les outils n'apparaissent-ils pas dans Claude Desktop ?

1. Redémarrez Claude Desktop complètement (Cmd+Q sur macOS)
2. Vérifiez que le fichier de config est du JSON valide
3. Vérifiez Node.js 18+ installé
4. Consultez les logs MCP : ~/Library/Logs/Claude/mcp.log

Voir Dépannage MCP.

Comment utiliser un mind différent ?

Changez SYNAPSE_MIND_KEY dans votre config MCP et redémarrez le client.

Pour plusieurs minds, exécutez plusieurs instances du serveur MCP avec différentes Mind Keys.

Puis-je limiter les outils exposés ?

Oui, utilisez les Tool Profiles :

• minimal : 8 outils composites (~500 tokens)
• standard : 25 outils (~2 500 tokens)
• full : 119 outils (~8 250 tokens, par défaut)

Définissez via la variable d'environnement MCP_PROFILE ou l'en-tête Mcp-Tool-Profile.

Comment déboguer les problèmes MCP ?

1. Exécutez le serveur MCP manuellement : npx -y synapse-mcp-api@latest
2. Consultez les logs client (varie selon le client)
3. Vérifiez que la Mind Key fonctionne : curl -H "Authorization: Bearer mk_..." .../memory/recall
4. Vérifiez la santé de Synapse : curl https://synapse.schaefer.zone/health

Voir Dépannage MCP.

Le serveur MCP est-il gratuit ?

Oui. Le paquet npm synapse-mcp-api est open source. Le serveur MCP hébergé sur synapse-mcp.schaefer.zone est gratuit pour un usage public.

Puis-je auto-héberger le serveur MCP ?

Oui :

npm install -g synapse-mcp-api
SYNAPSE_URL=https://your-synapse-instance.com \
SYNAPSE_MIND_KEY=mk_... \
synapse-mcp-api

En quoi MCP diffère-t-il des appels API directs ?

Aspect	API directe	MCP
Le LLM doit connaître	URLs, en-têtes, auth	Juste les noms d'outils
Gestion de l'auth	Manuelle	Automatique (var d'env)
Découverte des outils	Lire /endpoints	Automatique via protocole MCP
Gestion des erreurs	Manuelle	Standardisée
Idéal pour	Intégrations personnalisées	Agents LLM

Puis-je construire mon propre client MCP ?

Oui. Utilisez le SDK MCP officiel :

• TypeScript : @modelcontextprotocol/sdk
• Python : mcp

Voir Client MCP personnalisé.

Comment signaler des bugs MCP ?

Ouvrez un ticket : https://gitlab.com/schaefer-services/synapse-mcp/-/issues

Incluez :

• Version du serveur MCP
• Nom et version du client
• Système d'exploitation
• Logs pertinents
• Étapes pour reproduire

Prochaines étapes

• Qu'est-ce que MCP ?
• Configuration Claude Desktop
• Dépannage MCP