MCP를 사용하여 Obsidian을 YouMind에 연결하는 방법
Obsidian 보관함에는 이미 다음 프로젝트에 필요한 모든 것(연구, 계획, 독서 노트, 미완료 작업)이 들어 있을 수 있습니다. 이를 YouMind에 연결하면 자연어 요청을 통해 해당 노트를 유용한 무언가로 바꿀 수 있습니다.
이 가이드에서는 로컬 Obsidian 보관함을 YouMind에 연결하고, YouMind가 노트 세트를 읽고 정리하도록 요청한 후, 결과를 다시 Obsidian에 저장하는 방법을 알아봅니다. 예시에서는 항염증 식단에 관한 5개의 노트를 사용하여 원본 출처에 대한 링크가 포함된 실행 계획을 만듭니다.
시작하기 전에
다음이 필요합니다:
- 데스크톱 버전의 Obsidian과 편집 가능한 보관함.
- 사용자 정의 커넥터에 접근할 수 있는 YouMind 계정.
- ngrok 계정. ngrok을 사용하여 로컬 MCP 서버에 YouMind가 접근할 수 있는 HTTPS 주소를 부여합니다.
- 작업할 노트 몇 개. 자신의 연구, 프로젝트 노트 또는 식사 계획 노트를 사용할 수 있습니다.
연결 방식은 다음과 같습니다:
YouMind → ngrok HTTPS 주소 → MCP 커넥터 → 사용자의 Obsidian 보관함
MCP(Model Context Protocol)는 AI 애플리케이션이 다른 애플리케이션이 제공하는 도구를 사용할 수 있게 해줍니다. Obsidian 플러그인은 보관함 작업을 위한 도구를 노출하고, YouMind는 이를 사용하여 요청을 수행합니다.
이 연결을 사용할 때는 컴퓨터가 깨어 있고 인터넷에 연결되어 있으며, Obsidian, 연결된 보관함, ngrok이 실행 중인 상태를 유지하세요. 로컬 주소 127.0.0.1은 사용자 컴퓨터만 가리키므로, YouMind가 접근하려면 ngrok 주소가 필요합니다.
커넥터는 부여된 권한에 따라 노트를 읽거나 변경할 수 있습니다. 토큰을 비공개로 유지하고, 플러그인의 도구 권한 및 숨김 폴더 설정을 사용하여 접근을 제어하세요. 작업에 사용된 콘텐츠는 ngrok과 YouMind를 통과하며, 보관함을 연결한다고 해서 전체 보관함이 자동으로 동기화되지는 않습니다.
스크린샷은 macOS에서의 워크플로를 보여줍니다. 일부 계정 세부 정보는 제거되었거나 예시 값으로 대체되었습니다.
1. Obsidian에서 커뮤니티 플러그인 허용
Obsidian에서 설정 → 커뮤니티 플러그인을 엽니다.
보관함이 제한 모드인 경우 제한 모드 종료를 클릭하여 커뮤니티 플러그인을 허용합니다.
찾아보기를 클릭하여 커뮤니티 플러그인 디렉토리를 엽니다.
2. MCP Connector 설치 및 활성화
MCP Connector를 검색하고 istefox의 플러그인을 선택하세요. 디렉토리에는 비슷한 이름의 플러그인이 있으므로 작성자 이름을 확인하세요.
세부 정보를 열고 설치를 클릭합니다.
설치 후 활성화를 클릭합니다.
Obsidian 설정에서 MCP Connector를 열어 로컬 서버와 액세스 토큰을 구성합니다. 자세한 내용은 플러그인 디렉토리 페이지에서 확인할 수 있습니다.
3. 고정 서버 포트 설정
고정 포트를 찾아 27200을 입력하고 저장을 클릭합니다.
서버 포트 섹션에 이제 다음이 표시되어야 합니다:
http://127.0.0.1:27200/mcp
고정 포트는 ngrok 연결이 항상 동일한 로컬 서비스를 가리키도록 유지합니다. 포트 27200이 이미 사용 중인 경우 사용 가능한 포트를 선택하고 아래 ngrok 명령에서 해당 번호를 사용하세요.
4. YouMind용 토큰 생성
액세스 제어에서 토큰 추가를 클릭합니다.
새 토큰의 이름을 YouMind로 지정하여 나중에 식별할 수 있도록 합니다.
해당 토큰 행에서 복사를 클릭합니다. 이후 단계에서 YouMind에 붙여넣을 것입니다.
각 토큰은 고유한 도구 권한을 가질 수 있습니다. 이 예시에서는 노트를 읽고 새 노트를 생성할 수 있는 권한이 필요합니다. 스크린샷은 플러그인의 모든 52개 도구 구성을 사용합니다. 사용 가능한 도구 수는 플러그인 버전 및 설정에 따라 변경될 수 있습니다.
토큰은 부여된 액세스 권한에 대한 비밀번호처럼 취급하세요. AI 채팅에 붙여넣을 필요가 없습니다.
5. ngrok 터널 시작
아직 ngrok을 설치하지 않았다면 공식 설정 안내를 따르세요. macOS에서 이미 Homebrew를 사용 중이라면 다음 명령어로 설치하세요:
brew install ngrok
ngrok 대시보드에서 인증 토큰을 추가합니다:
ngrok config add-authtoken YOUR_NGROK_AUTHTOKEN
ngrok 인증 토큰은 ngrok을 계정에 연결합니다. 이전 단계의 Obsidian 토큰은 YouMind에 보관함 액세스 권한을 부여합니다. 이 두 자격 증명은 분리하여 보관하세요.
터미널에서 다음을 실행합니다:
ngrok httphttp://127.0.0.1:27200
이 터미널 세션을 계속 실행 상태로 두세요. Session Status가 online으로 표시되면 Forwarding 줄에 표시된 HTTPS 주소를 복사합니다.
해당 주소 끝에 /mcp를 추가합니다. 최종 커넥터 URL은 다음과 같은 구조여야 합니다:
https://YOUR_NGROK_DOMAIN/mcp
자신의 ngrok 세션에 표시된 실제 도메인을 사용하세요. 스크린샷의 도메인은 예시입니다. 전달 주소가 나중에 변경되면 YouMind에 저장된 주소도 업데이트하세요.
6. YouMind에서 사용자 정의 커넥터 추가
YouMind에서 설정 → 커넥터를 열고 사용자 정의 커넥터 추가를 클릭합니다.
obsidian과 같은 이름을 입력하고 끝에 /mcp가 붙은 ngrok 주소를 붙여넣습니다. 고급 설정을 펼칩니다. 사용자 정의 매개변수에서 매개변수 추가를 클릭하고 다음을 구성합니다:
설정 | 값 |
|---|---|
이름 |
|
서버 URL | ngrok HTTPS 주소 뒤에 |
OAuth 클라이언트 ID | 비워 둠 |
OAuth 클라이언트 시크릿 | 비워 둠 |
사용자 정의 매개변수 |
|
매개변수 값 |
|
시크릿 | 켜짐 |
YOUR_OBSIDIAN_TOKEN을 Obsidian에서 복사한 전체 토큰으로 바꾸세요. `Bearer` 뒤에 공백을 포함하세요. 예를 들어 토큰이 example-token인 경우 값은 다음과 같습니다:
Bearer example-token
이는 형식 예시일 뿐입니다. 실제 구성에서는 자신의 토큰을 사용하세요. 이 연결은 Bearer Token 인증을 사용하므로 두 OAuth 필드는 비워 둡니다.
추가를 클릭한 다음 커넥터 목록에서 obsidian을 찾아 연결을 클릭합니다.
이름 옆에 연결됨이 표시되어야 합니다.
이제 노트를 읽고 새 노트를 작성하는 작업으로 연결을 확인해 보겠습니다.
7. 관련 노트 몇 개 준비
YouMind가 작업할 실제 콘텐츠가 필요합니다. 이 예시에서는 보관함에 5개의 영어 노트가 포함되어 있습니다:
노트 | 내용 |
|---|---|
Anti-Inflammatory Eating Basics | 일반적인 식단 원칙 및 첫 주 목표 |
Anti-Inflammatory Grocery List | 쇼핑 목록 및 재료 대체품 |
7-Day Anti-Inflammatory Meal Plan | 일주일 분량의 아침, 점심, 저녁 식사 |
Simple Anti-Inflammatory Meal Prep | 준비 단계, 간단한 레시피 및 보관 요령 |
Anti-Inflammatory Weekly Review | 검토 템플릿 및 미완료 후속 작업 |
이 노트들은 워크플로를 시연하기 위한 샘플 자료입니다. 개인 맞춤형 의학 또는 영양 계획이 아닙니다.
다른 주제를 사용할 수도 있습니다. 예를 들어, 독서 노트를 학습 가이드로 결합하거나, 프로젝트 노트를 다음 단계 목록으로 바꾸거나, 여행 조사를 일정표로 정리할 수 있습니다. 보관함에 있는 노트와 일치하도록 프롬프트의 주제를 업데이트하세요.
8. YouMind에 읽기, 정리 및 저장 요청
YouMind에서 새 작업을 시작하고 다음을 입력합니다:
항염증 식단에 관한 내 Obsidian 노트를 검토해 줘. 핵심 원칙을 요약하고, 식료품 목록을 식사 계획과 연결하고, 세 가지 미해결 작업을 식별해 줘.
결과를 "Anti-Inflammatory Eating Action Plan"이라는 제목의 새 Obsidian 노트로 영어로 저장하고, 원본 노트에 대한 내부 링크를 포함해 줘.
프롬프트는 YouMind에게 어떤 노트를 읽을지, 정보를 어떻게 구성할지, 어떤 작업을 식별할지, 결과를 어디에 저장할지 알려줍니다. 또한 새 노트의 이름을 지정하고 소스에 대한 링크를 요청하여 출력을 쉽게 확인할 수 있도록 합니다.
작업을 제출하세요. YouMind는 커넥터를 사용하여 관련 노트를 찾고 읽은 다음 결과를 종합합니다. 대화에서 진행 상황을 확인할 수 있습니다.
9. Obsidian에서 새 노트 열기
이 예시에서 YouMind는 다음을 반환했습니다:
- 소개 노트의 원칙 요약.
- 식료품 목록과 식사 계획 간의 연결(여러 식사에 나타나는 재료 포함).
- 세 가지 미해결 작업: 쇼핑 계획 세우기, 점심 및 준비 세션 선택하기, 이후 검토 완료하기.
- Anti-Inflammatory Eating Action Plan이라는 제목의 새 노트와 원본 5개 노트에 대한 내부 링크.
모든 할 일 완료는 YouMind의 읽기, 정리 및 쓰기 작업을 의미합니다. 쇼핑 및 식사 준비는 계획을 사용하는 사람의 후속 조치로 남습니다.
Obsidian으로 다시 전환하고 Anti-Inflammatory Eating Action Plan을 엽니다.
새 노트가 파일 목록에 나타나고 내용이 보관함에 저장됩니다. 이 실행에서는 원본 노트에 대한 태그와 클릭 가능한 링크도 포함됩니다. 그래프 보기는 기존 노트와 함께 이러한 연결을 보여줍니다.
이제 Obsidian에서 계속 편집하거나, YouMind에 섹션 확장이나 다른 노트를 사용한 계획 업데이트와 같은 더 구체적인 요청을 할 수 있습니다.
문제 해결
401 Unauthorized 오류가 나타나는 이유는 무엇인가요?
Authorization 매개변수를 확인하세요. 값은 Bearer 뒤에 공백 하나와 전체 Obsidian 토큰이 와야 합니다. MCP Connector에서 토큰을 복사했는지 확인하세요. 토큰을 재생성했거나 취소한 경우 YouMind의 값을 업데이트하세요.
"OAuth authorization server metadata discovery failed (404)" 오류가 나타나는 이유는 무엇인가요?
토큰 확인이 실패하면 클라이언트가 OAuth 검색을 시도할 수 있습니다. 이 플러그인 연결은 Bearer Token을 사용하므로, 먼저 Authorization 헤더를 확인하고 OAuth 클라이언트 ID 및 시크릿 필드를 비워 두세요. Bearer 접두사가 누락되면 이 오류가 발생할 수 있습니다.
브라우저에서 /mcp URL을 열면 405 오류가 반환되는 이유는 무엇인가요?
플러그인의 MCP 엔드포인트는 POST를 통한 MCP 요청만 허용합니다. 브라우저 주소 표시줄에 URL을 입력하면 일반적으로 GET 요청이 전송되어 405 Method Not Allowed가 반환될 수 있습니다. YouMind와 실제 작업을 통해 연결을 확인하세요.
작동 중이던 연결이 응답을 멈춘 이유는 무엇인가요?
컴퓨터가 깨어 있고 온라인 상태인지, Obsidian에 올바른 보관함이 열려 있는지, 플러그인이 활성화되어 있는지, ngrok이 여전히 online 상태인지 확인하세요. 그런 다음 로컬 포트와 ngrok URL을 YouMind에 저장된 값과 비교하세요.
새 노트를 찾을 수 없는 경우 어떻게 하나요?
연결된 보관함에서 프롬프트에 지정한 제목을 검색하세요. 토큰에 노트 생성 권한이 있는지 확인하세요. YouMind에게 생성된 파일의 정확한 보관함 기준 경로를 물어본 다음 Obsidian에서 해당 경로를 열 수도 있습니다.
자신의 노트로 시도해 볼 준비가 되셨나요? YouMind 열기를 클릭하고 관련 노트 몇 개를 보관함의 유용한 새 페이지로 바꿔 달라고 요청하세요.