MCP dans Claude Desktop

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

Prérequis

• Application Claude Desktop (macOS ou Windows)
• Node.js 18+ installé (node --version)
• Votre Mind Key Synapse

Étape 1 : ouvrir le fichier de config

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

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

Étape 2 : ajouter le serveur MCP Synapse

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

Étape 3 : redémarrer Claude Desktop

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

Étape 4 : tester

Dans un nouveau chat, tapez :

memory_recall aufrufen

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

Outils disponibles (sélection)

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

Dépannage

Aucun outil n'apparaît dans Claude Desktop

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

Erreur « Mind Key invalid »

• Vérifiez que SYNAPSE_MIND_KEY commence par mk_
• Obtenez une nouvelle clé via POST /minds (nécessite un JWT de /login)
• Pas de guillemets autour de la clé dans le JSON

npx introuvable

• Installez Node.js 18+ : https://nodejs.org/
• Redémarrez le terminal après l'installation
• Sur macOS avec Homebrew : brew install node

Les outils apparaissent mais les appels échouent

• Vérifiez que SYNAPSE_URL est accessible : curl https://synapse.schaefer.zone/health
• Vérifiez que votre Mind Key fonctionne : curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• Voir Dépannage MCP

Tool Profiles (économiser des tokens)

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

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

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

Prochaines étapes

• Configuration Claude Code
• Configuration Cursor
• Dépannage MCP