Sử dụng PrivateNote với OpenAI Codex
Một câu lệnh sẽ kết nối PrivateNote MCP vào mọi phiên Codex. Các bước thiết lập, những gì Codex có thể làm, và cách giữ bí mật tránh khỏi prompt của tác nhân.
Điểm chính
- Wire PrivateNote MCP once so Codex can create encrypted notes safely.
- Keep raw secrets out of the agent prompt and chat logs.
- Use short-lived notes for handoffs between humans and tools.
- Treat MCP output links as sensitive—same as the secret itself.
OpenAI Codex là một tác nhân lập trình AI. Bạn mô tả những gì mình muốn — sửa lỗi, thêm tính năng, viết kiểm thử — và nó sẽ thực hiện một cách tự chủ trong môi trường sandbox.
Nhưng các tác nhân cần các thông tin bí mật. Chúng cần clone repo qua SSH, kéo dữ liệu từ các kho lưu trữ gói riêng tư, kết nối với cơ sở dữ liệu staging, gọi các API nội bộ. Điều đó có nghĩa là phải truyền thông tin xác thực cho chúng.
Việc dán một khóa API vào câu lệnh của tác nhân về cơ bản không khác gì việc dán nó vào Slack — nó sẽ nằm trong lịch sử ngữ cảnh, có thể trong nhật ký (logs), hoặc có thể trong bộ nhớ tồn tại giữa các phiên làm việc. PrivateNote cung cấp cho bạn một lộ trình sạch sẽ hơn: mã hóa thông tin bí mật trước khi tác nhân nhìn thấy nó, chia sẻ một liên kết tự hủy sau một lần đọc, và không để lại dấu vết gì.
Dưới đây là cách kết nối cả hai.
MCP là gì?
MCP (Model Context Protocol) là một giao thức mở cho phép các ứng dụng AI kết nối với các công cụ, nguồn dữ liệu và dịch vụ thông qua các máy chủ tiêu chuẩn hóa. Bất kỳ client nào tương thích với MCP — Claude Desktop, Cursor, Codex, Windsurf, hoặc một trợ lý khác — đều có thể gọi các công cụ được cung cấp bởi một máy chủ MCP.
Máy chủ PrivateNote MCP cung cấp một công cụ duy nhất: create_private_note. Khi AI gọi nó, một tiến trình Node.js cục bộ sẽ mã hóa nội dung của bạn trước khi bất kỳ thứ gì được truyền qua mạng. Kết quả là một liên kết bảo mật, có thời hạn mà bạn có thể chia sẻ với bất kỳ ai.
Yêu cầu
Trước khi cài đặt, hãy đảm bảo bạn đã có:
- Một client tương thích với MCP: Claude Desktop, Cursor, Codex CLI, Windsurf, hoặc bất kỳ client nào triển khai đặc tả MCP
- Node.js 18 trở lên — kiểm tra bằng lệnh: node --version
- npx khả dụng — kiểm tra bằng lệnh: npx --version
- Quyền truy cập mạng tới privatenote.ai (hoặc phiên bản tự lưu trữ của bạn)
Cách nhanh nhất: một câu lệnh (Codex)
Nếu bạn sử dụng Codex CLI, việc thêm PrivateNote dưới dạng một MCP server toàn cục chỉ cần một câu lệnh:
codex mcp add privatenote -- npx -y privatenote-mcp- Vậy là xong. Máy chủ được đăng ký toàn cục trong ~/.codex/config.toml
- Mỗi phiên Codex mới đều có quyền truy cập vào công cụ create_private_note
- Không cần cấu hình cấp dự án — nó sẽ đi theo bạn qua mọi repo
Claude Desktop và các client MCP khác
Hầu hết các client MCP đều chấp nhận tệp cấu hình JSON. Đối với Claude Desktop, hãy mở tệp cấu hình cho hệ điều hành của bạn:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Thêm mục sau, lưu tệp và khởi động lại Claude Desktop:
{
"mcpServers": {
"privatenote": {
"command": "npx",
"args": ["-y", "privatenote-mcp"]
}
}
}- Sau khi khởi động lại, Claude sẽ tự động phát hiện máy chủ và hiển thị công cụ create_private_note trong cửa sổ chat
- Cursor: thêm mục tương tự vào Settings → MCP
- Bất kỳ client nào khác tuân thủ đặc tả MCP đều sử dụng cùng một khối JSON
Những gì bạn có thể hỏi trợ lý AI của mình ngay bây giờ
Khi máy chủ MCP đã được kết nối, bạn có thể sử dụng ngôn ngữ tự nhiên thông thường:
# Example response from the assistant:
PrivateNote created:
https://privatenote.ai/note/xK9m2p...#A3f7...
Expires in 24 hours · Burns after reading- "Tạo một PrivateNote với nội dung: Mật khẩu tạm thời là X. Đặt thời gian hết hạn trong 24 giờ."
- "Gói mật khẩu cơ sở dữ liệu này vào một liên kết tự hủy cho nhà thầu"
- "Gửi khóa SSH một cách an toàn — hết hạn sau 15 phút, tự hủy sau khi đọc"
- "Tạo một PrivateNote cho thông tin đăng nhập staging và gửi liên kết cho tôi"
Những gì công cụ thực sự thực hiện
Khi AI gọi create_private_note, máy chủ MCP sẽ chạy một tiến trình Node.js cục bộ trên máy của bạn. Quá trình mã hóa diễn ra tại đó — trước khi bất kỳ dữ liệu nào được gửi lên mạng.
Máy chủ tạo ra một khóa AES 256-bit ngẫu nhiên, mã hóa nội dung bằng AES-256-GCM, và chỉ gửi bản mã (ciphertext) qua phương thức POST đến privatenote.ai. Khóa không nằm trong yêu cầu gửi đi.
Khóa giải mã chỉ tồn tại trong phân đoạn URL — phần #this-part mà trình duyệt không bao giờ gửi đến máy chủ. Kết quả trả về là một liên kết. Bất kỳ ai mở liên kết sẽ giải mã nó ngay trên trình duyệt của họ. Ghi chú sẽ tự xóa ngay lập tức sau đó.
privatenote.ai chỉ lưu trữ các khối dữ liệu đã mã hóa. Nếu không có phân đoạn (fragment), các khối dữ liệu đó sẽ vô nghĩa.
Các tùy chọn công cụ phổ biến
Công cụ create_private_note chấp nhận các tham số sau:
# Structured example prompt:
Create a PrivateNote with:
content: "The deployment token is ghp_abc123"
expiresIn: "15m"
burnAfterReading: true- content — văn bản nhạy cảm cần mã hóa và lưu trữ (bắt buộc)
- expiresIn — thời gian ghi chú có thể truy cập: 15m, 1h, 24h, hoặc 7d (mặc định: 24h)
- burnAfterReading — tiêu hủy ghi chú sau lần xem đầu tiên (mặc định: true)
- title — một nhãn tùy chọn được thêm vào trước nội dung trước khi mã hóa
Lưu ý quan trọng về quyền riêng tư bạn cần hiểu
Đây là sự thật: khi bạn nhập một bí mật vào câu lệnh Codex, Codex sẽ đọc nó trước khi công cụ MCP chạy. Các máy chủ của OpenAI sẽ xử lý tin nhắn đó.
Vì vậy, "tạo một PrivateNote cho sk_live_abc123" có nghĩa là giá trị sk_live_abc123 đã xuất hiện ngắn ngủi trong môi trường đám mây. Bước PrivateNote đảm bảo nó không tồn tại lâu dài trong Slack, email hoặc lịch sử chat — nhưng điều này không đồng nghĩa với việc AI chưa từng nhìn thấy nó.
Hai cách để thu hẹp khoảng cách đó:
- Sử dụng tiện ích mở rộng VS Code khi dùng Codex IDE — chọn nội dung bí mật trong trình soạn thảo, nhấp chuột phải → Share as PrivateNote. Nội dung bí mật sẽ được gửi trực tiếp từ trình soạn thảo đến liên kết đã mã hóa. Codex không bao giờ can thiệp vào quá trình này
- Sử dụng mô hình cục bộ cho phiên làm việc của agent. Không có gì rời khỏi máy của bạn cho đến khi nó đã được mã hóa
Sử dụng tiện ích mở rộng VS Code trong Codex IDE
Codex chạy bên trong một trình soạn thảo tương thích với VS Code. Tiện ích mở rộng PrivateNote VS Code được cài đặt và hoạt động tại đó chính xác như trong VS Code tiêu chuẩn.
code --install-extension PrivateNote.privatenote-vscode- Sau khi cài đặt, một biểu tượng phong bì sẽ xuất hiện trong thanh hoạt động — nhấp vào đó để mở bảng điều khiển PrivateNote
- Chọn bất kỳ văn bản nào trong trình soạn thảo, nhấp chuột phải → Share as PrivateNote để thực hiện nhanh một lần
- Biểu tượng ổ khóa trên thanh tiêu đề của trình soạn thảo sẽ xuất hiện bất cứ khi nào bạn chọn văn bản
- Với lộ trình này, Codex không bao giờ chạm vào văn bản thuần — tiện ích mở rộng sẽ mã hóa cục bộ trong tiến trình máy chủ VS Code
Nếu bạn muốn sử dụng tệp cấu hình
Bạn cũng có thể thêm máy chủ MCP một cách thủ công. Lệnh codex mcp add sẽ ghi vào ~/.codex/config.toml — bạn có thể chỉnh sửa trực tiếp tệp đó nếu muốn:
[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]Trỏ đến một phiên bản tự lưu trữ (self-hosted)
Nếu nhóm của bạn chạy máy chủ PrivateNote riêng, hãy thiết lập URL cơ bản thông qua biến môi trường trong cấu hình MCP:
[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]
[mcp_servers.privatenote.env]
PRIVATENOTE_API_BASE_URL = "https://notes.your-domain.com"- Tất cả các nội dung bí mật đều nằm trên hạ tầng của bạn — không có gì được gửi đến privatenote.ai
- Cùng một phương thức mã hóa AES-256-GCM được áp dụng; chỉ có đích đến lưu trữ là thay đổi
Khắc phục sự cố
Nếu công cụ PrivateNote không xuất hiện trong ứng dụng của bạn sau khi thiết lập:
- Khởi động lại ứng dụng MCP của bạn — các thay đổi cấu hình sẽ không được áp dụng khi ứng dụng đang chạy
- Xác nhận Node.js đã được cài đặt và có trong PATH: node --version
- Xác nhận npx hoạt động: npx --version
- Kiểm tra cấu hình JSON của bạn — dấu phẩy ở cuối là lỗi cú pháp phổ biến nhất
- Kiểm tra nhật ký (logs) MCP hoặc nhật ký tiện ích mở rộng của ứng dụng để tìm lỗi khởi động
- Đảm bảo máy của bạn có quyền truy cập mạng tới privatenote.ai (hoặc máy chủ tự lưu trữ của bạn)
Một vài điều cần lưu ý
URL chính là nội dung bí mật. Liên kết chứa khóa giải mã trong phần fragment. Hãy bảo mật nó cẩn thận như chính thông tin đăng nhập — không commit, không ghi log, không đăng lên các kênh công khai.
Burn-after-reading (đọc xong tự hủy) có nghĩa chính xác là như vậy. Một khi liên kết đã được mở, nó sẽ biến mất. Cả bạn và người nhận đều không thể mở lại nó.
Thay đổi (rotate) sau khi chia sẻ. Nếu một thông tin đăng nhập xuất hiện trong một câu lệnh AI — dù chỉ trong chốc lát — hãy coi như nó có khả năng đã bị lộ. Chia sẻ giá trị hiện tại qua PrivateNote, sau đó đổi sang một giá trị mới.
PrivateNote dùng để chuyển giao, không phải để lưu trữ. Nếu bạn cần một nội dung bí mật có thể truy cập được trong nhiều ngày, hãy sử dụng trình quản lý bí mật (secrets manager) chuyên dụng. PrivateNote là bước bàn giao an toàn, không phải là kho lưu trữ.
Sử dụng thời gian hết hạn ngắn. Đối với các nội dung bí mật dùng một lần, 15m hoặc 1h hầu như luôn là đủ. Hãy ưu tiên chọn khoảng thời gian ngắn nhất mà vẫn đảm bảo người nhận có thể sử dụng được.
Kết nối trợ lý AI của bạn với PrivateNote
Chỉ với một câu lệnh hoặc một khối JSON, bạn sẽ đăng ký máy chủ MCP. Mọi phiên làm việc sau đó đều được tích hợp sẵn công cụ chia sẻ bí mật an toàn.
Thử PrivateNote →