{"title":"MCP dans Claude Desktop","slug":"claude-desktop","category":"mcp","summary":"Connectez Synapse à Claude Desktop en 2 minutes. Claude obtient 79 outils Synapse nativement.","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":448,"read_minutes":2,"llm_context":"Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)\n %APPDATA%\\Claude\\claude_desktop_config.json (Windows)\nMCP server command: npx -y synapse-mcp-api@latest\nEnv vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)\nAfter config: restart Claude Desktop, check for 🔌 icon with \"79 tools\"\nTest: type \"memory_recall aufrufen\" in a new chat\nTroubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting\n","lang":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# MCP dans Claude Desktop\n\nClaude Desktop est l'application desktop d'Anthropic pour macOS et Windows. Avec le\nserveur MCP Synapse configuré, Claude obtient un accès natif aux 79 outils Synapse —\nil peut stocker des mémoires, les rappeler, gérer des tâches, chatter avec vous, et\nplus encore.\n\n## Prérequis\n\n- Application Claude Desktop (macOS ou Windows)\n- Node.js 18+ installé (`node --version`)\n- Votre Mind Key Synapse\n\n## Étape 1 : ouvrir le fichier de config\n\n- **macOS :** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows :** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nSi le fichier n'existe pas, créez-le.\n\n## Étape 2 : ajouter le serveur MCP Synapse\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_MIND_KEY_HERE\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n> [!TIP]\n> Si vous avez déjà d'autres serveurs MCP configurés, ajoutez simplement le bloc\n> `\"synapse\"` à l'intérieur de l'objet `\"mcpServers\"` existant.\n\n## Étape 3 : redémarrer Claude Desktop\n\n1. Quittez complètement Claude Desktop (Cmd+Q sur macOS, pas juste fermer la fenêtre)\n2. Rouvrez Claude Desktop\n3. Démarrez un nouveau chat\n4. Cherchez l'icône de plug 🔌 en bas à gauche — elle devrait dire « 79 tools »\n\n## Étape 4 : tester\n\nDans un nouveau chat, tapez :\n\n```\nmemory_recall aufrufen\n```\n\nClaude devrait appeler l'outil `memory_recall` et répondre avec un résumé de vos\nmémoires stockées (ou « No memories yet » si votre mind est vide).\n\n## Outils disponibles (sélection)\n\n| Outil | Description |\n|------|-------------|\n| `memory_recall` | Rappeler toutes les mémoires |\n| `memory_store` | Stocker une nouvelle mémoire |\n| `memory_search` | Rechercher des mémoires |\n| `task_list` | Lister les tâches |\n| `task_create` | Créer une tâche |\n| `chat_poll` | Vérifier les nouveaux messages |\n| `chat_reply` | Répondre à un message |\n| `browser_new` | Ouvrir un onglet de navigateur |\n| `computer_list` | Lister les ordinateurs enregistrés |\n\nListe complète : [Qu'est-ce que MCP ?](/docs/mcp/what-is-mcp)\n\n## Dépannage\n\n### Aucun outil n'apparaît dans Claude Desktop\n\n1. Vérifiez la version de Node.js : `node --version` (doit être ≥ 18)\n2. Vérifiez que le fichier de config est du JSON valide (pas de virgules finales)\n3. Redémarrez Claude Desktop complètement (Cmd+Q, pas juste fermer)\n4. Vérifiez les logs Claude Desktop : `~/Library/Logs/Claude/mcp.log` (macOS)\n\n### Erreur « Mind Key invalid »\n\n- Vérifiez que `SYNAPSE_MIND_KEY` commence par `mk_`\n- Obtenez une nouvelle clé via `POST /minds` (nécessite un JWT de `/login`)\n- Pas de guillemets autour de la clé dans le JSON\n\n### npx introuvable\n\n- Installez Node.js 18+ : \n- Redémarrez le terminal après l'installation\n- Sur macOS avec Homebrew : `brew install node`\n\n### Les outils apparaissent mais les appels échouent\n\n- Vérifiez que `SYNAPSE_URL` est accessible : `curl https://synapse.schaefer.zone/health`\n- Vérifiez que votre Mind Key fonctionne : `curl -H \"Authorization: Bearer mk_...\" https://synapse.schaefer.zone/memory/recall`\n- Voir [Dépannage MCP](/docs/mcp/troubleshooting)\n\n## Tool Profiles (économiser des tokens)\n\nSi vous utilisez un LLM plus petit ou voulez économiser des tokens de contexte,\ndéfinissez un profil d'outils :\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_...\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\",\n \"MCP_PROFILE\": \"standard\"\n }\n }\n }\n}\n```\n\nProfils : `minimal` (8 outils), `standard` (25), `full` (119, par défaut).\n\n## Prochaines étapes\n\n- [Configuration Claude Code](/docs/mcp/claude-code)\n- [Configuration Cursor](/docs/mcp/cursor)\n- [Dépannage MCP](/docs/mcp/troubleshooting)\n","content_html":"

MCP dans Claude Desktop

\n

Claude Desktop est l'application desktop d'Anthropic pour macOS et Windows. Avec le\nserveur MCP Synapse configuré, Claude obtient un accès natif aux 79 outils Synapse —\nil peut stocker des mémoires, les rappeler, gérer des tâches, chatter avec vous, et\nplus encore.

\n

Prérequis

\n\n

Étape 1 : ouvrir le fichier de config

\n\n

Si le fichier n'existe pas, créez-le.

\n

Étape 2 : ajouter le serveur MCP Synapse

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}
Si vous avez déjà d'autres serveurs MCP configurés, ajoutez simplement le bloc\n`\"synapse\"` à l'intérieur de l'objet `\"mcpServers\"` existant.

Étape 3 : redémarrer Claude Desktop

\n
    \n
  1. Quittez complètement Claude Desktop (Cmd+Q sur macOS, pas juste fermer la fenêtre)
    2. \n
  2. Rouvrez Claude Desktop
    3. \n
  3. DĂ©marrez un nouveau chat
    4. \n
  4. Cherchez l'icône de plug 🔌 en bas à gauche — elle devrait dire « 79 tools »
    5. \n
\n

Étape 4 : tester

\n

Dans un nouveau chat, tapez :

\n
memory_recall aufrufen

Claude devrait appeler l'outil memory_recall et répondre avec un résumé de vos\nmémoires stockées (ou « No memories yet » si votre mind est vide).

\n

Outils disponibles (sélection)

\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\n\n\n\n\n\n\n\n\n\n
OutilDescription
memory_recallRappeler toutes les mémoires
memory_storeStocker une nouvelle mémoire
memory_searchRechercher des mémoires
task_listLister les tâches
task_createCréer une tâche
chat_pollVĂ©rifier les nouveaux messages
chat_replyRĂ©pondre Ă  un message
browser_newOuvrir un onglet de navigateur
computer_listLister les ordinateurs enregistrés
\n

Liste complète : Qu'est-ce que MCP ?

\n

DĂ©pannage

\n

Aucun outil n'apparaît dans Claude Desktop

\n
    \n
  1. Vérifiez la version de Node.js : node --version (doit être ≥ 18)
    2. \n
  2. VĂ©rifiez que le fichier de config est du JSON valide (pas de virgules finales)
    3. \n
  3. Redémarrez Claude Desktop complètement (Cmd+Q, pas juste fermer)
    4. \n
  4. VĂ©rifiez les logs Claude Desktop : ~/Library/Logs/Claude/mcp.log (macOS)
    5. \n
\n

Erreur « Mind Key invalid »

\n\n

npx introuvable

\n\n

Les outils apparaissent mais les appels Ă©chouent

\n\n

Tool Profiles (Ă©conomiser des tokens)

\n

Si vous utilisez un LLM plus petit ou voulez économiser des tokens de contexte,\ndéfinissez un profil d'outils :

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

Profils : minimal (8 outils), standard (25), full (119, par défaut).

\n

Prochaines Ă©tapes

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