단기 기억상실의 Claude ! 내 옵시디언을 저장소로 활용하는 방법(Claudesidian-mcp 소개)

✅ 1. 소개

클로드와 긴밀하게 작업하다 보면, 종종 이전 대화를 기억하지 못하는 순간들이 생깁니다. 대화 길이 제한이나, 컨텍스트를 잊어버리는 구조 때문에, 중요한 정보를 다시 설명해야 하는 상황이 반복되곤 했죠.

그러다 우연히 Supermemory 기능을 소개한 글을 보게 됐습니다. 순간 “이거다!” 싶었지만, 곧장 고민이 들었습니다.

“내 데이터가 온라인 어딘가에 저장된다고…? 이건 좀 불안한데.”

그래서 생각을 바꿨습니다.

“이걸 내 PC 안, 특히 내가 평소에 쓰는 Obsidian Vault에 저장하는 방법은 없을까?”

그 고민의 끝에서 찾은 게 바로 claudesidian-mcp입니다. Claude 데스크탑과 Obsidian을 연결해, 대화 내용을 .md 파일로 자동 저장하고, 템플릿을 기반으로 프로젝트나 회의록 정리도 가능하게 해주는 강력한 도구죠. 개인 클라우드 없이도, 로컬에서 AI 대화의 맥락을 온전히 보존할 수 있는 방법입니다.

위 사진처럼, 대화 중에 핵심 내용을 옵시디언에 메모리처럼 넣을 수 있습니다.

그럼 위의 사진처럼, 자동으로 내용을 저장하고, MOC까지 연결해줍니다.

또한, 새 창에서 키워드로 검색하면, 볼트 내에서 관련 자료를 모두 찾아서 정리해줍니다.(빨간색은 개인정보가...)

🛠️ 2. 진행 방법

사용한 도구

Claude 데스크탑 앱
Obsidian (with claudesidian-mcp plugin)
Node.js

활용 방식 요약

claudesidian-mcp 플러그인을 Obsidian에 설치 및 활성화
Claude 데스크탑 설정에 플러그인 경로 등록
Claude 대화창에서 /save, /plan, /moc 등의 명령어를 통해 메모리, 프로젝트, 문서 자동 생성

사용 예시 명령어

/save topic:carbon_city → 대화 내용을 Claudesidian/Memories/2025-04-29_carbon_city.md로 저장 
/plan → project-plan.md 템플릿 기반 프로젝트 문서 생성 
/moc → 관련 MOC(Memo of Contents) 자동 업데이트

📦 3. 설치 방법

GitHub 링크: claudesidian-mcp

🔗 3-1.필수 소프트웨어 설치

Node.js (https://nodejs.org/) – LTS 버전
Obsidian (https://obsidian.md/)
Claude 데스크탑 앱 (Anthropic 공식 배포)

📁 3-2. 플러그인 파일 설치

GitHub 저장소 접속: https://github.com/ProfSynapse/claudesidian-mcp
오른쪽 초록색 버튼 <> Code 클릭 → Download ZIP
압축 해제 후 다음 경로에 아래 4개 파일만 복사:
```
[YourVault]/.obsidian/plugins/claudesidian-mcp/
```
- main.js
- manifest.json
- styles.css
- connector.js

📌 주의

GitHub에서 내려받은 경우 src/ 폴더가 포함되어 있을 수 있음 → 반드시 npm install 후 npm run build로 main.js 생성 필요

📌 main.js 생성법

메모장을 열고 아래 코드 붙여넣고 .bat 파일로 저장 후, 더블 클릭하여 실행
- 인코딩: ANSI
- 파일 형식: 모든 파일(*)
- 만약 잘 작동이 안되면, gpt에게 문의...

@echo off 
cd /d "[zip으로 압축 푼 claudesidian-mcp-main 폴더 위치]" 
echo [INFO] Installing npm packages... 
call npm install 

IF %ERRORLEVEL% NEQ 0 ( echo [ERROR] npm install failed. Please check if Node.js is installed correctly. pause exit /b %ERRORLEVEL% ) 

echo [INFO] Running build process... 
call npm run build 

IF %ERRORLEVEL% NEQ 0 ( echo [ERROR] Build failed. Check for errors in esbuild or TypeScript configuration. pause exit /b %ERRORLEVEL% ) 

echo [SUCCESS] Build complete. Please check if main.js has been generated. 
pause

실행 후 해당 폴더 내에 main.js 생성 확인, 아래 폴더에 나머지 3개 파일과 함께 넣기
```
[YourVault]/.obsidian/plugins/claudesidian-mcp/
```

⚙️ 3-3. Obsidian에서 플러그인 활성화

Obsidian 실행 → Settings > Community plugins
Safe Mode 비활성화
플러그인 폴더 열기 클릭 후 위 경로에 잘 들어갔는지 확인
claudesidian-mcp가 목록에 뜨면 활성화

🧩 3-4. Claude 데스크탑 설정 (`claude_desktop_config.json` 수정)

{
  "mcpServers": {
    "claudesidian": {
      "command": "node",
      "args": [
        "D:\\[YourVault]\\.obsidian\\plugins\\claudesidian-mcp\\connector.js"
      ]
    }
  }
}

설정 파일 경로 (Windows): %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Claude에서 mcp 활성화 여부(망치모양에 Claudesidian 서버 도구) 확인

3-5. Obsidian에서 Claudesidian-mcp 플러그인 설정

📁 Vault 구조 자동 생성

설정-커뮤니티플러그인-claudesidian-mcp의 설정에서 Best Practices 클릭, 'Copy Setup Prompt' 클릭하여 내용 복사 후 Claude 대화창에서 실행 → 클로드가 옵시디언 볼트 내에 폴더 자동 생성
claudesidian-mcp의 설정에서 'Install Templates' 클릭, 볼트에 생성된 Templates 폴더 내 템플릿들을 Claudesidian/Templates/에 삽입 (선택사항)
- project-plan.md: 프로젝트 계획용 템플릿
- meeting-notes.md: 회의록 정리용 템플릿
- prompts.md: Claude 시스템 명령어 정의 템플릿

Claudesidian/
├── VaultMOC.md
├── Memories/
├── Templates/
│   ├── project-plan.md
│   ├── meeting-notes.md
│   └── prompts.md
├── MOCs/
├── Projects/
├── Inbox/

✅ 3-6. System Prompt 등록 (Claude에서 mcp 단축 명령어 설정, 선택사항)

Claude 데스크탑 설정에서
“Claude가 응답할 때 고려해야 할 개인 선호 사항은 무엇인가요?” 항목에 아래 명령어 추가:

“다음 명령어들을 시스템 프롬프트에 등록해줘. 앞으로 기억하고, 언제든지 인식해서 claudesidian-mcp를 사용했으면 해.”

/save - "Save this conversation to Claudesidian/Memories/[date]_[keyword].md.  
You can use: `/save topic:keyword`.  
If no keyword is provided, extract one from the conversation context."

/moc - "Update relevant Maps of Contents"

/status - "Read MOCs and provide status"

/plan - "Create new project plan using template"

✅ 3-7. 테스트 명령어 예시

/save topic:carbon_city
→ Claudesidian/Memories/2025-04-29_carbon_city.md 저장
/plan
→ Templates/project-plan.md 기반 새 계획 노트 생성
/moc
→ MOC 노트 자동 업데이트

✨ 결과와 배운 점

직접 설정하고 사용해보니, 확실히 “이제 Claude가 나만의 도우미가 된 느낌”입니다. 이전에는 대화 내용을 복사해 붙여넣거나, 중요 내용을 다시 정리해야 했지만, 이제는 /save 한 줄로 자동 정리되고, /plan으로 문서까지 생성됩니다.

특히 인상 깊었던 점은 MOC(Memo of Contents) 기능입니다. 단순 저장을 넘어서, 구조적인 지식 관리가 가능하다는 점에서 Obsidian과 완벽한 궁합을 이룹니다.

시행착오

main.js 빌드 오류 → Node.js 설치 누락 확인
Claude 설정 경로 실수 → 경로 재검토 후 해결

꿀팁

Claude 시스템 프롬프트에 명령어를 등록해두면 인식률이 훨씬 좋아집니다

🔭 앞으로의 계획

지금은 주로 회의록 정리나 프로젝트 브레인스토밍 정리에 쓰고 있지만, 앞으로는 이 구조를 좀 더 확장해서

자동 태그 기반 분류
Claude로부터 받은 정보 기반 하이라이팅 및 요약 자동화
Obsidian dataview와 연동한 프로젝트 추적 대시보드 구성

까지 해볼 생각입니다.

📚 도움 받은 글

GitHub 공식 문서: claudesidian-mcp
지피터스 커뮤니티 Supermemory 관련 소개글: 링크
ChatGPT와 Claude를 활용한 개인화 프롬프트 설계 가이드
항상 유튜브로 큰 가르침을 주시는 구요환 선생님...

🚀 AI스터디 16기 오픈 | 얼리버드 혜택 받기 (~5/2)

단기 기억상실의 Claude ! 내 옵시디언을 저장소로 활용하는 방법(Claudesidian-mcp 소개)

✅ 1. 소개

🛠️ 2. 진행 방법

사용한 도구

활용 방식 요약

사용 예시 명령어

📦 3. 설치 방법

🔗 3-1.필수 소프트웨어 설치

📁 3-2. 플러그인 파일 설치

📌 주의

📌 main.js 생성법

⚙️ 3-3. Obsidian에서 플러그인 활성화

🧩 3-4. Claude 데스크탑 설정 (`claude_desktop_config.json` 수정)

3-5. Obsidian에서 Claudesidian-mcp 플러그인 설정

📁 Vault 구조 자동 생성

✅ 3-6. System Prompt 등록 (Claude에서 mcp 단축 명령어 설정, 선택사항)

✅ 3-7. 테스트 명령어 예시

✨ 결과와 배운 점

시행착오

꿀팁

🔭 앞으로의 계획

📚 도움 받은 글

👉 이 게시글도 읽어보세요

단기 기억상실의 Claude ! 내 옵시디언을 저장소로 활용하는 방법(Claudesidian-mcp 소개)

✅ 1. 소개

🛠️ 2. 진행 방법

사용한 도구

활용 방식 요약

사용 예시 명령어

📦 3. 설치 방법

🔗 3-1.필수 소프트웨어 설치

📁 3-2. 플러그인 파일 설치

📌 주의

📌 main.js 생성법

⚙️ 3-3. Obsidian에서 플러그인 활성화

🧩 3-4. Claude 데스크탑 설정 (claude_desktop_config.json 수정)

3-5. Obsidian에서 Claudesidian-mcp 플러그인 설정

📁 Vault 구조 자동 생성

✅ 3-6. System Prompt 등록 (Claude에서 mcp 단축 명령어 설정, 선택사항)

✅ 3-7. 테스트 명령어 예시

✨ 결과와 배운 점

시행착오

꿀팁

🔭 앞으로의 계획

📚 도움 받은 글

👉 이 게시글도 읽어보세요

🧩 3-4. Claude 데스크탑 설정 (`claude_desktop_config.json` 수정)