Если агент умеет читать вашу папку Markdown, проверьте, нужен ли дополнительный сервер вообще. Решили подключить Obsidian MCP - начните с тестового хранилища и проверьте чтение выбранной заметки.
Но на самом деле, мы можем работать вообще без Obsidian. В моей базе документы связаны вики-ссылками: когда ИИ нужна информация, он идёт из одного документа в другой и собирает нужное по задаче, а не всё, что лежит в папке.
Нужен ли MCP, если агент уже читает Markdown?
Для работы со своей базой мы просто указываем агенту, где она лежит.
Если у вашего агента есть файловый инструмент и доступ к папке, дайте путь к заметке и попросите вернуть содержимое. Сверьте результат с файлом.
Для MCP-подключения выберите конкретный сервер. Сервер MarkusPfundstein позволяет поручить агенту пересказать запись встречи или найти упоминания темы.
С общей базой работают разные модели, ничего не приходится копировать из чата в чат. Без приложения Obsidian тоже можно работать через MCP: сервер Nate Strong читает папку напрямую.
Разборы работы ИИ-агентов с базой знаний я выкладываю в канале:
Какой именно Obsidian MCP вы подключаете?
Сверьте автора и название пакета: похожее имя может означать другой проект и другие настройки.
| Автор и проект | Откуда заметки / нужен ли Obsidian | Конфигурация | Операции и границы |
|---|---|---|---|
| MarkusPfundstein/mcp-obsidian | Local REST API в работающем Obsidian | stdio, uvx mcp-obsidian; OBSIDIAN_API_KEY, OBSIDIAN_HOST, OBSIDIAN_PORT | Чтение, поиск, изменение, удаление. Путь в поручении не ограничивает права |
| Leonezz/obsidian-mcp-server | MCP-плагин внутри работающего Obsidian | Streamable 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 по внешнему пути | Отказ без текста файла | Ответ и уровень отказа |
| Новое чтение после отключения | Нет нового содержимого через связку | Ошибку либо отсутствие инструмента |
Если вы собираете свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.
По результатам решите, нужно ли подключение дальше. Ненужные MCP выключайте.
Кстати, я снял ролик «Полная схема по 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. Команда оттуда относится к локальной копии проекта, не к установке опубликованного пакета.
Что вы хотите поручить агенту в своей базе: пересказать запись встречи, найти решения или предложить обновления? Напишите в комментариях в канале.
Частые вопросы
Источники
- MarkusPfundstein: mcp-obsidian - требования, конфигурация Claude Desktop, инструменты и отладка.
- Local REST API: документация плагина - API-ключ, операции с файлами и встроенный MCP.
- Leonezz: obsidian-mcp-server - отдельный MCP-плагин и заявленные исключения доступа.
- Nate Strong: пакет obsidian-mcp - файловый доступ без запущенного Obsidian и OBSIDIAN_VAULT_PATH.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

