Connecter vos notes OneMira à Cursor avec MCP

Connectez OneMira à Cursor en lançant le serveur MCP local de OneMira via stdio, en enregistrant cette commande exacte dans Cursor, en examinant les outils exposés et en testant une requête en lecture seule sur une note locale connue. Ne collez pas de jeton distant dans la configuration d’un serveur local, sauf si l’outil documenté l’exige réellement.

Que connectez-vous ?

MCP sépare l’application hôte IA d’un serveur qui expose des outils ou des ressources. Cursor joue le rôle d’hôte/client. Le serveur OneMira est un processus local qui lit un espace de notes OneMira délimité et renvoie des résultats structurés. Le modèle ne reçoit pas automatiquement tout le dossier : il reçoit le résultat d’un appel d’outil approuvé et envoyé par l’hôte.

L’architecture officielle MCP prend en charge les serveurs locaux via stdio. Les recommandations de sécurité préconisent stdio pour les serveurs locaux lorsque c’est possible, car cela limite l’accès au client qui les lance. Elles rappellent toutefois qu’un serveur local s’exécute avec les privilèges système du client.

Que vérifier avant d’ajouter Cursor ?

1. Installez l’application OneMira compatible et terminez la synchronisation C1 documentée.
2. Ouvrez le dossier local des notes et choisissez une note de test non sensible.
3. Exécutez la commande de diagnostic OneMira ou de liste MCP indiquée par la version installée.
4. Vérifiez le chemin de l’exécutable avec command -v ou un chemin absolu.
5. Examinez la commande : elle doit lancer le serveur local connu de OneMira, et non un paquet npx non vérifié ou une chaîne de commandes shell.

La documentation actuelle de OneMira fait autorité pour les noms de commandes : consultez la configuration MCP et la référence CLI. Un article de blog ne doit pas figer un chemin d’installation qui varie selon les versions macOS et Windows.

Comment ajouter le serveur local dans Cursor ?

Cursor prend en charge les serveurs MCP et sa CLI propose des commandes pour les lister et examiner leurs outils. Dans les réglages MCP de Cursor, ajoutez un serveur local stdio , puis saisissez l’exécutable OneMira et les arguments exacts indiqués par la documentation de la version installée. Voici la structure d’une configuration à titre d’exemple :

{
  "mcpServers": {
    "onemira": {
      "command": "/absolute/path/to/onemira",
      "args": ["mcp", "serve"],
      "env": {
        "ONEMIRA_NOTES_ROOT": "/absolute/path/to/OneMira"
      }
    }
  }
}

Il s’agit d’une structure, pas de la garantie que chaque version emploie ces arguments précis. Copiez la commande depuis la documentation installée ou l’application, puis limitez autant que possible le dossier racine des notes. Ne choisissez pas ~ ni le disque entier.

Comment vérifier concrètement la connexion ?

La référence CLI officielle de Cursor répertorie cursor-agent mcp list et cursor-agent mcp list-tools <identifier>. Utilisez ces commandes si elles sont disponibles dans votre version installée :

cursor-agent mcp list
cursor-agent mcp list-tools onemira

Effectuez ensuite un test en quatre parties :

1. Détection : Cursor affiche le serveur OneMira comme connecté.
2. Vérification des outils : les noms et paramètres correspondent à la documentation OneMira ; aucun outil inattendu donnant accès au shell, au réseau ou à tout le système de fichiers n’apparaît.
3. Lecture avec résultat connu : recherchez une expression unique de la note de test et vérifiez l’extrait retourné ainsi que son chemin source.
4. Test hors périmètre : demandez un fichier situé en dehors du dossier racine configuré et vérifiez que le serveur refuse ou ne peut pas y accéder.

Notez les versions du serveur et de Cursor, le chemin de configuration, la liste des outils et le résultat du test. Un voyant vert « connecté » ne prouve à lui seul ni l’accès aux bonnes données ni le respect du périmètre.

Quelles données peuvent franchir cette limite ?

Il y a deux étapes. L’outil MCP local lit une note et renvoie du texte à Cursor. Cursor peut ensuite envoyer ce texte au modèle sélectionné, selon ses conditions et celles du fournisseur du modèle. Un serveur MCP local encadre la récupération du contexte ; il ne garantit pas que le contexte récupéré reste sur l’ordinateur.

Procédez par accès progressif :

• recherchez d’abord les métadonnées et de courts extraits ;
• récupérez une note complète uniquement si elle est pertinente ;
• excluez les dossiers sensibles par défaut ;
• privilégiez les outils en lecture seule, sauf si une écriture est explicitement nécessaire ;
• examinez toute modification de fichier produite par un agent sous forme de diff.

Comment diagnostiquer les problèmes ?

Comment supprimer proprement l’accès ?

Désactivez ou supprimez l’entrée du serveur OneMira dans Cursor, redémarrez l’hôte et vérifiez qu’elle n’apparaît plus dans la liste MCP. Supprimez les identifiants d’environnement ajoutés spécifiquement pour ce serveur. Les notes restent des fichiers locaux ordinaires : retirer l’accès MCP ne les supprime pas.

Pour comprendre l’architecture globale du contexte, lisez De la conversation au contexte. Pour les limites de sécurité de MCP, consultez les sources officielles ci-dessous.

Sources et lectures complémentaires

• Cursor : Model Context Protocol — présentation officielle de la connexion de Cursor à des outils et sources de données externes.
• Référence CLI de Cursor — commandes officielles MCP list, list-tools et login.
• Vue d’ensemble de l’architecture MCP — modèle officiel des hôtes, clients, serveurs, primitives et transports.
• Bonnes pratiques de sécurité MCP — recommandations officielles sur les serveurs locaux, le périmètre, la vérification des commandes et le consentement.
• Documentation MCP de OneMira — configuration et fonctionnement des outils actuellement pris en charge par OneMira.