Sådan forbinder du Claude Desktop med Obsidian — En rejse gennem 4 MCP-servere

Forestil dig: du har 400+ noter i Obsidian, samlet gennem år. Alt ligger spredt i vault-roden, koncepter blandet med tekniske noter, der er duplikater (ideas.md og en ideas/-mappe med 13 filer indeni), intet system. Du vil skabe orden — bygge en ordentlig mappearkitektur, tilføje MOC-filer, organisere tags. At gøre det manuelt er kedeligt og langsomt. Den logiske tanke: tilslut Claude til Obsidian via MCP, lad AI klare refaktoreringen. Det viser sig — det er en vej gennem et minefelt. Her er hvad jeg måtte igennem for at nå en fungerende løsning.

Hvad er MCP og hvorfor det ikke er så simpelt

MCP (Model Context Protocol) er en åben protokol fra Anthropic, der lader Claude forbinde til eksterne værktøjer og data. Princippet er simpelt: en lokal server kører, eksponerer "værktøjer" (tools), og Claude kalder dem under samtalen.

For Obsidian findes der teoretisk masser af MCP-servere. I praksis — hver har sine egne problemer.

Hovedproblemet med Obsidian-økosystemet: Obsidian er en lukket applikation uden officiel MCP. Fællesskabet fyldte hullet, men hver implementering går sin egen vej, og ingen har "officiel velsignelse".

Forsøg 1: MarkusPfundstein/mcp-obsidian

Det første værktøj, der dukker op ved søgning. 3.400 stjerner på GitHub, med i alle tutorials. Virker som et sikkert valg.

Hvordan det virker: Python-server baseret på Local REST API-pluginet i Obsidian. Serveren kommunikerer med pluginet via HTTPS, pluginet udfører operationer gennem Obsidian API.

Hvad der gik galt

• Ikke opdateret i 17 måneder
• 85 åbne issues
• Intet move/rename — kun read, write, append, delete
• Local REST API har en dokumenteret datatabs-bug: POST-endpoint kan lydløst overskrive en fil ved append

Ikke egnet til refaktorering — vi skal flytte filer og bevare links. Vi går videre.

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

Fandt en mulighed, der fungerer som et nativt Obsidian-plugin. Det betyder direkte adgang til Obsidians interne API — backlinks, Dataview, linkgraf. Move via det native API opdaterer alle wiki-links automatisk, fordi Obsidian håndterer dette selv.

Installationsvanskeligheder

• Pluginet er ikke i Obsidians officielle katalog (PR afventer med valideringsfejl)
• Skal installeres via BRAT (Beta Reviewers Auto-update Tool)
• Claude Desktop accepterer ikke Bearer token direkte via UI — tvang aktivering af HTTPS i pluginet
• Self-signed certifikat for localhost skaber tillidsproblemer

Gennem alle disse workarounds fik jeg det endelig forbundet. Grundtest — vault.move omskriver [[wikilinks]], virker som forventet.

Hvad der gik galt i produktion

Da jeg startede masserefaktorering (drag-and-drop af dusinvis af mapper i Obsidian + samtidige MCP-operationer), hang serveren i 4+ minutter. Hvorfor: pluginet kører inde i Obsidian. Når Obsidian genindekserer tusindvis af filer efter en massiv strukturændring, blokeres pluginet med det.

Konklusion: afhængigheden af en åben Obsidian-instans og dens indeks er fatal for masseoperationer.

Forsøg 3: @bitbonsai/mcpvault

Logisk — vi har brug for en server, der ikke afhænger af Obsidian. Arbejder direkte med filer på disk. @bitbonsai/mcpvault — anbefalet i mange anmeldelser. Direkte filsystemadgang, simpelt setup (npx @bitbonsai/mcpvault@latest /path/to/vault), 14 værktøjer. Obsidian behøver ikke engang at være åbent.

Før installation tjekkede jeg én kritisk ting — om wiki-links opdateres ved move. Fandt en brugeranmeldelse:

Filesystem-forbindelsen ved ikke, at den er i Obsidian — den ser en mappe med <code>.md</code>-filer og det er det. Ved ikke, at filnavne bærer semantisk vægt, at hver <code>[[wikilink]]</code> vil gå i stykker i det øjeblik du omdøber eller flytter. Auto-update links virker kun når omdøbningen sker indefra appen. Jeg lærte dette efter at have bedt Claude om at rydde op i filnavne og vendte tilbage til et dashboard med halvdelen af links ødelagt.

Bekræftet i mcpvaults egen dokumentation: PR #101 (wiki link resolution) er under review, ikke merget. Så at flytte via mcpvault ville ødelægge halvdelen af vaultet. Ikke egnet.

Forsøg 4: VaultForge (Final)

blacksmithers/vaultforge — specifikt bygget til AI-agenter, der laver refaktorering.

Arkitektonisk korrekt

• Direkte filsystem — ikke afhængigt af Obsidian
• Egen wikilink-motor — implementerer [[wikilink]]-opløsningslogik, der opdaterer alle former (stem, fuld sti, alias, embed)
• Dry run som standard på alle destruktive operationer — viser først hvad der ændres, derefter bekræfter du
• 27 værktøjer mod 8–14 hos konkurrenter: batch_rename, update_links, backlinks (impact analysis), prune_empty_dirs, frontmatter, smart_search (BM25), vault_themes (TF-IDF clustering)
• MIT-licens, TypeScript, nul underafhængigheder
• Installation på 30 sekunder via .mcpb (one-click-udvidelse til Claude Desktop)

Sikkerhedstest på isolerede filer

Oprettede 4 testfiler med krydslinks — stem-links, links med alias, links med fuld sti. Flytter én fil til en undermappe:

delta.md → subfolder/delta-renamed.md

VaultForge viste en dry run: "1 fil vil blive omdøbt, 3 links vil blive opdateret". Udført for real.

Tjekket bagefter — alle tre linktyper blev opdateret korrekt. Det er præcis hvad alle tidligere værktøjer manglede.

Sådan installerer du VaultForge — Endelig instruktion

Hvis du har macOS og Claude Desktop:

Trin 1

Download .mcpb-filen:

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

Trin 2

Claude Desktop åbner installationsdialogen for udvidelser. Indtast den absolutte sti til dit vault — ingen backslashes, normale mellemrum:

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

Trin 3

Klik på Save. Claude Desktop tilføjer udvidelsen til konfigurationen automatisk. Ingen genstart nødvendig — .mcpb-udvidelser opfanges automatisk.

Trin 4

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

Hvad jeg lærte om Obsidians MCP-økosystem

For det første: "mest populær" betyder ikke "virker". MarkusPfundstein/mcp-obsidian har 3.400 stjerner og er standardanbefalingen, men det er forældet og mangler vigtige operationer.

For det andet: et nativt plugin har en skjult pris. Aaronsb-pluginet så ideelt ud — graph, Dataview, nativt move. Men afhængigheden af en kørende Obsidian-instans og dens indeks gør det uegnet til seriøse masseoperationer.

For det tredje: direkte filsystem uden link-engine er en fælde. Mcpvault er hurtigt og simpelt, men "bare at flytte filer" ødelægger vault-strukturen. Links bærer påtvunget semantik, som filsystemet ikke kender til. Uden sin egen wikilink-logikimplementering bliver værktøjet en landmine.

For det fjerde: test på isolerede data. Før du betror et værktøj masserefaktorering — opret en testmappe med 4–5 filer med krydslinks og se hvad der sker. 5 minutters test sparer timer med genopretning fra backup.

For det femte: behold en git-backup af dit vault. Det vigtigste af alt. Et enkelt git init inde i vaultet og periodiske commits — det er forsikring mod alle fejl fra en AI-agent eller et værktøj. Hvis noget går i stykker — git reset --hard bringer alt tilbage.

Konklusion

Rejsen tog flere timer og tre mislykkede forsøg. Den endelige arkitektur ser sådan ud:

• VaultForge — hovedarbejdsværktøjet. Direkte filsystem + egen wikilink-motor + 27 værktøjer = stabil refaktorering i enhver skala.
• Git — vault-versionering. Gratis rollback for enhver fejl.

Nu kan jeg gøre det, som alt dette blev startet for: bede Claude om at organisere 400 noter i en ordentlig PARA-arkitektur, flette duplikater, tilføje frontmatter, bygge MOC-kort. Hver operation er sikker, links bevares, dry run viser hvad der vil ske, før noget ændres.

Hvis du også kigger på dit rodede Obsidian og vil have en AI-assistent — begynd direkte med VaultForge. Gentag ikke min rute gennem døde projekter, beta-plugins og filsystemservere uden linklogik.