Menggunakan PrivateNote dengan OpenAI Codex
Satu perintah menghubungkan PrivateNote MCP ke setiap sesi Codex. Langkah penyiapan, kemampuan Codex, dan cara menjaga rahasia agar tidak masuk ke prompt agen.
Poin utama
- 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 adalah agen pengodean AI. Anda mendeskripsikan apa yang Anda inginkan — memperbaiki bug, menambah fitur, menulis pengujian — dan ia melakukannya secara otonom di lingkungan sandbox.
Namun agen membutuhkan rahasia. Mereka perlu mengkloning repositori melalui SSH, menarik data dari registri paket privat, terhubung ke database staging, memanggil API internal. Itu berarti memberikan kredensial kepada mereka.
Menempelkan kunci API ke dalam prompt agen tidak berbeda secara mendasar dengan menempelkannya ke Slack — data tersebut akan berakhir di riwayat konteks, kemungkinan di log, kemungkinan di memori yang bertahan di antara sesi. PrivateNote memberi Anda jalur yang lebih bersih: enkripsi rahasia sebelum agen melihatnya, bagikan tautan yang hancur sendiri setelah satu kali baca, dan jangan tinggalkan jejak apa pun.
Berikut cara menghubungkan keduanya.
Apa itu MCP?
MCP (Model Context Protocol) adalah protokol terbuka yang memungkinkan aplikasi AI terhubung ke alat, sumber data, dan layanan melalui server standar. Klien apa pun yang kompatibel dengan MCP — Claude Desktop, Cursor, Codex, Windsurf, atau asisten lainnya — dapat memanggil alat yang disediakan oleh server MCP.
Server PrivateNote MCP menyediakan satu alat: create_private_note. Saat AI memanggilnya, proses Node.js lokal akan mengenkripsi konten Anda sebelum apa pun menyentuh jaringan. Hasilnya adalah tautan aman yang kedaluwarsa yang dapat Anda bagikan kepada siapa pun.
Persyaratan
Sebelum menginstal, pastikan Anda memiliki:
- Klien yang kompatibel dengan MCP: Claude Desktop, Cursor, Codex CLI, Windsurf, atau klien apa pun yang mengimplementasikan spesifikasi MCP
- Node.js 18 atau yang lebih baru — cek dengan: node --version
- npx tersedia — cek dengan: npx --version
- Akses jaringan ke privatenote.ai (atau instance self-hosted Anda)
Jalur tercepat: satu perintah (Codex)
Jika Anda menggunakan Codex CLI, menambahkan PrivateNote sebagai server MCP global hanya memerlukan satu perintah:
codex mcp add privatenote -- npx -y privatenote-mcp- Selesai. Server telah terdaftar secara global di ~/.codex/config.toml
- Setiap sesi Codex baru memiliki akses ke alat create_private_note
- Tidak perlu konfigurasi tingkat proyek — ini akan mengikuti Anda di berbagai repositori
Claude Desktop dan klien MCP lainnya
Sebagian besar klien MCP menerima file konfigurasi JSON. Untuk Claude Desktop, buka konfigurasi sesuai OS Anda:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Tambahkan entri berikut, simpan file, dan mulai ulang Claude Desktop:
{
"mcpServers": {
"privatenote": {
"command": "npx",
"args": ["-y", "privatenote-mcp"]
}
}
}- Setelah dimulai ulang, Claude akan mendeteksi server dan menampilkan alat create_private_note di chat secara otomatis
- Cursor: tambahkan entri yang sama di bawah Settings → MCP
- Klien lain apa pun yang mengikuti spesifikasi MCP menggunakan blok JSON yang sama
Apa yang kini dapat Anda tanyakan kepada asisten AI Anda
Setelah server MCP terhubung, Anda dapat menggunakan bahasa alami biasa:
# Example response from the assistant:
PrivateNote created:
https://privatenote.ai/note/xK9m2p...#A3f7...
Expires in 24 hours · Burns after reading- "Buat PrivateNote yang berbunyi: Kata sandi sementara adalah X. Atur agar kedaluwarsa dalam 24 jam."
- "Bungkus kata sandi database ini dalam tautan yang dapat hancur sendiri untuk kontraktor"
- "Kirim kunci SSH secara aman — kedaluwarsa 15 menit, hancurkan setelah dibaca"
- "Buat PrivateNote untuk kredensial staging dan berikan tautannya kepada saya"
Apa yang sebenarnya dilakukan alat ini
Saat AI memanggil create_private_note, server MCP menjalankan proses Node.js lokal di mesin Anda. Enkripsi terjadi di sana — sebelum apa pun menyentuh jaringan.
Server menghasilkan kunci AES 256-bit secara acak, mengenkripsi konten dengan AES-256-GCM, dan hanya mengirimkan ciphertext melalui POST ke privatenote.ai. Kunci tersebut tidak disertakan dalam permintaan.
Kunci dekripsi hanya tersimpan di fragmen URL — bagian #this-part yang tidak pernah dikirimkan browser ke server. Yang dikembalikan adalah sebuah tautan. Siapa pun yang membuka tautan tersebut akan mendekripsinya di browser mereka. Catatan akan langsung terhapus setelahnya.
privatenote.ai menyimpan blob terenkripsi. Tanpa fragmen tersebut, blob tersebut tidak berarti.
Opsi alat umum
Alat create_private_note menerima parameter berikut:
# Structured example prompt:
Create a PrivateNote with:
content: "The deployment token is ghp_abc123"
expiresIn: "15m"
burnAfterReading: true- content — teks sensitif yang akan dienkripsi dan disimpan (wajib)
- expiresIn — berapa lama catatan tetap dapat diakses: 15m, 1h, 24h, atau 7d (default: 24h)
- burnAfterReading — hancurkan catatan setelah dibaca pertama kali (default: true)
- title — label opsional yang ditambahkan sebelum konten dienkripsi
Peringatan privasi yang harus Anda pahami
Bagian jujurnya adalah: saat Anda mengetik rahasia ke dalam prompt Codex, Codex membacanya sebelum alat MCP dijalankan. Server OpenAI memproses pesan tersebut.
Jadi "buatkan PrivateNote untuk sk_live_abc123" berarti nilai sk_live_abc123 sempat muncul sejenak dalam konteks cloud. Langkah PrivateNote memastikan data tersebut tidak menetap di Slack, email, atau riwayat chat — tetapi ini tidak sama dengan AI yang tidak pernah melihatnya sama sekali.
Dua cara untuk menutup celah tersebut:
- Gunakan ekstensi VS Code saat berada di IDE Codex — pilih rahasia di editor Anda, klik kanan → Share as PrivateNote. Rahasia tersebut langsung dikirim dari editor Anda ke tautan terenkripsi. Codex tidak pernah terlibat.
- Gunakan model lokal untuk sesi agen. Tidak ada data yang keluar dari mesin Anda sampai data tersebut sudah terenkripsi.
Menggunakan ekstensi VS Code di Codex IDE
Codex berjalan di dalam editor yang kompatibel dengan VS Code. Ekstensi PrivateNote VS Code terinstal dan berfungsi di sana persis seperti pada VS Code standar.
code --install-extension PrivateNote.privatenote-vscode- Setelah instalasi, ikon amplop akan muncul di bar aktivitas — klik untuk membuka panel PrivateNote
- Pilih teks apa pun di editor, klik kanan → Share as PrivateNote untuk penggunaan cepat satu kali
- Ikon gembok di bar judul editor akan muncul setiap kali Anda memilih teks
- Dengan cara ini, Codex tidak pernah menyentuh teks biasa — ekstensi mengenkripsi secara lokal di dalam proses host VS Code
Jika Anda lebih suka menggunakan file konfigurasi
Anda juga dapat menambahkan server MCP secara manual. Perintah codex mcp add menulis ke ~/.codex/config.toml — Anda dapat mengedit file tersebut secara langsung jika mau:
[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]Pemecahan masalah
Jika alat PrivateNote tidak muncul di klien Anda setelah pengaturan:
- Mulai ulang klien MCP Anda — perubahan konfigurasi tidak akan terbaca saat aplikasi sedang berjalan
- Pastikan Node.js sudah terinstal dan ada di PATH Anda: node --version
- Pastikan npx berfungsi: npx --version
- Validasi konfigurasi JSON Anda — koma di akhir baris adalah kesalahan sintaks yang paling umum
- Periksa log MCP atau ekstensi klien Anda untuk melihat kesalahan saat startup
- Pastikan perangkat Anda memiliki akses jaringan ke privatenote.ai (atau host self-hosted Anda)
Beberapa hal yang perlu diingat
URL adalah rahasianya. Tautan tersebut berisi kunci dekripsi di dalam fragmennya. Perlakukan dengan kehati-hatian yang sama seperti kredensial itu sendiri — jangan commit, jangan log, dan jangan posting di saluran publik.
Burn-after-reading berarti persis seperti itu. Setelah tautan dibuka, ia akan hilang. Baik Anda maupun penerima tidak dapat membukanya kembali.
Lakukan rotasi setelah berbagi. Jika sebuah kredensial muncul dalam prompt AI — meskipun sebentar — anggaplah kredensial tersebut berpotensi telah terlihat. Bagikan nilai saat ini melalui PrivateNote, lalu rotasi ke nilai baru.
PrivateNote adalah untuk pengiriman, bukan penyimpanan. Jika Anda memerlukan rahasia yang dapat diakses lebih dari beberapa hari, gunakan pengelola rahasia (secrets manager) yang tepat. PrivateNote adalah langkah serah terima yang aman, bukan brankas.
Gunakan jendela kedaluwarsa yang singkat. Untuk rahasia sekali pakai, 15m atau 1h hampir selalu cukup. Gunakan jendela terpendek yang masih dapat berfungsi bagi penerima Anda.
Hubungkan asisten AI Anda ke PrivateNote
Satu perintah atau satu blok JSON mendaftarkan server MCP. Setiap sesi setelah itu memiliki alat berbagi rahasia yang aman yang sudah terintegrasi.
Coba PrivateNote →