Handleidingen · Obsidian

Obsidian als kennisbank koppelen aan Claude

Koppel je Obsidian-vault aan Claude via MCP of API. Doorzoek notities, vat samen en bespaar uren zoeken per week.

🟡 Gevorderd — beetje technisch ⏱ 120 minuten
Tools: ObsidianClaudeMCP
Obsidian als kennisbank koppelen aan Claude

Stap 1: Je Obsidian-vault structureren als AI-voedbare kennisbank

De meeste Obsidian-vaults groeien organisch en worden na verloop van tijd een ongestructureerde chaos. Voor een AI-voedbare kennisbank is structuur essentieel: Claude moet snel relevante notities kunnen vinden en begrijpen welke context bij welk onderwerp hoort.

Begin met een PARA-structuur: Projects (actieve projecten), Areas (gebieden met doorlopende verantwoordelijkheid), Resources (referentiemateriaal), Archives (afgesloten projecten). Naast PARA voeg je een 'AI-context' map toe: hier sla je documenten op die Claude als permanente context krijgt bij elke sessie.

Gebruik consistente frontmatter in elke notitie. Frontmatter is de YAML-header bovenaan een Markdown-bestand die metadata bevat. Claude leest deze metadata om relevantie te bepalen.

Maak ook een 'vault-index.md' in de root: een overzicht van wat er in de vault zit, hoe de structuur werkt, en welke tags je gebruikt. Dit wordt Claude's startpunt bij elke sessie.

Stap 2: Claude verbinden via MCP (Model Context Protocol)

MCP (Model Context Protocol) is de standaard die Anthropic heeft geintroduceerd voor het verbinden van Claude met externe databronnen. Met de Obsidian MCP-server geef je Claude directe leestoegang tot je vault - zonder dat je handmatig notities hoeft te kopieren.

Vereisten: Claude Desktop (beschikbaar via claude.ai), Node.js 18+ op je machine, en je Obsidian-vault op een locatie die je MacOS of Windows-bestandssysteem kan bereiken.

Na het opslaan en herstarten van Claude Desktop zie je in de interface een hamerpictogram (tools) met 'obsidian-vault' als beschikbare tool. Claude kan nu bestanden lezen uit je vault, mappen laten zien en zoeken naar specifieke termen.

Stap 3: Smart search instellen - Claude als zoekmotor voor je notities

Met MCP actief kun je Claude vragen om door je vault te zoeken. Maar slimme search gaat verder dan alleen trefwoorden vinden. Je wilt dat Claude verbanden legt, relevante notities combineert en je een antwoord geeft dat de kennis in je vault overstijgt.

Maak een 'system-prompt.md' in je vault die Claude bij elke sessie als instructie krijgt. Vraag Claude dit bestand altijd eerst te lezen.

Voor nog krachtigere search kun je een vector-database toevoegen via de Obsidian Smart Connections plugin. Deze plugin embedt al je notities lokaal en maakt semantische zoekresultaten beschikbaar die Claude kan gebruiken als context.

Stap 4: API-koppeling voor programmatische toegang en n8n-integratie

MCP via Claude Desktop is ideaal voor interactief gebruik. Maar wat als je de kennisbank automatisch wil updaten? Of als een n8n-workflow een notitie moet aanmaken na een klantgesprek? Dan heb je de Obsidian Local REST API-plugin nodig.

Installeer de 'Local REST API' plugin in Obsidian (Community plugins). De plugin start een lokale REST-server op poort 27123. Elk verzoek heeft een API-key nodig die je in de plugin-instellingen genereert.

In n8n maak je een HTTP Request-node die na een vergadering (getriggerd door Fireflies-webhook) automatisch een notitie aanmaakt in Obsidian met transcript, samenvatting van Claude en actiepunten. Zo groeit je kennisbank automatisch.

Stap 5: Dagelijkse workflow voor kennisbeheer

Een kennisbank is alleen waardevol als je hem actief bijhoudt. We stellen een dagelijkse routine in van 15 minuten die de vault fris en up-to-date houdt.

Ochtend (5 minuten): Open een Daily Note in Obsidian (ingebouwde feature, ctrl+shift+T) met een template die automatisch de datum invult en ruimte biedt voor 3 prioriteiten, 3 notities en 1 inzicht van gisteren. Maak dit een gewoonte door het als startpagina in Obsidian in te stellen.

Middag (5 minuten): Vraag Claude: 'Lees de notities van de afgelopen 3 dagen. Welke actiepunten staan nog open? Welke projecten hebben geen update gehad? Stel 2 follow-up acties voor.' Claude leest je recente notities via MCP en geeft je een geprioriteerde to-do.

Einde dag (5 minuten): Voeg een 'einde-dag reflectie' toe aan je Daily Note. Wat heb je geleerd? Wat moet je morgen onthouden? Claude kan suggereren welke notities bijgewerkt moeten worden op basis van wat je vandaag hebt gedaan.

Stap 6: Export naar teamformaten

Je persoonlijke Obsidian-vault is krachtig, maar soms wil je inzichten delen met je team. Hier zijn de meest gebruikte exportformaten en hoe je ze automatiseert.

Notion: Gebruik de Obsidian-to-Notion plugin om geselecteerde notities naar Notion te exporteren. Ideaal voor projectdocumentatie die het hele team moet kunnen raadplegen. De plugin behoudt koppen, lijsten en codeblokken.

Confluence: Gebruik de Obsidian Confluence Publisher-plugin voor teams die Jira en Confluence gebruiken. Pusht Markdown naar Confluence-pagina's met bewaard opmaak.

PDF: Obsidian's ingebouwde PDF-export (cmd+P) werkt goed voor rapporten. Combineer het met een Claude-prompt die first een samenvatting genereert: 'Maak een executive summary van 200 woorden van deze notitie' en plak die bovenaan voor een professioneel document.

Wekelijks teamrapport via n8n: bouw een workflow die elke vrijdag alle notities van de week leest, Claude vraagt om een teamupdate te schrijven van 300 woorden, en die via e-mail of Slack verstuurt naar het team.

Stap 7: Geavanceerde prompts voor diepere kennisextractie

Nu de techniek staat, is de volgende stap leren hoe je Claude de juiste vragen stelt om het maximale uit je kennisbank te halen. De kwaliteit van je output is direct afhankelijk van de kwaliteit van je prompt.

Prompt 1 - Syntheserend: 'Lees alle notities in de map /Areas/Klantensucces. Identificeer de 3 meest terugkerende pijnpunten die klanten noemen. Geef per pijnpunt een citaat uit de notities en een aanbeveling voor verbetering.'

Prompt 2 - Vergelijkend: 'Vergelijk de aanpak in project /Projects/Klant-A met /Projects/Klant-B. Welke aanpak heeft beter gewerkt op basis van de notities? Wat zijn de 3 lessen die we kunnen toepassen op toekomstige projecten?'

Prompt 3 - Voorspellend: 'Op basis van de vergadernotities van de afgelopen 4 weken, welke risico's voor project X zie je opkomen? Welke actiepunten zijn al twee keer besproken maar nog niet uitgevoerd?'

Prompt 4 - Kennishiaten: 'Controleer de vault op kennishiaten. Op welke onderwerpen die we regelmatig noemen ontbreken goede referentie-notities? Geef een prioriteitenlijst van de 5 notities die ik als eerste zou moeten schrijven.'

Stap 8: Onderhoud, beveiliging en back-up

Een kennisbank is zo waardevol als hij betrouwbaar is. Drie kritieke onderhoudstaken:

Back-up via iCloud of Git: Obsidian-vaults zijn gewone mappen met Markdown-bestanden. Sla de vault op in iCloud Drive voor automatische sync en back-up. Voor teams met meer controle: gebruik een privee Git-repository. De Obsidian Git-plugin committ automatisch je wijzigingen.

Beveiliging: Zet de Obsidian Local REST API alleen lokaal beschikbaar (niet via externe toegang) tenzij je een VPN gebruikt. Gebruik sterke API-keys en wissel ze maandelijks. Sla gevoelige klantdata niet in de vault op tenzij de vault volledig versleuteld is (Obsidian ondersteunt vault-encryptie niet native - gebruik VeraCrypt of Cryptomator voor extra beveiliging).

Maandelijks onderhoud: Vraag Claude eens per maand: 'Maak een audit van de vault. Welke notities zijn langer dan 3 maanden niet bijgewerkt maar staan als actief gemarkeerd? Welke tags komen slechts 1 keer voor en zijn waarschijnlijk typefouten? Geef een opschoonplan.' Dit houdt je vault schoon en relevant.

De combinatie van Obsidian en Claude is op dit moment een van de krachtigste persoonlijke productiviteitssetups beschikbaar. Je besteedt kennis niet langer aan je hoofd uit - je bouwt een extern brein dat altijd beschikbaar is, nooit iets vergeet en verbanden legt die jij niet ziet. Begin klein: richt de vault in, koppel MCP, en bouw van daaruit. Na twee weken consistent gebruik merk je het verschil.

Gerelateerd

Nieuwsbrief

Meer handleidingen en tips?

Elke week de beste agentic AI inzichten en nieuwe handleidingen in je inbox.

Gratis aanmelden →