Obsidian MCP: нужен ли сервер и что агент видит в заметках

Опубликовано 10.11.20268 мин чтенияСредний
Артемий Миллер в кепке с логотипом Obsidian рядом с надписью «НУЖЕН ЛИ СЕРВЕР» и логотипами Obsidian.
Что узнаешь
  • Когда достаточно прямого чтения Markdown
  • Как различить серверы Obsidian MCP и настроить mcp-obsidian
  • Как проверить чтение, границы доступа и отключение
Средний
11просмотров

Если агент умеет читать вашу папку Markdown, проверьте, нужен ли дополнительный сервер вообще. Решили подключить Obsidian MCP - начните с тестового хранилища и проверьте чтение выбранной заметки.

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

Нужен ли MCP, если агент уже читает Markdown?

Для работы со своей базой мы просто указываем агенту, где она лежит.

Если у вашего агента есть файловый инструмент и доступ к папке, дайте путь к заметке и попросите вернуть содержимое. Сверьте результат с файлом.

Для MCP-подключения выберите конкретный сервер. Сервер MarkusPfundstein позволяет поручить агенту пересказать запись встречи или найти упоминания темы.

С общей базой работают разные модели, ничего не приходится копировать из чата в чат. Без приложения Obsidian тоже можно работать через MCP: сервер Nate Strong читает папку напрямую.

Разборы работы ИИ-агентов с базой знаний я выкладываю в канале:

Какой именно Obsidian MCP вы подключаете?

Сверьте автора и название пакета: похожее имя может означать другой проект и другие настройки.

Автор и проектОткуда заметки / нужен ли ObsidianКонфигурацияОперации и границы
MarkusPfundstein/mcp-obsidianLocal REST API в работающем Obsidianstdio, uvx mcp-obsidian; OBSIDIAN_API_KEY, OBSIDIAN_HOST, OBSIDIAN_PORTЧтение, поиск, изменение, удаление. Путь в поручении не ограничивает права
Leonezz/obsidian-mcp-serverMCP-плагин внутри работающего ObsidianStreamable HTTP, http://localhost:27123/mcp по умолчанию, Bearer TokenРазработчик заявляет исключения по путям и тегам
Nate Strong, natestrong/obsidian-mcpНапрямую из папки; открытый Obsidian не нуженuvx obsidian-mcp; OBSIDIAN_VAULT_PATHФайловый доступ без Local REST API

У Local REST API есть собственный встроенный MCP: https://127.0.0.1:27124/mcp/. Это отдельный HTTP-интерфейс. Внешний сервер MarkusPfundstein запускается через stdio; адрес встроенного MCP в его конфигурацию подставлять не нужно.

Ниже подключаем именно MarkusPfundstein/mcp-obsidian.

Как подключить mcp-obsidian и не открыть рабочую базу вслепую?

Создайте тестовое хранилище Obsidian с искусственной заметкой, без рабочих документов и ссылок на рабочие папки. Внешнюю контрольную заметку держите за его пределами.

Нужны Python от 3.11 и mcp Python SDK от 1.1.0 до 2.0.0, исключая 2.0.0. Команда uvx должна быть доступна на компьютере.

В тестовом хранилище установите и включите плагин сообщества Local REST API. В Settings → Local REST API возьмите API-ключ. Подставляйте его только в локальную конфигурацию, не отправляйте в чат и не записывайте в журнал. Obsidian оставьте работающим.

Как установить Claude Desktop и где что лежит в интерфейсе, смотрите в отдельной статье.

Откройте конфигурацию Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json;
  • Windows: %APPDATA%/Claude/claude_desktop_config.json.

Сохраните копию файла. В объект mcpServers добавьте запись mcp-obsidian, сохранив остальные подключения. Поля записи:

Поле внутри mcp-obsidianЗначение
commandСтрока uvx
argsМассив строк ["mcp-obsidian"]
env → OBSIDIAN_API_KEYСтрока с вашим локальным API-ключом
env → OBSIDIAN_HOSTСтрока 127.0.0.1
env → OBSIDIAN_PORTСтрока 27124

Адрес и порт - значения выбранного сервера по умолчанию. Это конфигурация Claude Desktop; формат для Claude Code, Codex или другого клиента сверяйте отдельно.

После сохранения перезапустите Claude Desktop. Кроме чтения у сервера есть patch_content, append_content и delete_file. Сам Local REST API тоже умеет менять файлы. Поэтому первое подключение - только к тестовому хранилищу.

Видеоразбор Claude Desktop я выложил в канале бесплатно, пост от 10.06. Забрать можно здесь.

Агент действительно прочитал заметку или просто сказал «вижу»?

Вручную впишите в тестовую заметку уникальный маркер. Модели его заранее не сообщайте. Укажите агенту путь к файлу внутри хранилища:

Через mcp-obsidian прочитайте заметку по указанному пути. Покажите вызванный инструмент, путь и верните текст из файла. Другие каналы чтения не используйте.

Сначала запросите list_files_in_vault для корня или list_files_in_dir для каталога. Затем вызовите get_file_contents для контрольной заметки. Имя поля для пути берите из схемы инструмента в клиенте.

В журнале сверьте инструмент, переданный путь и вернувшийся текст с файлом. Ваш маркер должен быть в результате инструмента, а не только в сообщении модели «прочитал».

Отдельно выполните search по теме заметки. Для найденного файла снова вызовите get_file_contents. Поиск возвращает совпадения, чтение - содержимое файла. У этого сервера search ищет по тексту, не по смыслу.

В первом испытании не запускайте инструменты, которые меняют файлы:

  • patch_content вставляет содержимое относительно заголовка, ссылки на блок или поля метаданных;
  • append_content добавляет содержимое в новый или существующий файл;
  • delete_file удаляет файл либо каталог.

Сохраните вызовы и ответы для сравнения после отключения.

Одна выбранная заметка - это уже граница доступа?

Путь в поручении говорит агенту, куда идти. Права сервера от этого не меняются. У mcp-obsidian инструмент search ищет по всему подключённому хранилищу.

О доступе к данным в Claude Code читайте отдельную статью. Здесь проверяем именно подключение к Obsidian.

С общей базой может работать и команда: читать доступные разделы и предлагать обновления, которые вы принимаете. Это принцип моей базы, не настройка прав стороннего сервера.

Создайте искусственную заметку вне тестового хранилища с другим маркером. Для поиска сообщите имя или тему, для чтения - внешний путь. Маркер модели не сообщайте. Используйте только свои искусственные файлы.

В результате search не должно быть текста внешней заметки. От get_file_contents по внешнему пути ожидайте отказ без текста файла. Ответ запишите из журнала. Если путь отклонил клиент, так и запишите: отказ клиента.

Отсутствие файла в поиске не доказывает запрет чтения. Если появился текст внешней заметки, остановитесь и проверьте вызванный инструмент. Рабочую базу не подключайте. Подбирать другие пути после отказа не нужно.

Результаты относятся к вашей конфигурации и выбранным файлам. Исключения по путям и тегам у Leonezz нельзя переносить на MarkusPfundstein.

Как отключить подключение и проверить новый отказ?

Отключите Local REST API в тестовом хранилище. Из mcpServers в конфигурации Claude Desktop уберите только запись mcp-obsidian и перезапустите клиент.

В новой сессии запросите get_file_contents для первой заметки через отключённое подключение. Инструмент должен быть недоступен либо новый вызов не должен вернуть текст файла.

Старый маркер в ответе мог остаться из переписки. Проверяйте, был ли новый вызов. Если текст пришёл через файловый инструмент или другое подключение, проверяйте этот способ доступа отдельно.

Результаты сохраните в таблице. Последнюю колонку заполните по своему журналу.

Действие и инструментЧто ожидаемЧто записать у себя
Контрольная: get_file_contentsТекст и ваш маркерПуть, вызов, ответ
search по теме, затем чтениеСовпадение и файл из тестового хранилищаВыдачу и результат чтения
search по внешней контрольнойНет её содержимогоФактическую выдачу
get_file_contents по внешнему путиОтказ без текста файлаОтвет и уровень отказа
Новое чтение после отключенияНет нового содержимого через связкуОшибку либо отсутствие инструмента

Если вы собираете свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

По результатам решите, нужно ли подключение дальше. Ненужные MCP выключайте.

Кстати, я снял ролик «Полная схема по Hermes Agent с нуля для автоматизации бизнеса». Посмотрите фрагмент о работе с базой знаний:

Видео загрузится при скролле
Полная схема по Hermes Agent с нуля для автоматизации бизнеса

Внутри - «Второй мозг без Obsidian» и работа агента с базой. Показываю, как он берёт информацию по задаче и как не превратить базу в свалку.

Как не превратить общую базу в огромную свалку?

В корне базы мы создаём index.md. Это карта: какие разделы есть, что в них лежит и по какому вопросу куда идти. Всю информацию в этот файл мы не копируем, иначе вместо карты у нас получится огромная свалка, так не надо.

Как собрать второй мозг в Claude Code, смотрите в отдельной статье.

Для работы с готовыми заметками можно дать такое поручение:

Используйте карту разделов и читайте заметки по задаче. Не копируйте всю базу в индекс. Изменения сначала предложите в ответе; файлы сами не меняйте.

Это просьба агенту, а не настройка прав. Инструменты изменения и удаления остаются доступны; обязательное подтверждение записи от такого поручения не появляется.

Что проверить, если подключение не работает?

  • Клиент не находит uvx. На macOS выполните which uvx и укажите полученный полный путь в command, как советует README.
  • AttributeError с упоминанием list_tools. Сверьте mcp Python SDK: от 1.1.0 до 2.0.0, исключая 2.0.0. Сервер использует обработчики mcp 1.x, удалённые в 2.0.
  • Нет соединения. Проверьте, что тестовое хранилище открыто в Obsidian, Local REST API включён, а ключ, адрес и порт в конфигурации совпадают с настройками.
  • Вместо запуска uvx появился HTTP-адрес /mcp/. Сверьте проект: встроенный MCP плагина и внешний mcp-obsidian подключаются по-разному.

Не отключайте авторизацию ради исправления ошибки. Для дальнейшей отладки у MarkusPfundstein в разделе Debugging описан MCP Inspector. Команда оттуда относится к локальной копии проекта, не к установке опубликованного пакета.

Что вы хотите поручить агенту в своей базе: пересказать запись встречи, найти решения или предложить обновления? Напишите в комментариях в канале.

Частые вопросы

Источники

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Связанные инструкции

OpenCode AGENTS.md: какой инструктаж получил агент - перепроверь сам

OpenCode объединяет найденные AGENTS.md без автоматического разрешения противоречий. Проверьте корневой и вложенный файлы раздельными метками и сравните поведение в текущей и новой сессиях.

8 мин

Codex sandbox: проверьте, какие права вы дали агенту

Codex sandbox ограничивает команды, но запрет внешней записи не доказывает запрет чтения. Проверьте права на искусственных файлах и повторите проверку после перезапуска.

9 мин

Antigravity Skills: не ставьте лишнего - установите навык и проверьте

Для установки навыка в Antigravity скопируйте проверенную папку с SKILL.md в .agents/skills/ тестового проекта. Затем проверьте доступность навыка, чтение инструкций и реальный коммит в истории Git.

7 мин

Голосовой ИИ-агент: поймать квала и передать человеку

Первому голосовому ИИ-агенту поручите определить явный интерес и передать разговор сотруднику. До подключения клиентов проверьте отказы, перебивания и неудачную передачу на внутреннем стенде.

9 мин