ВойтиПолучить доступ

Настройки Claude Code11 минобновлено

Mcp obsidian

Для mcp obsidian подключи встроенный MCP-сервер плагина Local REST API with MCP: он даёт Claude Code и Codex инструменты поиска и чтения заметок. Отдельный Python-посредник для этого пути не нужен. Начни с копии хранилища и разреши только необходимые операции.

Проверено: 22 октября 2026 года по README Local REST API 5.5.2 и официальной документации клиентов. Конфиги ниже составлены по документам; живое подключение к личному Obsidian и операции с заметками здесь не выполнялись.

Какой mcp obsidian тебе подключать?

Выбери одну реализацию: у серверов с похожими названиями различаются установка, транспорт и инструменты. В этой инструкции основной путь - встроенный сервер Local REST API, работающий внутри настольного Obsidian.

Что ты нашёл Как подключается Что учитывать
Local REST API with MCP Прямой HTTP MCP по адресу https://127.0.0.1:27124/mcp/ Нужны открытый Obsidian, ключ плагина и доверие его сертификату
MarkusPfundstein/mcp-obsidian Локальный Python-процесс uvx mcp-obsidian, который обращается к REST API плагина Другие имена инструментов; в прочитанном коде проверка TLS-сертификата выключена
Agent MCP Плагин с терминалом и контекстом редактора Его getLatestSelection и getOpenEditors не заменяют инструменты поиска по всему vault

Vault - папка твоего хранилища Obsidian. Если задача сводится к оформлению Markdown и работе с файлами, сначала посмотри Obsidian Skills. В этом наборе нет MCP-сервера: скилл объясняет агенту способ работы, а подключение предоставляет вызываемые инструменты.

Не смешивай два маршрута Local REST API: корневой адрес обслуживает REST API, а путь /mcp/ - протокол MCP. Порт 27123 относится к отдельно включаемому незашифрованному HTTP-серверу плагина. В конфигурациях ниже используется HTTPS на 27124.

Как подготовить хранилище и доступ?

Сначала подготовь отдельный vault без секретов, затем включи плагин именно в нём. Общая резервная копия должна оставаться вне папок, доступных агенту.

  1. Сохрани копии существующих .mcp.json, настроек разрешений Claude Code и config.toml Codex. Не заменяй весь файл новым примером: добавляй только нужную секцию.
  2. В настольном Obsidian открой настройки сторонних плагинов, найди Local REST API, сверь репозиторий coddingtonbear/obsidian-local-rest-api и автора Adam Coddington, установи и включи плагин. Для показанного встроенного MCP проверен README релиза 5.5.2; старую версию сначала сверяй с её документацией.
  3. Открой Settings -> Local REST API. Здесь находятся API-ключ и сертификат. Оставь привязку к 127.0.0.1, не открывай порт в интернет.
  4. Настрой доверие локальному центру сертификации плагина в своей ОС или клиенте. Используй сертификат из настроек своего экземпляра; универсальная команда доверия для всех ОС здесь не приводится. Успешное доверие в браузере ещё не доказывает доверие в Claude Code или Codex.
  5. Передай ключ плагина в переменную окружения OBSIDIAN_API_KEY процесса, из которого запускаешь клиента. Это не ключ Anthropic или OpenAI. Не вставляй значение в общий конфиг, Git, переписку или снимок экрана.

Для Bash ключ можно ввести скрытым вводом в текущем терминале:

read -r -s -p 'Ключ Local REST API: ' OBSIDIAN_API_KEY
printf '\n'
export OBSIDIAN_API_KEY

После этого запускай выбранного клиента из того же терминала. Это пример для Bash, не PowerShell; уже работающий процесс в IDE может не получить новую переменную. Команда не выводит ключ, но процесс и его дочерние программы получают доступ к значению.

Для Claude Code укажи сохранённый CA в окружении до запуска. Официальная справка Anthropic описывает переменную NODE_EXTRA_CA_CERTS:

export NODE_EXTRA_CA_CERTS=/path/to/obsidian-local-rest-api.crt

Замени путь своим файлом сертификата из настроек плагина. Не загружай в доверенные случайный сертификат из чужой инструкции.

Для системного доверия в Ubuntu есть отдельный путь. Сначала проверь, что экспортированный CA имеет PEM-формат и расширение .crt. Затем, по инструкции Ubuntu, установи его в системное хранилище:

sudo cp /path/to/obsidian-local-rest-api.crt /usr/local/share/ca-certificates/obsidian-local-rest-api.crt
sudo update-ca-certificates

Это изменение доверенных сертификатов всей ОС, нужны права администратора. Оно подходит только для Ubuntu с ca-certificates, не для Windows или macOS. После него перезапусти Codex и отдельно проверь MCP: импорт в ОС не является результатом проверки конкретного клиента. Для другой ОС используй её порядок установки CA, а не эти команды.

Чтобы отдельно проверить HTTPS без передачи ключа, укажи путь к сохранённому CA плагина:

curl --cacert /path/to/obsidian-local-rest-api.crt https://127.0.0.1:27124/

Замени /path/to/ своим путём. Корневой запрос по документации проверяет доступность сервера без авторизации. Его успех не означает, что MCP подключён или разрешено чтение. Не отключай TLS-проверку глобально ради устранения ошибки сертификата.

Как подключить Obsidian к Claude Code?

Добавь HTTP-сервер в проектный .mcp.json. Переменную ${OBSIDIAN_API_KEY} Claude Code подставляет из окружения; сам секрет остаётся за пределами этого примера.

{
  "mcpServers": {
    "obsidian": {
      "type": "http",
      "url": "https://127.0.0.1:27124/mcp/",
      "headers": {
        "Authorization": "Bearer ${OBSIDIAN_API_KEY}"
      }
    }
  }
}

Если .mcp.json уже содержит серверы, объедини записи внутри mcpServers. Не переноси сюда claude_desktop_config.json: это настройки другого приложения. Общие области подключения разобраны в статье MCP в Claude Code.

У плагина есть инструменты записи и выполнения команд Obsidian. Для первого опыта добавь следующие запреты в существующий объект permissions файла .claude/settings.local.json своего проекта:

{
  "permissions": {
    "deny": [
      "mcp__obsidian__vault_write",
      "mcp__obsidian__vault_append",
      "mcp__obsidian__vault_patch",
      "mcp__obsidian__vault_delete",
      "mcp__obsidian__vault_move",
      "mcp__obsidian__vault_copy",
      "mcp__obsidian__vault_get_upload_url",
      "mcp__obsidian__command_execute"
    ]
  }
}

Не стирай прежние правила. Префикс obsidian соответствует имени сервера в .mcp.json; при другом имени исправь его и в правилах. Список относится к инструментам проверенной версии: расширения плагина могут добавить новые, их нужно оценить отдельно. Оставь подтверждения остальных действий включёнными.

Эти запреты действуют на перечисленные MCP-инструменты: документация Claude Code указывает, что запрещённые инструменты убираются из контекста модели. Экран управления сервером при этом может показывать сведения о них. Запреты не мешают агенту менять файлы через собственную оболочку или файловые инструменты. Поэтому учебная копия и ограничения доступа ОС остаются нужны; ключ плагина не становится ключом только для чтения.

Как подключить тот же vault к Codex?

В Codex добавь отдельную секцию в ~/.codex/config.toml. Для нового подключения начни с разрешённого списка чтения и поиска.

[mcp_servers.obsidian]
url = "https://127.0.0.1:27124/mcp/"
bearer_token_env_var = "OBSIDIAN_API_KEY"
enabled_tools = ["vault_list", "vault_read", "search_simple", "tag_list"]
default_tools_approval_mode = "prompt"

bearer_token_env_var содержит имя переменной, из которой клиент берёт токен. Не заменяй его строкой с ${OBSIDIAN_API_KEY} внутри произвольного TOML: это другой механизм, чем подстановка Claude Code.

Адрес и имена инструментов взяты из README плагина, поля конфигурации - из документации Codex. Здесь не нужны command = "uvx" или аргумент Python-пакета: выбран прямой HTTP MCP. Подробности хранения настроек - в руководстве по MCP в Codex.

Ограничение enabled_tools не запрещает собственные файловые операции Codex. Не запускай агента с доступом ко всем рабочим заметкам, если проверяешь только учебное подключение.

Как проверить, что агент читает нужную заметку?

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

Сначала в своём клиенте посмотри серверы:

claude mcp list
claude mcp get obsidian

Для Codex:

codex mcp list

Затем открой /mcp в интерактивной сессии выбранного клиента. Ожидаешь подключение obsidian без ошибки соединения и инструменты встроенного сервера: vault_list, vault_read, search_simple. У Codex видимый набор ограничен твоим enabled_tools; у Claude Code запреты не обязательно скрывают инструменты из перечня.

Вручную создай в учебном vault файл mcp-check.md с одной строкой:

Контрольная строка: кедр-47

Попроси агента:

Используй только MCP-сервер obsidian, без оболочки и прямого
чтения файлов. Найди mcp-check.md и прочитай его через vault_read.
Верни путь и контрольную строку. Ничего не создавай и не изменяй.

Проверь журнал вызовов клиента: он должен показывать инструмент сервера obsidian, а не обычное чтение файла. Затем сравни путь и строку с оригиналом в Obsidian. Ожидаемый результат - mcp-check.md и кедр-47, без изменений заметки. Это учебный критерий, не результат выполненного здесь теста.

Текстовая просьба не заменяет ограничения доступа. Если клиент предлагает запись или вызов неизвестного инструмента, не подтверждай его автоматически. Успешное чтение также не проверяет запись, поиск по всем форматам или совместимость сторонних расширений.

Чтобы дальше выбирать инструменты и разрешения агента, посмотри состав ClaudeBase. В программе есть уроки о правилах проекта, разрешениях и выборе MCP или CLI. Программу можно посмотреть без оплаты; если подходит, перейди к подписке ClaudeBase. Доступ к базе - после оплаты подписки. Подписки Anthropic и OpenAI оплачиваются отдельно.

Что проверить, если соединение не появилось?

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

Что ты видишь Что проверить Как отличить исправление от видимости успеха
Ошибка сертификата Доверяет ли именно клиент CA выбранного экземпляра Local REST API HTTPS работает без глобального отключения TLS-проверки; затем отдельно проверь MCP
Ошибка авторизации, HTTP 401 Получил ли процесс клиента OBSIDIAN_API_KEY, ключ ли это нужного плагина и vault Соединение проходит авторизацию, затем читается контрольная заметка; ключ не выводи в лог
Отказ соединения или таймаут Открыт ли Obsidian, включён ли плагин, совпадают ли адрес и порт Сервер доступен из той же среды, где работает клиент
Сервер добавлен, инструментов нет Есть ли /mcp/ в HTTP-адресе, настроено ли доверие CA На экране /mcp видно соединение и подходящие инструменты
Ожидаешь obsidian_get_file_contents, видишь vault_read Не смешаны ли Python-сервер Markus и встроенный MCP Имена в задании и разрешениях соответствуют выбранной реализации

127.0.0.1 означает текущую машину или среду процесса. В контейнере, WSL или удалённой сессии это может быть не компьютер с Obsidian. Сначала проверь локальный сценарий; не меняй привязку на 0.0.0.0 ради быстрого доступа к заметкам извне.

Если ты уже используешь Python-пакет Markus, его конфиг не нужно дополнять HTTP-полями из этой инструкции. В прочитанном коде пакета отключена проверка сертификата, а совместимость его PATCH-запроса с Local REST API 5.5.2 вызывает вопросы по коду обеих сторон. Живой сбой записи здесь не воспроизводился. Не проверяй такую запись на единственном экземпляре заметок.

Как отключить подключение и сохранить заметки?

Верни сохранённую конфигурацию клиента или убери только добавленную запись obsidian, затем перезапусти сессию. В Codex можно оставить секцию и добавить enabled = false. Если локальный API больше не нужен другим программам, отключи плагин Local REST API в Obsidian.

Не удаляй vault, чтобы убрать подключение. Если ключ оказался в Git или переписке, замени его в настройках плагина и обнови своё защищённое окружение: удаления сообщения недостаточно. Резервная копия помогает восстановить заметки, но не отменяет уже переданную модели информацию.

Перед работой с основной базой убедись, что клиент читает нужный vault, ограничения соответствуют видимым инструментам, а источник резервной копии ему недоступен. Инструкции внутри заметки не дают агенту разрешения менять файлы или расширять доступ.

Источники

Дата обращения ко всем источникам - 22 октября 2026 года. Проверены документы и код; локальная установка и работа MCP с личными заметками не тестировались.

Спрашивают

Пять вопросов по теме

Нужно ли держать Obsidian открытым?

Да, для встроенного MCP Local REST API настольный Obsidian должен работать, а плагин - быть включён в нужном хранилище. Если закрыть приложение, этот сервер перестанет обслуживать запросы. Это условие выбранного пути, не всех серверов для Markdown-файлов.

Чем MCP отличается от Obsidian Skills?

MCP даёт клиенту вызываемые инструменты сервера, например чтение или поиск заметок. Obsidian Skills - инструкции агенту по форматам и операциям с заметками. Набор скиллов не содержит MCP-сервера и сам по себе не создаёт подключение к Local REST API.

Почему удалённый Codex не видит локальный Obsidian?

Адрес 127.0.0.1 указывает на среду, где работает клиент. Удалённая машина или контейнер обращается к себе, а не к твоему компьютеру. Начни с клиента рядом с Obsidian; сеть WSL и контейнеров проверь отдельно. Не открывай порт хранилища в интернет ради этой проверки.

Как не подключить случайно другое хранилище?

Открой нужный vault и проверь настройки плагина именно в нём. До запроса к агенту создай там заметку с уникальной контрольной строкой. Сверь порт и ключ выбранного экземпляра: чтение правильной строки по известному пути надёжнее одного статуса Connected.

Останутся ли заметки только на моём компьютере?

Локальный сервер не даёт такой гарантии. Текст, который MCP возвращает агенту, становится контекстом выбранной модели и может передаваться её провайдеру. Сначала проверь условия своего клиента и аккаунта, исключи секреты и используй отдельное учебное хранилище.

Источники