Cách kết nối Obsidian với YouMind bằng MCP

Kho lưu trữ Obsidian của bạn có thể đã chứa mọi thứ bạn cần cho dự án tiếp theo: nghiên cứu, kế hoạch, ghi chú đọc sách và các tác vụ còn dang dở. Kết nối nó với YouMind cho phép bạn biến những ghi chú đó thành thứ bạn có thể sử dụng, chỉ với một yêu cầu bằng ngôn ngữ tự nhiên.

Trong hướng dẫn này, bạn sẽ kết nối một kho lưu trữ Obsidian cục bộ với YouMind, yêu cầu YouMind đọc và sắp xếp một tập hợp các ghi chú, rồi lưu kết quả trở lại Obsidian. Ví dụ sử dụng năm ghi chú về chế độ ăn chống viêm để tạo một kế hoạch hành động có kèm liên kết đến các nguồn gốc.

Trước khi bắt đầu

Bạn sẽ cần:

Phiên bản Obsidian dành cho máy tính và một kho lưu trữ bạn có thể chỉnh sửa.
Một tài khoản YouMind có quyền truy cập vào các trình kết nối tùy chỉnh.
Một tài khoản ngrok. Chúng ta sẽ dùng ngrok để cấp cho máy chủ MCP cục bộ của bạn một địa chỉ HTTPS mà YouMind có thể truy cập.
Một vài ghi chú để làm việc. Bạn có thể sử dụng nghiên cứu, ghi chú dự án hoặc ghi chú lập kế hoạch bữa ăn của riêng mình.

Kết nối hoạt động như sau:

YouMind → địa chỉ HTTPS của ngrok → Trình kết nối MCP → kho lưu trữ Obsidian của bạn

MCP, viết tắt của Model Context Protocol (Giao thức Ngữ cảnh Mô hình), cho phép một ứng dụng AI sử dụng các công cụ do một ứng dụng khác cung cấp. Plugin Obsidian hiển thị các công cụ để làm việc với kho lưu trữ của bạn và YouMind sử dụng chúng để thực hiện yêu cầu của bạn.

Giữ cho máy tính của bạn hoạt động và kết nối internet, đồng thời chạy Obsidian, kho lưu trữ đã kết nối và ngrok bất cứ khi nào bạn sử dụng kết nối này. Địa chỉ cục bộ 127.0.0.1 chỉ trỏ đến máy tính của riêng bạn, vì vậy YouMind cần địa chỉ ngrok để truy cập nó.

Trình kết nối có thể đọc hoặc thay đổi ghi chú tùy theo quyền bạn cấp cho nó. Giữ mã thông báo (token) của nó ở chế độ riêng tư và sử dụng cài đặt quyền công cụ và thư mục ẩn của plugin để kiểm soát quyền truy cập. Nội dung được sử dụng trong một tác vụ sẽ đi qua ngrok và YouMind; việc kết nối một kho lưu trữ không tự động đồng bộ toàn bộ kho lưu trữ.

Ảnh chụp màn hình hiển thị quy trình làm việc trên macOS. Một số chi tiết tài khoản đã được xóa hoặc thay thế bằng các giá trị ví dụ.

1. Cho phép plugin cộng đồng trong Obsidian

Mở Cài đặt → Plugin cộng đồng trong Obsidian.

Nếu kho lưu trữ của bạn đang ở chế độ Hạn chế, hãy nhấp vào Thoát chế độ Hạn chế để cho phép các plugin cộng đồng.

Nhấp vào Duyệt để mở thư mục plugin cộng đồng.

Open the Obsidian community plugin directory.

2. Cài đặt và kích hoạt MCP Connector

Tìm kiếm MCP Connector và chọn plugin của istefox. Kiểm tra tên tác giả, vì thư mục có thể bao gồm các plugin có tên tương tự.

Mở chi tiết của nó và nhấp vào Cài đặt.

Sau khi cài đặt, nhấp vào Kích hoạt.

Mở MCP Connector trong cài đặt của Obsidian để cấu hình máy chủ cục bộ và mã thông báo truy cập của nó. Bạn có thể tìm thêm thông tin trên trang thư mục của plugin.

3. Đặt một cổng máy chủ cố định

Tìm Cổng cố định, nhập 27200 và nhấp vào Lưu.

Phần Cổng máy chủ bây giờ sẽ hiển thị:

http://127.0.0.1:27200/mcp

Một cổng cố định giữ cho kết nối ngrok của bạn luôn trỏ đến cùng một dịch vụ cục bộ. Nếu cổng 27200 đã được sử dụng, hãy chọn một cổng khả dụng và sử dụng số đó trong lệnh ngrok bên dưới.

4. Tạo một mã thông báo cho YouMind

Trong Kiểm soát truy cập, nhấp vào Thêm mã thông báo.

Add a separate access token for YouMind.

Đặt tên cho mã thông báo mới là YouMind để bạn có thể nhận ra nó sau này.

Nhấp vào Sao chép trên hàng của mã thông báo đó. Bạn sẽ dán nó vào YouMind trong một bước sau.

Mỗi mã thông báo có thể có các quyền công cụ riêng. Ví dụ này cần quyền đọc ghi chú và tạo một ghi chú mới. Ảnh chụp màn hình sử dụng cấu hình Tất cả 52 công cụ của plugin; số lượng công cụ khả dụng có thể thay đổi tùy theo phiên bản plugin và cài đặt của bạn.

Hãy coi mã thông báo như một mật khẩu cho quyền truy cập mà nó cấp. Bạn không cần phải dán nó vào một cuộc trò chuyện AI.

5. Khởi động một đường hầm ngrok

Nếu bạn chưa cài đặt ngrok, hãy làm theo hướng dẫn cài đặt chính thức. Trên macOS, nếu bạn đã sử dụng Homebrew, hãy cài đặt nó bằng:

brew install ngrok

Thêm mã xác thực (authtoken) từ bảng điều khiển ngrok của bạn:

ngrok config add-authtoken YOUR_NGROK_AUTHTOKEN

Mã xác thực ngrok kết nối ngrok với tài khoản của bạn. Mã thông báo Obsidian từ bước trước cấp cho YouMind quyền truy cập vào kho lưu trữ của bạn. Giữ hai thông tin xác thực này riêng biệt.

Trong Terminal, chạy:

ngrok http http://127.0.0.1:27200

Start ngrok and forward traffic to Obsidian’s local port.

Giữ cho phiên terminal này chạy. Khi Trạng thái phiên hiển thị trực tuyến, hãy sao chép địa chỉ HTTPS hiển thị trên dòng Chuyển tiếp.

Copy the public HTTPS forwarding address from ngrok.

Thêm /mcp vào cuối địa chỉ đó. URL trình kết nối cuối cùng của bạn sẽ có cấu trúc này:

https://YOUR_NGROK_DOMAIN/mcp

Sử dụng tên miền thực tế hiển thị trong phiên ngrok của riêng bạn. Tên miền trong ảnh chụp màn hình chỉ là một ví dụ. Nếu địa chỉ chuyển tiếp của bạn thay đổi sau này, hãy cập nhật địa chỉ đã lưu trong YouMind.

6. Thêm trình kết nối tùy chỉnh trong YouMind

Trong YouMind, mở Cài đặt → Trình kết nối và nhấp vào Thêm trình kết nối tùy chỉnh.

Nhập tên, ví dụ: obsidian, và dán địa chỉ ngrok của bạn kèm /mcp ở cuối. Mở rộng Cài đặt nâng cao. Trong Tham số tùy chỉnh, nhấp vào Thêm tham số và cấu hình như sau:

Cài đặt	Giá trị
Tên	`obsidian`
URL máy chủ	Địa chỉ HTTPS ngrok của bạn, theo sau là `/mcp`
ID ứng dụng OAuth	Để trống
Bí mật ứng dụng OAuth	Để trống
Tham số tùy chỉnh	`Authorization`
Giá trị tham số	`Bearer YOUR_OBSIDIAN_TOKEN`
Bí mật	Bật

Thay thế YOUR_OBSIDIAN_TOKEN bằng mã thông báo hoàn chỉnh bạn đã sao chép từ Obsidian. Bao gồm một khoảng trắng sau **Bearer**. Ví dụ: nếu mã thông báo của bạn là example-token, giá trị sẽ là:

Bearer example-token

Đây chỉ là một ví dụ về định dạng. Sử dụng mã thông báo của riêng bạn trong cấu hình thực tế. Kết nối này sử dụng xác thực Bearer Token, vì vậy hãy để trống hai trường OAuth.

Configure the server URL and Authorization header in YouMind.

Nhấp vào Thêm, sau đó tìm obsidian trong danh sách trình kết nối và nhấp vào Kết nối.

Connect the newly added Obsidian connector.

Bạn sẽ thấy Đã kết nối bên cạnh tên của nó.

Bây giờ hãy kiểm tra kết nối bằng một tác vụ đọc ghi chú và viết một ghi chú mới.

7. Chuẩn bị một vài ghi chú liên quan

YouMind cần nội dung thực tế để làm việc. Trong ví dụ này, kho lưu trữ chứa năm ghi chú tiếng Anh:

Ghi chú	Nội dung
Nguyên tắc cơ bản về Ăn uống Chống viêm	Nguyên tắc ăn uống chung và mục tiêu cho tuần đầu tiên
Danh sách Mua sắm Chống viêm	Một danh sách mua sắm và các nguyên liệu thay thế
Kế hoạch Bữa ăn Chống viêm 7 Ngày	Một tuần các bữa sáng, trưa và tối
Chuẩn bị Bữa ăn Chống viêm Đơn giản	Các bước chuẩn bị, công thức nấu ăn đơn giản và ghi chú bảo quản
Đánh giá Hàng tuần Chống viêm	Một mẫu đánh giá và các tác vụ theo dõi còn dang dở

Five related notes in the Obsidian vault before the task.

Những ghi chú này là tài liệu mẫu để trình bày quy trình làm việc. Chúng không phải là một kế hoạch y tế hoặc dinh dưỡng cá nhân hóa.

Bạn có thể sử dụng một chủ đề khác. Ví dụ: kết hợp các ghi chú đọc sách thành một hướng dẫn học tập, biến các ghi chú dự án thành danh sách các bước tiếp theo hoặc sắp xếp nghiên cứu du lịch thành một hành trình. Cập nhật chủ đề trong lời nhắc để phù hợp với các ghi chú trong kho lưu trữ của bạn.

8. Yêu cầu YouMind đọc, sắp xếp và lưu

Bắt đầu một tác vụ mới trong YouMind và nhập:

Xem lại các ghi chú Obsidian của tôi về chế độ ăn chống viêm. Tóm tắt các nguyên tắc chính, kết nối danh sách mua sắm với kế hoạch bữa ăn và xác định ba tác vụ còn tồn đọng.
Lưu kết quả bằng tiếng Anh dưới dạng một ghi chú Obsidian mới có tiêu đề "Kế hoạch Hành động Ăn uống Chống viêm", có kèm liên kết nội bộ đến các ghi chú nguồn.

Enter a prompt asking YouMind to read the notes and save a new action plan.

Lời nhắc hướng dẫn YouMind đọc ghi chú nào, cách sắp xếp thông tin, xác định tác vụ nào và lưu kết quả ở đâu. Nó cũng đặt tên cho ghi chú mới và yêu cầu liên kết đến các nguồn, giúp dễ dàng kiểm tra đầu ra.

Gửi tác vụ. YouMind sẽ sử dụng trình kết nối để tìm và đọc các ghi chú liên quan, sau đó tổng hợp kết quả. Bạn có thể theo dõi tiến trình của nó trong cuộc trò chuyện.

YouMind reads the notes and works through the task.

9. Mở ghi chú mới trong Obsidian

Trong ví dụ này, YouMind đã trả về:

Một bản tóm tắt các nguyên tắc trong ghi chú giới thiệu.
Các kết nối giữa danh sách mua sắm và kế hoạch bữa ăn, bao gồm những nguyên liệu nào xuất hiện trong nhiều bữa ăn.
Ba tác vụ còn tồn đọng: lên kế hoạch cho chuyến đi mua sắm, chọn bữa trưa và các buổi chuẩn bị, và hoàn thành việc đánh giá sau đó.
Một ghi chú mới có tiêu đề Kế hoạch Hành động Ăn uống Chống viêm, có kèm liên kết nội bộ đến năm ghi chú gốc.

YouMind reports the completed summary and new Obsidian note.

Tất cả việc cần làm đã hoàn thành đề cập đến tác vụ đọc, sắp xếp và viết của YouMind. Việc mua sắm và chuẩn bị bữa ăn vẫn là các hành động tiếp theo cho người sử dụng kế hoạch.

Chuyển lại sang Obsidian và mở Kế hoạch Hành động Ăn uống Chống viêm.

The new action plan appears in Obsidian with tags and links to its source notes.

Ghi chú mới xuất hiện trong danh sách tệp và nội dung của nó được lưu trong kho lưu trữ của bạn. Trong lần chạy này, nó cũng bao gồm các thẻ và liên kết có thể nhấp vào các ghi chú gốc. Chế độ xem biểu đồ hiển thị các kết nối đó cùng với các ghi chú hiện có.

Bây giờ bạn có thể tiếp tục chỉnh sửa trong Obsidian hoặc yêu cầu YouMind tiếp tục với một yêu cầu cụ thể hơn, chẳng hạn như mở rộng một phần hoặc cập nhật kế hoạch bằng một ghi chú khác.

Khắc phục sự cố

Tại sao tôi thấy lỗi 401 Unauthorized?

Kiểm tra tham số Authorization. Giá trị của nó phải là Bearer, theo sau là một khoảng trắng và mã thông báo Obsidian hoàn chỉnh của bạn. Đảm bảo bạn đã sao chép mã thông báo từ MCP Connector. Nếu bạn đã tạo lại hoặc thu hồi nó, hãy cập nhật giá trị trong YouMind.

Tại sao tôi thấy "OAuth authorization server metadata discovery failed (404)"?

Một lần kiểm tra mã thông báo không thành công có thể khiến ứng dụng khách cố gắng khám phá OAuth. Kết nối plugin này sử dụng Bearer Token, vì vậy trước tiên hãy kiểm tra tiêu đề Authorization và giữ các trường ID ứng dụng OAuth và Bí mật ứng dụng OAuth để trống. Việc thiếu tiền tố Bearer có thể gây ra lỗi này.

Tại sao việc mở URL /mcp trong trình duyệt lại trả về lỗi 405?

Điểm cuối MCP của plugin chấp nhận các yêu cầu MCP thông qua POST. Việc mở một URL trong thanh địa chỉ của trình duyệt thường gửi yêu cầu GET, có thể trả về 405 Method Not Allowed. Xác minh kết nối thông qua YouMind và một tác vụ thực tế.

Tại sao một kết nối đang hoạt động lại ngừng phản hồi?

Kiểm tra xem máy tính của bạn có đang hoạt động và trực tuyến không, Obsidian có đang mở đúng kho lưu trữ không, plugin có được kích hoạt không và ngrok vẫn hiển thị trực tuyến không. Sau đó, so sánh cổng cục bộ và URL ngrok với các giá trị đã lưu trong YouMind.

Nếu tôi không thể tìm thấy ghi chú mới thì sao?

Tìm kiếm trong kho lưu trữ đã kết nối theo tiêu đề bạn đã chỉ định trong lời nhắc. Kiểm tra xem mã thông báo có cho phép tạo ghi chú không. Bạn cũng có thể yêu cầu YouMind cung cấp đường dẫn tương đối chính xác trong kho lưu trữ của tệp mà nó đã tạo, sau đó mở đường dẫn đó trong Obsidian.

Sẵn sàng thử nghiệm với các ghi chú của riêng bạn? Mở YouMind và yêu cầu nó biến một vài ghi chú liên quan thành một trang mới hữu ích trong kho lưu trữ của bạn.