Tài liệu

Máy chủ MCP

Cần quyền lợi tài khoản tương ứng

Chỉ có thể truy cập MCP khi quyền lợi hiện tại của tài khoản Savebase đã đăng nhập đã bao gồm tính năng này.

Savebase cung cấp một Model Context Protocol (MCP) để trợ lý AI có thể tìm kiếm, đọc dấu trang đã lưu. Hỏi Claude, ChatGPT hoặc Cursor, chẳng hạn "Mình đã lưu gì về tập tạ ấm nhỉ?" và công cụ sẽ truy vấn trực tiếp thư viện Savebase.

Tổng quan

MCP là tiêu chuẩn mở cho phép ứng dụng AI kết nối với nguồn dữ liệu bên ngoài. Savebase triển khai điểm cuối HTTP tương thích MCP, cung cấp cho trợ lý AI quyền chỉ đọc dấu trang, thư mục và thẻ của bạn.

Đối với ChatGPT, hãy cài đặt bản đã phát hành của Plugin Savebase. Với Claude, Cursor, VS Code và các ứng dụng khách MCP khác, dùng địa chỉ máy chủ này:

text
https://mcp.savebase.space/mcp

Đăng nhập như app khác bằng tài khoản, không sao API key hay token. MCP chỉ đọc: không công cụ kết nối nào thêm/sửa/xóa được.

Yêu cầu

  • Tài khoản Savebase có quyền truy cập MCP trong quyền lợi hiện tại
  • Plugin Savebase công bố cho ChatGPT hoặc MCP như Claude, Cursor, VS Code

Claude (web, máy tính, di động)

1

Mở trình kết nối Claude

Trong claude.ai hoặc ứng dụng máy tính, vào Cài đặt → Trình kết nối.
2

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

Nhấp Thêm trình kết nối tùy chỉnh, đặt tên là Savebase, rồi dán https://mcp.savebase.space/mcp.
3

Kết nối và đăng nhập

Nhấp Thêm → Kết nối, đăng nhập bằng tài khoản Savebase và chấp thuận. Các công cụ Savebase giờ đã có trong cuộc trò chuyện.

Cũng dùng được trên di động

Trình kết nối từ xa thêm trên claude.ai có thể dùng trong Claude cho iOS và Android, nhưng không thể thêm máy chủ mới trực tiếp từ Claude Mobile. Xem tài liệu của Anthropic: ghi chú hiện hành về hỗ trợ MCP từ xa.

Claude Code

1

Thêm máy chủ

Chạy lệnh sau trong terminal. Kéo --scope user nếu chỉ muốn dùng trong dự án hiện tại.
bash
claude mcp add --transport http --scope user savebase https://mcp.savebase.space/mcp
2

Xác thực

Mở Claude Code rồi chạy /mcp. Một cửa sổ trình duyệt mở ra — đăng nhập và chấp thuận.
3

Xác minh

Chạy claude mcp list. Savebase sẽ hiển thị là đã kết nối.

Cursor

1

Mở cấu hình MCP

Đi tới Cài đặt → MCP → Thêm máy chủ, hoặc chỉnh sửa ~/.cursor/mcp.json trực tiếp.
2

Thêm máy chủ Savebase

Thêm mục bên dưới. Lưu ý không có headers — việc xác thực diễn ra trong trình duyệt.
json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

Tải lại và cấp quyền

Tải lại Cursor. Máy chủ sẽ hiện cần đăng nhập; nhấp vào, đăng nhập rồi chấp thuận.

Thông tin quan trọng cho người dùng Cursor

Luôn chọn HTTP làm loại máy chủ — chọn HTTP, không phải SSE. Nếu trước đây đã thêm Savebase bằng SSE, hãy xóa và thêm lại bằng HTTP rồi khởi động lại Cursor.

ChatGPT

1

Mở plugin Savebase

Truy cập trang chính thức Trang giới thiệu plugin Savebase trong ChatGPT.
2

Cài đặt và đăng nhập

Chọn nút cộng để cài Savebase. Khi được hỏi, đăng nhập và duyệt truy cập thư viện chỉ đọc.
3

Dùng Savebase trong trò chuyện

Mở cuộc trò chuyện ChatGPT Work mới và gọi Savebase bằng @Savebase, hoặc chọn từ khung soạn tin khi muốn ChatGPT tìm trong thư viện.

Không cần thiết lập cho nhà phát triển

Plugin công khai thay chế độ nhà phát triển và MCP tự cấu hình ChatGPT cũ. URL trên vẫn dùng cho máy khách khác.

VS Code

1

Thêm máy chủ

Mở Bảng lệnh, chạy MCP: Thêm máy chủ, chọn HTTP, rồi dán https://mcp.savebase.space/mcp.
2

Hoặc chỉnh sửa cấu hình trực tiếp

Thêm mục này vào .vscode/mcp.json trong không gian làm việc:
json
{
  "servers": {
    "savebase": {
      "type": "http",
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

Đăng nhập

Khởi động máy chủ từ giao diện MCP. Trình duyệt mở để đăng nhập; duyệt rồi công cụ hiện trong chế độ tác nhân Copilot Chat.

Quản lý ứng dụng đã kết nối

Mọi ứng dụng bạn đăng nhập đều được liệt kê trong Cài đặt → Máy chủ MCP → Ứng dụng kết nối, kèm ngày bạn kết nối và lần cuối đọc thư viện. Nhấp Ngắt kết nối để thu hồi quyền ngay.

Ứng dụng có thể thấy gì

Ứng dụng đã kết nối có quyền chỉ đọc dấu trang, ghi chú, bản chép lời, tên thư mục và thẻ của bạn. Chúng không bao giờ thấy mật khẩu và không thể sửa thư viện.

Savebase chỉ gửi dữ liệu khi yêu cầu khiến trợ lý kết nối truy vấn máy chủ MCP; không đẩy thư viện sang ứng dụng nền hay dùng huấn luyện mô hình Savebase. Khi dữ liệu đến trợ lý, điều khoản quyền riêng tư và sử dụng dữ liệu của nhà cung cấp đó áp dụng. Xem Chính sách quyền riêng tư Savebase để xem đầy đủ những gì ứng dụng kết nối có thể nhận.

Nâng cao: Token truy cập thủ công

Một số máy khách MCP cũ không đăng nhập bằng trình duyệt được, cần token trong tiêu đề. Khi đó mở Cài đặt → Máy chủ MCP → Nâng cao, nhập nhãn rồi nhấp Tạo mã thông báo. Token bắt đầu bằng sb- và còn hiệu lực cho tới khi bạn thu hồi.

json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp",
      "headers": {
        "Authorization": "Bearer sb-YOUR_MCP_TOKEN"
      }
    }
  }
}

Bảo mật token

Savebase không lưu token gốc, chỉ lưu hàm băm SHA-256. Token chỉ hiện một lần khi tạo, nên hãy sao chép ngay. Thu hồi bất kỳ lúc nào tại Cài đặt → Máy chủ MCP.

Công cụ khả dụng

Sau khi kết nối, trợ lý AI có quyền truy cập chín công cụ này. Tất cả chỉ đọc; không công cụ nào thay đổi bất cứ điều gì trong thư viện.

Công cụMô tả
search_bookmarksTìm từ khóa trong tiêu đề, nội dung, ghi chú, tác giả, URL và bản chép lời video. Thu hẹp theo trường và lọc nền tảng, thư mục, thẻ, người tạo, khoảng ngày hoặc có bản chép lời.
list_bookmarksDuyệt không cần từ khóa, với bộ lọc nền tảng, thư mục, thẻ và ngày tùy chọn
list_recent_bookmarksNội dung lưu hôm nay, tuần này, tháng này hoặc 7/30 ngày qua
get_bookmarkThông tin đầy đủ về một dấu trang, cùng thẻ, thư mục và bản xem trước chép lời
get_bookmark_transcriptĐọc bản chép lời video dài theo từng phần để không phải tải tất cả cùng lúc
find_bookmark_by_urlKiểm tra xem liên kết đã được lưu chưa. Bỏ qua tham số theo dõi như utm_source.
list_foldersLiệt kê thư mục của bạn, bao gồm cấu trúc lồng nhau
list_tagsLiệt kê tất cả thẻ của bạn
get_library_statsTổng số, phân bổ theo nền tảng, các thư mục và thẻ dùng nhiều nhất, cùng hoạt động lưu gần đây

Ví dụ câu lệnh

Thử hỏi trợ lý AI những câu như:

  • "Mình đã lưu gì về tập tạ ấm nhỉ?"
  • "Cho tôi xem mọi thứ đã lưu từ Reddit tháng trước."
  • "Tìm video đã lưu có người giải thích cách thiết lập Cloudflare Worker."
  • "Tôi đã lưu liên kết này chưa?" — dán URL
  • "Tìm mọi dấu trang trong thư mục ‘Cảm hứng thiết kế’ của tôi."
  • "Tôi đã gắn thẻ ‘AI’ cho những bài báo nào?"
  • "Phân tích thư viện của tôi — có bao nhiêu, từ đâu, những thẻ phổ biến nhất."
  • "Tóm tắt các bài viết tôi lưu tuần trước."

Tìm lời đã nói trong video

Nếu đã chép lời video được lưu, bạn cũng có thể tìm kiếm nội dung lời nói của video. Một câu hỏi như "làm X như thế nào" có thể tìm ra một bước được giải thích bằng lời trong đoạn video bạn đã lưu từ nhiều tháng trước.

Khắc phục sự cố

Vấn đềGiải pháp
Savebase không có trong ChatGPTMở plugin Savebase đã phát hành, cài đặt rồi bắt đầu cuộc trò chuyện ChatGPT Work mới. Bạn không còn cần tạo ứng dụng tùy chỉnh trong chế độ Nhà phát triển.
Ứng dụng không yêu cầu đăng nhậpKiểm tra xem URL có chính xác là https://mcp.savebase.space/mcp — lỗi gõ khiến máy khách không tìm được bước đăng nhập.
"Không thể truy cập MCP" khi đăng nhậpĐăng nhập tài khoản hiện có quyền MCP, hoặc liên hệ hỗ trợ nếu cho rằng quyền không đúng.
"Yêu cầu này đã hết hạn"Yêu cầu ủy quyền có hiệu lực 10 phút. Bắt đầu kết nối lại từ ứng dụng AI.
Kết nối ngừng hoạt độngKiểm tra xem ứng dụng còn xuất hiện trong Cài đặt → MCP Server → Ứng dụng đã kết nối không. Nếu đã ngắt kết nối, hãy kết nối lại từ ứng dụng đó.
Máy chủ hiện «errored» trong CursorXóa mục Savebase cũ trong Cài đặt Cursor → MCP. Thêm lại dưới dạng Loại: HTTP (không phải SSE), rồi khởi động lại hoàn toàn Cursor.
Không thấy công cụKhởi động lại ứng dụng AI sau khi thêm cấu hình. Một số ứng dụng cần khởi động lại hoàn toàn để phát hiện máy chủ MCP mới.
Không có kết quảĐảm bảo bạn có dấu trang đã lưu trong thư viện Savebase. Máy chủ MCP chỉ tìm kiếm dữ liệu của chính bạn.
Mất mã thông báo thủ côngToken chỉ hiển thị một lần. Thu hồi token cũ tại Cài đặt → Máy chủ MCP → Nâng cao rồi tạo token mới.

Các bước khôi phục nhanh

Nếu có vấn đề: (1) ngắt kết nối Savebase trong ứng dụng AI, (2) xóa khỏi Cài đặt → Máy chủ MCP → Ứng dụng đã kết nối, (3) thêm trình kết nối lại và đăng nhập, (4) khởi động lại hoàn toàn ứng dụng khách AI.