MCP 옵시디언 연동
MCP를 이용해서 LLM이 내 옵시디언을 참고하게 해보자!

MCP(Model Context Protocol)란?
모델 컨텍스트 프로토콜(MCP)은 LLM 애플리케이션과 외부 데이터 소스 및 도구 간의 원활한 통합을 가능하게 하는 개방형 프로토콜입니다. AI 기반 IDE를 구축하든, 채팅 인터페이스를 개선하든, 맞춤형 AI 워크플로를 만들든, MCP는 LLM이 필요한 컨텍스트와 연결할 수 있는 표준화된 방법을 제공합니다.
> 출처 : github - Model Context Protocol
MCP(Model Context Protocol)는 Claude를 만든 Anthropic에서 제안한 프로토콜입니다. 간단히 말해 LLM이 여러가지 어플리케이션을 통해 추가 컨텍스트를 참고할 수 있게 만들어주는 프로토콜입니다.
LLM이 필요에 따라 스스로 여러 어플리케이션을 하나의 도구(tool)로써 이용할 수 있게 만들어주는 기술입니다.
Claude + 옵시디언
이미 수많은 어플리케이션이 MCP를 사용하여 LLM Claude 연동할 수 있게 플러그인이 만들어져 있습니다. 여기서는 옵시디언(Obsidian)을 MCP로 연동해 보겠습니다.
Claude Desktop 설치
Claude와 MCP를 연동하기 위해서는 가장 먼저, 로컬 PC에 Claude Desktop을 설치해야 합니다.
> Claude Desktop
MCP server for Obsidian
MCP server for Obsidian라는 python 라이브러리를 사용해서 Claude와 옵시디언을 MCP로 연동해 보겠습니다.
1. 커뮤니티 플러그인 설치
우선 해당 MCP 서버 라이브러리는 REST API로 옵시디언을 이용합니다. 따라서 옵시디언에 REST API를 사용할 수 있게 만들어주는 Local REST API Community plugin을 설치해야 합니다.
Options
- Community plugins
- Browse 버튼
에 들어가서 Local REST API
플러그인을 검색해서 설치해줍니다. 그리고 반드시 해당 플러그인을 사용할 수 있게 활성화해줍니다.
> Community plugin 설치 후 반드시 활성화하자
활성화 버튼 옆에 ⚙️버튼을 클릭하여 설정을 열어서 API Key를 복사해둡니다. 해당 정보는 MCP 설정에 필요합니다.
> Claude MCP 설정에 필요한 API Key를 복사해두자
2. python uv 설치
uv
는 파이썬 패키지 매니저입니다. Installing uv 페이지를 참고해서 설치를 진행합니다.
$ curl -LsSf https://astral.sh/uv/install.sh | sh
> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
아래의 명령으로 uv
가 제대로 설치되었는지 확인합니다.
$ uv --version
uv 0.6.3 (a0b9f22a2 2025-02-24)
3. Claude MCP 설정
- Claude Desktop를 실행하여
Settings
창을 열어야 합니다. - 좌측 상단에 햄버거 버튼에서
File
-Settings
를 클릭합니다. - 해당 창에서
Developer
탭을 선택합니다. Edit Config
버튼을 눌러서claude_desktop_config.json
파일을 열겠습니다.
> Claude Desktop에서 Settings를 열자
claude_desktop_config.json
파일에 아래의 JSON을 붙여 넣습니다. 마지막으로 <YOUR_OBSIDIAN_API_KEY>
부분에 자신의 옵시디언 플러그인에서 복사해뒀던 API Key를 입력합니다.
{
"mcpServers": {
"mcp-obsidian": {
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY" : "<YOUR_OBSIDIAN_API_KEY>"
}
}
}
}
4. 연동 확인
Claude 입력창 하단에 새로운 🔨 아이콘이 추가되었으면 제대로 연동됐습니다! 이제 Claude가 볼트 내에 있는 정보를 검색해서 답변하는지 확인 해보겠습니다.
> Claude에 MCP tools가 추가된 것을 확인
5. 질의 해보기
질의에 대해서 참고할 정보를 빠르게 찾을 수 있게 도와주는 내용(경로, 파일명)을 적어주는 것을 추천드립니다!
> Claude가 옵시디언을 참고하는 것을 볼 수 있다!
마무리
MCP(Model Context Protocol)를 통해 LLM과 외부 데이터 소스 및 도구 간의 원활한 통합을 가능하게 하는 방법을 알아보았습니다. 이를 통해 LLM이 보다 풍부한 컨텍스트를 활용하여 더 나은 답변을 제공할 수 있게 되었습니다.
다음으로
다음글: MCP Cursor 연동에서는 Cursor에서 MCP로 GitHub와 Chrome 개발자 도구를 연동하는 방법에 대해서 알아보겠습니다. 나아가서는 MCP SDK로 직접 MCP 서버를 만들어 보겠습니다!
감사합니다! 😊