최종 업데이트: 2026년 11월 7일.
가능한 작업
Adam Coddington이 만든 커뮤니티 플러그인 Local REST API with MCP에는 Obsidian 내부에서 실행되는 MCP 서버가 포함되어 있습니다. README에 따르면 이 서버는 Streamable HTTP 전송 방식을 사용하며 API 키가 필요합니다. AskWatch는 사용자가 입력한 주소의 MCP 서버에 Streamable HTTP로 연결합니다.
- Mac이 켜져 있어야 합니다. 플러그인은 데스크톱 버전 Obsidian 내부에서 실행되므로, 어떤 연결 방식을 사용하든 Mac에서 플러그인이 활성화된 상태로 Obsidian이 열려 있어야 합니다. 아래 단계의 127.0.0.1 주소는 항상 현재 사용 중인 컴퓨터를 가리킵니다. 따라서 해당 단계는 Obsidian이 실행 중인 Mac의 AskWatch에서 작동하며, iPhone, iPad 또는 Apple Watch에서는 작동하지 않습니다. Tailscale을 통한 두 번째 연결 방식을 사용하면 iPhone이나 iPad에서 접근할 수 있습니다.
- 노트 작업 도구. 플러그인에는 노트 읽기, 검색, 생성, 수정, 이동, 삭제 및 Obsidian 명령 실행 도구가 나열되어 있습니다.
- 커뮤니티 소프트웨어. 이 플러그인은 Obsidian이나 AskWatch에서 만든 것이 아닙니다. AskWatch에서는 이 플러그인을 테스트하지 않았습니다.
준비 사항
- 설정에 MCP 서버 탭이 있는 Mac용 AskWatch.
- 같은 Mac에 설치되어 있고 커뮤니티 플러그인이 활성화된 Obsidian. Obsidian은 Restricted mode가 꺼져 있을 때만 커뮤니티 플러그인을 실행합니다. 먼저 Obsidian의 플러그인 보안 안내를 읽어 보세요. 커뮤니티 플러그인이 컴퓨터의 파일에 접근할 수 있다고 설명되어 있습니다.
- Obsidian의 커뮤니티 플러그인에서 설치하고 활성화한 Local REST API with MCP 플러그인. Obsidian 플러그인 디렉터리에 등록되어 있습니다.
- Obsidian의 Settings → Local REST API에 표시되는 플러그인의 API 키.
단계별 안내
- Obsidian에서 커뮤니티 플러그인을 켜고 Local REST API with MCP를 설치한 다음 활성화합니다.
- Obsidian에서 Settings → Local REST API를 엽니다. API 키를 복사하고 Enable HTTP server를 켭니다. README에서는 플러그인의 일반 HTTP 주소를 사용하려면 이 스위치를 켜도록 안내합니다.
- Mac의 AskWatch에서 설정을 열고 MCP 서버 탭으로 이동한 다음, MCP 서버 추가를 선택하고 주소로 추가를 선택합니다.
- 서버 이름에 원하는 이름을 입력합니다. 서버 URL에는
http://127.0.0.1:27123/mcp/를 입력합니다. 인증을 Bearer 토큰으로 설정하고 Bearer 토큰 필드에 API 키를 붙여 넣습니다. 그런 다음 서버 추가 및 테스트를 선택합니다. - 주소가 http로 시작하므로 AskWatch에서 먼저 암호화되지 않은 MCP 연결 경고를 표시합니다. 내용을 읽고 위험을 이해했습니다를 켠 다음 이해했습니다 — 계속을 선택합니다.
- 그러면 AskWatch가 서버에 도구 목록을 요청합니다. 이 설정 과정에서 발견된 모든 도구는 처음에 매번 질문으로 설정됩니다.
Obsidian과 플러그인의 항목 이름은 플러그인 README에 표기된 대로 영어로 작성했습니다.
https 주소
플러그인은 https://127.0.0.1:27124/mcp/도 제공합니다. 이 주소의 인증서는 플러그인이 자체적으로 생성한 인증 기관에서 발급하며, README에 따르면 클라이언트가 해당 인증 기관을 신뢰해야 합니다. AskWatch의 MCP 연결 코드에는 macOS가 신뢰하지 않는 인증서를 허용하는 예외가 없습니다. macOS에서 플러그인의 인증 기관을 신뢰하도록 설정하지 않았다면 http 주소를 사용하세요. 저희는 https 주소를 사용해 보지 않았습니다.
iPhone 또는 iPad에서
플러그인은 Binding host 설정을 변경하지 않으면 Mac 자체에서만 연결을 수신합니다. iPhone이나 iPad에서는 네트워크를 통해 Mac에 접근할 수 있는 주소가 필요하므로, 이 두 번째 연결 방식은 설정에 더 많은 작업이 필요합니다. 아래 표의 모든 연결 방식은 AskWatch에서 시도해 보지 않았습니다. 명령어와 설정은 각 제품의 공식 문서에서 가져왔습니다.
동기화가 켜져 있으면 AskWatch에 추가한 MCP 서버와 해당 주소가 다른 기기로 동기화됩니다. tailnet의 주소는 모든 기기에서 동일합니다. 127.0.0.1 주소는 항상 그 주소를 사용하는 기기 자체를 가리키므로, Mac에서 이 주소로 추가한 서버로는 iPhone에서 Obsidian에 접근할 수 없습니다.
AskWatch에서 무엇을 전송할 수 있는지에 따라 사용할 수 있는 연결 경로가 결정됩니다. 주소로 추가 양식에서는 없음, Bearer 토큰, OAuth 로그인을 선택할 수 있습니다. 이 양식에는 추가 요청 헤더를 입력하는 필드가 없습니다.
확인한 모든 연결 방식
언급된 제품의 문서를 바탕으로, 다른 기기에서 Mac의 플러그인에 접근하는 연결 방식과 현재 AskWatch에서 사용할 수 있는지를 정리했습니다.
| 연결 방식 | iPhone 및 iPad | 보관함 도구에 접근할 수 있는 대상 | 설정할 항목 | 저희의 견해 | 현재 AskWatch에서 사용 가능한지 |
|---|---|---|---|---|---|
Mac에서만 127.0.0.1로 연결(위 단계) | 아니요 | 해당 Mac의 프로그램 | 플러그인과 HTTP 서버 활성화 스위치 | 가장 간단한 연결 방식입니다. 다른 기기에서는 연결할 수 없습니다. | 가능합니다. AskWatch에서는 시도해 보지 않았습니다. |
| Tailscale Serve(아래 단계) | 가능합니다. Tailscale 앱에서 동일한 tailnet에 로그인해야 합니다. | tailnet에 속하며 Tailscale 접근 규칙에서 허용한 기기 | 두 기기에 Tailscale 설치, 관리 콘솔에서 HTTPS 활성화, Mac에서 명령어 1개 실행 | 비공개 연결 방식입니다. 도구 설정은 매번 질문으로 유지하세요. | 가능합니다. ts.net으로 끝나는 https 주소를 사용합니다. AskWatch에서는 시도해 보지 않았습니다. |
| Tailscale Funnel | 가능합니다. | 인터넷의 모든 사용자 | Mac에서 명령어 1개 실행 | 권장하지 않습니다. 노트를 작성하고 삭제할 수 있는 도구를 보호하는 수단이 플러그인의 API 키뿐이게 됩니다. | AskWatch는 https 주소를 허용하겠지만, 이 연결 방식은 권장하지 않으며 설정 단계도 제공하지 않습니다. |
| 공개 호스트 이름을 사용하는 Cloudflare Tunnel 단독 연결 | 가능합니다. | 인터넷에서 해당 호스트 이름에 접근하는 모든 사용자 | Cloudflare의 도메인, Mac의 cloudflared, 플러그인용 공개 호스트 이름 | 권장하지 않습니다. 노트를 작성하고 삭제할 수 있는 도구를 보호하는 수단이 플러그인의 API 키뿐이게 됩니다. | AskWatch는 https 주소를 허용하겠지만, 이 연결 방식은 권장하지 않으며 설정 단계도 제공하지 않습니다. |
| Cloudflare Access 및 서비스 토큰을 사용하는 Cloudflare Tunnel | 가능합니다. | 서비스 토큰이 포함된 요청만 | Cloudflare의 도메인, 터널, Service Auth 정책이 적용된 Access 애플리케이션, 서비스 토큰 | 비공개로 연결되겠지만 AskWatch는 해당 토큰을 전송할 수 없습니다. | 아니요. 현재는 작동하지 않습니다. 주소로 추가 양식과 MCP 연결에는 요청 헤더 CF-Access-Client-Id와 CF-Access-Client-Secret을 입력할 필드가 없습니다. 지원을 계획하고 있습니다. |
| Cloudflare Access 및 로그인(Managed OAuth)을 사용하는 Cloudflare Tunnel | 가능합니다. | Access 정책에서 허용한 사용자 | 위 행과 동일하게 설정하고 Access 애플리케이션에서 Managed OAuth 활성화 | 비공개로 연결되겠지만 작동하는지는 알지 못합니다. | 작동 여부는 알려져 있지 않습니다. 플러그인은 Authorization 헤더에 자체 API 키를 요구하고 AskWatch는 Authorization 값 1개를 전송하므로, 둘 다 전송할 방법을 알지 못합니다. AskWatch에서는 시도해 보지 않았습니다. |
| iPhone 또는 iPad의 Cloudflare One Client를 사용하는 Cloudflare 사설 네트워크 | 가능합니다. Cloudflare One Agent 앱을 사용합니다. | Cloudflare Zero Trust 조직에 등록된 기기 | Zero Trust 조직, 커넥터와 경로, 기기에 설치할 앱 | 원칙적으로 비공개 연결입니다. | 작동 여부는 알려져 있지 않습니다. 읽어 본 문서에서는 이 연결 방식으로 127.0.0.1에서만 연결을 수신하는 서비스에 접근하는 방법을 찾지 못했으므로, 설정 단계는 제공하지 않습니다. |
| 홈 네트워크에서 Mac의 주소로 연결 | 가능합니다. 동일한 네트워크에 있어야 합니다. | 해당 네트워크의 모든 기기 | 플러그인의 Binding host를 Mac의 주소로 설정 | 권장하지 않습니다. 연결은 암호화되지 않은 http이며, 네트워크의 모든 기기에서 플러그인에 접근할 수 있습니다. | AskWatch는 사설 주소에 대한 암호화되지 않은 http 연결을 허용하며 암호화되지 않은 MCP 연결 경고를 표시합니다. 설정 단계는 제공하지 않습니다. |
Tailscale Serve 설정 단계
AskWatch에서 이 단계를 시도해 보지 않았으며 Tailscale 규칙에서 허용한 모든 기기가 플러그인에 접근할 수 있다는 점을 받아들이는 경우에만 다음 단계를 진행하세요.
- Mac과 iPhone 또는 iPad에 Tailscale을 설치하고 두 기기에서 동일한 tailnet에 로그인하세요. iOS에서는 앱이 VPN 구성 설치를 요청합니다. 도구를 사용하는 동안 iPhone 또는 iPad에서 Tailscale 연결을 유지하세요.
- Tailscale 관리 콘솔에서 DNS 페이지를 열고, MagicDNS가 꺼져 있으면 켠 다음 HTTPS Certificates에서 Enable HTTPS를 선택하세요. Tailscale은 이 설정을 활성화하면 기기 이름과 tailnet 이름이 공개 인증서 원장에 게시된다고 경고하므로, 기기 이름이 민감한 정보라면 활성화하지 마세요.
- Obsidian에서 위의 2단계와 같이 Enable HTTP server가 켜져 있는지 확인하세요. 플러그인은 계속 127.0.0.1에서만 연결을 수신합니다.
- Mac의 터미널에서
tailscale serve --bg http://127.0.0.1:27123를 실행하세요. Tailscale이https://device-name.tailnet-name.ts.net형식의 주소를 출력합니다. 주소를 다시 확인하려면tailscale serve status를, 서비스 제공을 중지하려면tailscale serve reset을 실행하세요. - iPhone 또는 iPad의 AskWatch에서 설정, MCP 서버, MCP 서버 관리 순서로 여세요. MCP 서버 추가를 선택한 다음 주소로 추가를 선택하세요.
- 서버 이름에 원하는 이름을 입력하세요. 서버 URL에는 이전 명령어에서 나온 주소 끝에
/mcp/를 붙여 입력하세요. 예를 들면https://device-name.tailnet-name.ts.net/mcp/입니다. 인증을 Bearer 토큰으로 설정하고 플러그인의 API 키를 붙여 넣은 다음 서버 추가 및 테스트를 선택하세요. 주소가 https로 시작하므로 AskWatch는 암호화되지 않은 연결에 대한 경고를 표시하지 않습니다.
Tailscale은 공인 인증 기관인 Let's Encrypt에서 인증서를 발급받으므로, 인증서를 수동으로 신뢰하도록 설정할 필요가 없습니다. 저희는 이를 기기에서 확인하지 않았습니다.
이 용도로 tailscale funnel을 사용하지 마세요. Tailscale은 tailscale serve를 tailnet 내부에서 서비스를 공유하는 기능으로, tailscale funnel을 인터넷을 통해 모든 사용자에게 서비스를 공개하는 기능으로 설명합니다.
Tailscale의 접근 규칙은 다른 서비스와 마찬가지로 Serve에도 적용되며, tailnet에 공유된 기기도 접근할 수 있습니다. 플러그인 자체의 API 키는 여전히 필요합니다. 도구 설정은 매번 질문으로 유지하세요.
도구가 노트를 처리하도록 허용하기 전에
- 플러그인의 도구는 노트를 작성, 이동, 삭제하고 모든 Obsidian 명령을 실행할 수 있습니다. AskWatch에서는 각 도구를 꺼짐, 매번 질문 또는 묻지 않고 실행으로 설정할 수 있습니다.
- 도구 설정은 매번 질문으로 유지하세요. 서버가 읽기 전용으로 표시하지 않은 도구의 경우, AskWatch는 묻지 않고 실행 설정을 허용하기 전에 경고를 표시합니다.
- 도구가 반환하는 내용은 대화의 일부가 되므로 선택한 AI 제공업체로 전송됩니다. 플러그인의 README에 따르면 결과는 보통 모델의 컨텍스트에 바로 전달됩니다.
- README에 따르면 플러그인은 API 키로 접근을 제어합니다. 키를 비공개로 보관하고 인터넷에서 플러그인의 포트에 접근할 수 없도록 하세요.
- AskWatch는 iCloud Keychain을 통해 다른 기기와 동기화할 수 있는 항목으로 키를 키체인에 저장합니다.
작동하지 않는 경우
- Obsidian이 열려 있는지, 플러그인이 활성화되어 있는지, Enable HTTP server가 켜져 있는지 확인하세요. 주소가 포트와 마지막 슬래시를 포함해 정확히
http://127.0.0.1:27123/mcp/인지도 확인하세요. - 플러그인의 현재 API 키를 붙여 넣었는지 확인하세요. README에 따르면 1분 안에 잘못된 키가 10번 입력되면 해당 1분이 끝날 때까지 플러그인이 이후의 잘못된 키를 거부합니다.
- 다른 커뮤니티 대안으로는 같은 플러그인을 통해 작동하는 cyanheads의 obsidian-mcp-server가 있습니다. 해당 README에 따르면 STDIO 또는 Streamable HTTP를 지원하고, 기본적으로 STDIO로 실행되며, HTTP 모드(
MCP_TRANSPORT_TYPE=http)에서는http://127.0.0.1:3010/mcp에서 요청을 수신합니다. AskWatch는 서버의 HTTP 모드만 사용할 수 있습니다. 플러그인의 README에서는 타사 서버가 더 이상 필요하지 않다고 설명합니다. 저희는 이 서버도 사용해 보지 않았습니다. - 이 연결 방법이 작동한다고 보장할 수 없으며, 타사 플러그인을 수정할 수도 없습니다. 플러그인 문제는 해당 이슈 트래커에 신고하세요.
확인하지 않은 사항
- AskWatch 팀에서는 누구도 AskWatch를 이 플러그인에 연결해 본 적이 없습니다. 이 플러그인을 대상으로 서버 추가 및 테스트가 성공하는지 알지 못합니다.
- 문서상으로는 양쪽이 지원하는 프로토콜 개정 버전이 겹칩니다. AskWatch는 MCP 개정 버전 2026-07-28, 2025-11-25, 2025-06-18 및 2025-03-26을 지원하며, 플러그인의 README에 따르면 플러그인은 2026-07-28 및 2024-10-07부터 2025-11-25까지를 지원합니다. 저희는 실제로 사용해 보지 않았습니다.
- 저희는 https 주소나 다른 Obsidian 플러그인 또는 서버를 사용해 보지 않았습니다.
- 플러그인과 Obsidian은 변경될 수 있습니다. 이 페이지는 2026년 10월 17일에 공개된 플러그인 버전 5.5.2의 README를 2026년 11월 7일에 읽고 작성했습니다.
- 저희는 Tailscale을 비롯해 표에 나온 다른 연결 방식까지, iPhone 또는 iPad용 연결 방식을 하나도 시도해 보지 않았습니다. 명령어와 설정은 2026년 11월 7일에 읽은 Tailscale 및 Cloudflare 문서에서 가져왔습니다.
타사 제품 고지
Obsidian, Tailscale 및 Cloudflare는 타사 제품입니다. AskWatch는 Obsidian, Tailscale 또는 Cloudflare와 제휴 관계가 없으며 이들의 보증을 받지 않습니다. 해당 이름과 상표는 각 소유자에게 귀속됩니다.
출처
모든 출처는 2026년 11월 7일에 읽었습니다.
- Local REST API with MCP: GitHub의 README
- Obsidian: 플러그인 보안
- Obsidian 플러그인 디렉터리: Local REST API with MCP
- cyanheads/obsidian-mcp-server: GitHub의 README
- RFC 1122, 3.2.1.3절: 127 루프백 주소
- Tailscale: tailscale serve 명령어
- Tailscale: Tailscale Serve
- Tailscale: tailscale funnel 명령어
- Tailscale: HTTPS 활성화
- Tailscale: iOS에 Tailscale 설치
- Cloudflare: 공개 애플리케이션용 Tunnel
- Cloudflare: Universal SSL 인증서
- Cloudflare: Access 서비스 토큰
- Cloudflare: Access 정책
- Cloudflare: Managed OAuth
- Cloudflare: 사설 네트워크
- Cloudflare: Cloudflare One Client 다운로드
- Local REST API with MCP: 기본 바인딩 호스트가 지정된 소스 파일