Cursor : ajouter une mémoire partagée avec un serveur MCP distant

Mis à jour le 30 octobre 2026. Étapes tirées de la documentation officielle de Cursor, consultée le 30 octobre 2026. L'interface de Cursor évolue vite : si un intitulé a changé, le fichier mcp.json, lui, garde le même format.

Pour donner une mémoire persistante à Cursor, ajoutez un serveur MCP distant dans ~/.cursor/mcp.json (tous vos projets) ou .cursor/mcp.json (un seul projet), sous la clé mcpServers, avec son url. Cursor gère la connexion OAuth au serveur, puis l'agent utilise ses outils quand ils sont pertinents. Ce guide prend l'exemple de Pryzm Memory, une mémoire partagée entre plusieurs IA via MCP (Model Context Protocol).

L'intérêt : l'agent de Cursor est excellent dans un projet, mais il repart de zéro à chaque nouveau chat. Avec une mémoire MCP, il retrouve vos décisions techniques, vos bugs résolus et vos préférences, y compris ce que vous avez dit à Claude ou à ChatGPT.

Ce qu'il vous faut

• Cursor, version récente.
• Un compte Pryzm. Gratuit jusqu'à 100 souvenirs ; sur l'offre gratuite, l'adresse e-mail doit être confirmée avant de connecter une IA. Gardez votre identifiant Pryzm sous la main : c'est lui, et non l'e-mail, que demande la page de connexion.

Les étapes

1. Ouvrez le fichier de configuration MCP. Éditez ~/.cursor/mcp.json directement, ou passez par la page Customize de Cursor, d'où l'on installe et gère les serveurs MCP.
2. Collez la configuration ci-dessous. Si le fichier contient déjà d'autres serveurs, ajoutez seulement le bloc pryzm-memory dans mcpServers. Enregistrez.
3. Connectez-vous. Dans Customize, Pryzm apparaît parmi les serveurs MCP avec une invite de connexion. Suivez-la : le navigateur s'ouvre sur la page Pryzm, saisissez votre identifiant et votre mot de passe. Cursor renouvelle ensuite le jeton tout seul.
4. Vérifiez. Les outils de Pryzm (memory_search, memory_store…) apparaissent dans la liste des outils disponibles. Un interrupteur dans Customize permet de couper le serveur sans le supprimer.
5. Ajoutez une règle. Collez les instructions « mémoire principale » dans Customize → Rules, en règle utilisateur : elle vaut pour tous vos projets et s'applique à l'agent.
6. Testez dans le chat de l'agent : « Cherche dans Pryzm ce qu'on a décidé pour l'authentification. » Par défaut, Cursor demande votre accord avant d'utiliser un outil MCP.

{
  "mcpServers": {
    "pryzm-memory": {
      "url": "https://pryzm-memory.com/mcp"
    }
  }
}

Les instructions prêtes à coller sont sur la page de connexion. Le format du fichier et les options sont décrits dans la documentation MCP de Cursor.

Pour un seul projet

Le même bloc JSON dans .cursor/mcp.json, à la racine du dépôt, ne vaut que pour ce projet. Pour une règle propre au projet, utilisez un fichier dans .cursor/rules, versionné avec le code. Chaque développeur se connecte avec son propre compte : la mémoire n'est pas partagée entre comptes.

Si quelque chose ne marche pas

• Le serveur reste en erreur : vérifiez que le JSON est valide (virgules, accolades) et que l'URL est exacte, sans espace ni barre oblique finale.
• Pas d'invite de connexion : enregistrez mcp.json, puis redémarrez Cursor.
• « Identifiants incorrects » : utilisez votre identifiant Pryzm, pas votre e-mail.
• L'agent n'appelle jamais Pryzm : vérifiez que le serveur est activé dans Customize et que la règle est ajoutée, puis nommez « Pryzm » dans votre demande.
• Copie depuis VS Code : le format n'est pas le même. Cursor attend mcpServers ; le fichier .vscode/mcp.json de VS Code utilise servers.

Ce que voit le serveur

Le serveur reçoit ce que l'agent lui envoie : une recherche, ou le texte d'un souvenir à enregistrer. Pas votre code, sauf si l'agent le met dans un souvenir. Chez Pryzm, chaque compte est chiffré avec sa propre clé (AES-256-GCM), serveurs en Allemagne ; pendant une session, le serveur déchiffre vos souvenirs en mémoire pour pouvoir y chercher, ce n'est donc pas du chiffrement de bout en bout. Les clés d'API et mots de passe sont refusés à l'enregistrement.

Quand ce n'est pas utile

Si vous ne codez qu'avec Cursor, sur un seul projet, ses règles et le contexte du dépôt suffisent probablement. Une mémoire externe sert quand vous passez d'un outil à l'autre : Cursor pour coder, Claude Code dans le terminal, Claude ou ChatGPT pour réfléchir. Pour VS Code, voir le guide VS Code et Copilot.