Hvordan koble Claude Desktop til Obsidian — En reise gjennom 4 MCP-servere

Se for deg: du har 400+ notater i Obsidian, samlet opp gjennom år. Alt ligger spredt i vault-roten, konsepter blandet med tekniske notater, det finnes duplikater (ideas.md og en ideas/-mappe med 13 filer inni), ikke noe system. Du vil rydde opp — bygge en skikkelig mappearkitektur, legge til MOC-filer, organisere tagger. Å gjøre det manuelt er kjedelig og tregt. Den logiske tanken: koble Claude til Obsidian via MCP, la AI gjøre refaktoreringen. Det viser seg — det er en vei gjennom et minefelt. Her er hva jeg måtte gjennom for å nå en fungerende løsning.

Hva er MCP og hvorfor det ikke er så enkelt

MCP (Model Context Protocol) er en åpen protokoll fra Anthropic som lar Claude koble seg til eksterne verktøy og data. Prinsippet er enkelt: en lokal server kjører, eksponerer "verktøy" (tools), og Claude kaller dem under samtalen.

For Obsidian finnes det teoretisk mange MCP-servere. I praksis — hver har sine egne problemer.

Hovedproblemet med Obsidian-økosystemet: Obsidian er en lukket applikasjon uten offisiell MCP. Fellesskapet fylte gapet, men hver implementasjon går sin egen vei, og ingen har "offisiell velsignelse".

Forsøk 1: MarkusPfundstein/mcp-obsidian

Første verktøyet som dukker opp ved søk. 3 400 stjerner på GitHub, med i alle tutorials. Virker som et trygt valg.

Hvordan det fungerer: Python-server basert på Local REST API-pluginet i Obsidian. Serveren kommuniserer med pluginet via HTTPS, pluginet utfører operasjoner gjennom Obsidian API.

Hva som gikk galt

• Ikke oppdatert på 17 måneder
• 85 åpne issues
• Ingen move/rename — bare read, write, append, delete
• Local REST API har en dokumentert datatap-bug: POST-endpoint kan stille overskrive en fil ved append

Ikke egnet for refaktorering — vi trenger å flytte filer og bevare lenker. Vi går videre.

Forsøk 2: aaronsb/obsidian-mcp-plugin

Fant et alternativ som fungerer som et nativt Obsidian-plugin. Det betyr direkte tilgang til Obsidians interne API — backlinks, Dataview, lenkegraf. Move via det native API-et oppdaterer alle wiki-lenker automatisk, fordi Obsidian håndterer dette selv.

Installasjonsvanskeligheter

• Pluginet er ikke i Obsidians offisielle katalog (PR venter med valideringsfeil)
• Må installeres via BRAT (Beta Reviewers Auto-update Tool)
• Claude Desktop aksepterer ikke Bearer token direkte via UI — tvang aktivering av HTTPS i pluginet
• Self-signed sertifikat for localhost skaper tillitsproblemer

Gjennom alle disse omveiene fikk jeg det endelig koblet til. Grunntest — vault.move skriver om [[wikilinks]], fungerer som forventet.

Hva som gikk galt i produksjon

Da jeg begynte massrefaktorering (drag-and-drop av dusinvis av mapper i Obsidian + samtidige MCP-operasjoner), hang serveren i 4+ minutter. Hvorfor: pluginet kjører inne i Obsidian. Når Obsidian omindekserer tusenvis av filer etter en massiv strukturendring, blokkeres pluginet med det.

Konklusjon: avhengigheten av en åpen Obsidian-instans og dens indeks er fatal for masseoperasjoner.

Forsøk 3: @bitbonsai/mcpvault

Logisk — vi trenger en server som ikke er avhengig av Obsidian. Jobber direkte med filer på disk. @bitbonsai/mcpvault — anbefalt i mange anmeldelser. Direkte filsystemtilgang, enkel oppsett (npx @bitbonsai/mcpvault@latest /path/to/vault), 14 verktøy. Obsidian trenger ikke engang å være åpent.

Før installasjon sjekket jeg én kritisk ting — om wiki-lenker oppdateres ved move. Fant en brukeranmeldelse:

Filesystem-tilkoblingen vet ikke at den er i Obsidian — den ser en mappe med <code>.md</code>-filer og det er alt. Vet ikke at filnavn bærer semantisk vekt, at hver <code>[[wikilink]]</code> vil gå i stykker i det øyeblikket du gir nytt navn eller flytter. Auto-update links fungerer bare når navneendringen skjer innenfra appen. Jeg lærte dette etter å ha bedt Claude rydde opp i filnavn og kom tilbake til et dashboard med halvparten av lenkene ødelagt.

Bekreftet i mcpvaults egen dokumentasjon: PR #101 (wiki link resolution) er under review, ikke merget. Så å flytte via mcpvault ville ødelegge halve vaultet. Ikke egnet.

Forsøk 4: VaultForge (Final)

blacksmithers/vaultforge — spesielt bygget for AI-agenter som gjør refaktorering.

Arkitektonisk korrekt

• Direkte filsystem — ikke avhengig av Obsidian
• Egen wikilink-motor — implementerer [[wikilink]]-oppløsningslogikk som oppdaterer alle former (stem, full sti, alias, embed)
• Dry run som standard på alle destruktive operasjoner — viser først hva som endres, så bekrefter du
• 27 verktøy mot 8–14 hos konkurrenter: batch_rename, update_links, backlinks (impact analysis), prune_empty_dirs, frontmatter, smart_search (BM25), vault_themes (TF-IDF clustering)
• MIT-lisens, TypeScript, null underavhengigheter
• Installasjon på 30 sekunder via .mcpb (one-click-utvidelse for Claude Desktop)

Sikkerhetstest på isolerte filer

Opprettet 4 testfiler med krysslenker — stem-lenker, lenker med alias, lenker med full sti. Flytter én fil til en undermappe:

delta.md → subfolder/delta-renamed.md

VaultForge viste en dry run: "1 fil vil bli omdøpt, 3 lenker vil bli oppdatert". Utført på ordentlig.

Sjekket etterpå — alle tre lenketyper ble oppdatert korrekt. Dette er nøyaktig det alle tidligere verktøy manglet.

Hvordan installere VaultForge — Endelig instruksjon

Hvis du har macOS og Claude Desktop:

Steg 1

Last ned .mcpb-filen:

curl -fsSL https://github.com/blacksmithers/vaultforge/releases/latest/download/vaultforge.mcpb \
  -o /tmp/vaultforge.mcpb && open /tmp/vaultforge.mcpb

Steg 2

Claude Desktop åpner installasjonsdialogen for utvidelser. Skriv inn den absolutte stien til vaultet ditt — ingen backslashes, vanlige mellomrom:

/Users/yourname/Library/Mobile Documents/iCloud~md~obsidian/Documents/MyVault

Steg 3

Klikk Save. Claude Desktop legger til utvidelsen i konfigurasjonen automatisk. Ingen omstart nødvendig — .mcpb-utvidelser plukkes opp automatisk.

Steg 4

Verifiser: i en ny chat spør: "What is the status of my Obsidian vault?" — bør returnere noe som totalFiles: 416, totalDirs: 135, ...

Hva jeg lærte om Obsidians MCP-økosystem

For det første: "mest populær" betyr ikke "fungerer". MarkusPfundstein/mcp-obsidian har 3 400 stjerner og er standardanbefalingen, men det er utdatert og mangler viktige operasjoner.

For det andre: et nativt plugin har en skjult kostnad. Aaronsb-pluginet så ideelt ut — graph, Dataview, nativt move. Men avhengigheten av en kjørende Obsidian-instans og dens indeks gjør det uegnet for seriøse masseoperasjoner.

For det tredje: direkte filsystem uten link-engine er en felle. Mcpvault er raskt og enkelt, men "bare å flytte filer" ødelegger vault-strukturen. Lenker bærer påtvunget semantikk som filsystemet ikke vet om. Uten sin egen wikilink-logikkimplementasjon blir verktøyet en landmine.

For det fjerde: test på isolerte data. Før du betror et verktøy massrefaktorering — lag en testmappe med 4–5 filer med krysslenker og se hva som skjer. 5 minutters testing sparer timer med gjenoppretting fra backup.

For det femte: behold en git-backup av vaultet ditt. Det viktigste av alt. Et enkelt git init inne i vaultet og periodiske commits — det er forsikring mot alle feil fra en AI-agent eller et verktøy. Hvis noe går i stykker — git reset --hard bringer alt tilbake.

Konklusjon

Reisen tok flere timer og tre mislykkede forsøk. Den endelige arkitekturen ser slik ut:

• VaultForge — hovedarbeidsverktøyet. Direkte filsystem + egen wikilink-motor + 27 verktøy = stabil refaktorering i enhver skala.
• Git — vault-versjonering. Gratis rollback for enhver feil.

Nå kan jeg gjøre det alt dette ble startet for: be Claude organisere 400 notater i en ordentlig PARA-arkitektur, slå sammen duplikater, legge til frontmatter, bygge MOC-kart. Hver operasjon er trygg, lenker bevares, dry run viser hva som vil skje før noe endres.

Hvis du også ser på ditt rotete Obsidian og vil ha en AI-assistent — start rett med VaultForge. Ikke gjenta min rute gjennom døde prosjekter, beta-plugins og filsystemservere uten lenkelogikk.