Плагин для Obsidian · 0.5.0

Ваши заметки для Claude Code

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

Установить Подключить агента

Obsidian 1.11.4+ Только компьютер Только локально, по токену

claude · obsigate-notes

Пример сессии, ответы условные

Подключение одной командой

Собирать команду руками не придётся. Откройте в настройках плагина «Подключить агента», выберите Claude Code, Codex CLI или GigaCode CLI и нажмите «Копировать»: имя сервера, порт и токен уже на своих местах. Останется вставить команду в терминал.

Та же кнопка есть в палитре команд и в меню строки состояния. Вот как выглядит команда для хранилища notes.

Что может агент

Агенту не нужно угадывать по именам файлов. Он видит хранилище так же, как вы в Obsidian: с тегами, ссылками, свойствами и заметкой, которая открыта прямо сейчас. Всего 26 инструментов. Их описания написаны на английском, потому что читает их модель.

Обзор 4

vault_infoсколько заметок, папок и вложений
list_notesзаметки папки, постранично
list_foldersвсе папки
get_recent_notesнедавно изменённые

Чтение 4

read_noteзаметка целиком или диапазон строк
read_multiple_notesдо 20 заметок за раз
get_active_noteзаметка, открытая сейчас
get_note_outlineзаголовки с номерами строк

Поиск и теги 3

search_notesпо словам, с фильтром по папке и тегу
list_tagsвсе теги со счётчиками
search_by_tagзаметки с тегом и подтегами

Ссылки и свойства 4

get_backlinksкто ссылается на заметку
get_outgoing_linksссылки из заметки
get_frontmatterсвойства в JSON
set_frontmatterизменить одно свойство

Запись 7

create_note, create_folderсоздать
append_note, patch_noteдописать или заменить фрагмент
insert_under_headingвставить в конец раздела
rename_noteObsidian сам поправит ссылки
delete_noteв корзину хранилища

Obsidian 4

get_daily_noteежедневная заметка за дату
open_noteоткрыть заметку в окне
list_commands, execute_commandкоманды палитры, выключены по умолчанию

Что агенту можно, а что нет

Только этот компьютер

Сервер отвечает только программам на вашем компьютере (адрес 127.0.0.1) и в сеть не выходит. Сайт, открытый в браузере, до него тоже не достучится: запросы с чужим Host или Origin сервер отклоняет.

Токен в защищённом хранилище

Токен, ключ доступа к серверу, создаётся сам при первом запуске. Он хранится в хранилище секретов Obsidian, которое шифрует система, и не попадает ни в data.json, ни в синхронизацию. Вместе с заметками в облако он не уедет.

Только заметки

За пределы хранилища, в папку .obsidian и в корзину агенту хода нет: абсолютные пути и .. не пройдут. Создавать и переименовывать он может только файлы .md.

Режим «только чтение»

Хотите, чтобы агент только читал? Включите этот режим в настройках. Инструменты записи тогда вообще не регистрируются, и агент о них не узнает. Перезапускать сервер не нужно.

Команды по списку

Запускать команды Obsidian агент по умолчанию не может. Если это нужно, включите и разрешите только те команды, которым доверяете, перечислив их id.

Правки через Obsidian

Агент правит заметки через сам Obsidian, как если бы вы печатали руками. Поиск и ссылки обновляются сразу, открытая у вас заметка не расходится с файлом, а удалённое можно достать из корзины.

Установка

Плагина пока нет в каталоге Obsidian, поэтому его ставят вручную, это пара минут. Нужен компьютер: на телефоне Obsidian не может запустить сервер.

Скачать Obsigate 0.5.0

zip · 172 КБObsidian 1.11.4+Только компьютер

Или по файлам: main.js · manifest.json

SHA-256 архива: d8e62ba7e5cfad8f9e12c13122722866f0846174f9b60af2d14ee0748267ad00

Скачайте архив кнопкой выше.
Распакуйте его в папку .obsidian/plugins/ внутри хранилища: появится папка obsigate с файлами плагина. Папку .obsidian не видно в Obsidian, откройте хранилище в проводнике.
Включите плагин в «Настройки → Сторонние плагины». Сервер запустится сам, в строке состояния появится Obsigate :22422.
Подключите агента: скопируйте команду из настроек плагина и выполните её в терминале. В Claude Code команда /mcp покажет, что сервер на связи.

Если у вас открыто несколько хранилищ, у каждого будет свой порт и своё имя сервера. Имя берётся из названия хранилища: «Мои заметки» превратится в obsigate-moi-zametki.

Вопросы

Зачем плагин, если агент может читать файлы напрямую?

Напрямую агент видит просто папку с файлами. Он не знает про теги, обратные ссылки и свойства, а переименовав файл, оставит за собой сломанные ссылки. Через Obsigate он работает с хранилищем так же, как Obsidian: при переименовании ссылки поправятся, удалённое уйдёт в корзину, а открытая у вас заметка не разойдётся с диском.

Чем Obsigate отличается от MCP-сервера TaskFlow?

Obsigate отвечает за заметки: найти, прочитать, связать, поправить текст. TaskFlow отвечает за задачи: статусы, сроки, подзадачи и учёт времени. У них разные порты и токены, и к одному агенту можно подключить оба.

Большая заметка не поместится в ответ?

Поместится, только по частям. Один ответ ограничен 60 000 символов: длинная заметка придёт обрезанной, а в последней строке будет сказано, с какой строки читать дальше. Списки и результаты поиска тоже приходят по страницам.

Хранилище синхронизируется на другой компьютер. Токен тот же?

Нет. Хранилище секретов не синхронизируется, поэтому на втором компьютере у того же хранилища будет свой токен. Агентов там подключайте командой из настроек плагина на этом компьютере, в ней уже будет нужный токен.

Порт занят, что делать?

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