Obsidian MCP-сервер: четыре способа подключить хранилище к ИИ-агентам

1. mcp-obsidian (семейство Local REST API)

Самый популярный подход (у репозитория mcp-obsidian больше 4 тысяч звёзд на GitHub на июль 2026): mcp-obsidian Маркуса Пфундштайна и похожие серверы (например, obsidian-mcp-server от cyanheads) общаются с community-плагином Local REST API внутри Obsidian. Агент получает настоящую семантику Obsidian: список файлов, чтение и правку заметок, поиск.

Требования вытекают из конструкции: Obsidian должен быть установлен и запущен с включённым плагином, нужен API-ключ, а MCP-сервер работает локальным процессом на той же машине. Настройка занимает несколько минут, и всё остаётся локально.

2. Файловый MCP-сервер

Хранилище — это папка markdown-файлов, поэтому общий файловый MCP-сервер (@modelcontextprotocol/server-filesystem), направленный на хранилище, тоже работает. Obsidian даже не нужно запускать. Компромисс: агент видит файлы, а не базу знаний. Ни семантического поиска, ни резолва вики-ссылок, ни метаданных; на большом хранилище агент скатывается к чтению файлов целиком — медленно и дорого по токенам.

3. Плагины Obsidian со встроенным MCP

Часть community-плагинов встраивает MCP-эндпоинт (или похожий) прямо в Obsidian. Удобно, но ограничение то же, что в первом способе: хранилище доступно ровно пока Obsidian открыт на этой машине.

У всех трёх локальных способов общий профиль: полностью приватно, быстро ставится и привязано к работающему десктопу. Для одного пользователя на одной машине этот профиль часто ровно то, что нужно, — начинайте с него.

Что получает агент

MCP-эндпоинт отдаёт search, expand, note_html, similar и инструменты federated_* для соседних баз (федерация). Поиск возвращает toc_path — указатель на конкретный раздел заметки, и агент читает раздел, а не весь файл: примерно в 15 раз дешевле по медиане, замеры воспроизводимы в бенчмарке токенов.

Доступ не «всё или ничего»: заметки без free: true требуют токен, а подграфы подписок позволяют открыть агенту (или человеку) одну папку хранилища, не открывая остальное. Это то, чего локальные серверы не могут конструктивно, и именно это делает общее командное хранилище рабочим.

Настройка

1. Создайте инстанс: self-hosted в Docker (инструкция), одноразовый локальный через memcli или бесплатный облачный.
2. Установите плагин синхронизации trip2g в Obsidian, подключите, нажмите Sync. Подробности в «Начале работы».
3. Добавьте MCP-эндпоинт в клиент:

{
  "mcpServers": {
    "obsidian-vault": {
      "url": "https://your-site.example.com/_system/mcp"
    }
  }
}

Для приватных хранилищ создайте персональный токен в User → Tokens и передавайте его как Authorization: Bearer t2g_…. Все варианты аутентификации: справочник MCP.

Проверка

curl https://your-site.example.com/_system/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Ответ перечислит инструменты. Затем в MCP-клиенте попросите агента найти через search фразу, которая точно есть в хранилище, и процитировать найденную заметку. Процитировал ваш текст — цикл замкнулся. Проверить можно прямо сейчас на живом инстансе: https://trip2g.com/_system/mcp обслуживает хранилище этого сайта документации.