Cập nhật lần cuối ngày 7 tháng 11 năm 2026.
Có thể làm gì
Plugin cộng đồng Local REST API with MCP của Adam Coddington tích hợp một máy chủ MCP chạy bên trong Obsidian. README của plugin cho biết máy chủ sử dụng phương thức truyền tải Streamable HTTP và cần khóa API. AskWatch kết nối với máy chủ MCP qua Streamable HTTP tại địa chỉ bạn nhập.
- Mac phải được bật. Tiện ích bổ sung chạy bên trong phiên bản Obsidian dành cho máy tính, nên Obsidian phải được mở trên Mac và tiện ích bổ sung phải được bật, bất kể bạn dùng cách kết nối nào. Địa chỉ trong các bước bên dưới, 127.0.0.1, luôn chỉ máy tính bạn đang sử dụng. Vì vậy, các bước đó dùng được trong AskWatch trên Mac đang chạy Obsidian, nhưng không dùng được trên iPhone, iPad hoặc Apple Watch. Cách kết nối thứ 2 qua Tailscale cho phép truy cập từ iPhone hoặc iPad.
- Công cụ cho ghi chú của bạn. Plugin liệt kê các công cụ để đọc, tìm kiếm, tạo, sửa đổi, di chuyển và xóa ghi chú, cũng như chạy các lệnh Obsidian.
- Phần mềm cộng đồng. Plugin không do Obsidian hay AskWatch phát triển. AskWatch chưa kiểm thử plugin này.
Những gì bạn cần
- AskWatch trên Mac, có thẻ Máy chủ MCP trong phần cài đặt.
- Obsidian trên cùng máy Mac, đã bật plugin cộng đồng. Obsidian chỉ chạy plugin cộng đồng khi Restricted mode tắt. Trước tiên, hãy đọc trang của Obsidian về bảo mật plugin: trang này cho biết plugin cộng đồng có thể truy cập các tệp trên máy tính của bạn.
- Plugin Local REST API with MCP, được cài đặt từ danh sách plugin cộng đồng của Obsidian và đã bật. Plugin có trong danh mục plugin của Obsidian.
- Khóa API của plugin, hiển thị trong Obsidian tại Settings → Local REST API.
Các bước thực hiện
- Trong Obsidian, bật plugin cộng đồng, cài đặt Local REST API with MCP rồi bật plugin này.
- Trong Obsidian, mở Settings → Local REST API. Sao chép khóa API và bật Enable HTTP server. README nêu rằng bật tùy chọn này là cách để sử dụng địa chỉ HTTP không mã hóa của plugin.
- Trong AskWatch trên Mac, mở Cài đặt, sau đó mở thẻ Máy chủ MCP, chọn Thêm Máy chủ MCP rồi chọn Thêm theo địa chỉ.
- Nhập tên bất kỳ vào Tên máy chủ. Trong URL máy chủ, nhập
http://127.0.0.1:27123/mcp/. Đặt Xác thực thành Mã thông báo Bearer và dán khóa API vào trường Mã thông báo Bearer. Sau đó chọn Thêm và Kiểm tra Máy chủ. - Vì địa chỉ bắt đầu bằng http, trước tiên AskWatch sẽ hiển thị cảnh báo Kết nối MCP không mã hóa. Đọc cảnh báo, bật Tôi hiểu các rủi ro rồi chọn Tôi hiểu — Tiếp tục.
- Sau đó, AskWatch yêu cầu máy chủ cung cấp danh sách công cụ. Mỗi công cụ được tìm thấy trong quá trình thiết lập này đều được đặt ở Hỏi mỗi lần lúc đầu.
Tên các mục trong Obsidian và plugin được viết bằng tiếng Anh, theo cách viết trong README của plugin.
Địa chỉ https
Plugin cũng cung cấp địa chỉ https://127.0.0.1:27124/mcp/. Chứng chỉ của plugin do một tổ chức phát hành chứng chỉ mà chính plugin tạo ra cấp, và README cho biết ứng dụng khách phải tin cậy tổ chức đó. Mã xử lý kết nối MCP của AskWatch không có ngoại lệ cho các chứng chỉ mà macOS không tin cậy. Hãy dùng địa chỉ http, trừ khi bạn đã thiết lập để macOS tin cậy tổ chức phát hành chứng chỉ của plugin. Chúng tôi chưa thử địa chỉ https.
Trên iPhone hoặc iPad
Tiện ích bổ sung chỉ lắng nghe kết nối trên chính Mac, trừ khi bạn thay đổi cài đặt Binding host của tiện ích bổ sung. Với iPhone hoặc iPad, địa chỉ phải cho phép truy cập Mac qua mạng, nên đây là cách kết nối thứ 2 và cần thiết lập nhiều hơn. AskWatch chưa thử bất kỳ cách kết nối nào trong bảng dưới đây. Các lệnh và cài đặt được lấy từ tài liệu chính thức của các sản phẩm.
Khi bật đồng bộ hóa, AskWatch đồng bộ các máy chủ MCP bạn thêm cùng với địa chỉ của chúng sang các thiết bị khác của bạn. Địa chỉ trong tailnet của bạn giống nhau trên mọi thiết bị. Địa chỉ 127.0.0.1 luôn chỉ thiết bị đang sử dụng địa chỉ đó, nên máy chủ được thêm trên Mac bằng địa chỉ này không cho phép truy cập Obsidian từ iPhone.
Cách kết nối nào hoạt động phụ thuộc vào những gì AskWatch có thể gửi. Biểu mẫu Thêm theo địa chỉ cung cấp các tùy chọn Không, Mã thông báo Bearer và Đăng nhập OAuth. Biểu mẫu này không có trường để nhập các tiêu đề yêu cầu bổ sung.
Tất cả các cách kết nối chúng tôi tìm thấy
Các cách để thiết bị khác truy cập tiện ích bổ sung trên Mac, theo tài liệu của các sản phẩm được nêu tên, và khả năng sử dụng từng cách trong AskWatch hiện nay.
| Cách kết nối | iPhone và iPad | Ai có thể truy cập các công cụ của kho ghi chú | Những gì bạn cần thiết lập | Nhận định của chúng tôi | AskWatch hiện có dùng được không |
|---|---|---|---|---|---|
Chỉ trên Mac, tại 127.0.0.1 (các bước ở trên) | Không | Các chương trình trên Mac đó | Tiện ích bổ sung và tùy chọn bật máy chủ HTTP của tiện ích bổ sung | Cách kết nối đơn giản nhất. Không thiết bị nào khác có thể kết nối. | Có. AskWatch chưa thử cách này. |
| Tailscale Serve (các bước bên dưới) | Có, khi ứng dụng Tailscale đã đăng nhập vào cùng tailnet | Các thiết bị trong tailnet của bạn được quy tắc truy cập Tailscale của bạn cho phép | Tailscale trên cả 2 thiết bị, bật HTTPS trong bảng điều khiển quản trị, chạy 1 lệnh trên Mac | Một cách kết nối riêng tư. Giữ các công cụ ở chế độ Hỏi mỗi lần. | Có, với địa chỉ https kết thúc bằng ts.net. AskWatch chưa thử cách này. |
| Tailscale Funnel | Có | Bất kỳ ai trên internet | Chạy 1 lệnh trên Mac | Không khuyến nghị. Khóa API của tiện ích bổ sung sẽ là lớp bảo vệ duy nhất cho các công cụ có thể ghi và xóa ghi chú. | AskWatch có thể chấp nhận địa chỉ https, nhưng chúng tôi không khuyến nghị cách kết nối này và không cung cấp các bước thực hiện. |
| Chỉ dùng Cloudflare Tunnel, với tên máy chủ công khai | Có | Bất kỳ ai trên internet truy cập được tên máy chủ đó | Tên miền trên Cloudflare, cloudflared trên Mac, tên máy chủ công khai cho tiện ích bổ sung | Không khuyến nghị. Khóa API của tiện ích bổ sung sẽ là lớp bảo vệ duy nhất cho các công cụ có thể ghi và xóa ghi chú. | AskWatch có thể chấp nhận địa chỉ https, nhưng chúng tôi không khuyến nghị cách kết nối này và không cung cấp các bước thực hiện. |
| Cloudflare Tunnel kết hợp với Cloudflare Access và mã thông báo dịch vụ | Có | Chỉ các yêu cầu có kèm mã thông báo dịch vụ | Tên miền trên Cloudflare, đường hầm, ứng dụng Access có chính sách Service Auth, mã thông báo dịch vụ | Cách này sẽ tạo kết nối riêng tư, nhưng AskWatch không thể gửi mã thông báo. | Không. Hiện tại cách này không hoạt động: biểu mẫu Thêm bằng địa chỉ và kết nối MCP không có trường để nhập các tiêu đề yêu cầu CF-Access-Client-Id và CF-Access-Client-Secret. Đã có kế hoạch bổ sung hỗ trợ. |
| Cloudflare Tunnel kết hợp với Cloudflare Access và đăng nhập (Managed OAuth) | Có | Những người được chính sách Access của bạn cho phép | Như hàng trên, đồng thời bật Managed OAuth cho ứng dụng Access | Cách này sẽ tạo kết nối riêng tư, nhưng chúng tôi chưa biết liệu có hoạt động hay không. | Chưa rõ. Tiện ích bổ sung yêu cầu khóa API riêng trong tiêu đề Authorization, còn AskWatch gửi 1 giá trị Authorization, nên chúng tôi chưa thấy cách gửi cả 2. AskWatch chưa thử cách này. |
| Mạng riêng Cloudflare, với Cloudflare One Client trên iPhone hoặc iPad | Có, với ứng dụng Cloudflare One Agent | Các thiết bị đã đăng ký vào tổ chức Cloudflare Zero Trust của bạn | Tổ chức Zero Trust, trình kết nối và tuyến mạng, ứng dụng trên thiết bị | Về nguyên tắc, đây là kết nối riêng tư. | Chưa rõ. Trong các trang đã đọc, chúng tôi không tìm thấy cách để tuyến mạng như vậy truy cập dịch vụ chỉ lắng nghe trên 127.0.0.1, nên chúng tôi không cung cấp các bước thực hiện. |
| Địa chỉ của Mac trên mạng gia đình của bạn | Có, khi ở cùng mạng | Mọi thiết bị trên mạng đó | Đặt Binding host của tiện ích bổ sung thành địa chỉ của Mac | Không khuyến nghị. Kết nối dùng http không mã hóa và mọi thiết bị trên mạng đều có thể truy cập tiện ích bổ sung. | AskWatch chấp nhận http không mã hóa đến các địa chỉ riêng và hiển thị cảnh báo Kết nối MCP không mã hóa. Chúng tôi không cung cấp các bước thực hiện. |
Các bước dùng Tailscale Serve
Chỉ làm theo các bước này nếu bạn chấp nhận rằng AskWatch chưa thử chúng và mọi thiết bị được quy tắc Tailscale của bạn cho phép đều có thể truy cập tiện ích bổ sung.
- Cài đặt Tailscale trên Mac và trên iPhone hoặc iPad, rồi đăng nhập vào cùng tailnet trên cả 2 thiết bị. Trên iOS, ứng dụng yêu cầu cài đặt cấu hình VPN. Giữ Tailscale kết nối trên iPhone hoặc iPad trong khi sử dụng các công cụ.
- Trong bảng điều khiển quản trị Tailscale, mở trang DNS, bật MagicDNS nếu đang tắt, rồi trong mục HTTPS Certificates, chọn Enable HTTPS. Tailscale cảnh báo rằng tên máy và tên tailnet của bạn khi đó sẽ được công bố trong sổ đăng ký chứng chỉ công khai, nên đừng bật tùy chọn này nếu tên máy chứa thông tin nhạy cảm.
- Trong Obsidian, kiểm tra xem Enable HTTP server đã bật chưa, như ở bước 2 bên trên. Tiện ích bổ sung vẫn chỉ lắng nghe trên 127.0.0.1.
- Trong cửa sổ dòng lệnh trên Mac, chạy
tailscale serve --bg http://127.0.0.1:27123. Tailscale hiển thị địa chỉ có dạnghttps://device-name.tailnet-name.ts.net. Chạytailscale serve statusđể xem lại địa chỉ vàtailscale serve resetđể tắt việc cung cấp dịch vụ. - Trong AskWatch trên iPhone hoặc iPad, mở Cài đặt, rồi Máy chủ MCP, rồi Quản lý máy chủ MCP. Chọn Thêm Máy chủ MCP, sau đó chọn Thêm theo địa chỉ.
- Nhập tên bất kỳ vào Tên máy chủ. Trong URL máy chủ, nhập địa chỉ từ lệnh trước và thêm
/mcp/vào cuối, ví dụhttps://device-name.tailnet-name.ts.net/mcp/. Đặt Xác thực thành Mã thông báo Bearer, dán khóa API của tiện ích bổ sung và chọn Thêm và Kiểm tra Máy chủ. Địa chỉ bắt đầu bằng https nên AskWatch không hiển thị cảnh báo về kết nối không mã hóa.
Tailscale lấy chứng chỉ từ Let's Encrypt, một tổ chức cấp chứng chỉ công khai, nên bạn không phải tự xác nhận tin cậy chứng chỉ. Chúng tôi chưa kiểm tra điều này trên thiết bị.
Không dùng tailscale funnel cho việc này. Tailscale mô tả tailscale serve là chia sẻ dịch vụ trong tailnet của bạn, còn tailscale funnel là chia sẻ dịch vụ qua internet để mọi người đều có thể truy cập.
Các quy tắc truy cập của Tailscale áp dụng cho Serve như với bất kỳ dịch vụ nào khác, và thiết bị được chia sẻ vào tailnet của bạn cũng có thể truy cập dịch vụ này. Vẫn cần khóa API riêng của tiện ích bổ sung. Giữ các công cụ ở chế độ Hỏi mỗi lần.
Trước khi cho phép công cụ thao tác với ghi chú
- Các công cụ của plugin có thể ghi, di chuyển và xóa ghi chú, cũng như chạy bất kỳ lệnh Obsidian nào. Trong AskWatch, mỗi công cụ có thể được đặt thành Tắt, Hỏi mỗi lần hoặc Chạy mà không hỏi.
- Hãy giữ các công cụ ở Hỏi mỗi lần. Với công cụ mà máy chủ không đánh dấu là chỉ đọc, AskWatch sẽ hiển thị cảnh báo trước khi chấp nhận Chạy mà không hỏi.
- Dữ liệu công cụ trả về trở thành một phần của cuộc trò chuyện, nên sẽ được gửi đến nhà cung cấp AI bạn đã chọn. README của plugin cho biết kết quả thường được đưa thẳng vào ngữ cảnh của mô hình.
- Theo README, plugin kiểm soát quyền truy cập bằng khóa API. Hãy giữ kín khóa và không để cổng của plugin có thể được truy cập từ internet.
- AskWatch lưu khóa trong Keychain dưới dạng một mục có thể đồng bộ với các thiết bị khác của bạn qua iCloud Keychain.
Nếu kết nối không hoạt động
- Kiểm tra rằng Obsidian đang mở, plugin đã bật, Enable HTTP server đã bật và địa chỉ chính xác là
http://127.0.0.1:27123/mcp/, bao gồm cả cổng và dấu gạch chéo ở cuối. - Kiểm tra rằng bạn đã dán khóa API hiện tại của plugin. Theo README, sau 10 lần nhận khóa sai trong 1 phút, plugin sẽ từ chối các khóa sai tiếp theo cho đến khi phút đó kết thúc.
- Một lựa chọn khác từ cộng đồng là obsidian-mcp-server của cyanheads, hoạt động thông qua cùng plugin này. README của máy chủ cho biết máy chủ hỗ trợ STDIO hoặc Streamable HTTP, mặc định chạy bằng STDIO và ở chế độ HTTP (
MCP_TRANSPORT_TYPE=http) sẽ lắng nghe tạihttp://127.0.0.1:3010/mcp. AskWatch chỉ có thể sử dụng chế độ HTTP của máy chủ. README của plugin cho biết các máy chủ bên thứ ba không còn cần thiết. Chúng tôi cũng chưa thử máy chủ này. - Chúng tôi không thể cam kết cách kết nối này hoạt động, và chúng tôi không thể sửa lỗi plugin của bên thứ ba. Hãy báo cáo vấn đề với plugin trên trang theo dõi vấn đề của plugin.
Những gì chúng tôi chưa kiểm tra
- Chưa có ai tại AskWatch kết nối AskWatch với plugin này. Chúng tôi không biết liệu Thêm và Kiểm tra Máy chủ có thành công khi kết nối với plugin này hay không.
- Theo tài liệu, hai bên có các bản sửa đổi giao thức chung: AskWatch hỗ trợ các bản sửa đổi MCP 2026-07-28, 2025-11-25, 2025-06-18 và 2025-03-26, còn README của plugin cho biết plugin hỗ trợ 2026-07-28 và các bản từ 2024-10-07 đến 2025-11-25. Chúng tôi chưa thử.
- Chúng tôi chưa thử địa chỉ https hay bất kỳ plugin hoặc máy chủ Obsidian nào khác.
- Plugin và Obsidian có thể thay đổi. Trang này dựa trên README của plugin phiên bản 5.5.2, được phát hành ngày 17 tháng 10 năm 2026, theo nội dung được đọc ngày 7 tháng 11 năm 2026.
- Chúng tôi chưa thử bất kỳ cách kết nối nào cho iPhone hoặc iPad, dù là Tailscale hay các cách khác trong bảng. Các lệnh và cài đặt được lấy từ tài liệu của Tailscale và Cloudflare mà chúng tôi đã đọc vào ngày 7 tháng 11 năm 2026.
Thông báo về bên thứ ba
Obsidian, Tailscale và Cloudflare là các sản phẩm của bên thứ 3. AskWatch không có liên kết với và không được Obsidian, Tailscale hay Cloudflare chứng thực. Tên và nhãn hiệu của các sản phẩm này thuộc về chủ sở hữu tương ứng.
Nguồn
Tất cả đều được đọc ngày 7 tháng 11 năm 2026.
- Local REST API with MCP: README trên GitHub
- Obsidian: Bảo mật plugin
- Danh mục plugin Obsidian: Local REST API with MCP
- cyanheads/obsidian-mcp-server: README trên GitHub
- RFC 1122, mục 3.2.1.3: các địa chỉ vòng lặp 127
- Tailscale: lệnh tailscale serve
- Tailscale: Tailscale Serve
- Tailscale: lệnh tailscale funnel
- Tailscale: bật HTTPS
- Tailscale: cài đặt Tailscale trên iOS
- Cloudflare: đường hầm cho các ứng dụng công khai
- Cloudflare: chứng chỉ Universal SSL
- Cloudflare: mã thông báo dịch vụ Access
- Cloudflare: chính sách Access
- Cloudflare: Managed OAuth
- Cloudflare: mạng riêng
- Cloudflare: tải xuống Cloudflare One Client
- Local REST API with MCP: tệp mã nguồn chứa địa chỉ lắng nghe mặc định