Claude Code + Obsidian: MCP-сервер не нужен. И три мифа из рунета
Хранилище Obsidian — это просто папка с .md-файлами. Claude Code читает и пишет файлы сам. Разбор трёх ошибок, которые кочуют по статьям.
Связку «Claude Code + Obsidian» я использую каждый день: агент читает и пополняет мою базу знаний по проектам. Когда я стал искать, что об этом уже написано, нашёл статью-первоисточник, на которую ссылается половина рунета. В ней три фактические ошибки.
Главный тезис: MCP-сервер здесь лишний
Хранилище Obsidian — это просто папка с .md-файлами. Claude Code читает и пишет файлы в каталоге запуска и так, без всяких прослоек.
MCP-сервер нужен Claude Desktop, ChatGPT и Cursor — у них нет прямого файлового доступа. Для Claude Code это лишний слой, который добавляет точку отказа и ничего не даёт.
Три мифа, которые я проверил
Миф 1: ставьте @modelcontextprotocol/server-obsidian.
Такого пакета не существует. npm view возвращает 404. Рабочий вариант — obsidian-mcp (StevenStavrakis, MIT), если MCP вам всё-таки нужен.
Миф 2: MCP-серверы прописываются в ~/.claude/settings.json.
Нет. Правильный путь — команда claude mcp add, а конфигурация ложится в ~/.claude.json (user-скоуп) либо в .mcp.json рядом с проектом. Скоупы: local по умолчанию, project, user.
Миф 3: спрятать личное можно через .claudeignore.
Claude Code молча игнорирует этот файл. Ограничить доступ можно только через permissions.deny в .claude/settings.json. Это самая опасная из трёх ошибок: человек думает, что закрыл личные заметки, а они открыты.
Как проверять такие вещи
Проверка каждого мифа заняла минуту: npm view <пакет> version и официальная документация. Я взял за правило сверять факты по npm и докам, а не по статьям — ошибка из одной популярной статьи расходится по десяткам пересказов и живёт годами.
Побочный эффект оказался приятным: разбор чужих ошибок сам по себе стал самой сильной частью материала. Пересказать документацию может каждый; сказать, где именно все ошибаются, — нет.