MCP dans Cursor

Cursor est un IDE alimenté par IA basé sur VS Code. Avec MCP Synapse, Cursor gagne une mémoire persistante entre les sessions — il se souvient de vos décisions de projet, des schémas de codebase et des sessions de débogage passées.

Prérequis

• IDE Cursor installé (https://cursor.com)
• Node.js 18+
• Votre Mind Key Synapse

Configuration

Étape 1 : ouvrir les paramètres Cursor

Dans Cursor :

1. Ouvrez les Paramètres (Cmd+, sur macOS, Ctrl+, sur Windows/Linux)
2. Recherchez « MCP » ou naviguez vers Cursor Settings → MCP Servers

Étape 2 : ajouter le serveur MCP Synapse

Cliquez sur « Add MCP Server » et configurez :

Champ	Valeur
Nom	synapse
Type	stdio
Commande	npx -y synapse-mcp-api@latest
Env	SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone

Étape 3 : éditer config.json directement (alternative)

Cursor stocke la config MCP dans ~/.cursor/config.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"
      }
    }
  }
}

Étape 4 : redémarrer Cursor

Redémarrez complètement Cursor (Cmd+Q et rouvrez sur macOS).

Vérifier que ça fonctionne

Dans le panneau de chat de Cursor (Cmd+L) :

recall all my memories

Cursor devrait appeler memory_recall et répondre avec vos mémoires stockées.

Schémas courants

Onboarding de projet

À l'ouverture d'un nouveau projet :

recalling project context — what do I know about this codebase?

Cursor appelle memory_recall et continue le travail là où vous l'aviez laissé.

Décisions d'architecture

store this decision: "Using Fastify instead of Express for this project
because of schema validation. Date: 2026-06-27."

Cursor le stocke en tant que mémoire project avec priorité high.

Historique de débogage

what bugs have I hit in this codebase?

Cursor recherche les mémoires mistake et vous rappelle les corrections passées.

Schémas de code inter-sessions

search memories: "authentication pattern"

Cursor trouve les mémoires sur les implémentations d'authentification que vous avez déjà faites.

Dépannage

Le serveur MCP ne se connecte pas

1. Vérifiez Node.js : node --version (≥ 18)
2. Testez le serveur MCP : npx -y synapse-mcp-api@latest (devrait démarrer sans erreurs)
3. Consultez les logs MCP de Cursor (View → Output → MCP)
4. Redémarrez Cursor complètement

Les outils n'apparaissent pas

• Vérifiez que ~/.cursor/config.json est du JSON valide
• Vérifiez que la variable d'env SYNAPSE_MIND_KEY est définie
• Vérifiez que la version de Cursor prend en charge MCP (≥ 0.42)

Mind Key invalide

# Testez votre Mind Key directement
curl -H "Authorization: Bearer mk_YOUR_KEY" \
     https://synapse.schaefer.zone/memory/recall

Prochaines étapes

• Configuration Claude Desktop
• Configuration Continue.dev
• Guide agent LLM persistant