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

Mọi thư mục xuất, dù ở đâu, mỗi thư mục mang tên của chính nó, như notes hoặc messages. Hai thư mục trùng tên được phân biệt bằng tên thư mục cha, như export (Bear). 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.

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 bao quát mọi bản xuất. Apple Notes, Danh bạ và Tin nhắn được xếp hạng 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. Tệp của mọi ứng dụng khác, trong đó có Mail, Lịch, Bear, Lời nhắc và Tài liệu, được quét bên cạnh, và hai danh sách lần lượt xen kẽ trong kết quả. 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à 50 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í