1. Obsidian MCP 개요

이 문서는 <MCP Obsidian 연동 방법>에 관해 기록하는 문서입니다.
옵시디언에 MCP(Model Context Protocol)를 적용하면 문서를 자동으로 생성할 수 있습니다.
이 글에서는 mcp-obsidian, obsidian-mcp 설정 과정을 다룹니다.

2. 내용

2.1. Obsidian 볼트 만들기

저의 경우에 구글 드라이브 위치인 C:\Users\msm25\내 드라이브 위치에 다음과 같이 볼트를 만들었습니다.

다음과 같이 볼트가 생긴 것을 확인할 수 있습니다.

2.2. Obsidian 플러그인 설치

2.2.1. 커뮤니티 플러그인 활성화

ctrl + , 키를 눌러서 설정창 열기

Turn on community plugins 버튼 클릭

Browse 버튼 클릭하여 플러그인 검색하기

2.2.2. Local REST API 플러그인 설치

Local REST API 검색

Install 및 Enable 클릭

Options 클릭하면 다음과 같이 Local API Key가 나오는 것을 확인할 수 있음

2.2.3. MCP Tools 플러그인 설치

MCP Tools 검색 후 Install 및 Enable 클릭

Options 클릭

위 과정에서 Local REST API를 설치했다면 위와같이 연동되는 것을 확인할 수 있음

Install server 버튼 클릭하여 설치

만약 설치 안되면 Obsidian 재실행 후 다시 클릭하면 설치됩니다.

우측 상단에 MCP server를 다운로드하고 완료되면 다음과 같이 버전이 뜹니다.

2.3. Powershell로 uv 설치

2.3.1. 기존 uv 삭제

만약 기존 uv가 설치되어있다면 다음의 과정으로 삭제한 후 실행하면 정상적으로 설치됩니다.

우선 uv.exe 파일이 어디에 위치해있는지를 찾습니다.

Get-Command uv

다음의 명령어로 파일을 삭제합니다.
경로로 들어가 파일을 직접 삭제해도 됩니다.

Remove-Item "C:\Users\msm25\.local\bin\uv.exe"

캐시도 정리해줍니다.

Remove-Item "$env:USERPROFILE\.cache\uv" -Recurse -Force -ErrorAction SilentlyContinue

2.3.2. uv 설치

uv 설치 명령어는 여기에 나와있습니다.

파워셸 실행하여 다음과 같이 입력

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

다음과 같이 정상적으로 설치되는 것을 확인할 수 있습니다.

2.4. Claude 데스크탑 설치(생략)

2.5. Python 3.10 이상 설치(생략)

커맨드 창에 python --version 을 입력했을 때 다음과 같이 버전이 뜨면 설치된 것입니다.

설치 했는데 python 실행이 되지 않는다면 환경 변수를 점검해보세요.

2.6. Claude mcp 설정

ctrl + , 키를 눌러서 설정 창을 엽니다.

좌측에 개발자 탭을 선택하면 다음과 같이 obsidian-mcp-tools 셋팅이 되어있는 것을 확인할 수 있습니다.

설정 편집 버튼을 claude_desktop_config.json 파일을 메모장 같은 편집기로 열어서 잘 설정되어 있는지 확인합니다.

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "C:\\Users\\user\\내 드라이브\\01_AI_Work\\.obsidian\\plugins\\mcp-tools\\bin\\mcp-server.exe",
      "env": {
        "OBSIDIAN_API_KEY": "34fda4d90cea523d96ac12ba4f1de0a1df28632570ae7d785cf94b40295b6894"
      }
    }
  }
}

이렇게 설정한 후 reload하기 위해 클로드를 한번 껐다가 켜줘야 합니다. 백그라운드에서 돌고 있는 클로드를 끄기 위해서는 다음과 같이 종료했다가 재실행해야 합니다.