Máy chủ MCP

Exporter chạy một máy chủ MCP bên trong ứng dụng. Máy chủ cung cấp các thư mục xuất của bạn cho Claude, Cursor, VS Code và mọi ứng dụng khách MCP khác, ở chế độ chỉ đọc và chỉ trên Mac của bạn. Về các skill và dòng lệnh mà agent cũng dùng được, xem Cho agent.

Khởi động

1. Xuất ít nhất một ứng dụng dưới dạng Markdown (bắt đầu). Máy chủ chỉ đọc tệp Markdown.
2. Trên thẻ Máy chủ MCP, nhấn “bắt đầu”. Thẻ sau đó hiển thị localhost:8744 và một hàng “kết nối”.

Điểm cuối là http://localhost:8744/mcp (Streamable HTTP), trên một cổng cố định. Máy chủ nằm trong ứng dụng: nó trả lời trong lúc Exporter chạy, dù cửa sổ mở hay đóng, và dừng khi bạn thoát. Nếu máy chủ đang chạy khi bạn thoát, nó sẽ khởi động lại cùng ứng dụng. curl -s http://127.0.0.1:8744/health trả lời OK khi máy chủ đang chạy.

Kết nối Claude Code

claude mcp add --transport http exporter http://localhost:8744/mcp

Thêm --scope user để dùng nó trong mọi dự án. Nút “claude code” trên thẻ sao chép lệnh này.

Claude Desktop, Cursor và VS Code

• Claude Desktop: nhấn “claude desktop” trên thẻ. Nút này sao chép một mục chạy npx -y mcp-remote http://localhost:8744/mcp (npx đi kèm Node.js). Dán nó vào bên trong mcpServers ở Settings > Developer > Edit Config, lưu lại, rồi thoát Claude và mở lại
• Cursor hoặc VS Code: nhấn “cursor” hoặc “vs code” trên thẻ. Trình soạn thảo mở ra với máy chủ sẵn sàng để cài; hãy xác nhận ở đó

Những thư mục được cung cấp

Các thư mục xuất nằm trong cùng thư mục cha với thư mục xuất Apple Notes (nếu không có, thì là thư mục xuất đầu tiên máy chủ tìm thấy). Một thư mục xuất ở bất kỳ nơi nào khác sẽ vô hình với agent, và thẻ Máy chủ MCP cho biết agent thấy được những thư mục nào.

thư mục xuất	được cung cấp
~/Documents/notes, ~/Documents/messages	cả hai
~/Documents/notes, ~/Dropbox/messages	chỉ notes

Để đưa một thư mục vào, nhấn “thay đổi…” trên hàng xuất tới của ứng dụng đó, chọn một thư mục trong cùng thư mục cha, rồi nhấn “đồng bộ lại toàn bộ” trên thẻ đó. Máy chủ đọc danh sách thư mục khi khởi động, nên hãy nhấn “dừng” rồi “bắt đầu” sau mỗi thay đổi. Mỗi nguồn được đặt tên theo thư mục của nó, như notes hoặc messages.

Sáu công cụ

công cụ	chức năng	tham số
get_stats	theo từng nguồn: số tệp, ngày mới nhất và cũ nhất, dung lượng. Gọi nó trước tiên để biết tên các nguồn	source (tùy chọn)
search	tìm kiếm toàn văn có xếp hạng	query, source (tùy chọn), limit (20)
read	một mục: Markdown, front matter, ngày sửa và dung lượng của nó	source, id (tên tệp không có .md)
list	các mục của một nguồn	source, limit (50), offset (0)
get_recent	các mục thay đổi gần đây nhất	sources (phân tách bằng dấu phẩy, tùy chọn), limit (20)
get_metadata	số lượng và thời điểm đồng bộ gần nhất	source (tùy chọn)

search xếp hạng Apple Notes, Danh bạ và Tin nhắn dựa trên chỉ mục của ứng dụng: một cái tên sẽ tìm ra cuộc trò chuyện, và một kết quả ghi chú mang theo liên kết mở nó trong Apple Notes. Bear, Logseq, Thời gian sử dụng và Tài liệu cũng được cung cấp, nhưng search không xếp hạng chúng khi chỉ mục đang trả lời; hãy truy cập chúng bằng list, get_recent và read. Khi chỉ mục vẫn còn trống, search quét Markdown của mọi nguồn.

Câu trả lời chỉ đầy đủ bằng bản xuất: với phần miễn phí, đó là 100 ghi chú đầu tiên, 100 liên hệ và 10 cuộc trò chuyện gần nhất, 10 ngày và 10 tài liệu của bạn.

Quyền riêng tư

Máy chủ lắng nghe trên 127.0.0.1, nên không gì bên ngoài Mac của bạn truy cập được nó, và nó chỉ đọc. Những gì một công cụ trả về sẽ trở thành một phần cuộc trò chuyện của bạn với AI và được gửi tới mô hình của nó, như mọi thứ bạn dán vào.

Khi không hoạt động

• Chưa cấu hình thư mục xuất nào. Hãy đặt thư mục xuất trước.: chọn một thư mục xuất trên bất kỳ thẻ nào
• Không tìm thấy ghi chú đã xuất. Hãy chạy một lần xuất trước.: nhấn “đồng bộ ngay” trên một thẻ, rồi “bắt đầu”
• một lỗi hệ thống khi nhấn “bắt đầu”: một chương trình khác đang dùng cổng 8744. Thoát chương trình đó rồi bắt đầu lại
• thiếu một nguồn: nó nằm ngoài thư mục cha, chỉ được xuất dưới dạng HTML, xuất hiện sau khi máy chủ khởi động, hoặc vượt quá phần miễn phí