Как подключить Claude Desktop к Obsidian — путь через 4 MCP-сервера

Представьте: у вас 400+ заметок в Obsidian, накопленных за годы. Всё разбросано по корню хранилища, концепты перемешаны с техническими заметками, есть дубли (ideas.md и папка ideas/ с 13 файлами внутри), нет системы. Хочется навести порядок — построить нормальную архитектуру папок, добавить MOC-файлы, расставить теги. Вручную это долго и скучно. Логичная мысль: подключить Claude к Obsidian через MCP, пусть AI сделает рефакторинг. Оказалось — это путь через минное поле. Вот что пришлось пройти, чтобы добраться до рабочего решения.

Что такое MCP и почему это не так просто

MCP (Model Context Protocol) — открытый протокол от Anthropic, который позволяет Claude подключаться к внешним инструментам и данным. Принцип прост: запускается локальный сервер, экспонирующий "инструменты" (tools), а Claude их вызывает во время разговора.

Для Obsidian теоретически есть масса MCP-серверов. На практике — у каждого свои проблемы.

Главная проблема экосистемы Obsidian: Obsidian — закрытое приложение без официального MCP. Сообщество заполнило пробел, но каждая имплементация идёт своим путём, и "официального благословения" нет ни у одной.

Попытка 1: MarkusPfundstein/mcp-obsidian

Первый инструмент, который находится при поиске. 3400 звёзд на GitHub, во всех туториалах. Кажется безопасным выбором.

Как работает: Python-сервер на основе плагина Local REST API в Obsidian. Сервер обращается к плагину через HTTPS, плагин выполняет операции через Obsidian API.

Что пошло не так

• Не обновлялся 17 месяцев
• 85 открытых issues
• Нет move/rename — только read, write, append, delete
• Local REST API имеет документированный data-loss баг: POST endpoint может молча перезаписать файл при append

Для рефакторинга не годится — нам нужно перемещать файлы и сохранять ссылки. Идём дальше.

Попытка 2: aaronsb/obsidian-mcp-plugin

Нашёл вариант, который работает как нативный плагин Obsidian. Это означает прямой доступ к внутреннему API Obsidian — backlinks, Dataview, граф связей. Move через нативный API обновляет все вики-ссылки автоматически, потому что Obsidian сам это обрабатывает.

Сложности установки

• Плагин не в официальном каталоге Obsidian (PR висит с ошибками валидации)
• Устанавливать нужно через BRAT (Beta Reviewers Auto-update Tool)
• Claude Desktop не принимает Bearer token напрямую через UI — пришлось включать HTTPS в плагине
• Self-signed сертификат для localhost создаёт проблемы с доверием

Через все эти обходные пути наконец подключил. Базовый тест — vault.move действительно переписывает [[wikilinks]], работает как надо.

Что пошло не так в бою

Когда начал массовый рефакторинг (drag-and-drop десятков папок в Obsidian + одновременные MCP-операции), сервер завис на 4+ минуты. Почему: плагин работает внутри Obsidian. Когда Obsidian переиндексирует тысячи файлов после массового изменения структуры, плагин блокируется вместе с ним.

Вывод: зависимость от открытого Obsidian и его индекса — фатальна для bulk-операций.

Попытка 3: @bitbonsai/mcpvault

Логично — нужен сервер, который не зависит от Obsidian. Работает напрямую с файлами на диске. @bitbonsai/mcpvault — рекомендуется во многих обзорах. Прямой доступ к файловой системе, простая настройка (npx @bitbonsai/mcpvault@latest /path/to/vault), 14 инструментов. Obsidian вообще не нужно держать открытым.

Перед установкой проверил один критический момент — обновляются ли вики-ссылки при move. Нашёл отзыв пользователя:

Filesystem connector не знает, что он в Obsidian — видит папку с <code>.md</code> файлами и всё. Не знает, что имена файлов несут семантическую нагрузку, что каждый <code>[[wikilink]]</code> сломается в момент rename или move. Auto-update links срабатывает только когда rename происходит изнутри приложения. Я узнал это после того, как попросил Claude почистить имена файлов и вернулся к dashboard с половиной сломанных ссылок.

Подтвердилось в документации самого mcpvault: PR #101 (wiki link resolution) в review, не помержен. То есть move через mcpvault сломает половину vault. Не годится.

Попытка 4: VaultForge (финал)

blacksmithers/vaultforge — специально построен для AI-агентов, которые делают рефакторинг.

Архитектурно правильно

• Direct filesystem — не зависит от Obsidian
• Собственный wikilink engine — реализована логика резолвинга [[wikilinks]], обновляющая все формы (stem, полный путь, alias, embed)
• Dry run по умолчанию на всех разрушительных операциях — сначала показывает что изменится, потом подтверждаешь
• 27 инструментов против 8–14 у конкурентов: batch_rename, update_links, backlinks (impact analysis), prune_empty_dirs, frontmatter, smart_search (BM25), vault_themes (TF-IDF clustering)
• MIT лицензия, TypeScript, zero sub-dependencies
• Установка за 30 секунд через .mcpb (one-click extension для Claude Desktop)

Тест безопасности на изолированных файлах

Создал 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 — без backslashes, с нормальными пробелами:

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

Шаг 3

Нажмите Save. Claude Desktop сам добавит расширение в конфиг. Перезапуск не нужен — .mcpb extensions подхватываются автоматически.

Шаг 4

Проверьте: в новом чате спросите: "Какой статус моего Obsidian vault?" — должно вернуться что-то вроде totalFiles: 416, totalDirs: 135, ...

Что я понял про MCP-экосистему Obsidian

Во-первых, "самый популярный" не значит "рабочий". MarkusPfundstein/mcp-obsidian имеет 3400 звёзд и его ставят по умолчанию, но он устарел и не имеет ключевых операций.

Во-вторых, нативный плагин имеет скрытую цену. Aaronsb plugin выглядел идеально — graph, Dataview, нативные move. Но зависимость от открытого Obsidian и его индекса делает его непригодным для серьёзных массовых операций.

В-третьих, direct filesystem без link-engine — ловушка. Mcpvault быстрый и простой, но "просто перемещение файлов" разрушает структуру vault. Ссылки — это навязанная семантика, о которой файловая система не знает. Без собственной реализации wikilink-логики инструмент превращается в мину.

В-четвёртых, проверяйте на изолированных данных. Прежде чем доверять инструменту массовый рефакторинг — создайте тестовую папку с 4–5 файлами с перекрёстными ссылками и посмотрите, что происходит. 5 минут тестов экономят часы восстановления из backup.

В-пятых, держите git-бэкап vault. Самое важное из всего. Один git init внутри vault и периодические коммиты — это страховка от любых ошибок AI-агента или инструмента. Если что-то сломается — git reset --hard вернёт всё назад.

Заключение

Путь занял несколько часов и три неудачных попытки. Финальная архитектура выглядит так:

• VaultForge — основной рабочий инструмент. Direct filesystem + собственный wikilink engine + 27 инструментов = стабильный рефакторинг любого масштаба.
• Git — версионирование vault. Бесплатный откат для любой ошибки.

Теперь можно делать то, ради чего всё затевалось: попросить Claude разложить 400 заметок по нормальной архитектуре PARA, объединить дубли, добавить frontmatter, построить MOC-карты. Каждая операция безопасна, ссылки сохраняются, dry run показывает что будет до того, как что-то изменится.

Если вы тоже смотрите на свой захламлённый Obsidian и хотите AI-помощника — начинайте сразу с VaultForge. Не повторяйте мой маршрут через мёртвые проекты, beta-плагины и filesystem-серверы без link-логики.