# 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

```json
{
  "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"
      }
    }
  }
}
```

> [!TIP]
> Si vous avez déjà d'autres serveurs MCP configurés, ajoutez simplement le bloc
> `"synapse"` à l'intérieur de l'objet `"mcpServers"` existant.

## É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)

| Outil | Description |
|------|-------------|
| `memory_recall` | Rappeler toutes les mémoires |
| `memory_store` | Stocker une nouvelle mémoire |
| `memory_search` | Rechercher des mémoires |
| `task_list` | Lister les tâches |
| `task_create` | Créer une tâche |
| `chat_poll` | Vérifier les nouveaux messages |
| `chat_reply` | Répondre à un message |
| `browser_new` | Ouvrir un onglet de navigateur |
| `computer_list` | Lister les ordinateurs enregistrés |

Liste complète : [Qu'est-ce que MCP ?](/docs/mcp/what-is-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](/docs/mcp/troubleshooting)

## 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 :

```json
{
  "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](/docs/mcp/claude-code)
- [Configuration Cursor](/docs/mcp/cursor)
- [Dépannage MCP](/docs/mcp/troubleshooting)