Obsidian에 입문한 건축가, 옵시디언과 클로드 MCP 연결하기

소개

시도하고자 했던 것과 그 이유를 알려주세요.

첫째주 스터디 때 Obsidian을 다운로드하여 설치하고, 무작정 스터디 내용을 노트에 기록했습니다. 이제 Obsidian을 사용한 지 1주일도 안 되었지만, 첫 스터디때 이태극 스터디장님께서 유용한 팁을 공유해주셔서 흥미가 생겼고, 매일매일 사용하면서 Obsidian에 빠져들고 있습니다. 브라이언 님께서 공유해주신 영상을 보고, Obsidian과 Claude MCP연결에 대한 내용을 차근차근 기록했습니다. 이번 17기에는 발표전달력 스터디에 참여하면서 개인지식관리에 청강으로 참여하고 있습니다. 아직은 Obsidian 초보 단계지만, 꾸준히 잘 사용해보겠습니다~

진행 방법

어떤 도구를 사용했고, 어떻게 활용하셨나요?

운영체제 : 윈도우

Obsidian

Claude Desktop ver.

UV

.

.

1. UV 설치하기

https://docs.astral.sh/uv/#python-versions

1-01_위 링크에 접속하면 아래와 같은 화면이 나타납니다.

보라색 배경이있는 보라색 화면의 스크린 샷

.

.

1-02_화면을 좀 위로 올려서 Installation / window탭 클릭하고 아래 내용을 복사

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

프로그램 설치를 보여주는 웹 페이지의 스크린 샷

.

.

1-03_복사된 내용을 파워셀에 붙여넣기.

한국 컴퓨터에서 PowerPoint 앱의 스크린 샷
Windows 10에서 명령 프롬프트의 스크린 샷
Windows 10에서 파이썬 스크립트의 스크린 샷
Windows 10에서 명령 프롬프트의 스크린 샷
한국어가있는 Windows 10 컴퓨터의 스크린 샷

1-04_필요시 Powershell에 $env:PATH += ";C:\Users\User\.local\bin"

위 명령어 한 번 더 입력할 것.

저는 입력하지 않아도 문제 없었습니다.

.

.

2. Obsidian MCP 다운받기

https://github.com/MarkusPfundstein/mcp-obsidian

2-01_ 위 링크에 접속

- code 탭을 클릭한 뒤 맨 아래 zip파일 다운로드

사람들 그룹을 보여주는 웹 페이지의 스크린 샷

파일 및 폴더 목록이있는 페이지의 스크린 샷

2-02_zip파일 압축해제 후 옵시디언 경로안의 폴더에 복사 (mcp-obsidian-main 이라는 폴더)

- 볼트 위치 확인필요시 : 옵시디언 (윈도우)Ctrl+P 눌러서 "탐색기" or "System Explorer"로 검색

- 설치폴더를 "C:\Users\User\Documents\Obsidian Vault"로 설정했음. 각자 위치가 상이할 수 있음.

- 해당 폴더에 "mcp-obsidian-main 이라는 폴더"를 붙여넣기

컴퓨터의 파일 및 폴더 목록

.

.

3. Obsidian에 Local REST 플러그인 설치

3-01_왼쪽 하단 톱니바퀴모양 클릭한 후 Community Plugins 클릭후 탐색버튼을 누르고

: "Local rest api" 검색하여 설치

Gmail에서 메일 설정의 스크린 샷
컴퓨터의 설정 메뉴의 스크린 샷
한국 앱의 스크린 샷

.

.

3-02_옵션버튼을 누르면 API Key를 확인할 수 있음.

- 설치후 API Key : 추후 연결시 필요.

로컬 REST API에 액세스하는 방법

.

.

4.Claude Desktop 설정

4-01_Claude Desktop 개발자/설정에서 Claude_desktop_config.json 파일 편집

- "Ctrl+,"(파일-설정) 단축키 누른 후 개발자 / 설정에 접속하여

Claude_desktop_config.json 파일 편집

한국 키보드 - 스크린 샷 1

.

.

4-02_Claude_desktop_config.json 파일 편집

브라이언님의 링크 참조 : 링크

브라우저에서 CSS 파일의 스크린 샷

.

.

4-03_위 이미지에서 command 경로와 OBSIDIAN_API_KEY 를 수정해야 함.

4-04_command 경로는 Powershell에서 "where.exe uv"라고 명령어를 입력하면 경로를 찾을 수 있음.

Windows 10 명령 프롬프트의 스크린 샷
Windows 10에서 명령 프롬프트의 스크린 샷

.

.

4-05_OBSIDIAN_API_KEY : Local REST 플러그인에 나와 있는 API KEY 입력

: 위 3-02 내용 참고 (커뮤니티 플러그인 Local REST API 설치후 옵션버튼 클릭 / API 복사)

한국 앱의 스크린 샷
로컬 REST API에 액세스하는 방법

4-06_"Ctrl+,"(파일-설정) 단축키 누른 후 개발자 / 설정에 접속하여 mcp-obsidian을 클릭하여 running이라고 표시되는지 확인

한국어 메뉴의 스크린 샷
한국어 텍스트가있는 앱의 스크린 샷

.

.

4-07_대화창 아래 '+'의 오른쪽에 있는 버튼을 누르면 맨 아래 mcp-obsidian 이 설치된 것을 확인할 수 있습니다. 매번 어렵게 설치하고, 그 뒤에 설치방법을 알 수 없었지만, 이번에는 설치과정을 사례글로 남기면서 기록해봤습니다.

.

.

결과와 배운 점

MCP연결을 초보자가 혼자 수행하기는 너무 어렵습니다.

지난 16기때도 토요일 오프모임때 이모카 님의 도움으로 노션-클로드 MCP를 어렵게 연결했고,

이번 17기때도 브라이언 님의 도움으로 옵시디언-클로드 MCP를 어렵게 연결했기에,

초보분들에게 도움이 되었으면 하는 바람으로 MCP연결과정을 사례글로 남깁니다.

모두 성공하시길 바랍니다!!!

.

.

도움 받은 글 (옵션)

참고한 지피터스 글이나 외부 사례를 알려주세요.

브라이언님의 1주차 강의 및 MCP연결 추가영상 : https://youtu.be/DRFzR475Y7Y

3
2개의 답글

👉 이 게시글도 읽어보세요