AI ajanları için MCP sunucusu
Bir ajanın güvenli teslimat aracına ihtiyacı olduğunda kullanın.
Neden
Bir MCP istemcisine, ajanın sır teslim etmesi gerektiğinde PrivateNote bağlantıları oluşturan yerel bir araç verin.
MCP sunucusunu Codex, Cursor, Claude Desktop, Continue.dev, Zed veya herhangi bir MCP istemcisine ekleyin. Ajan bir create_private_note aracı alır ve yerel MCP süreci şifreli bağlantıyı oluşturur.
Not oluşturmak gönderme izni vermez. sendAuthorized yalnızca onaylanan önizleme kanalı ve alıcıyı belirtiyorsa doğrudur; aksi hâlde URL kullanıcıya verilmelidir.
Hızlı başlangıç
Node.js 18 veya üzeri gerekir. Yapılandırmayı kaydettikten sonra MCP istemcisini yeniden başlatın.
npx -y privatenote-mcp
{
"mcpServers": {
"privatenote": {
"command": "npx",
"args": ["-y", "privatenote-mcp"]
}
}
}
codex mcp add privatenote -- npx -y privatenote-mcpCanlı deneyin
Bir MCP araç çağrısını simüle edin — oyun alanı sayfada şifreler ve ajanların create_private_note’tan aldığı JSON şeklini döndürür.
Canlı demo — privatenote.ai’de gerçek bir not oluşturur. Üretim kimlik bilgisi değil, atılabilir bir sır kullanın.
// MCP araç çağrısı// 1. Preview — pass a path, not the secret. No URL yet. create_private_note({ "contentFilePath": "/absolute/path/secret.txt", "expiresIn": "1h", "burnAfterReading": true }) // 2. After you approve confirm_private_note({ "confirmationId": "cnfg_…" })
Güvenlik
Cihazınızda AES-256-GCM — tarayıcı, düzenleyici, terminal veya MCP süreci.
Sunucu şifreli metni ve not üst verisini saklar, çözme anahtarını değil.
Anahtar URL parçasında kalır; HTTP isteklerinde gönderilmez.
bir sır bir bulut AI istemine yazılırsa, MCP aracı çalışmadan önce model sağlayıcısı onu görebilir. En güçlü gizlilik duruşu için MCP akışını yerel bir modelle kullanın.
Aynı ana makine mesaj veya dosya gönderebiliyorsa PRIVATENOTE_MCP_ALLOW_ONE_SHOT değerini ayarlamayın. Doğrudan mod onay önizlemesini atlar.
Yerel şifrele
Cihazınızda AES-256-GCM — tarayıcı, düzenleyici, terminal veya MCP süreci.
Şifreli metni yükle
Sunucuya yalnızca şifreli baytlar ve not üst verisi (süre sonu, okuduktan sonra imha) ulaşır.
Anahtar #parçada
Çözme anahtarı URL karmasında kalır. Tarayıcılar parçaları HTTP isteklerinde göndermez.
privatenote.ai/note/…#key
confirm_private_note yalnızca confirmationId kabul eder. Aracı onay sırasında dosya yolunu, süreyi veya hedefi değiştiremez.
Varsayılan olarak yalnızca çalışma alanındaki dosyalar okunabilir. PRIVATENOTE_MCP_ALLOWED_ROOTS klasör ekler; SSH anahtarları, bulut kimlik bilgileri ve MCP oturum dosyası engelli kalır.
Ekler, notları listeleme veya iptal etme, alıcı doğrulaması ve açılma bildirimleri için sign_in gerekir.
Referans
| Ad | Açıklama |
|---|---|
| create_private_note | Yalnızca önizleme: contentFilePath veya filePaths, süre, okunduktan sonra silme ve isteğe bağlı sendChannel ile sendRecipient gönderin. |
| confirm_private_note | Onaydan sonra şifreler. Yalnızca confirmationId kabul eder ve secureUrl döndürür. |
| sendAuthorized | Yalnızca onaylanan önizleme kanalı ve alıcıyı belirtiyorsa doğrudur. Aksi hâlde URL kullanıcıya verilmelidir. |
| sign_in / whoami / sign_out | Tarayıcıda onaylayın. MCP oturum dosyası web sitesi çerezinden ayrıdır. |
| list_sent_notes / revoke_sent_note | Ücretli hesap ve giriş gerekir. Olayları listeler ve açılmamış notları iptal eder; asla düz metin döndürmez. |
| PRIVATENOTE_API_BASE_URL | Kendi sunucunuz için API adresini değiştirin. PRIVATENOTE_WEB_ORIGIN değerini de yapılandırın. |
İlgili entegrasyonlar
CLI
Sırları stdin veya dosyalardan borulayın. Yerel şifreleyin, tek kullanımlık bağlantı yazdırın ve düz metni kabuk geçmişinden ve derleme günlüklerinden uzak tutun.
Belgeleri görüntüleDüzenleyici uzantısı
Bağlam değiştirmeden VS Code, Cursor veya Codex IDE’den not oluşturun. Kenar çubuğunu, seçili metin komutunu veya başlık çubuğu eylemini kullanın.
Belgeleri görüntüleCodex eklentisi
MCP ve beceriler için paketlenmiş eklentiyi yükleyin veya privatenote-mcp’yi ~/.codex/config.toml’a ekleyin. Ajanın asla görmemesi gereken sırlar için Codex IDE’de aynı VS Code uzantısını kullanın.
Belgeleri görüntüleChrome uzantısı
Herhangi bir sekmeden seçili metni bağlam menüsü, araç çubuğu açılır penceresi veya klavye kısayoluyla şifreleyin — siteyi önce açmadan.
Belgeleri görüntüleAI ajanları için MCP sunucusu
Bir ajanın güvenli teslimat aracına ihtiyacı olduğunda kullanın.
