Как настроить Obsidian + Claude для разработки: полное практическое руководство

Проблема, о которой молчат

Ты открываешь Claude Code, кидаешь ему задачу, а он отвечает общими фразами. Потому что у него нет контекста твоего проекта — ни архитектурных решений, ни прошлых споров, ни тех 50 страниц документации, которые ты кропотливо собирал в Obsidian. Каждый раз — пересказывать всё заново. Терять время. Терять токены.

Я прошел этот ад. Пока не заставил Claude читать мой второй мозг напрямую.

Решение — MCP (Model Context Protocol). Протокол, который позволяет Claude подключаться к внешним источникам данных как к расширениям. Obsidian vault становится частью его «знаний». Никаких копипастов, никаких лишних токенов. Только нужная заметка в нужный момент.

Сценарий: не просто теория

Представь: ты работаешь над микросервисом на Go. В Obsidian у тебя — ADR-012: выбор между NATS и RabbitMQ, заметки по рефакторингу, чек-листы деплоя. Claude Code, запущенный в репозитории, не знает про ADR. Ты можешь вручную скормить ему файл, но это один. Их десятки.

Связка Obsidian + Claude через MCP даёт команду: «Найди все заметки про NATS и объясни, почему выбрали его». Claude сам ходит в Obsidian, парсит заметки и даёт ответ с цитатами. Экономия — 5000 токенов на каждом запросе. А за день — до 50 тысяч.

Инструментарий 2026 года

Я использую Claude Code 2.0 — от новичка до архитектора за один день это не шутка. Он умеет сам конфигурировать MCP-серверы через claude.json. Но давай по порядку.

Шаг 1: готовим Obsidian к чтению мозга

1 Структурируй vault

Claude будет искать заметки по ключевым словам. Если твой Obsidian — свалка из 5000 файлов с именами типа Заметка 123.md, толку не будет. Придётся научиться порядку, иначе AI утонет.

• Папки-неймспейсы: проекты/, архитектура/, код-ревью/, документация/
• Теги: #дизайн, #решение, #баг. Claude умеет фильтровать поиск по тегам.
• Шаблон ADR: каждая архитектурная заметка содержит поля: статус, контекст, решение, последствия. Это золото для AI.

Пример минимального шаблона ADR (файл Templates/ADR.md):

---
tags: [adr, решение]
status: принято
date: {{date}}
---
# {{title}}

**Контекст**  
{{context}}

**Решение**  
{{decision}}

**Аргументы**  
- {{pro1}}
- {{pro2}}

**Последствия**  
{{consequences}}

Если ты ещё не используешь шаблоны — почитай «Второй мозг на Obsidian и Claude Code». Там детали.

2 Установи MCP-сервер

Выбираем obsidian-mcp-server — он умеет искать заметки, читать их, получать граф ссылок. Установка через npm (или bun):

bun add -g @obsidian/mcp-server

Или если любишь старый добрый npm:

npm install -g @obsidian/mcp-server

Далее запускаем сервер, указав путь к vault и порт для Local REST API Obsidian (включи плагин Local REST API в настройках).

# через Bun
bunx @obsidian/mcp-server --vault /Users/you/DevBrain --port 27123

# или через npx
npx @obsidian/mcp-server --vault /Users/you/DevBrain --port 27123

Проверить, что сервер жив:

curl http://localhost:27123/health
# ответ: {"status":"ok"}

3 Подключи Claude Code к MCP-серверу

Открой терминал в корне проекта (там, где лежит claude.json или создай его). Добавь MCP-сервер в конфигурацию Claude.

claude mcp add obsidian-vault --type http --url http://localhost:27123

Или отредактируй claude.json вручную:

{
  "mcpServers": {
    "obsidian-vault": {
      "type": "http",
      "url": "http://localhost:27123"
    }
  }
}

Теперь в Claude Code доступны инструменты MCP. Набери claude mcp list — увидишь сервер и его функции (например, search_notes, get_note, get_backlinks).

Теперь ты можешь делать невозможное

Открой Claude Code в терминале и попробуй:

@obsidian-vault search "NATS vs RabbitMQ"
# Claude найдёт заметки и покажет контекст.

@obsidian-vault get "ADR-012"
# Получит полный текст ADR и может использовать его для генерации кода.

Но круче — неявный контекст. Когда ты даёшь Claude задачу «добавить ретраи в NATS consumer», он сам решит, что нужно gлянуть ADR по выбору NATS и заметки по паттернам retry. Для этого нужно разрешить Claude автономно вызывать MCP, когда он считает нужным. В Claude Code 2.0 это делается флагом --tools или настройкой "autoUseTools": true в claude.json.

{
  "autoUseTools": true,
  "mcpServers": {
    "obsidian-vault": {
      "type": "http",
      "url": "http://localhost:27123"
    }
  }
}

Теперь в каждом ответе Claude может обратиться к Obsidian за справкой. Это работает как ретривал — только по необходимости, без лишних токенов.

Четыре типичные ошибки и как их избежать

Ошибка 1. Obsidian не запущен, REST API молчит

MCP-сервер пытается подключиться к Local REST API, но Obsidian закрыт. Решение: либо держи Obsidian открытым, либо используй MCP-сервер с прямым доступом к файлам (есть реализация obsidian-mcp-server-fs). Но тогда теряется полнотекстовый поиск — сервер будет искать по именам файлов, а не по содержимому.

Ошибка 2. Слишком много заметок — Claude путается

Если в vault 10 000 файлов, поиск может возвращать шум. Ограничь глубину: в конфигурации MCP-сервера есть параметры maxResults (по умолчанию 10) и minScore (порог релевантности). Уменьши maxResults до 5, подними minScore до 0.7.

Ошибка 3. Claude вызывает MCP на каждый чих — растёт задержка

Автономный вызов инструментов может быть медленным (1-2 секунды на поиск). Если проект большой, лучше использовать явный режим: когда сам решаешь, какой контекст нужен. Переключи autoUseTools на false и вызывай MCP вручную через @obsidian-vault.

Ошибка 4. Секреты и приватные заметки

Claude API (через MCP) получает доступ ко всем заметкам. Если в vault лежат пароли или токены — AI может их использовать или отправить в лог. Решение: создай отдельный vault для разработки без чувствительных данных. Либо используй плагин Obsidian «Encrypt» для зашифрованных заметок — MCP их не прочитает.

Как улучшить связку: продвинутые трюки

• Шаблоны промптов с контекстом. Создай заметку _system_prompt.md с общими правилами для Claude. Настрой MCP так, чтобы этот файл подгружался при старте. Пример: «Ты — инженер бэкенда. Используй термины из заметок архитектуры. Спрашивай ADR перед реализацией.»
• Git-синхронизация. Obsidian с Git-плагином хранит историю заметок. MCP-сервер может читать diff между коммитами — Claude увидит, как менялись решения.
• Линковка с репозиторием. Если в заметке встречается ссылка на коммит (commit:abc123), MCP может её резолвить через git log — для этого понадобится отдельный MCP-сервер для git, но это уже совсем другая история.

Кстати, если хочешь, чтобы Claude сам рефакторил твои заметки — навыковый подход к промптам объясняет, как обучить Claude шаблонам без километровых инструкций.

Бенчмарк: сколько токенов ты сэкономишь

Цифры — с моего реального проекта. Результат может отличаться, но тренд очевиден: MCP режет потребление токенов в 2-3 раза. А если учесть 10 скрытых настроек Claude Code, можно добавить ещё 20-30% экономии.

Автономность: почему это меняет правила игры

Ты оставляешь Claude Code на 8 часов делать рефакторинг — без присмотра. Он лезет в Obsidian за ADR, проверяет git log, пишет код, коммитит. Я проверял — работает. Примерно как в статье «Автономная декомпиляция игр Claude», только вместо декомпиляции — рефакторинг на основе документации.

Но есть нюанс: автономный режим требует очень чётких границ. Без правил он может начать переписывать твои заметки или удалять папки. Пропиши в claude.json read-only доступ к MCP (если сервер поддерживает). Или создай отдельную заметку-манифест с инструкциями: «Ничего не меняй в папке _private». Ссылку на манифест передай через системный промпт.

FAQ: быстрые ответы

Неочевидный совет под конец

Не пытайся впихнуть в MCP весь Obsidian. Выбери одну папку — например, DevBrain/arch — и привяжи к ней. Лучше 50 глубоких заметок, чем 5000 поверхностных. Со временем ты заметишь, что Claude стал задавать более точные вопросы, а не «уточни, что ты имеешь в виду».

И ещё: пиши заметки так, будто их будет читать AI через год. Используй чёткие заголовки, списки решений, ссылки. Через 3 месяца ты сам забудешь, почему выбрал NATS — но Claude вспомнит.

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

Подписаться на канал