Brain add-on

De Brain MCP-server geeft Claude een geheugen dat langer meegaat dan het gesprek: een map met markdownnotities op je eigen server die Claude kan doorzoeken, lezen en schrijven. Besluiten, servergegevens, klantafspraken en handleidingen komen in de vault terecht, en het volgende gesprek begint met ze op te zoeken in plaats van het je opnieuw te vragen.

Brain is een add-on voor mcp-core, de zelf gehoste MCP-server. mcp-core draait in Docker op je eigen infrastructuur, en de vault is een gewone map die je in de container mount. De notities blijven gewone .md-bestanden. Je opent ze in elke editor, maakt er back-ups van met je gebruikelijke tools of bladert erdoor in een markdown-app naast Claude.

Wat kan Claude in een Brain-vault?

De Brain MCP-server geeft Claude tien tools voor de hele levensloop van een notitie:

• Lezen: een bestand lezen, de structuur van de vault tonen, zoeken en de wijzigingsgeschiedenis bekijken.
• Schrijven: een bestand schrijven of bijwerken, iets aan een bestand toevoegen, een bestand verplaatsen of hernoemen, de zoekindex opnieuw opbouwen en een map op het hoogste niveau een korte omschrijving geven.
• Verwijderen: een bestand weghalen dat niet meer nodig is.

Zoeken gebruikt eerst een snelle index van samenvattingen en koppen. Vindt die niets, dan valt het terug op een volledige scan van de inhoud van elk bestand. Wijzig je bestanden buiten Claude om, dan brengt de reindex-tool de index weer bij.

Waarom staat de Brain MCP-server standaard op read-write?

Omdat een kennisbank waarin Claude niet kan schrijven weinig waarde heeft. Elke andere add-on op mcp-core begint read-only; Brain is de enige uitzondering. Je kunt nog steeds een seat toevoegen met Brain op read-only, bijvoorbeeld om een collega de vault te laten raadplegen zonder bewerkrechten.

Wat read-write veilig maakt, is versiebeheer. Met VERSIONING_ENABLED=true wordt elke schrijf-, toevoeg-, verplaats- en verwijderactie gecommit in een git-repository in de vault. Een foute bewerking is nooit een onherstelbare overschrijving: Claude kan de geschiedenis van één bestand of van de hele vault tonen, en je zet elke eerdere versie terug met git.

Welke beveiligingen heeft de vault?

Paden worden binnen VAULT_PATH opgelost en alles daarbuiten wordt geweigerd. De map .git met de geschiedenis kan via de Brain-tools nooit beschreven, verplaatst of verwijderd worden. Een map logs is leesbaar voor Claude maar beschermd tegen wijzigingen. Deze regels zitten in de Brain MCP-server zelf, dus ze gelden voor elke seat.

Hoe stel je de Brain MCP-server in?

Je hebt een draaiende mcp-core nodig en een locatie voor de vault, meestal een gemount Docker-volume. Voeg daarna drie variabelen toe aan je .env:

VAULT_PATH=/vault
VERSIONING_ENABLED=true
INDEX_MAX_AGE_DAYS=7

VAULT_PATH is verplicht. VERSIONING_ENABLED is optioneel maar aanbevolen. INDEX_MAX_AGE_DAYS bepaalt hoe vaak de zoekindex opnieuw wordt opgebouwd. Draai ./mcp-update.sh om de wijziging toe te passen. De installatiehandleiding voor Brain behandelt de volume-mount en de eerste start.

Hoe structureer je een vault?

Begin met een handvol mappen op het hoogste niveau, bijvoorbeeld klanten, servers, besluiten en procedures. Vraag Claude om bij elke map een omschrijving van één regel te zetten. Als je de root van de vault opvraagt, verschijnen die omschrijvingen, en dat helpt Claude de juiste map te kiezen naarmate de vault groeit. Korte, gerichte notities met duidelijke koppen zoeken beter dan één lang document.

Welke add-ons werken goed samen met Brain?

De Brain MCP-server is het nuttigst naast een tool die informatie oplevert. Met de Missive MCP-server leest Claude een klantgesprek en legt de afspraak vast in de vault. Met de Database-add-on bewaart het de SQL achter een terugkerend rapport, zodat de volgende keer begint met een bekende query.

Een bredere uitleg van het idee lees je in Claude koppelen aan je notities.