Claude-Obsidian MCP 설치 및 사용법 완벽 가이드 – Windows에서 Claude AI와 Obsidian 통합하기
Claude-Obsidian MCP 설치 및 사용자 가이드
안녕하세요! 이 가이드는 Windows에서 Claude-Obsidian MCP를 설치하고 사용하는 방법을 A부터 Z까지 자세히 설명하는 블로그 스타일의 문서입니다. Claude-Obsidian MCP는 Anthropic의 Claude AI와 Obsidian 노트 관리 애플리케이션을 Model Context Protocol(MCP)을 통해 통합하여, 노트 검색, 내용 조회, 작성 등의 기능을 제공합니다. 이 가이드를 통해 초보자도 쉽게 설치와 사용법을 익힐 수 있습니다.
소개
Claude-Obsidian MCP는 Claude AI가 Obsidian 보관소(vault)와 상호 작용하도록 설계된 도구입니다. 이를 통해 사용자는 AI를 활용해 노트를 효율적으로 관리하고, 검색하거나 새로운 내용을 추가할 수 있습니다. 예를 들어, 특정 주제에 대한 노트를 빠르게 찾거나, 일일 노트에 작업을 추가하는 등의 작업이 가능합니다. 이 통합은 생산성을 높이고, AI와 노트 관리의 강력한 조합을 제공합니다.
사전 준비
Claude-Obsidian MCP를 설치하기 전에 다음 소프트웨어와 환경이 준비되어야 합니다:
| 항목 | 설명 |
|---|---|
| Obsidian | 노트 관리 애플리케이션, Obsidian 공식 사이트에서 다운로드 |
| Claude Desktop | Claude AI의 데스크톱 버전, Anthropic 웹사이트에서 설치 |
| Node.js | 버전 20 이상, Node.js 공식 사이트에서 설치 |
Obsidian 보관소: 이미 Obsidian에서 사용 중인 보관소가 있어야 하며, 그 경로(예: C:\Users\YourUsername\Documents\MyVault)를 알고 있어야 합니다.
권장: 보관소 데이터를 백업하세요(예: Git 사용). MCP는 읽기/쓰기 권한을 가지므로 데이터 손실을 방지하기 위해 백업이 중요합니다.
설치 방법
Claude-Obsidian MCP를 설치하는 방법은 두 가지입니다: Smithery CLI를 사용한 자동 설치와 수동 설정입니다. 아래에서 두 방법을 자세히 설명합니다.
방법 1: Smithery CLI를 통한 자동 설치 (권장)
Smithery CLI는 설치 과정을 간소화하는 도구로, 대부분의 사용자에게 추천됩니다. 다음 단계를 따르세요:
명령 프롬프트 또는 PowerShell 실행:
Windows에서 명령 프롬프트 또는 PowerShell을 관리자 권한으로 열어주세요.
mcp-obsidian 서버 설치:
다음 명령을 실행하세요:
npx @smithery/cli install mcp-obsidian --client claude이 명령은 Smithery CLI를 통해 mcp-obsidian 서버를 설치합니다. 설치 중 Obsidian 보관소의 절대 경로를 입력하라는 메시지가 나타날 수 있습니다.
Obsidian 보관소 경로 입력:
예를 들어, 보관소가 C:\Users\YourUsername\Documents\MyVault에 있다면, 이 경로를 정확히 입력하세요.
경로는 반드시 절대 경로(예: C:\...) 형식이어야 하며, 상대 경로는 작동하지 않습니다.
Claude Desktop 재시작:
설치가 완료되면 Claude Desktop을 완전히 종료한 후 다시 실행하세요.
설치가 성공적이라면 Claude Desktop에서 MCP 도구(예: 검색, 파일 조회 등)가 활성화된 것을 확인할 수 있습니다. smithery-ai/mcp-obsidian 리포지토리에서 제공하는 스크린샷을 참조하세요.
참고: Smithery.ai(MCP Server)에서 "obsidian MCP"를 검색하면 설치 명령어와 JSON 설정 예시를 확인할 수 있습니다. 설치 중 JSON 설정이 자동으로 적용되지만, 필요 시 수동으로 확인할 수 있습니다.
방법 2: 수동 설정
수동 설정은 설정 파일을 직접 편집하여 MCP 서버를 구성하는 방법입니다. 이 방법은 더 많은 제어가 필요하거나 Smithery CLI가 작동하지 않을 때 유용합니다.
obsidian-mcp 패키지 설치 (선택 사항):
일부 구현에서는 obsidian-mcp 패키지를 전역으로 설치해야 할 수 있습니다:
npm install -g obsidian-mcp하지만 smithery-ai/mcp-obsidian 구현에서는 이 단계가 필요 없을 수 있습니다.
Claude Desktop 설정 파일 열기:
설정 파일은 다음 경로에 위치합니다:
%APPDATA%\Claude\claude_desktop_config.json파일 탐색기에서 %APPDATA%\Claude로 이동하거나, 텍스트 에디터(예: Notepad++)로 파일을 열어주세요. 저장을 위해 관리자 권한이 필요할 수 있습니다.
JSON 설정 추가:
설정 파일에 다음 JSON 블록을 추가하세요:
{ "mcpServers": { "obsidian": { "command": "npx", "args": [ "-y", "obsidian-mcp", "C:\\Users\\YourUsername\\Documents\\MyVault" ] } } }C:\\Users\\YourUsername\\Documents\\MyVault를 실제 Obsidian 보관소 경로로 변경하세요.
JSON 형식이 올바른지 확인하세요(예: 쉼표, 중괄호 등). JSONLint 같은 도구로 유효성을 검사할 수 있습니다.
설정 저장 및 Claude Desktop 재시작:
파일을 저장한 후 Claude Desktop을 재시작하세요.
MCP 서버가 정상적으로 연결되면 Claude Desktop에서 MCP 도구가 활성화됩니다.
참고: 수동 설정은 StevenStavrakis/obsidian-mcp 리포지토리에서 권장하는 방법입니다. 이 리포지토리는 obsidian-mcp라는 이름의 서버를 사용하며, smithery-ai/mcp-obsidian과 약간 다를 수 있습니다.
대체 방법: Deno 사용
일부 사용자는 Deno를 선호할 수 있습니다. 이 경우 다음 단계를 따르세요:
Deno 설치:
Deno 공식 사이트에서 Deno v2를 설치하세요.
Deno로 설치 실행:
PowerShell에서 다음 명령을 실행하세요:
deno run -E -S -R npm:@smithery/cli install mcp-obsidian --client claude
설정 파일 편집:
%APPDATA%\Claude\claude_desktop_config.json에 다음 JSON을 추가하세요:
{ "mcpServers": { "mcp-obsidian": { "command": "deno", "args": [ "-E", "-S", "-R", "run", "npm:mcp-obsidian", "C:\\Users\\YourUsername\\Documents\\MyVault" ] } } }
Claude Desktop 재시작:
설정을 저장하고 Claude Desktop을 재시작하세요.
참고: Deno 방법은 Medium Article에서 제안된 대안입니다. 그러나 Smithery CLI가 더 간단하므로 특별한 이유가 없다면 CLI 방법을 권장합니다.
설정
설치 후 몇 가지 추가 설정이 필요할 수 있습니다:
보관소 경로 확인:
설치 또는 설정 중 입력한 보관소 경로가 정확한지 확인하세요. 잘못된 경로는 연결 실패로 이어질 수 있습니다.
여러 보관소를 사용하려면 JSON 설정의 args 배열에 추가 경로를 입력하세요:
"args": [ "C:\\Users\\YourUsername\\Documents\\MyVault", "C:\\Users\\YourUsername\\Documents\\AnotherVault" ]
로그 확인:
문제가 발생하면 다음 경로의 로그 파일을 확인하세요:
%APPDATA%\Claude\logs\mcp*.log로그에는 MCP 서버 연결 상태와 오류 메시지가 기록됩니다.
Obsidian 설정:
Obsidian에서 보관소가 정상적으로 작동하는지 확인하세요. MCP는 Obsidian의 로컬 REST API 플러그인과 상호 작용할 수 있으므로, 필요한 경우 이 플러그인을 활성화하세요(Obsidian Forum).
사용법
Claude-Obsidian MCP가 설치되고 설정되면 Claude Desktop을 통해 Obsidian 보관소와 상호 작용할 수 있습니다. 다음은 주요 사용 예시입니다:
| 작업 | 명령 예시 |
|---|---|
| 노트 검색 | "내 옵시디언 보관소에서 '프로젝트 X'를 검색하세요.'" |
| 노트 내용 조회 | "'회의록'의 메모에는 어떤 내용이 있나요?" |
| 노트에 내용 추가 | "내 일일 노트에 '새 작업: 전화 클라이언트' 추가하기" |
| 파일 목록 조회 | "내 옵시디언 보관소에 있는 모든 파일 나열하기" |
| 특정 파일 삭제 | "내 보관함에서 'old_note.md' 파일을 삭제합니다." |
검색: 특정 키워드로 보관소 내 모든 노트를 검색할 수 있습니다. 예를 들어, "Azure CosmosDb"가 언급된 파일을 찾으려면 Claude에 요청하면 됩니다.
내용 관리: 기존 노트에 내용을 추가하거나, 특정 헤딩 아래에 텍스트를 삽입할 수 있습니다.
고급 기능: MarkusPfundstein/mcp-obsidian과 같은 구현은 파일 목록 조회, 삭제, 특정 디렉토리 검색 등의 추가 도구를 제공합니다.
참고: 사용 가능한 명령어는 설치한 MCP 서버 구현에 따라 다를 수 있습니다. 자세한 도구 목록은 설치한 리포지토리의 문서를 확인하세요.
문제 해결
설치나 사용 중 문제가 발생할 경우 다음 단계를 시도하세요:
Claude Desktop 재시작:
설치 또는 설정 변경 후 Claude Desktop을 반드시 재시작하세요. 변경사항이 적용되지 않을 수 있습니다.
보관소 경로 확인:
JSON 설정 또는 설치 중 입력한 경로가 정확한지 확인하세요. 경로가 잘못되면 MCP 서버가 보관소에 접근할 수 없습니다.
Node.js 및 npm 확인:
Node.js가 최신 버전(20 이상)인지 확인하고, npm이 정상적으로 작동하는지 확인하세요:
node -v npm -v
로그 파일 확인:
%APPDATA%\Claude\logs\mcp*.log에서 오류 메시지를 확인하세요. 예를 들어, "vault not found" 오류는 경로가 잘못되었음을 나타냅니다.
Obsidian REST API 플러그인:
일부 구현은 Obsidian의 로컬 REST API 플러그인에 의존합니다. Obsidian 설정에서 이 플러그인이 활성화되어 있는지 확인하세요.
고급 사용법
여러 보관소 관리:
JSON 설정에서 여러 보관소를 지정하여 동시에 관리할 수 있습니다. 이는 프로젝트별로 별도의 보관소를 사용하는 사용자에게 유용합니다.
다른 MCP 서버 탐색:
Smithery.ai에서 다른 MCP 서버를 찾아 Claude의 기능을 확장할 수 있습니다. 예를 들어, 파일 시스템 MCP를 사용해 Obsidian 외의 디렉토리와 상호 작용할 수 있습니다(Reddit Post).
개발자 설정:
고급 사용자는 StevenStavrakis/obsidian-mcp를 클론하여 직접 빌드할 수 있습니다:
git clone https://github.com/StevenStavrakis/obsidian-mcp cd obsidian-mcp npm install npm run build빌드 후 설정 파일에 node 명령과 빌드된 main.js 경로를 추가하세요.
결론
Claude-Obsidian MCP는 Obsidian과 Claude AI를 통합하여 노트 관리와 생산성을 혁신적으로 향상시키는 도구입니다. 이 가이드를 통해 Smithery CLI 또는 수동 설정을 사용하여 Windows에서 쉽게 설치하고, Claude를 활용해 노트를 검색하고 관리하는 방법을 배웠습니다. 추가 질문이나 문제가 있다면, 아래 참고 자료를 확인하거나 커뮤니티 포럼에 문의하세요.
참고자료
