Hur man ansluter Claude Desktop till Obsidian — En resa genom 4 MCP-servrar

Föreställ dig: du har 400+ anteckningar i Obsidian, samlade under åren. Allt ligger utspritt i vault-roten, koncept blandade med tekniska anteckningar, det finns dubbletter (ideas.md och en ideas/-mapp med 13 filer inuti), inget system. Du vill skapa ordning — bygga en ordentlig mapparkitektur, lägga till MOC-filer, organisera taggar. Att göra det manuellt är tråkigt och långsamt. Den logiska tanken: anslut Claude till Obsidian via MCP, låt AI göra refaktoreringen. Det visar sig — det är en väg genom ett minfält. Här är vad jag fick gå igenom för att nå en fungerande lösning.

Vad är MCP och varför det inte är så enkelt

MCP (Model Context Protocol) är ett öppet protokoll från Anthropic som låter Claude ansluta till externa verktyg och data. Principen är enkel: en lokal server körs, exponerar "verktyg" (tools), och Claude anropar dem under konversationen.

För Obsidian finns det teoretiskt gott om MCP-servrar. I praktiken — var och en har sina egna problem.

Huvudproblemet med Obsidian-ekosystemet: Obsidian är en stängd applikation utan officiell MCP. Communityn fyllde gapet, men varje implementation går sin egen väg, och ingen har "officiellt godkännande".

Försök 1: MarkusPfundstein/mcp-obsidian

Första verktyget som dyker upp vid sökning. 3 400 stjärnor på GitHub, med i varje tutorial. Verkar vara ett säkert val.

Hur det fungerar: Python-server baserad på Local REST API-pluginet i Obsidian. Servern kommunicerar med pluginet via HTTPS, pluginet utför operationer via Obsidian API.

Vad som gick fel

• Inte uppdaterat på 17 månader
• 85 öppna issues
• Inget move/rename — bara read, write, append, delete
• Local REST API har en dokumenterad bug för dataförlust: POST-endpoint kan tyst skriva över en fil vid append

Inte lämpligt för refaktorering — vi behöver flytta filer och bevara länkar. Vi går vidare.

Försök 2: aaronsb/obsidian-mcp-plugin

Hittade ett alternativ som fungerar som ett nativt Obsidian-plugin. Det innebär direkt åtkomst till Obsidians interna API — backlinks, Dataview, länkgraf. Move via det nativa API:et uppdaterar alla wiki-länkar automatiskt, eftersom Obsidian hanterar detta själv.

Installationssvårigheter

• Pluginet finns inte i Obsidians officiella katalog (PR väntar med valideringsfel)
• Måste installeras via BRAT (Beta Reviewers Auto-update Tool)
• Claude Desktop accepterar inte Bearer token direkt via UI — tvingade aktivering av HTTPS i pluginet
• Self-signed certifikat för localhost skapar förtroendeproblem

Genom alla dessa lösningar lyckades jag äntligen ansluta det. Grundtest — vault.move skriver om [[wikilinks]], fungerar som förväntat.

Vad som gick fel i produktion

När jag började med massrefaktorering (drag-and-drop av dussintals mappar i Obsidian + samtidiga MCP-operationer), hängde servern i 4+ minuter. Varför: pluginet körs inuti Obsidian. När Obsidian omindexerar tusentals filer efter en massiv strukturförändring, blockeras pluginet med det.

Slutsats: beroendet av en öppen Obsidian-instans och dess index är fatalt för massoperationer.

Försök 3: @bitbonsai/mcpvault

Logiskt — vi behöver en server som inte beror på Obsidian. Arbetar direkt med filer på disk. @bitbonsai/mcpvault — rekommenderas i många recensioner. Direkt filsystemåtkomst, enkel installation (npx @bitbonsai/mcpvault@latest /path/to/vault), 14 verktyg. Obsidian behöver inte ens vara öppet.

Innan installation kontrollerade jag en kritisk sak — om wiki-länkarna uppdateras vid move. Hittade en användarrecension:

Filesystem-anslutningen vet inte att den är i Obsidian — den ser en mapp med <code>.md</code>-filer och det är allt. Vet inte att filnamn bär semantisk vikt, att varje <code>[[wikilink]]</code> kommer att gå sönder i det ögonblick du byter namn eller flyttar. Auto-update links fungerar bara när namnbytet sker inifrån appen. Jag lärde mig detta efter att ha bett Claude rensa filnamn och kom tillbaka till en dashboard med hälften av länkarna trasiga.

Bekräftat i mcpvaults egen dokumentation: PR #101 (wiki link resolution) är under review, inte mergad. Så att flytta via mcpvault skulle förstöra halva vaultet. Inte lämpligt.

Försök 4: VaultForge (Final)

blacksmithers/vaultforge — specifikt byggt för AI-agenter som gör refaktorering.

Arkitektoniskt korrekt

• Direkt filsystem — beror inte på Obsidian
• Egen wikilink-motor — implementerar [[wikilink]]-upplösningslogik som uppdaterar alla former (stem, fullständig sökväg, alias, embed)
• Dry run som standard på alla destruktiva operationer — visar först vad som ändras, sedan bekräftar du
• 27 verktyg 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-licens, TypeScript, noll underberoenden
• Installation på 30 sekunder via .mcpb (one-click-tillägg för Claude Desktop)

Säkerhetstest på isolerade filer

Skapade 4 testfiler med korslänkar — stem-länkar, länkar med alias, länkar med fullständig sökväg. Flyttar en fil till en undermapp:

delta.md → subfolder/delta-renamed.md

VaultForge visade en dry run: "1 fil kommer att döpas om, 3 länkar kommer att uppdateras". Kördes på riktigt.

Kontrollerade efteråt — alla tre länktyper uppdaterades korrekt. Det här är precis vad alla tidigare verktyg saknade.

Hur man installerar VaultForge — Slutgiltig instruktion

Om du har macOS och Claude Desktop:

Steg 1

Ladda ner .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 öppnar installationsdialogen för tillägg. Ange den absoluta sökvägen till ditt vault — inga backslashes, vanliga mellanslag:

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

Steg 3

Klicka på Save. Claude Desktop lägger till tillägget i konfigurationen automatiskt. Ingen omstart behövs — .mcpb-tillägg plockas upp automatiskt.

Steg 4

Verifiera: i en ny chatt fråga: "What is the status of my Obsidian vault?" — bör returnera något som totalFiles: 416, totalDirs: 135, ...

Vad jag lärde mig om Obsidians MCP-ekosystem

För det första: "mest populär" betyder inte "fungerar". MarkusPfundstein/mcp-obsidian har 3 400 stjärnor och är standardrekommendationen, men det är föråldrat och saknar viktiga operationer.

För det andra: ett nativt plugin har en dold kostnad. Aaronsb-pluginet såg idealiskt ut — graph, Dataview, nativt move. Men beroendet av en körande Obsidian-instans och dess index gör det olämpligt för seriösa massoperationer.

För det tredje: direkt filsystem utan link-engine är en fälla. Mcpvault är snabbt och enkelt, men "bara flytta filer" förstör vault-strukturen. Länkar bär påtvingad semantik som filsystemet inte känner till. Utan sin egen wikilink-logikimplementation blir verktyget en landmina.

För det fjärde: testa på isolerade data. Innan du anförtror ett verktyg massrefaktorering — skapa en testmapp med 4–5 filer med korslänkar och se vad som händer. 5 minuters testning sparar timmar av återställning från backup.

För det femte: behåll en git-backup av ditt vault. Det viktigaste av allt. Ett enda git init inuti vaultet och periodiska commits — det är försäkring mot alla misstag av en AI-agent eller ett verktyg. Om något går sönder — git reset --hard tar tillbaka allt.

Slutsats

Resan tog flera timmar och tre misslyckade försök. Den slutgiltiga arkitekturen ser ut så här:

• VaultForge — huvudarbetsverktyget. Direkt filsystem + egen wikilink-motor + 27 verktyg = stabil refaktorering i alla skalor.
• Git — vault-versionshantering. Gratis rollback för alla misstag.

Nu kan jag göra det som allt detta startades för: be Claude organisera 400 anteckningar i en ordentlig PARA-arkitektur, slå samman dubbletter, lägga till frontmatter, bygga MOC-kartor. Varje operation är säker, länkarna bevaras, dry run visar vad som kommer att hända innan något ändras.

Om du också tittar på ditt stökiga Obsidian och vill ha en AI-assistent — börja direkt med VaultForge. Upprepa inte min väg genom döda projekt, beta-plugins och filsystemservrar utan länklogik.