Claude Desktop-ты Obsidian-ға қалай жалғау керек — 4 MCP сервер арқылы саяхат

Елестетіп көріңіз: Obsidian-да жылдар бойы жинақталған 400-ден астам жазбаңыз бар. Бәрі қойма түбірінде шашылып жатыр, тұжырымдамалар техникалық жазбалармен араласқан, қайталанулар бар (ideas.md және ішінде 13 файл бар ideas/ қалтасы), ешқандай жүйе жоқ. Тәртіп орнатқыңыз келеді — дұрыс қалталар архитектурасын құру, MOC файлдарын қосу, тегтерді реттеу. Мұны қолмен істеу — ұзақ әрі жалықтырады. Қисынды ой: Claude-ты MCP арқылы Obsidian-ға жалғап, рефакторингті AI жасасын. Шындығында бұл — мина алаңы арқылы өтетін жол болып шықты. Жұмыс істейтін шешімге жету үшін неден өткенімді айтайын.

MCP дегеніміз не және неге бұл соншалықты оңай емес

MCP (Model Context Protocol) — Claude-қа сыртқы құралдар мен деректерге жалғануға мүмкіндік беретін Anthropic-тің ашық протоколы. Принципі қарапайым: жергілікті сервер іске қосылады, ол "құралдарды" (tools) ұсынады, ал Claude оларды әңгіме барысында шақырады.

Obsidian үшін теориялық тұрғыда MCP серверлері жеткілікті. Тәжірибеде — әрқайсысының өз мәселелері бар.

Obsidian экожүйесінің басты мәселесі: Obsidian — ресми MCP-сі жоқ жабық қосымша. Қауымдастық бұл олқылықтың орнын толтырды, бірақ әрбір іске асыру өз жолымен жүреді, әрі ешқайсысында "ресми бата" жоқ.

1-әрекет: MarkusPfundstein/mcp-obsidian

Іздеген кезде табылатын алғашқы құрал. GitHub-та 3400 жұлдыз, барлық оқулықтарда бар. Қауіпсіз таңдау сияқты көрінеді.

Қалай жұмыс істейді: Obsidian-дағы Local REST API плагинінің негізіндегі Python сервері. Сервер плагинге HTTPS арқылы жүгінеді, ал плагин операцияларды Obsidian API арқылы орындайды.

Не дұрыс болмады

• 17 ай бойы жаңартылмаған
• 85 ашық issue
• move/rename жоқ — тек read, write, append, delete
• Local REST API-де құжатталған деректер жоғалту багы бар: POST endpoint append кезінде файлды үнсіз қайта жазып жіберуі мүмкін

Рефакторингке жарамайды — бізге файлдарды жылжытып, сілтемелерді сақтау қажет. Әрі қарай жүреміз.

2-әрекет: aaronsb/obsidian-mcp-plugin

Obsidian-ның нативті плагині ретінде жұмыс істейтін нұсқаны таптым. Бұл Obsidian-ның ішкі API-іне тікелей қол жеткізуді білдіреді — backlinks, Dataview, байланыстар графы. Нативті API арқылы move барлық вики-сілтемелерді автоматты түрде жаңартады, өйткені Obsidian мұны өзі өңдейді.

Орнату қиындықтары

• Плагин Obsidian-ның ресми каталогында жоқ (PR валидация қателерімен ілініп тұр)
• BRAT (Beta Reviewers Auto-update Tool) арқылы орнату керек
• Claude Desktop Bearer token-ды UI арқылы тікелей қабылдамайды — плагинде HTTPS-ті қосуға мәжбүр етті
• localhost үшін self-signed сертификат сенім мәселелерін тудырады

Осы айналма жолдардың бәрі арқылы ақыры жалғадым. Негізгі сынақ — vault.move шынымен [[wikilinks]] қайта жазады, керегінше жұмыс істейді.

Өндірісте не дұрыс болмады

Жаппай рефакторингті бастаған кезде (Obsidian-да ондаған қалталарды drag-and-drop + бір мезгілде MCP операциялары), сервер 4+ минутқа қатып қалды. Себебі: плагин Obsidian-ның ішінде жұмыс істейді. Obsidian құрылымның жаппай өзгеруінен кейін мыңдаған файлды қайта индекстегенде, плагин де онымен бірге бұғатталады.

Қорытынды: ашық Obsidian данасына және оның индексіне тәуелділік жаппай операциялар үшін апатты.

3-әрекет: @bitbonsai/mcpvault

Қисынды тұрғыда — бізге Obsidian-ға тәуелді емес сервер керек. Дискідегі файлдармен тікелей жұмыс істейді. @bitbonsai/mcpvault — көптеген шолуларда ұсынылады. Файлдық жүйеге тікелей қол жеткізу, қарапайым баптау (npx @bitbonsai/mcpvault@latest /path/to/vault), 14 құрал. Obsidian-ды ашық ұстаудың тіпті қажеті жоқ.

Орнатпас бұрын бір маңызды жайтты тексердім — move кезінде вики-сілтемелер жаңарады ма. Пайдаланушының пікірін таптым:

Файлдық жүйе коннекторы өзінің Obsidian-да екенін білмейді — ол <code>.md</code> файлдары бар қалтаны көреді, болды. Файл аттарының семантикалық салмақ көтеретінін, әрбір <code>[[wikilink]]</code> қайта атау немесе жылжыту сәтінде бұзылатынын білмейді. Auto-update links тек қайта атау қосымшаның ішінен жасалғанда ғана іске қосылады. Мұны Claude-тан файл аттарын тазалауды сұрағаннан кейін, сілтемелерінің жартысы бұзылған dashboard-қа оралғанда білдім.

mcpvault-тың өз құжаттамасында расталды: PR #101 (wiki link resolution) шолуда, merge жасалмаған. Яғни mcpvault арқылы move vault-тың жартысын бұзады. Жарамайды.

4-әрекет: VaultForge (финал)

blacksmithers/vaultforge — рефакторинг жасайтын AI агенттеріне арнайы жасалған.

Архитектуралық тұрғыда дұрыс

• Тікелей файлдық жүйе — Obsidian-ға тәуелді емес
• Өз wikilink қозғалтқышы — барлық түрлерін (stem, толық жол, alias, embed) жаңартатын [[wikilink]] шешу логикасын іске асырады
• Әдепкіде dry run барлық қиратушы операцияларда — алдымен нені өзгертетінін көрсетеді, содан кейін сіз растайсыз
• 27 құрал бәсекелестердегі 8–14-ке қарсы: batch_rename, update_links, backlinks (әсерді талдау), prune_empty_dirs, frontmatter, smart_search (BM25), vault_themes (TF-IDF clustering)
• MIT лицензиясы, TypeScript, нөл ішкі тәуелділік
• 30 секундта орнату .mcpb арқылы (Claude Desktop үшін one-click extension)

Оқшауланған файлдарда қауіпсіздік сынағы

Айқас сілтемелері бар 4 сынақ файлын жасадым — stem сілтемелер, alias-пен сілтемелер, толық жолмен сілтемелер. Бір файлды ішкі қалтаға жылжытамын:

delta.md → subfolder/delta-renamed.md

VaultForge dry run көрсетті: "1 файл қайта аталады, 3 сілтеме жаңартылады". Шын мәнінде орындадым.

Кейін тексердім — сілтемелердің үш түрі де дұрыс жаңарды. Дәл осы нәрсе бұрынғы барлық құралдарда жетіспеді.

VaultForge-ті қалай орнату керек — түпкілікті нұсқаулық

Егер сізде macOS және Claude Desktop болса:

1-қадам

.mcpb файлын жүктеп алыңыз:

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

2-қадам

Claude Desktop кеңейтімді орнату диалогын ашады. Vault-қа абсолютті жолды енгізіңіз — backslash-сыз, қалыпты бос орындармен:

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

3-қадам

Save түймесін басыңыз. Claude Desktop кеңейтімді конфигке автоматты түрде қосады. Қайта іске қосу қажет емес — .mcpb кеңейтімдері автоматты түрде қабылданады.

4-қадам

Тексеріңіз: жаңа чатта сұраңыз: "What is the status of my Obsidian vault?" — totalFiles: 416, totalDirs: 135, ... сияқты бірдеңе қайтуы керек

Obsidian-ның MCP экожүйесі туралы не түсіндім

Біріншіден, "ең танымал" деген "жұмыс істейді" дегенді білдірмейді. MarkusPfundstein/mcp-obsidian-да 3400 жұлдыз бар және ол әдепкі ұсыныс, бірақ ол ескірген әрі негізгі операциялары жоқ.

Екіншіден, нативті плагиннің жасырын құны бар. Aaronsb плагині мінсіз көрінді — graph, Dataview, нативті move. Бірақ жұмыс істеп тұрған Obsidian данасына және оның индексіне тәуелділік оны байыпты жаппай операцияларға жарамсыз етеді.

Үшіншіден, link-engine-сіз тікелей файлдық жүйе — тұзақ. Mcpvault жылдам әрі қарапайым, бірақ "жай ғана файлдарды жылжыту" vault құрылымын бұзады. Сілтемелер файлдық жүйе білмейтін таңылған семантиканы көтереді. Өз wikilink логикасын іске асырмайынша, құрал минаға айналады.

Төртіншіден, оқшауланған деректерде сынаңыз. Қандай да бір құралға жаппай рефакторингті сеніп тапсырмас бұрын — айқас сілтемелері бар 4–5 файлдан тұратын сынақ қалтасын жасап, не болатынын қараңыз. 5 минуттық сынақ backup-тан қалпына келтірудің сағаттарын үнемдейді.

Бесіншіден, vault-тың git-бэкапын ұстаңыз. Бәрінің ішіндегі ең маңыздысы. Vault ішінде бір ғана git init және мерзімді коммиттер — бұл AI агентінің немесе құралдың кез келген қатесінен сақтандыру. Егер бірдеңе бұзылса — git reset --hard бәрін қайтарады.

Қорытынды

Жол бірнеше сағат пен үш сәтсіз әрекетке созылды. Түпкілікті архитектура былай көрінеді:

• VaultForge — негізгі жұмыс құралы. Тікелей файлдық жүйе + өз wikilink қозғалтқышы + 27 құрал = кез келген ауқымдағы тұрақты рефакторинг.
• Git — vault-ты нұсқалау. Кез келген қате үшін тегін қайтару.

Енді осының бәрі неден басталса, соны істей аламын: Claude-тан 400 жазбаны дұрыс PARA архитектурасына реттеуді, қайталануларды біріктіруді, frontmatter қосуды, MOC карталарын құруды сұрай аламын. Әрбір операция қауіпсіз, сілтемелер сақталады, dry run бірдеңе өзгермес бұрын не болатынын көрсетеді.

Егер сіз де өзіңіздің ретсіз Obsidian-ыңызға қарап, AI көмекшісін қаласаңыз — бірден VaultForge-тен бастаңыз. Менің өлі жобалар, beta плагиндер және link-логикасы жоқ файлдық жүйе серверлері арқылы өткен жолымды қайталамаңыз.