aimcpnhà phát triểnBảo mật

Để AI gửi bí mật mà không đọc nội dung.

Cách PrivateNote MCP bàn giao tệp qua email, Slack, Discord, và WhatsApp — mà không để mô hình đọc chúng

Đã cập nhật 11 tháng 9, 2026Đọc 7 phútPrivateNote.ai

Trợ lý của bạn có thể gửi một hợp đồng, mật khẩu hoặc tệp CSV ngay hôm nay. Nó không cần phải đọc các tệp đó để thực hiện việc này. Hãy truyền đường dẫn cục bộ tới PrivateNote MCP và chỉ đặt một liên kết tự hủy vào kênh mà bạn đang sử dụng.

Điểm chính

  • Pass file paths, not file bytes—the local MCP encrypts so the model never needs the payload.
  • You approve a preview that binds exact bytes, options, and destination. Creating a note is not permission to send it.
  • Email, Slack, Discord, and WhatsApp should carry only the PrivateNote URL after sendAuthorized — never the file. Leave one-shot off if the agent can also send messages.
  • The decryptable URL is a bearer capability the agent can see after confirm. Do not log it. After delivery, poll open status or revoke an unopened note.

Phần hữu ích của một trợ lý AI không phải là việc nó có thể đọc một hợp đồng, một tệp mật khẩu hoặc một bản xuất dữ liệu khách hàng. Phần hữu ích là nó có thể đưa nội dung đó đến đúng người, trên kênh mà họ đang sử dụng, mà không biến trợ lý thành một bản sao của bí mật đó.

Đó là công việc hàng ngày: gửi một PDF cho khách hàng qua email, gửi mật khẩu staging cho đồng đội trong Slack, bàn giao bot token cho người điều phối trong Discord, hoặc đưa thông tin đăng nhập một lần vào một luồng WhatsApp. Mọi người vốn đã làm việc này bằng cách dán (paste). Các Agent giúp việc dán nhanh hơn — và chúng cũng làm rò rỉ lớn hơn, vì thông tin bí mật giờ đây còn nằm trong ngữ cảnh của mô hình, trong bản ghi chat và trong mọi nhật ký (log) mà máy chủ lưu giữ.

Máy chủ MCP của PrivateNote được xây dựng cho sự phân tách ngược lại. Agent điều phối. Một tiến trình cục bộ xử lý thông tin bí mật. Bạn phê duyệt chính xác tệp và đích đến. Email, Slack, Discord, và WhatsApp chỉ mang theo một liên kết. Mô hình được yêu cầu truyền đường dẫn tệp, chứ không phải dữ liệu byte của tệp. Việc mã hóa diễn ra trên máy của bạn sau khi bạn xác nhận. Kết quả trả về là một URL mà phân đoạn của nó giữ khóa — cùng một mô hình liên kết bí mật một lần như ứng dụng web. Việc tạo một ghi chú không đồng nghĩa với việc được phép gửi nó.


Công việc là gửi đi, không phải là biết nội dung

Hầu hết các lời khuyên về "AI + bí mật" vẫn giả định rằng mô hình phải thấy thông tin xác thực thì mới có thể giúp đỡ. Điều đó đúng nếu bạn muốn mô hình giải thích tệp, viết lại hợp đồng, hoặc gỡ lỗi khóa. Điều đó không đúng nếu bạn chỉ muốn mô hình chuyển giao nó.

Chuyển giao là một vấn đề hậu cần: tệp nào, cho ai, qua kênh nào, thời gian truy cập kéo dài bao lâu, và liệu nó có nên tự hủy sau lần xem đầu tiên hay không. Không có quyết định nào trong số đó yêu cầu nội dung văn bản thuần (plaintext). Chúng yêu cầu một công cụ có thể đọc đường dẫn cục bộ, mã hóa và trả về một mã định danh (handle) mà các thành phần còn lại trong hệ thống được phép nhìn thấy.

Đó là mục đích của privatenote-mcp. Các máy chủ tuân thủ hướng dẫn của MCP sẽ được yêu cầu theo thứ tự: nếu người dùng chỉ định một tệp cục bộ, hãy truyền đường dẫn tuyệt đối; không được mở, đọc (cat) hoặc tóm tắt nó; gọi create_private_note (để xem trước); đợi bạn phê duyệt; sau đó mới gọi confirm_private_note. Chỉ sau đó, một công cụ khác mới có thể gửi URL — và chỉ đến đích mà bạn đã phê duyệt.

Quy tắc

Nếu trợ lý có thể hoàn thành tác vụ bằng một đường dẫn, nó không được phép hoàn thành bằng nội dung bên trong. Dán vào câu lệnh (prompt) là giải pháp cuối cùng — sau khi thông tin bí mật đã nằm trong đoạn chat.

Tại sao các kênh bạn đang dùng lại giữ bản sao sai

Email, Slack, Discord, và WhatsApp rất giỏi trong việc trò chuyện. Nhưng chúng là những kho lưu trữ tồi. Mã hóa khi truyền tải, hay thậm chí mã hóa đầu cuối, không quyết định được một bản sao có thể tìm kiếm sẽ tồn tại bao lâu trên các thiết bị, trong các bản xuất workspace, trong các bản sao lưu đám mây, hoặc trong các bản xem trước thông báo. Điều này cũng giống như tại sao email là nơi tệ nhất để giữ bí mật và tại sao không bao giờ nên dán bí mật vào chat.

  • Email lưu trữ các tệp đính kèm trong cả hộp thư đến, trên máy chủ thư, trong các lệnh lưu trữ pháp lý, và trong tính năng "tìm kiếm tất cả thư". Việc chuyển tiếp sẽ nhân bản các bản sao mà sau này bạn không thể thu hồi.
  • Slack được lập chỉ mục bởi workspace. Quản trị viên, các bản xuất tuân thủ, và các tính năng AI tóm tắt kênh đều có thể tìm lại một mật khẩu sau nhiều tháng.
  • Discord trông có vẻ tạm thời trong một máy chủ bận rộn. Nhưng thực tế không phải vậy. Các tính năng ghim (pin), tìm kiếm, và tin nhắn trực tiếp (DM) sẽ giữ các bot token và bí mật quản trị viên mời ngay cạnh các tệp meme.
  • WhatsApp thường là kênh duy nhất mà một nhà thầu hoặc khách hàng thực sự mở. Nó cũng là một hộp thư gia đình: ảnh chụp màn hình được chia sẻ, các máy tính liên kết được đồng bộ, và các bản sao lưu tồn tại lâu hơn cả công việc.

Mục đích không phải là từ bỏ các công cụ đó. Mục đích là ngừng đặt nội dung chính (payload) vào chúng. Chúng vẫn đóng vai trò là phong bì. Ghi chú mới là bức thư. Người nhận vẫn không cần tài khoản PrivateNote: họ chỉ cần mở liên kết trong trình duyệt, giống như cách họ mở bất kỳ URL nào khác mà bạn đã gửi.


Sự phân tách ba phần

Vai tròNhững gì có thể thấyNhững gì không được thấy
AI agent (Cursor, Claude, Codex)Ai, đường dẫn nào, kênh nào, thời hạn, tự hủy sau khi đọc. Sau khi bạn xác nhận: URL có thể giải mãDữ liệu byte của tệp, mật khẩu, nội dung ghi chú. Không được gửi URL cho đến khi bạn phê duyệt đích đến đó
PrivateNote MCP (tiến trình Node cục bộ)Các tệp trên đĩa, chỉ dùng để mã hóaKhông có gì được trả về dưới dạng văn bản thuần
Email / Slack / Discord / WhatsApp PrivateNote URL (và một tiêu đề có thể đọc được)Tệp đính kèm, thông tin xác thực, mật mã

MCP không gửi email hoặc tin nhắn Slack thay cho bạn. Việc tạo một ghi chú không đồng nghĩa với việc được cấp quyền gửi nó. Sau khi bạn phê duyệt một bản xem trước có nêu rõ kênh và người nhận chính xác, kết quả có thể bao gồm sendAuthorized: true — khi đó công cụ gửi thư hoặc chat có thể chỉ gửi URL đến đích đó. Nếu không có đích đến nào được phê duyệt, sendAuthorized là sai và agent nên đưa cho bạn URL để dán, chứ không phải kích hoạt một công cụ khác.

URL là một khả năng mang theo (bearer capability): bất kỳ ai có nó đều có thể mở ghi chú. Host MCP hiện tại trả về secureUrl trong kết quả công cụ, vì vậy agent có thể quan sát được liên kết mặc dù không thể quan sát các byte của tệp. Không ghi nhật ký (log), không commit, hoặc không sao chép nó vào các công cụ không liên quan. Hãy đối xử với nó như một bí mật.

Phần còn lại của payload được trả về rất nhỏ: noteId, expiresAt, burnAfterReading, và khi cần thiết là passwordProtected và attachedFileNames. Tên tệp là siêu dữ liệu (metadata), không phải nội dung — tuy nhiên vẫn nên tránh đặt bí mật vào tên tệp.


Những gì MCP thực sự thực hiện trên máy của bạn

Khi agent gọi create_private_note, một tiến trình Node.js cục bộ — không phải mô hình — sẽ chuẩn hóa đường dẫn, kiểm tra nó với danh sách cho phép (allowlist) của workspace, băm (hash) tệp và hiển thị bản xem trước cho bạn. Nó chưa trả về một URL có thể giải mã. Sau khi bạn phê duyệt, confirm_private_note sẽ mở lại chính tệp đó, xác minh thiết bị, inode, kích thước và SHA-256, sau đó mã hóa các byte đó. Nếu tệp bị thay đổi, việc xác nhận sẽ thất bại; agent phải bắt đầu lại từ đầu. Bản mã AES-256-GCM được POST đến PrivateNote. Khóa giải mã được đặt trong phân đoạn URL (#…). Trình duyệt không gửi các phân đoạn đến máy chủ. API lưu trữ một blob đã mã hóa. Nếu không có phân đoạn, blob đó chỉ là dữ liệu nhiễu.

Ưu tiên các tham số đường dẫn (path parameters) để host không bao giờ phải đưa bí mật vào các đối số gọi công cụ (tool-call arguments) mà mô hình đã xây dựng:

  • contentFilePath — tệp UTF-8 trở thành nội dung ghi chú (mật khẩu, mã khôi phục, hoặc một hướng dẫn ngắn).
  • filePath / filePaths — các tệp đính kèm cục bộ (PDF, CSV, hình ảnh). Yêu cầu sign_in. Tối đa kết hợp 20 tệp.
  • passwordFilePath — dòng đầu tiên của một tệp cục bộ trở thành mật khẩu tiết lộ (Argon2id wrap). Hãy gửi mật khẩu đó ngoài luồng (out of band), tuyệt đối không gửi trong cùng một tin nhắn với liên kết.
  • content và password — giải pháp cuối cùng, chỉ khi người dùng đã dán bí mật vào chat và không có tệp nào tồn tại.

Chính sách mặc định khớp với một sự bàn giao, không phải một kho lưu trữ: burnAfterReading là true, expiresIn mặc định là 24 giờ. Thời gian ngắn hơn sẽ tốt hơn khi người nhận đang chờ ở phía bên kia của Slack. Chế độ xem đa dạng (burnAfterReading: false) cần tài khoản Premium. Đính kèm tệp, xác minh người nhận, thông báo mở, và liệt kê/thu hồi cần một phiên đăng nhập; các cổng kiểm soát và cảnh báo cũng cần một gói trả phí.

Các đường dẫn bị hạn chế. Theo mặc định, chỉ các tệp dưới workspace (thư mục làm việc của tiến trình MCP) mới có thể được đọc. Thiết lập PRIVATENOTE_MCP_ALLOWED_ROOTS nếu bạn bắt buộc phải thêm các thư mục. Khóa SSH, các thư mục thông tin xác thực đám mây và tệp phiên MCP luôn bị chặn, ngay cả khi bạn cho phép $HOME hoặc /.


Bạn phê duyệt việc bàn giao chính xác — chứ không phải một đường dẫn

Một agent có thể tạo liên kết có thể giải mã và gửi email hoặc Slack là một 'confused deputy' (người đại diện nhầm lẫn): nó có thể mã hóa sai tệp, hoặc gửi đúng liên kết cho sai người trong cùng một lượt. Mặc định của PrivateNote là bạn ủy quyền ba thứ cùng lúc: các byte tệp chính xác, các tùy chọn ghi chú chính xác (thời hạn, tự hủy sau khi đọc), và đích đến chính xác.

Bản xem trước phải hiển thị đích đến khi yêu cầu gửi, ví dụ: “Gửi qua: Email / Người nhận: alice@example.com”. Việc phê duyệt đó không bao giờ được phép ủy quyền cho một địa chỉ hoặc kênh Slack khác. confirm_private_note chỉ nhận confirmationId. Agent không thể ghi đè đường dẫn, người nhận, kênh, thời hạn hoặc chính sách hủy khi xác nhận.

Việc tạo một ghi chú mà không có đích đến sẽ trả về sendAuthorized: false. Điều này là có chủ đích. Một liên kết trong chat vẫn nhạy cảm — nhưng nó không phải là sự cho phép để gửi thư.

Không bật chế độ one-shot nếu agent có thể gửi

PRIVATENOTE_MCP_ALLOW_ONE_SHOT bỏ qua bản xem trước của con người. Agent không thể bật tính năng này như một đối số công cụ, và việc thay đổi môi trường (env) sau đó sẽ không có tác dụng cho đến khi bạn khởi động lại máy chủ MCP. Hãy để nó tắt. Việc bật nó lên trong khi cùng một host có thể gửi email, Slack, Discord, hoặc tệp sẽ cho phép mô hình tạo một liên kết có thể giải mã và gửi đi trong một bước — bao gồm cả việc gửi sai tệp hoặc sai người nhận. Việc cho phép đường dẫn (path allowlisting) vẫn được áp dụng; đó không phải là sự thay thế cho sự phê duyệt của bạn.

Kết nối nó một lần

Yêu cầu Node.js 18+. Sau khi lưu, hãy khởi động lại client MCP để tải các schema và hướng dẫn công cụ hiện tại. Ghi chú cài đặt đầy đủ có tại trang tích hợp MCP.

~/.cursor/mcp.json · Claude Desktop sử dụng cùng một khối
{
  "mcpServers": {
    "privatenote": {
      "command": "npx",
      "args": ["-y", "privatenote-mcp"]
    }
  }
}

Codex CLI: codex mcp add privatenote -- npx -y privatenote-mcp. Việc đó sẽ ghi ~/.codex/config.toml. Các ghi chú dành riêng cho Codex nằm trong Sử dụng PrivateNote với OpenAI Codex.

Tự lưu trữ (Self-hosted): thiết lập PRIVATENOTE_API_BASE_URL và PRIVATENOTE_WEB_ORIGIN trong khối MCP env để bản mã không bao giờ rời khỏi hạ tầng của bạn. Có thể tùy chọn thiết lập PRIVATENOTE_MCP_ALLOWED_ROOTS. Không thêm PRIVATENOTE_MCP_ALLOW_ONE_SHOT trừ khi bạn có một máy chủ tự động hóa được giới hạn phạm vi chặt chẽ và không có các công cụ gửi (send tools).


Sử dụng hàng ngày: email

Email vẫn là cách các công ty gửi hợp đồng, NDA, hóa đơn kèm chi tiết ngân hàng và dữ liệu xuất của khách hàng. Lỗi thường gặp là đính kèm tệp. Khi đó, hộp thư sẽ lưu giữ một bản sao có thể giải mã trong nhiều năm, bao gồm cả ở phía người nhận, các dấu vết BCC và e-discovery.

Mô hình MCP: agent đã biết địa chỉ của Alice và hai tệp PDF cục bộ. Nó không được mở các tệp PDF đó. Nó đăng nhập nếu cần, gọi create_private_note với filePaths, sendChannel, và sendRecipient để bản xem trước hiển thị tên Alice, đợi bạn phê duyệt, sau đó confirm_private_note. Chỉ khi đó, công cụ mail mới được phép đưa duy nhất secureUrl vào nội dung email. Nếu bạn sử dụng xác minh người nhận, người đọc phải chứng minh họ sở hữu địa chỉ đó trước khi ghi chú được mở khóa — bước kiểm soát đó không gửi mail; công cụ mail của bạn vẫn là bên thực hiện.

Những gì bạn nói
Send these two files to Alice by email.
Protect them with the password in /absolute/path/client-password.txt.
Don't expose the files or password to the model:
/absolute/path/contract.pdf
/absolute/path/nda.pdf
  • Agent gọi sign_in nếu không có phiên plugin, sau đó gọi create_private_note với filePaths, passwordFilePath, sendChannel: "email", và sendRecipient. Bạn phê duyệt bản xem trước. Sau đó confirm_private_note.
  • Tiêu đề email có thể ghi “gói hợp đồng” — không nên trích dẫn các điều khoản từ PDF.
  • Gửi mật khẩu (passphrase) trong một tin nhắn thứ hai, một cuộc gọi, hoặc chia sẻ qua trình quản lý mật khẩu — tuyệt đối không gửi cùng email với liên kết. Xem cách chia sẻ mật khẩu an toàn.
  • Đối với người nhận được chỉ định trong gói trả phí: requireRecipientVerification: true và recipientEmail: "alice@example.com".

Đây là cùng một mô hình chuyển giao như gửi tài liệu nhạy cảm một cách an toàn, ngoại trừ việc trợ lý được phép thực hiện mà không trở thành người đọc gói tài liệu đó.


Sử dụng hàng ngày: Slack

Slack là nơi diễn ra các ca trực (on-call). Mật khẩu cơ sở dữ liệu staging, token triển khai, và “tệp CSV từ bộ phận tài chính” thường được thả vào một luồng chat vì mọi người đều đã ở đó. Sau đó, tính năng tìm kiếm workspace sẽ biến việc thả dữ liệu đó thành một wiki nội bộ vĩnh viễn về các bí mật.

Hãy yêu cầu bàn giao dựa trên đường dẫn (path-based) và có thời hạn ngắn. Mười lăm phút là đủ nếu đồng nghiệp đang trực tuyến. Hãy tiêu hủy sau khi đọc để nếu có tìm kiếm sau này thì đó chỉ là một liên kết chết, không phải là một thông tin xác thực đang hoạt động. Hãy đối xử với URL như một bí mật: không đăng nó vào kênh công khai; hãy sử dụng DM hoặc một kênh riêng tư chuyên dụng.

Những gì bạn nói
Send Mark the database password from /absolute/path/secrets/db-password.txt in Slack.
Make it read-once and expire in 15 minutes.
Don't read the file into the chat.
  • create_private_note với contentFilePath, expiresIn: "15m", burnAfterReading: true, và đích đến Slack được ràng buộc tại bản xem trước. Phê duyệt, sau đó confirm_private_note.
  • Nếu Slack được kết nối như một công cụ MCP khác, agent có thể chỉ đăng secureUrl đến đích đã được phê duyệt sau khi sendAuthorized là true. Nếu không, nó sẽ đưa cho bạn URL để dán.
  • Sau khi Mark mở nó, hãy thay đổi mật khẩu nếu đó là một bí mật staging dùng chung — ghi chú này giúp giảm các bản sao còn sót lại; nó không làm cho một thông tin xác thực dùng chung trở nên duy nhất.

Sử dụng hàng ngày: Discord

Discord là kênh vận hành mặc định cho nhiều cộng đồng sản phẩm và các nhóm liên quan đến game. Bot token, khóa Cloudflare, và “đây là bảng tính danh sách người dùng bị báo cáo” thường được dán vào DM của mod vì Discord là nơi các mod hiện diện.

Một tin nhắn Discord vẫn là một tin nhắn được lưu trữ. Các thành viên máy chủ có vai trò phù hợp, bản sao lưu thiết bị, và tính năng tìm kiếm của chính Discord sẽ lưu giữ nó. Mô hình MCP giống hệt với Slack: mã hóa tệp hoặc token cục bộ, đặt liên kết vào DM, thiết lập thời gian hết hạn ngắn. Nếu token đã được dán trước đó trong cùng một máy chủ, hãy thay đổi nó — việc bọc một bí mật đã bị rò rỉ không có nghĩa là nó không còn bị rò rỉ nữa.

Những gì bạn nói
DM the community lead the bot token in /absolute/path/secrets/discord-bot.txt
and the moderation export at /absolute/path/reports/export.csv.
Read-once, 1 hour, don't open those files.
  • Các tệp đính kèm cần sign_in. Một ghi chú chỉ chứa token có thể sử dụng contentFilePath mà không cần phiên làm việc.
  • Ràng buộc đích đến Discord tại bản xem trước, phê duyệt nó, sau đó confirm_private_note. Chỉ khi đó, một công cụ Discord mới có thể gửi URL.
  • Ưu tiên dùng DM với người dùng thay vì dán vào kênh mod. “Kênh riêng tư” vẫn là một bản ghi chép (transcript).
  • Nếu bản xuất dữ liệu bao gồm dữ liệu cá nhân, hãy thêm một tệp mật khẩu và nói mật khẩu đó cho trưởng nhóm qua một cuộc gọi thoại.

Sử dụng hàng ngày: WhatsApp

WhatsApp là kênh bạn sử dụng khi đối phương không tham gia Slack và sẽ không kiểm tra email cho đến thứ Hai. Một nhà thầu, một trợ lý văn phòng gia đình, hay một khách hàng qua điện thoại. Mã hóa đầu cuối là có thật. Tính lưu trữ cũng có thật: đoạn chat là một bản ghi, thường nằm trên nhiều thiết bị và thường được sao lưu.

Bạn không cần họ phải cài đặt PrivateNote. Bạn chỉ cần họ nhấn vào một liên kết. Công việc của trợ lý là chuẩn bị liên kết đó từ một tệp cục bộ mà bạn đã có sẵn — hóa đơn PDF, mật khẩu Wi-Fi, mã cổng một lần — mà không cần đọc nội dung đó vào Cursor hoặc luồng Claude trước. Bạn vẫn phê duyệt bản xem trước (chính xác tệp và đích đến WhatsApp) trước khi confirm_private_note tạo ra URL.

Những gì bạn nói
Send the onboarding pack at /absolute/path/client/onboarding.pdf
to Ana on WhatsApp. Burn after reading, expire tomorrow.
Don't read the PDF.

WhatsApp sẽ xem trước các URL. Bản xem trước đó là trang đích của PrivateNote, không phải tệp đã được giải mã. Tuy nhiên: đừng để mật mã vào cùng một đoạn chat. Nếu số đó có thể bị sai, hãy tạo ghi chú, gửi liên kết và thu hồi nếu cô ấy không bao giờ mở nó. Các luật sư và những người gửi chuyên nghiệp khác cần một trang hiển thị thương hiệu thay vì một bong bóng chat xanh nên đọc giao hàng bảo mật cho luật sư.


Đăng nhập khi nội dung truyền tải là một tệp

Các ghi chú chỉ chứa văn bản từ contentFilePath có thể được tạo mà không cần tài khoản, tuân theo các giới hạn tốc độ công khai tương tự như trang web. Việc đính kèm tệp thì khác. MCP phải gọi sign_in trước. Thao tác đó sẽ mở một trang phê duyệt trong trình duyệt (quyền cấp đã có sẵn trong URL — không cần nhập mã). Sau khi bạn nhấn Phê duyệt, agent sẽ gọi sign_in một lần nữa với pollDeviceCode. Phiên làm việc được lưu trữ tại ~/.config/privatenote/mcp-session.json và được gửi dưới dạng Authorization: Bearer. Nó không thay thế phiên cookie trang web của bạn.

  • Agent chạy sign_in() — trình duyệt mở ra
  • Bạn nhấn Phê duyệt trên trang PrivateNote
  • Agent thăm dò bằng pollDeviceCode, sau đó là whoami()
  • Agent gọi create_private_note với các đường dẫn tệp (xem trước — chưa có URL)
  • Bạn phê duyệt chính xác các tệp, thời hạn hết hạn và đích đến
  • Agent gọi confirm_private_note, sau đó bạn (hoặc một công cụ khác) chỉ gửi secureUrl qua kênh liên lạc thông thường

whoami hiển thị tài khoản đã đăng nhập. sign_out xóa tệp phiên của plugin. Hãy coi tệp đó như một thông tin xác thực cho máy này.

Cài đặt privatenote-mcp trong Cursor, Claude Desktop, hoặc Codex. Agent duy trì quy trình làm việc; quy trình cục bộ giữ bí mật.

Mở hướng dẫn thiết lập MCP

Sau khi liên kết được gửi

Một quy trình bàn giao tốt không kết thúc khi tin nhắn rời khỏi Slack. Các phiên trả phí, đã đăng nhập có thể coi việc giao hàng là các sự kiện, không phải nội dung: đã tạo, đã mở, đã hết hạn, đã thu hồi. list_sent_notes trả về id, trạng thái và openedAt — không bao giờ là văn bản thuần túy. revoke_sent_note làm mất hiệu lực một ghi chú chưa được mở. notifyOnOpen gửi email cho tài khoản PrivateNote của bạn khi ghi chú được mở lần đầu; agent biết về việc mở bằng cách thăm dò list_sent_notes. Không có webhook đẩy vào Cursor.

Quy trình kinh doanh do Agent điều khiển
sign_in()
create_private_note({
  filePaths: [
    "/absolute/path/signed-contract.pdf",
    "/absolute/path/customer-export.csv"
  ],
  expiresIn: "24h",
  burnAfterReading: true,
  requireRecipientVerification: true,
  recipientEmail: "john@example.com",
  notifyOnOpen: true,
  label: "contract-for-john",
  sendChannel: "email",
  sendRecipient: "john@example.com"
})
# wait for user approval of that exact destination
confirm_private_note({ confirmationId: "<from preview>" })
# email or Slack only secureUrl to John
# later: list_sent_notes() and look for openedAt on that noteId

Xác minh người nhận là một cổng mở khóa trên PrivateNote, không phải là sự thay thế cho việc gửi tin nhắn. Cảnh báo mở yêu cầu email người gửi đã được xác minh trên tài khoản. Các biên lai chỉ chứa trạng thái được giải thích trong biết khi nào một liên kết bí mật được mở. Các agent có quyền truy cập công cụ rộng rãi vẫn cần mô hình cấp quyền trong bảo mật agent AI như nhân viên.


Lưu ý trung thực về quyền riêng tư

Khẳng định mạnh mẽ — “AI không bao giờ thấy các byte của tệp” — được duy trì khi máy chủ tuân thủ các hướng dẫn ưu tiên đường dẫn và bạn không bao giờ dán nội dung vào lời nhắc. Điều đó không có nghĩa là agent không thể thấy secureUrl sau khi xác nhận. Một lệnh gọi công cụ MCP thông thường vẫn có thể để lộ các đối số cho máy chủ. Đó là lý do tại sao các công cụ ưu tiên đường dẫn: đối số là /Users/you/secrets/db-password.txt, không phải mật khẩu.

Nếu bạn nhập create a PrivateNote for sk_live_abc123, một nhà cung cấp mô hình đám mây có thể xử lý chuỗi đó trước khi MCP chạy. PrivateNote vẫn sẽ chỉ lưu trữ văn bản mã hóa, và Slack vẫn sẽ chỉ nhận được một liên kết. Bạn đã cải thiện việc rò rỉ ở hạ nguồn. Bạn chưa giữ bí mật tránh khỏi mô hình. Để có quyền riêng tư tối đa, hãy giữ bí mật trong các tệp (hoặc sử dụng tiện ích mở rộng VS Code / Cursor để trình chỉnh sửa mã hóa mà không cần agent), và cho trợ lý biết đường dẫn.

  • Đừng yêu cầu mô hình “kiểm tra PDF trước” hoặc tóm tắt nó. Điều đó sẽ buộc phải đọc bằng một công cụ khác.
  • Đừng để mật mã vào cùng một Slack/WhatsApp/email với URL.
  • Coi secureUrl là bí mật. Agent có thể thấy nó trong kết quả công cụ. Không được cam kết (commit), ghi nhật ký (log), hoặc dán nó vào bất kỳ kênh Discord công khai nào.
  • Tải lại client MCP sau khi nâng cấp privatenote-mcp để các hướng dẫn và schema luôn được cập nhật. Để chế độ one-shot ở trạng thái tắt.

Câu hỏi thường gặp

Có phải PrivateNote MCP tự gửi Slack, Discord, WhatsApp, hoặc email không?

Không. Nó mã hóa cục bộ và trả về một URL cùng với siêu dữ liệu (metadata). Việc chuyển phát sử dụng bất cứ thứ gì bạn đang dùng — một máy chủ MCP khác (Gmail, Slack, …), hoặc bạn tự dán liên kết. Việc tạo một ghi chú không đồng nghĩa với việc được phép gửi nó. sendAuthorized chỉ là true nếu bạn đã phê duyệt chính xác kênh và người nhận đó trong bản xem trước.

Tại sao tôi phải xác nhận trước khi liên kết được tạo?

Xác nhận sẽ ràng buộc chính xác các byte tệp, tùy chọn ghi chú và điểm đến. Nếu không có nó, một agent cũng có các công cụ thư hoặc chat có thể mã hóa sai tệp hoặc gửi đúng liên kết cho sai người chỉ trong một lượt. Chế độ one-shot sẽ bỏ qua bước xem trước này. Hãy để nó ở trạng thái tắt, đặc biệt nếu cùng một host có thể gửi tin nhắn hoặc tệp.

Agent có thể thấy URL có thể giải mã được không?

Có, trong host MCP hiện tại. secureUrl được trả về trong kết quả công cụ để một công cụ chuyển phát có thể gửi nó. Agent vẫn không được phép thấy các byte của tệp. Việc sở hữu URL có thể mở khóa ghi chú — hãy coi nó như một khả năng mang theo (bearer capability), chứ không phải là “mô hình không thể truy cập bí mật.”

Người nhận có phải cài đặt bất cứ thứ gì không?

Không. Họ chỉ cần mở liên kết đầy đủ trong một trình duyệt thông thường. Không cần tài khoản PrivateNote để xem một ghi chú. Họ vẫn có thể cần mật khẩu hoặc xác minh email nếu bạn đã bật các lớp bảo vệ đó.

Tôi có thể đính kèm tệp mà không cần đăng nhập không?

Không. Đính kèm tệp, liệt kê/thu hồi, xác minh người nhận và thông báo mở yêu cầu sign_in. Một ghi chú chỉ chứa văn bản từ contentFilePath có thể được tạo mà không cần phiên làm việc, trong giới hạn công khai.

Nếu trợ lý vẫn đọc tệp thì sao?

Khi đó ranh giới quyền riêng tư đã bị phá vỡ trong lượt đó. Các hướng dẫn của MCP yêu cầu các host không được làm vậy. Nếu client của bạn phớt lờ chúng, hãy tiếp tục sử dụng tiện ích mở rộng trình soạn thảo hoặc ứng dụng web, và đừng chỉ định agent vào tệp đó. Bạn vẫn có thể gửi URL mà tiện ích mở rộng đã tạo ra.

Chế độ burn-after-read có ngăn chặn được ảnh chụp màn hình không?

Không. Một khi người nhận hợp pháp đã giải mã ghi chú, họ có thể sao chép, chụp màn hình hoặc tải lên lại. Burn-after-read và thời hạn hết hạn giúp giảm các bản sao còn sót lại trên dịch vụ và trong lịch sử chat. Chúng không thể xóa từ xa những gì ai đó đã chụp lại. Đối với tài liệu, quyền truy cập tệp chỉ xem trên Business giúp giảm việc tải xuống ngẫu nhiên; nó không phải là lệnh cấm chụp ảnh.

Hãy để agent gửi liên kết. Giữ tệp nằm ngoài mô hình.

Cài đặt privatenote-mcp, trỏ nó vào các đường dẫn cục bộ, và tiếp tục sử dụng email, Slack, Discord, và WhatsApp như những phong bì — chứ không phải là kho lưu trữ. Để chế độ one-shot ở trạng thái tắt nếu cùng một host có thể gửi tin nhắn hoặc tệp.

Ảnh: Léna Le Roy · Unsplash.