MCP-Server

Was er tut

MCP (Model Context Protocol) ist ein offener Standard, über den KI-Apps Tools einbinden. MindLake hat einen MCP-Server integriert: Richte einen MCP-Client darauf, und die KI des Clients kann deinen Vault durchsuchen, Notizen lesen, Aufgaben auflisten, deine Listen und Canvases lesen und Backlinks folgen.

Der Server ist die MindLake App selbst, gestartet mit --mcp-serve. Er läuft auf deinem Mac und liest die Dateien deines Vaults direkt, MindLake muss also nicht geöffnet sein. Er ist schreibgeschützt: Nichts, was so verbunden ist, kann etwas anlegen, ändern oder löschen. In MindLake gibt es dafür keine Einstellung. Du fügst ihn im Client hinzu.

Bevor du anfängst

• Eine Lizenz oder eine Testphase auf diesem Mac. Der Server startet nur dort, wo auch MindLake selbst öffnen würde: mit Lizenz oder innerhalb der Testphase (siehe Testphase und Lizenz). Er prüft die Lizenz, die MindLake zuletzt gespeichert hat, ohne online zu gehen. Andernfalls stoppt er sofort mit „MindLake is not licensed on this Mac“ (Exit-Code 3). Wenn du MindLake öffnest, ist das behoben.
• Der vollständige Pfad deines Vaults. Er muss mit /Users/ beginnen, denn ein Pfad, der mit ~ beginnt, funktioniert nicht. Um ihn zu kopieren, halte die Wahltaste gedrückt, während du im Finder mit der rechten Maustaste auf den Vault-Ordner klickst, und wähl „Als Pfadname kopieren“. Dein Vault erklärt, wo er liegt.

Einen Client verbinden

1. Kopier den vollständigen Pfad deines Vaults.
2. Füg den Server in deinem Client hinzu, mit dem Pfad deines eigenen Vaults statt dem Beispiel (unten).
3. Füg optional --index für die gewichtete Suche hinzu (siehe Gewichtete Suche einrichten).
4. Starte den Client neu oder beginne eine neue Sitzung, damit er den Server erkennt.

In Claude Code fügst du ihn im Terminal hinzu:

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"

Apps, die mit einer JSON-Datei eingerichtet werden, nehmen stattdessen einen Eintrag wie diesen:

{
  "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"
      ]
    }
  }
}

Wenn MindLake nicht in deinem Ordner „Programme“ liegt, passe den Anfang des Befehls entsprechend an.

Gewichtete Suche einrichten

Füg --index mit dem vollständigen Pfad zum Suchindex von MindLake hinzu, und der Client bekommt zusätzlich find_notes, die gewichtete Suche, die auch der Assistent von MindLake nutzt. In einer JSON-Datei fügst du beides als zwei weitere Einträge in args hinzu.

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

Der Index umfasst den in MindLake geöffneten Vault und wird aktuell gehalten, solange MindLake läuft. Übergib also den Pfad dieses Vaults. Ist Find notes by meaning an (Settings ▸ AI ▸ Advanced, unter Understanding), findet er auch nach Bedeutung. Fehlt die Datei, startet der Server ohne find_notes.

Was er bereitstellt

Sicherheitsregeln

• Schreibgeschützt. Der Server bietet keine schreibenden Tools an und lehnt jede solche Anfrage ab.
• Nur dein Vault. Pfade außerhalb des Vault-Ordners, den du angegeben hast, werden abgelehnt.
• Gesperrte Notizen bleiben gesperrt. Sie können nicht gelesen werden und werden nie durchsucht oder indiziert.
• Alles andere ist lesbar. Jede Textdatei im Vault kann gelesen werden, auch deine gesicherten Chats im Ordner Chats.
• Ergebnisse sind begrenzt. Jeder Aufruf liefert eine begrenzte Menge, wie oben aufgeführt.
• Die Regeln deines Clients gelten. Ob er vor jedem Tool-Aufruf fragt, entscheidet der Client, und was er liest, geht zu den Bedingungen des Anbieters an den KI-Anbieter dieses Clients. MindLake bekommt es nie.

Wenn sich ein Client verbindet, erklärt der Server ihm auch, wie MindLake Notizen aufgebaut sind (siehe Dateiformat), damit seine KI sie richtig liest.

Aus anderen Apps schreiben

Der in MindLake integrierte Server kann keine Notizen anlegen oder ändern. Ein separater Server, mindlake-mcp, fügt vier schreibende Tools hinzu: create_note, edit_note, append_to_note und write_canvas. Seine Änderungen durchlaufen dieselbe Prüfung auf verlorene Inhalte wie der Chat, und --read-only schaltet seine schreibenden Tools ab. Er ist nicht im MindLake Download enthalten und hat keine Einstellung in der App: Wo er installiert ist, wird er von Hand zu einem Client hinzugefügt, genauso wie oben.

Damit eine KI deine Notizen mit der App im Auslieferungszustand bearbeitet, nutz den Chat in MindLake. Er prüft jede Änderung auf verlorene Inhalte und bewahrt frühere Versionen der Notiz auf.