{"title":"FAQ MCP","slug":"mcp-faq","category":"faq","summary":"Questions courantes sur l'intégration MCP — outils, transports, dépannage.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":507,"read_minutes":3,"lang":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# FAQ MCP\n\nQuestions courantes sur le serveur MCP Synapse.\n\n## Qu'est-ce que MCP ?\n\nMCP (Model Context Protocol) est un standard ouvert d'Anthropic pour l'intégration\nLLM-outil. Au lieu de coller la documentation de l'API dans les prompts, vous\nenregistrez des outils auprès d'un serveur MCP, et le LLM les appelle comme des\nfonctions natives.\n\nVoir [Qu'est-ce que MCP ?](/docs/mcp/what-is-mcp).\n\n## Combien d'outils le MCP Synapse expose-t-il ?\n\n**79 outils** répartis en 12 catégories : memory, chat, scheduler, tasks, scripts,\ncomputers, push, user, utility, visualization, sharing, webhooks, browser.\n\nVoir [Qu'est-ce que MCP ?](/docs/mcp/what-is-mcp) pour la liste complète.\n\n## Quels clients MCP sont pris en charge ?\n\n- Claude Desktop (macOS, Windows)\n- Claude Code (terminal)\n- Cursor (IDE)\n- Continue.dev (VS Code, JetBrains)\n- Cline (VS Code)\n- Tout client compatible MCP\n\nVoir [Configuration Claude Desktop](/docs/mcp/claude-desktop) pour des exemples de\nconfiguration.\n\n## Quels transports sont pris en charge ?\n\n1. **stdio** (local, recommandé pour desktop)\n2. **HTTP/SSE** (distant, multi-tenant)\n3. **WebSocket** (mobile, haut volume)\n\n## Comment configurer Claude Desktop ?\n\nÉditez `claude_desktop_config.json` :\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_YOUR_KEY\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\nVoir [Configuration Claude Desktop](/docs/mcp/claude-desktop).\n\n## Pourquoi les outils n'apparaissent-ils pas dans Claude Desktop ?\n\n1. **Redémarrez Claude Desktop complètement** (Cmd+Q sur macOS)\n2. **Vérifiez que le fichier de config est du JSON valide**\n3. **Vérifiez Node.js 18+** installé\n4. **Consultez les logs MCP** : `~/Library/Logs/Claude/mcp.log`\n\nVoir [Dépannage MCP](/docs/mcp/troubleshooting).\n\n## Comment utiliser un mind différent ?\n\nChangez `SYNAPSE_MIND_KEY` dans votre config MCP et redémarrez le client.\n\nPour plusieurs minds, exécutez plusieurs instances du serveur MCP avec différentes\nMind Keys.\n\n## Puis-je limiter les outils exposés ?\n\nOui, utilisez les **Tool Profiles** :\n\n- `minimal` : 8 outils composites (~500 tokens)\n- `standard` : 25 outils (~2 500 tokens)\n- `full` : 119 outils (~8 250 tokens, par défaut)\n\nDéfinissez via la variable d'environnement `MCP_PROFILE` ou l'en-tête\n`Mcp-Tool-Profile`.\n\n## Comment déboguer les problèmes MCP ?\n\n1. **Exécutez le serveur MCP manuellement** : `npx -y synapse-mcp-api@latest`\n2. **Consultez les logs client** (varie selon le client)\n3. **Vérifiez que la Mind Key fonctionne** : `curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **Vérifiez la santé de Synapse** : `curl https://synapse.schaefer.zone/health`\n\nVoir [Dépannage MCP](/docs/mcp/troubleshooting).\n\n## Le serveur MCP est-il gratuit ?\n\nOui. Le paquet npm `synapse-mcp-api` est open source. Le serveur MCP hébergé sur\n`synapse-mcp.schaefer.zone` est gratuit pour un usage public.\n\n## Puis-je auto-héberger le serveur MCP ?\n\nOui :\n\n```bash\nnpm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api\n```\n\n## En quoi MCP diffère-t-il des appels API directs ?\n\n| Aspect | API directe | MCP |\n|--------|-----------|-----|\n| Le LLM doit connaître | URLs, en-têtes, auth | Juste les noms d'outils |\n| Gestion de l'auth | Manuelle | Automatique (var d'env) |\n| Découverte des outils | Lire /endpoints | Automatique via protocole MCP |\n| Gestion des erreurs | Manuelle | Standardisée |\n| Idéal pour | Intégrations personnalisées | Agents LLM |\n\n## Puis-je construire mon propre client MCP ?\n\nOui. Utilisez le SDK MCP officiel :\n\n- TypeScript : `@modelcontextprotocol/sdk`\n- Python : `mcp`\n\nVoir [Client MCP personnalisé](/docs/mcp/custom-client).\n\n## Comment signaler des bugs MCP ?\n\nOuvrez un ticket : \n\nIncluez :\n\n- Version du serveur MCP\n- Nom et version du client\n- Système d'exploitation\n- Logs pertinents\n- Étapes pour reproduire\n\n## Prochaines étapes\n\n- [Qu'est-ce que MCP ?](/docs/mcp/what-is-mcp)\n- [Configuration Claude Desktop](/docs/mcp/claude-desktop)\n- [Dépannage MCP](/docs/mcp/troubleshooting)\n","content_html":"

FAQ MCP

\n

Questions courantes sur le serveur MCP Synapse.

\n

Qu'est-ce que MCP ?

\n

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

\n

Voir Qu'est-ce que MCP ?.

\n

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

\n

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

\n

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

\n

Quels clients MCP sont pris en charge ?

\n\n

Voir Configuration Claude Desktop pour des exemples de\nconfiguration.

\n

Quels transports sont pris en charge ?

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

Comment configurer Claude Desktop ?

\n

Éditez claude_desktop_config.json :

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

Voir Configuration Claude Desktop.

\n

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

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

Voir Dépannage MCP.

\n

Comment utiliser un mind différent ?

\n

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

\n

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

\n

Puis-je limiter les outils exposés ?

\n

Oui, utilisez les Tool Profiles :

\n\n

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

\n

Comment déboguer les problèmes MCP ?

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

Voir Dépannage MCP.

\n

Le serveur MCP est-il gratuit ?

\n

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

\n

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

\n

Oui :

\n
npm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
AspectAPI directeMCP
Le LLM doit connaîtreURLs, en-têtes, authJuste les noms d'outils
Gestion de l'authManuelleAutomatique (var d'env)
Découverte des outilsLire /endpointsAutomatique via protocole MCP
Gestion des erreursManuelleStandardisée
Idéal pourIntégrations personnaliséesAgents LLM
\n

Puis-je construire mon propre client MCP ?

\n

Oui. Utilisez le SDK MCP officiel :

\n\n

Voir Client MCP personnalisé.

\n

Comment signaler des bugs MCP ?

\n

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

\n

Incluez :

\n\n

Prochaines étapes

\n\n","urls":{"html":"/docs/faq/mcp-faq","text":"/docs/faq/mcp-faq?format=text","json":"/docs/faq/mcp-faq?format=json","llm":"/docs/faq/mcp-faq?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}