데스크탑 초기화_ 스터디 1주차의 마음으로 클로드에 MPC 설치부터 다시하기

가장 쉬운 옵시디언-클로드 연동법 (MCP 방식)

준비물

Claude 데스크탑 앱 (웹버전 불가)
Python 설치 (Windows/Mac/Linux 공통)
UV(파이썬 패키지 매니저)
옵시디언(Obsidian)과 연동할 Vault

1. Claude 데스크탑 앱 설치

Claude 공식 사이트에서 데스크탑 앱을 설치하세요.

2. Python과 UV 설치

Python 최신 버전 설치
터미널(명령 프롬프트)에서 다음으로 UV 설치:
```
bash
```
pip install uv

3. MCP-Obsidian 서버 설치

UV 명령어로 MCP-Obsidian 서버 실행:
```
bash
```
uvx mcp-obsidian
(uv, mcp-obsidian 관련 오류가 나면 공식 깃허브 또는 안내 블로그 참고)

4. 옵시디언 REST API 플러그인 설치

옵시디언 Community Plugins 메뉴에서 ‘REST API’ 플러그인 찾아 설치
API 키를 생성하고 복사

5. 클로드 데스크탑 설정에 MCP-Obsidian 서버 연결 추가

Claude 데스크탑 → 좌측 상단 메뉴 → File → Settings → Developer → Edit Config 선택
claude_desktop_config.json 파일의 "mcpServers" 항목에 다음 내용 추가 :
```
json
```
"mcp-obsidian": { "command": "uvx", "args": [ "mcp-obsidian" ], "env": { "OBSIDIAN_API_KEY": "<옵시디언 REST API에서 복사한 API키>" } }
<옵시디언 REST API에서 복사한 API키> 부분에는 4번에서 복사한 API 키를 붙여넣으세요.

6. 클로드 데스크탑 완전 종료 후 재실행

설정 적용을 위해 Claude 앱을 완전히 종료했다가 다시 켜주세요.

연동 확인 및 사용법

Claude 데스크탑 창 하단에 ‘🔨’ 아이콘(도구모음)이 나타나면 정상적으로 연동된 것입니다.
Claude에게 옵시디언 Vault의 노트를 읽고, 생성, 편집해달라고 요청할 수 있습니다.

참고사항

MCP 방식이 가장 널리 쓰이며, 오픈소스 기반이라 빠르고 관리가 쉽습니다.
더 쉬운 자동설치, UI 기반 플러그인은 아직 공식 지원이 안 됩니다.
오류 시 MCP 관련 공식 가이드, 티스토리 블로그, 유튜브 영상들을 참고하면 문제 해결이 쉽습니다.

3줄 요약

Claude 데스크탑 + MCP-Obsidian + REST API 플러그인 설치 → API키 설정 → config.json에 등록.
완전 종료 후 재시작하면 Claude가 옵시디언 Vault에 자유롭게 접근 가능.
조건 맞추면 누구나 손쉽게 "AI 노트 자동화" 라이프 가능!

퍼플렉시티에 "옵시디언과 클로드 연결하는 방법 중 가장 간단한 것 알려줘."라는 한 줄의 프롬프트와 한번의 답변을 받고 일사천리로 진행했습니다.

데스크탑이 초기화 된 이유로 1주차처럼 처음부터 다시 시작했는데 오히려 1주차때보다 굉장히 수월하게 설치하고 성공했습니다. 어깨 너머로 들었던 것들이 모두 도움이 되었나봅니다. 스터디장님과 멤버들에게 감사의 말씀을 드립니다~ ^^

과정 중 소소한 오류
1. 파이썬이 제대로 설치되지 않았다.
해결방법 : 윈도우 +R를 누르고 cmd 입력해서 터미널 열고 뜬 창에 아래 코드 넣고 버전 확인이 되면 잘 설치된 것입니다. 저의 경우 재설치 후 성공했습니다. 파이썬 버전이 표시되면 정상.

python --version

파이썬 설치 시 Add Python to PATH 꼭 체크하기.
그런데 저는 그 항목이 안보여 질문한 결과 Add Python to environment variavles 선택하라고 답변 받았는데 체크 후 잘 잘동되는 것을 확인했습니다.

2. 소소한 코드 수정
코드를 감싼 괄호 부분 오류와 API 넣는 부분에 예시로있던 <>를 안 지우는 등 소소한 실수와 디버깅했습니다.

{
    "mcpServers": {
      "mcp-obsidian": {
        "command": "uvx",
        "args": [
          "mcp-obsidian"
        ],
        "env": {
          "OBSIDIAN_API_KEY": "본인의 REST API키 넣는 부분"
        }
      }
    }
  }

3.볼트는 구글 드라이브 데스크탑 설치 후 적용했습니다. 이후 다른 디바이스에서 동기화 된 자료를 활용하고자 함입니다.

결론적으로 잘 설치되고 내 옵시디언 내용도 잘 가져오는 것 확인했습니다. 마지막 주에 새로운 시작을 맛본 기분입니다. 남은 요일동안 알려주신 내용 바탕으로 나만의 지식관리 폴더 체계 구성 및 글쓰기 적용해보고 공유하고자 합니다. ^^

⏰ 가장 빠르게 AI를 배우는 곳 | AI스터디 18기 사전모집 OPEN🚀