Serveur MCP

À quoi il sert

MCP (Model Context Protocol) est un standard ouvert qui permet aux apps d’IA de brancher des outils. MindLake intègre un serveur MCP : pointez un client MCP vers lui, et l’IA du client peut rechercher dans votre coffre, lire des notes, lister des tâches, lire vos listes et vos canevas, et suivre les rétroliens.

Le serveur, c’est l’app MindLake elle-même, lancée avec --mcp-serve. Il tourne sur votre Mac et lit directement les fichiers de votre coffre : MindLake n’a pas besoin d’être ouvert. Il est en lecture seule : rien de ce qui se connecte ainsi ne peut créer, modifier ou supprimer quoi que ce soit. Il n’y a pas de réglage pour lui dans MindLake ; c’est dans le client que vous l’ajoutez.

Avant de commencer

• Une licence ou un essai sur ce Mac. Le serveur ne démarre que là où MindLake lui-même s’ouvrirait : avec une licence, ou pendant l’essai (voir Essai et licence). Il vérifie la dernière licence enregistrée par MindLake, sans se connecter à Internet. Sinon, il s’arrête aussitôt avec « MindLake is not licensed on this Mac » (code de sortie 3) ; ouvrir MindLake règle le problème.
• Le chemin complet de votre coffre. Il doit commencer par /Users/, car un chemin qui commence par ~ ne fonctionnera pas. Pour le copier, maintenez Option enfoncée en cliquant avec le bouton droit sur le dossier du coffre dans le Finder, puis choisissez Copier en tant que nom de chemin. Votre coffre explique où il se trouve.

Connecter un client

1. Copiez le chemin complet de votre coffre.
2. Ajoutez le serveur à votre client, en remplaçant le chemin d’exemple par celui de votre coffre (ci-dessous).
3. Ajoutez si vous le souhaitez --index pour la recherche classée (voir Ajouter la recherche classée).
4. Redémarrez le client, ou ouvrez une nouvelle session, pour qu’il prenne en compte le serveur.

Dans Claude Code, ajoutez-le depuis Terminal :

claude mcp add --scope user mindlake -- \
  /Applications/Mindlake.app/Contents/MacOS/Mindlake --mcp-serve \
  --vault "/Users/you/Library/Mobile Documents/com~apple~CloudDocs/Mindlake/My Vault"

Les apps configurées par un fichier JSON prennent plutôt une entrée comme celle-ci :

{
  "mcpServers": {
    "mindlake": {
      "type": "stdio",
      "command": "/Applications/Mindlake.app/Contents/MacOS/Mindlake",
      "args": [
        "--mcp-serve",
        "--vault", "/Users/you/Library/Mobile Documents/com~apple~CloudDocs/Mindlake/My Vault"
      ]
    }
  }
}

Si MindLake n’est pas dans votre dossier Applications, adaptez le début de la commande.

Ajouter la recherche classée

Ajoutez --index avec le chemin complet de l’index de recherche de MindLake, et le client obtient aussi find_notes, la recherche classée qu’utilise l’assistant de MindLake. Dans un fichier JSON, ajoutez les deux comme deux entrées de plus dans args.

--index "/Users/you/Library/Application Support/Mindlake/Search/index.sqlite"

L’index couvre le coffre ouvert dans MindLake et reste à jour tant que MindLake tourne : indiquez donc le chemin de ce coffre. Si Find notes by meaning est activé (Settings ▸ AI ▸ Advanced, sous Understanding), il cherche aussi par le sens. Si le fichier est absent, le serveur démarre sans find_notes.

Ce qu’il expose

Règles de sécurité

• Lecture seule. Le serveur ne propose aucun outil d’écriture et refuse toute demande en ce sens.
• Votre coffre uniquement. Les chemins hors du dossier de coffre que vous lui avez donné sont refusés.
• Les notes verrouillées le restent. Elles ne peuvent pas être lues, et ne sont jamais recherchées ni indexées.
• Tout le reste est lisible. N’importe quel fichier texte du coffre peut être lu, y compris vos conversations enregistrées dans le dossier Chats.
• Les résultats sont plafonnés. Chaque appel renvoie une quantité limitée, comme indiqué ci-dessus.
• Les règles de votre client s’appliquent. C’est le client qui décide s’il demande avant chaque appel d’outil, et ce qu’il lit va au fournisseur d’IA de ce client, selon les conditions de ce fournisseur. MindLake ne le reçoit jamais.

Lorsqu’un client se connecte, le serveur lui indique aussi comment les notes MindLake sont organisées (voir Format de fichier), pour que son IA les lise correctement.

Écrire depuis d’autres apps

Le serveur intégré à MindLake ne peut ni créer ni modifier de notes. Un serveur distinct, mindlake-mcp, ajoute quatre outils d’écriture : create_note, edit_note, append_to_note et write_canvas. Ses modifications passent par le même contrôle du contenu perdu que la conversation, et --read-only désactive ses outils d’écriture. Il n’est pas inclus dans le téléchargement de MindLake et n’a aucun réglage dans l’app : là où il est installé, on l’ajoute à un client à la main, de la même façon que ci-dessus.

Pour qu’une IA modifie vos notes avec l’app telle qu’elle est livrée, utilisez la conversation de MindLake, qui contrôle chaque modification pour éviter toute perte de contenu et conserve les versions antérieures de la note.