Как подключить Obsidian к YouMind с помощью MCP
Ваше хранилище Obsidian, вероятно, уже содержит всё необходимое для следующего проекта: исследования, планы, заметки о прочитанном и незавершённые задачи. Подключив его к YouMind, вы сможете превратить эти заметки в нечто полезное с помощью запроса на естественном языке.
В этом руководстве вы подключите локальное хранилище Obsidian к YouMind, попросите YouMind прочитать и организовать набор заметок, а затем сохраните результат обратно в Obsidian. В примере используются пять заметок о противовоспалительном питании для создания плана действий со ссылками на исходные источники.
Перед началом работы
Вам понадобится:
- Десктопная версия Obsidian и хранилище, которое вы можете редактировать.
- Учётная запись YouMind с доступом к пользовательским коннекторам.
- Учётная запись ngrok. Мы будем использовать ngrok, чтобы предоставить вашему локальному MCP-серверу HTTPS-адрес, доступный для YouMind.
- Несколько заметок для работы. Вы можете использовать свои собственные исследования, проектные заметки или заметки по планированию питания.
Соединение работает следующим образом:
YouMind → HTTPS-адрес ngrok → MCP Коннектор → ваше хранилище Obsidian
MCP (Model Context Protocol) позволяет AI-приложению использовать инструменты, предоставляемые другим приложением. Плагин Obsidian предоставляет инструменты для работы с вашим хранилищем, а YouMind использует их для выполнения вашего запроса.
Держите ваш компьютер включённым и подключённым к интернету, а Obsidian, подключённое хранилище и ngrok — запущенными, когда вы используете это соединение. Локальный адрес 127.0.0.1 указывает только на ваш собственный компьютер, поэтому YouMind нужен адрес ngrok для доступа к нему.
Коннектор может читать или изменять заметки в соответствии с предоставленными вами разрешениями. Храните его токен в тайне и используйте настройки разрешений инструментов плагина и скрытых папок для контроля доступа. Контент, используемый в задаче, проходит через ngrok и YouMind; подключение хранилища не означает автоматическую синхронизацию всего хранилища.
Скриншоты показывают рабочий процесс на macOS. Некоторые детали учётной записи были удалены или заменены на примеры значений.
1. Разрешите сторонние плагины в Obsidian
Откройте Настройки → Сторонние плагины в Obsidian.
Если ваше хранилище находится в ограниченном режиме, нажмите Выйти из ограниченного режима, чтобы разрешить сторонние плагины.
Нажмите Обзор, чтобы открыть каталог сторонних плагинов.
2. Установите и включите MCP Connector
Найдите MCP Connector и выберите плагин от istefox. Проверьте имя автора, так как в каталоге есть плагины с похожими названиями.
Откройте его подробности и нажмите Установить.
После установки нажмите Включить.
Откройте MCP Connector в настройках Obsidian, чтобы настроить его локальный сервер и токен доступа. Дополнительную информацию можно найти на странице плагина в каталоге.
3. Установите фиксированный порт сервера
Найдите Фиксированный порт, введите 27200 и нажмите Сохранить.
В разделе Порт сервера теперь должно отображаться:
http://127.0.0.1:27200/mcp
Фиксированный порт гарантирует, что ваше соединение ngrok будет указывать на один и тот же локальный сервис. Если порт 27200 уже занят, выберите доступный порт и используйте этот номер в команде ngrok ниже.
4. Создайте токен для YouMind
В разделе Контроль доступа нажмите Добавить токен.
Назовите новый токен YouMind, чтобы вы могли узнать его позже.
Нажмите Копировать в строке этого токена. Вы вставите его в YouMind на следующем шаге.
Каждый токен может иметь свои собственные разрешения на инструменты. Для этого примера требуется разрешение на чтение заметок и создание новой заметки. На скриншотах используется конфигурация плагина Все 52 инструмента; количество доступных инструментов может меняться в зависимости от версии плагина и ваших настроек.
Относитесь к токену как к паролю для предоставляемого им доступа. Вам не нужно вставлять его в AI-чат.
5. Запустите туннель ngrok
Если вы ещё не установили ngrok, следуйте официальной инструкции по установке. На macOS, если вы уже используете Homebrew, установите его с помощью:
brew install ngrok
Добавьте authtoken из панели управления ngrok:
ngrok config add-authtoken YOUR_NGROK_AUTHTOKEN
Authtoken ngrok подключает ngrok к вашей учётной записи. Токен Obsidian из предыдущего шага предоставляет YouMind доступ к вашему хранилищу. Храните эти два учётных данных отдельно.
В терминале выполните:
ngrok httphttp://127.0.0.1:27200
Оставьте этот сеанс терминала запущенным. Как только Session Status покажет online, скопируйте HTTPS-адрес, отображаемый в строке Forwarding.
Добавьте /mcp в конец этого адреса. Ваш конечный URL коннектора должен иметь следующую структуру:
https://YOUR_NGROK_DOMAIN/mcp
Используйте фактический домен, отображаемый в вашем собственном сеансе ngrok. Домен на скриншоте является примером. Если ваш адрес пересылки изменится позже, обновите сохранённый адрес в YouMind.
6. Добавьте пользовательский коннектор в YouMind
В YouMind откройте Настройки → Коннекторы и нажмите Добавить пользовательский коннектор.
Введите имя, например obsidian, и вставьте ваш адрес ngrok с /mcp в конце. Разверните Расширенные настройки. В разделе Пользовательские параметры нажмите Добавить параметр и настройте следующее:
Настройка | Значение |
|---|---|
Имя |
|
URL сервера | Ваш HTTPS-адрес ngrok, за которым следует |
OAuth Client ID | Оставьте пустым |
OAuth Client Secret | Оставьте пустым |
Пользовательский параметр |
|
Значение параметра |
|
Секретный | Вкл. |
Замените YOUR_OBSIDIAN_TOKEN на полный токен, скопированный вами из Obsidian. Включите пробел после **Bearer**. Например, если бы ваш токен был example-token, значение было бы:
Bearer example-token
Это всего лишь пример формата. Используйте свой собственный токен в фактической конфигурации. Это соединение использует аутентификацию Bearer Token, поэтому оставьте два поля OAuth пустыми.
Нажмите Добавить, затем найдите obsidian в списке коннекторов и нажмите Подключиться.
Рядом с его именем должно появиться сообщение Подключено.
Теперь давайте проверим соединение с помощью задачи, которая читает заметки и создаёт новую.
7. Подготовьте несколько связанных заметок
YouMind нужно реальное содержимое для работы. В этом примере хранилище содержит пять заметок на английском языке:
Заметка | Что содержит |
|---|---|
Anti-Inflammatory Eating Basics | Общие принципы питания и цели на первую неделю |
Anti-Inflammatory Grocery List | Список покупок и замена ингредиентов |
7-Day Anti-Inflammatory Meal Plan | Неделя завтраков, обедов и ужинов |
Simple Anti-Inflammatory Meal Prep | Этапы подготовки, простые рецепты и заметки по хранению |
Anti-Inflammatory Weekly Review | Шаблон обзора и незавершённые последующие задачи |
Эти заметки являются примером материала для демонстрации рабочего процесса. Они не являются персонализированным медицинским или диетологическим планом.
Вы можете использовать другую тему. Например, объедините заметки о прочитанном в учебное пособие, превратите проектные заметки в список следующих шагов или организуйте туристические исследования в маршрут. Обновите тему в запросе в соответствии с заметками в вашем хранилище.
8. Попросите YouMind прочитать, организовать и сохранить
Начните новую задачу в YouMind и введите:
Просмотри мои заметки Obsidian о противовоспалительном питании. Обобщи ключевые принципы, свяжи список покупок с планом питания и определи три незавершённые задачи.
Сохрани результат на английском языке как новую заметку Obsidian с заголовком "Anti-Inflammatory Eating Action Plan", содержащую внутренние ссылки на исходные заметки.
Запрос сообщает YouMind, какие заметки читать, как организовать информацию, какие задачи определить и куда сохранить результат. Он также называет новую заметку и просит ссылки на источники, что упрощает проверку результата.
Отправьте задачу. YouMind использует коннектор для поиска и чтения соответствующих заметок, а затем собирает результат. Вы можете следить за его прогрессом в диалоге.
9. Откройте новую заметку в Obsidian
В этом примере YouMind вернул:
- Обобщение принципов из вводной заметки.
- Связи между списком покупок и планом питания, включая то, какие ингредиенты используются в нескольких блюдах.
- Три незавершённые задачи: спланировать поход за покупками, выбрать обеды и сеансы подготовки, а затем провести обзор.
- Новая заметка с заголовком Anti-Inflammatory Eating Action Plan, содержащая внутренние ссылки на исходные пять заметок.
Все задачи выполнены относится к задаче YouMind по чтению, организации и записи. Покупки и приготовление еды остаются последующими действиями для человека, использующего план.
Переключитесь обратно в Obsidian и откройте Anti-Inflammatory Eating Action Plan.
Новая заметка появляется в списке файлов, а её содержимое сохраняется в вашем хранилище. В этом запуске она также включает теги и кликабельные ссылки на исходные заметки. Представление графа показывает эти связи рядом с существующими заметками.
Теперь вы можете продолжить редактирование в Obsidian или попросить YouMind продолжить с более конкретным запросом, например, расширить раздел или обновить план, используя другую заметку.
Устранение неполадок
Почему я вижу 401 Unauthorized?
Проверьте параметр Authorization. Его значение должно быть Bearer, за которым следует один пробел и ваш полный токен Obsidian. Убедитесь, что вы скопировали токен из MCP Connector. Если вы перегенерировали или отозвали его, обновите значение в YouMind.
Почему я вижу «OAuth authorization server metadata discovery failed (404)»?
Неудачная проверка токена может привести к тому, что клиент попытается выполнить обнаружение OAuth. Это соединение плагина использует Bearer Token, поэтому сначала проверьте заголовок Authorization и оставьте поля OAuth Client ID и Secret пустыми. Отсутствие префикса Bearer может вызвать эту ошибку.
Почему открытие URL /mcp в браузере возвращает 405?
Конечная точка MCP плагина принимает MCP-запросы через POST. Открытие URL в адресной строке браузера обычно отправляет GET, что может вернуть 405 Method Not Allowed. Проверьте соединение через YouMind и фактическую задачу.
Почему работающее соединение перестало отвечать?
Убедитесь, что ваш компьютер включён и находится в сети, в Obsidian открыто правильное хранилище, плагин включён, а ngrok всё ещё показывает online. Затем сравните локальный порт и URL ngrok со значениями, сохранёнными в YouMind.
Что делать, если я не могу найти новую заметку?
Выполните поиск в подключённом хранилище по заголовку, который вы указали в запросе. Проверьте, разрешает ли токен создание заметок. Вы также можете попросить YouMind указать точный путь к файлу относительно хранилища, который он создал, а затем открыть этот путь в Obsidian.
Готовы попробовать с вашими собственными заметками? Откройте YouMind и попросите его превратить несколько связанных заметок в полезную новую страницу в вашем хранилище.