Een second brain bouwen die Claude echt kan doorzoeken
De meeste pogingen tot een second brain lopen op hetzelfde punt vast: de notities bestaan wel, maar de juiste terugvinden kost zes maanden later meer tijd dan het antwoord opnieuw uitzoeken. De Brain-add-on voor MCP Self-hosted pakt het anders aan. Je notities staan in een markdown-vault op je eigen server, en Claude doorzoekt, leest en schrijft ze voor je.
Dit artikel legt uit hoe de vault werkt, hoe zoeken dingen vindt, waarom Brain standaard lezen én schrijven mag, en hoe versiebeheer dat veilig houdt.
Wat is een second brain in MCP Self-hosted?
Het is een map met markdown-bestanden, de vault, plus tien tools waarmee Claude ermee werkt: lezen, schrijven, toevoegen, tonen, zoeken, verplaatsen, verwijderen, een map beschrijven, opnieuw indexeren en geschiedenis tonen. De bestanden zijn gewone markdown op schijf, dus je opent, bewerkt en back-upt ze met elke tool die je wilt. Niets zit opgesloten in een database.
Claude gebruikt de vault zoals je een collega met een goed archief iets zou vragen: “Sla het besluit uit het gesprek van vandaag op onder projects/pricing” of “Wat hebben we met de leverancier afgesproken over levertijden?”
Waarom mag Brain standaard lezen en schrijven?
Elke andere mcp-core-tool start read-only, omdat iets opzoeken minder risico heeft dan iets wijzigen. Brain is de uitzondering. Een second brain die Claude alleen kan lezen, is een tragere versie van de notitie-app die je al hebt. Het wordt pas nuttig als Claude dingen kan opslaan terwijl je werkt.
De standaard is geen verplichting. De modus stel je per seat in op het tabblad Seats van je licentie. Een read-only seat krijgt alleen de leestools: lezen, tonen, zoeken en geschiedenis. Dat past bij een collega die dingen moet kunnen opzoeken, maar niet wijzigen.
Hoe zet je de vault op?
De downloadbundel doet het meeste werk al. Hij bevat een lege map vault/ die in de container op /vault wordt gemount, en VAULT_PATH wijst daarheen. Omdat de map op de host staat, overleeft de vault herstarts van de container en elke run van ./mcp-update.sh.
Twee optionele instellingen bepalen het gedrag:
VERSIONING_ENABLED=true
# INDEX_MAX_AGE_DAYS=7Zet ze in .env of op het tabblad Tools van je licentie en ververs daarna de licentie. De handleiding Brain MCP instellen heeft alle stappen.
Hoe doorzoekt Claude je second brain?
Zoeken gaat in twee stappen. Eerst controleert het een index met per bestand de titel, een korte samenvatting uit de eerste alinea, de koppen en de hoofdtekst. Vindt dat niets, dan doorzoekt het de volledige inhoud van elk markdown-bestand. Er komen maximaal 20 resultaten per zoekopdracht terug.
Het zoeken matcht woorden, geen betekenis. Claude vangt dat op door meer dan één term te proberen: vindt “pricing change” niets, dan probeert het “price increase” of de naam van de klant. Jij helpt door notities te schrijven met een duidelijke titel en een eerste alinea die zegt waar de notitie over gaat. Die samenvatting ziet Claude als eerste in de zoekresultaten.
INDEX_MAX_AGE_DAYS, standaard 7, bepaalt hoe oud de index van een map mag worden voordat hij bij het volgende gebruik opnieuw wordt opgebouwd. Schrijfacties via Claude werken de index direct bij. Bewerk of voeg je bestanden buiten Claude om toe, vraag het dan om opnieuw te indexeren zodat zoeken ze ziet.
Wat beschermt een second brain waar Claude in kan schrijven?
Versiebeheer. Met VERSIONING_ENABLED=true wordt elke schrijf-, toevoeg-, verplaats- en verwijderactie een git-commit in de vault. Een schrijfactie is dan nooit een onherstelbare overschrijving, en Claude kan de recente geschiedenis van één bestand of de hele vault tonen.
Nog twee waarborgen beschermen je second brain. Een bestand verwijderen vraagt een expliciete bevestiging in de aanroep. De map .git is via de tools helemaal niet bereikbaar, dus de geschiedenis zelf is veilig voor de tools.
Hoe ziet een week met een second brain eruit?
Op maandag vraag je Claude om de uitkomst van een vergadering als notitie op te slaan. Op woensdag vraag je om een vervolgactie aan dezelfde notitie toe te voegen. De week erna vraag je “wat hebben we besloten over de prijswijziging?” Claude zoekt, vindt de notitie via titel en samenvatting, leest hem en antwoordt, met het bestandspad zodat je hem zelf kunt openen.
Voor vergadernotities zet de gratis meeting notes structurer skill een geplakt transcript of een lijst met bullets om in een gestructureerde notitie in je vault, met besluiten, actiepunten, open vragen en links naar gerelateerde notities.
Veelvoorkomende misverstanden
“Het zijn gewoon markdown-bestanden in een map.” De bestanden zijn markdown, ja. De zoekindex erbovenop zorgt ervoor dat Claude een notitie vindt zonder dat jij de bestandsnaam noemt.
“Standaard lezen en schrijven is onveilig.” Het is een ander risicoprofiel, en versiebeheer dekt het af. Zet VERSIONING_ENABLED aan en elke wijziging is te traceren en terug te draaien.
“Mijn notities moeten een vast formaat hebben.” Er is geen sjabloon nodig. Een duidelijke titel en een nuttige eerste alinea laten zoeken beter werken, meer niet.
Veelgestelde vragen
Kan ik de bestanden zonder Claude lezen?
Ja. Het zijn markdown-bestanden in de map vault/ van je installatie.
Synchroniseert de vault tussen installaties?
Nee. Hij hoort bij één installatie. Kopieer of back-up de map zoals alle andere data.
Kunnen meerdere mensen één second brain delen?
Ja. Elke verbinding met de Brain-tool op dezelfde licentie gebruikt dezelfde vault. Geef iedereen de modus die hij nodig heeft.
Tot slot
Een second brain loont alleen als een notitie vinden sneller gaat dan hem onthouden. Houd de vault op je eigen server, zet versiebeheer aan, schrijf notities met een duidelijke titel en laat Claude het archiveren doen. Bekijk wat de add-on Brain MCP-server bevat, of lees hoe je Claude koppelt aan je notities.