Brain MCP instellen
Met de Brain add-on bewaart en doorzoekt Claude je eigen notities en documenten. Brain heeft geen API-sleutel en geen account elders nodig, dus er is bijna niets in te stellen.
Wat je nodig hebt
- Niets van een andere dienst.
- Ongeveer een minuut.
- Een seat op MCP Hosted, of MCP Self-hosted, met de Brain add-on.
Waar je het vindt
Een geschiedenis bijhouden
Er is niets op te zoeken. De enige keuze is of Brain een geschiedenis van elke wijziging bewaart. Met geschiedenis aan is een verkeerde bewerking door Claude één stap terug, geen verloren tekst. We raden aan het aan te zetten.
Plak het in AddoCore
- Open in Mijn account MCP Hosted en kies je seat. Bij MCP Self-hosted open je je licentie.
- Ga naar Tools en kies Instellen op de kaart Brain.
- Kies Inloggegevens opslaan en daarna Verbinding testen. Een groene uitslag betekent dat het werkt.
Brain is de enige add-on die vanaf het begin wijzigingen mag aanbrengen, want notities waar Claude niet in kan schrijven hebben weinig nut. Je kunt de seat nog steeds op alleen lezen zetten. We slaan je inloggegevens versleuteld op.
Over de Brain add-on · Claude koppelen aan Brain: zo werkt het · Alle installatiehandleidingen
Zelf draaien
Alleen voor MCP Self-hosted als je instellingen in het .env-bestand zet in plaats van in Mijn account. Met de stappen hierboven heb je dit niet nodig.
Toon de technische uitleg
Met Brain MCP instellen geef je Claude een markdown-kennisbank op je eigen server: een vaultmap die Claude kan doorzoeken, lezen, schrijven en herindelen. Je hebt de Brain-entitlement nodig en bijna geen configuratie, want de vaultmap zit al in je download. Zet versiebeheer aan, zodat geen enkele schrijfactie een onherstelbare overschrijving is.
Wat heb je nodig om Brain MCP in te stellen?
Je hebt een draaiende mcp-core-installatie nodig en de Brain-add-on op dezelfde licentie. Niets externs: geen API-key, geen account bij een derde partij. Nog niet geïnstalleerd? Volg dan eerst de installatiehandleiding van mcp-core.
- Een actieve licentie met de entitlement
tool:brain, uit de add-on Brain MCP-server. - Schijfruimte naast je
docker-compose.ymlvoor de mapvault/. - Een seat in Mijn account → MCP Self-hosted met de Brain-tool aangevinkt.
Brain toegevoegd aan een bestaande licentie? Geen nieuwe download en geen herinstallatie. De add-on wordt aan je licentie toegevoegd, en je krijgt een e-mail met de env-variabelen die nodig zijn.
Waar staat de vault van Brain MCP?
De vault is de map vault/ in de directory die je hebt uitgepakt. De docker-compose.yml mount die in de container als /vault, en VAULT_PATH wijst de tool naar dat pad in de container.
VAULT_PATH=/vaultLaat /vault staan. Het is het pad binnen de container, geen pad op je host. Wil je beginnen met bestaande notities, kopieer je .md-bestanden dan naar de map vault/ op de host; submappen zijn prima. Maak een back-up van die map zoals van elke andere datamap; alles wat Brain MCP opslaat, staat erin.
Welke env-variabelen gebruikt Brain MCP?
Brain gebruikt één verplichte variabele en een paar optionele. De .env in je download bevat VAULT_PATH= en de optionele regels als commentaar.
| Variabele | Verplicht | Standaard | Doel |
|---|---|---|---|
VAULT_PATH | Ja | /vault | Locatie van de vault binnen de container |
VERSIONING_ENABLED | Nee | false | true houdt een git-geschiedenis bij van elke wijziging |
INDEX_MAX_AGE_DAYS | Nee | 7 | Leeftijd waarna de zoekindex van een map bij de volgende toegang opnieuw wordt opgebouwd |
GIT_AUTHOR_NAME | Nee | MCP Core | Auteursnaam op versiebeheer-commits |
GIT_AUTHOR_EMAIL | Nee | mcp-core@localhost | E-mailadres van de auteur op versiebeheer-commits |
Waarom zou je versiebeheer gebruiken bij Brain MCP?
Met VERSIONING_ENABLED=true wordt elke schrijf-, toevoeg-, verplaats- en verwijderactie een git-commit in de vault. Een verkeerde bewerking door Claude is dan één stap terug in de geschiedenis, geen verloren content.
VERSIONING_ENABLED=trueVersiebeheer staat bewust standaard uit: sommige teams willen geen contentgeschiedenis op hun server. Zet je het aan, dan draait mcp-core de eerste keer zelf git init in de vault; je hoeft geen enkel git-commando te draaien. Claude leest de geschiedenis met brain_history, voor één bestand of de hele vault. Zonder versiebeheer geeft die tool een leeg resultaat.
Welke tools krijgt Claude in read-only- en read-write-modus?
Brain is de enige add-on die standaard op read-write staat, omdat een kennisbank waarin Claude niet kan schrijven weinig nut heeft. Je kunt een seat voor Brain toch op read-only zetten wanneer je die toevoegt in Mijn account → MCP Self-hosted → Seats. Hoe licentie en modus samenwerken, lees je in entitlements vs. toolmodi.
| Modus | Tools die Claude ziet |
|---|---|
| read-only | brain_read, brain_list, brain_search, brain_history |
| read-write (standaard) | Alle bovenstaande, plus brain_write, brain_append, brain_move, brain_delete, brain_reindex, brain_describe_folder |
Een paar regels gelden in elke modus. Paden buiten de vault worden geweigerd. Een map logs op het hoogste niveau kan gelezen maar niet gewijzigd worden, en de map .git is nooit bereikbaar. brain_delete draait alleen als Claude de bevestiging DELETE meegeeft. brain_search controleert eerst de index van samenvattingen en koppen en valt terug op een volledige tekstscan.
Hoe herstart en test je Brain MCP?
Draai na het wijzigen van .env het updatescript vanuit je installatiemap:
./mcp-update.shNet de add-on gekocht? Haal de nieuwe entitlement direct binnen:
docker exec mcp-core npm run refresh-licenseRoep in Claude mcp_status aan: die toont de licentiestatus, je seat en elke tool met zijn modus. Vraag Claude daarna om “de vault te tonen” en een testnotitie te schrijven. Met versiebeheer aan toont brain_history de commit voor die notitie. Welke client welk token gebruikt, lees je in MCP-seats.
Welke foutmeldingen kom je tegen bij het instellen van Brain MCP?
Deze meldingen komen van de Brain-tool zelf.
- “Path outside vault is not allowed”: Claude gaf een pad als
../mee. Vraag om een pad binnen de vault. - “The ‘logs’ directory is read-only and cannot be modified”: schrijf ergens anders.
- “The ‘.git’ directory cannot be accessed through brain tools”: verwacht gedrag; de geschiedenis is alleen bereikbaar via
brain_history. - “Deletion cancelled: confirm must be exactly “DELETE””: Claude moet een verwijdering expliciet bevestigen.
- Zoeken vindt niets wat er wel is: bestanden zijn buiten Claude om gewijzigd. Vraag Claude om
brain_reindexte draaien. - Schrijftools ontbreken: de seat is toegevoegd met Brain op read-only. Voeg een verbinding met read-write toe.
Brain MCP werkt als brain_list je mappen toont en een testnotitie verschijnt in de map vault/ op de host. Voor de andere add-ons, zie de MCP-installatiehandleidingen.
Klaar om het te proberen?