MCP-Server für KI-Agenten
Verwenden Sie diese Option, wenn ein Agent ein sicheres Übergabetool benötigt.
Auf dieser Seite
Warum
Geben Sie einem MCP-Client ein lokales Tool, das PrivateNote-Links erstellt, wenn ein Agent ein Geheimnis sicher übergeben muss.
Fügen Sie den MCP-Server zu Codex, Cursor, Claude Desktop, Continue.dev, Zed oder einem anderen MCP-Client hinzu. Der Agent erhält ein create_private_note Tool, und der lokale MCP-Prozess erstellt den verschlüsselten Link.
Das Erstellen einer Notiz erlaubt noch keinen Versand. sendAuthorized ist nur wahr, wenn die bestätigte Vorschau Kanal und Empfänger nennt; andernfalls die URL an den Nutzer zurückgeben.
Schnellstart
Erfordert Node.js 18 oder neuer. Starten Sie den MCP-Client nach dem Speichern der Konfiguration neu.
npx -y privatenote-mcp
{
"mcpServers": {
"privatenote": {
"command": "npx",
"args": ["-y", "privatenote-mcp"]
}
}
}
codex mcp add privatenote -- npx -y privatenote-mcpMCP im Gespräch mit einem Agenten
Beispielgespräch. Diese Anleitung liest keine Dateien und erstellt keine echte Notiz.
1. Ihre Anweisung
Erstelle aus /workspace/secret.txt einen Link, der einmal geöffnet werden kann und nach 24 Stunden abläuft. Zeige den Dateiinhalt nicht im Chat und zeige mir vor dem Erstellen die Vorschau.
2. MCP-Werkzeugaufruf
create_private_note({
"contentFilePath": "/workspace/secret.txt",
"expiresIn": "24h",
"burnAfterReading": true
})3. Antwort
Create an encrypted PrivateNote link? Files Attached none Note Body file · 128 B · /workspace/secret.txt Password no Expires 24h Destroy after first access Branding none Send Status not requested Approve to create the link. The agent must not send this URL.
JSON
{
"status": "pending_confirmation",
"confirmationId": "cnfg_example",
"confirmationExpiresAt": "2026-11-09T10:48:28.956Z",
"preview": {
"contentFromFile": true,
"contentFromChat": false,
"contentBytes": 128,
"contentFilePath": "/workspace/secret.txt",
"attachedFiles": [],
"passwordProtected": false,
"passwordFromFile": false,
"expiresIn": "24h",
"burnAfterReading": true,
"title": null,
"recipientEmail": null,
"requireRecipientVerification": false,
"notifyOnOpen": false,
"label": null,
"sendChannel": null,
"sendRecipient": null,
"accountBranding": false
},
"summary": "Create an encrypted PrivateNote link?\n\nFiles\n Attached none\n\nNote\n Body file · 128 B · /workspace/secret.txt\n Password no\n Expires 24h\n Destroy after first access\n Branding none\n\nSend\n Status not requested\n\nApprove to create the link. The agent must not send this URL.",
"nextStep": "Creation requires Accept in the MCP host approval dialog. Call confirm_private_note with only confirmationId to request that dialog. A chat message or confirmationId alone is not approval. Hosts without form elicitation cannot create notes in the default mode. Do not change path, expiry, or destination."
}4. Der MCP-Host bittet um Zustimmung
confirm_private_note({
"confirmationId": "cnfg_example"
})Den Link für /workspace/secret.txt mit einmaligem Öffnen und 24 Stunden Gültigkeit erstellen?
Das Erstellen einer Notiz erlaubt noch keinen Versand. sendAuthorized ist nur wahr, wenn die bestätigte Vorschau Kanal und Empfänger nennt; andernfalls die URL an den Nutzer zurückgeben.
Sicherheit
AES-256-GCM auf Ihrem Gerät — Browser, Editor, Terminal oder MCP-Prozess.
Der Server speichert Chiffretext und Notizmetadaten, nicht den Entschlüsselungsschlüssel.
Der Schlüssel verbleibt im URL-Fragment, das nicht in HTTP-Anfragen gesendet wird.
Wenn ein Geheimnis in einen Cloud-KI-Prompt eingegeben wird, kann der Modellanbieter es sehen, bevor das MCP-Tool ausgeführt wird. Für den größtmöglichen Datenschutz nutzen Sie den MCP-Flow mit einem lokalen Modell.
Lassen Sie PRIVATENOTE_MCP_ALLOW_ONE_SHOT ungesetzt, wenn derselbe Host Nachrichten oder Dateien senden kann. Der Einzelschritt überspringt die Bestätigungsvorschau.
Lokal verschlüsseln
AES-256-GCM auf Ihrem Gerät — Browser, Editor, Terminal oder MCP-Prozess.
Chiffretext hochladen
Nur verschlüsselte Bytes und Notiz-Metadaten (Ablauf, Burn-after-reading) erreichen den Server.
Schlüssel in #fragment
Der Entschlüsselungsschlüssel bleibt im URL-Hash. Browser senden Fragmente nicht in HTTP-Anfragen.
privatenote.ai/note/…#key
confirm_private_note akzeptiert nur confirmationId. Der Agent kann Dateipfad, Ablauf oder Ziel bei der Bestätigung nicht ändern.
Standardmäßig können nur Dateien im Arbeitsbereich gelesen werden. PRIVATENOTE_MCP_ALLOWED_ROOTS ergänzt Ordner; SSH-Schlüssel, Cloud-Zugangsdaten und die MCP-Sitzungsdatei bleiben gesperrt.
sign_in ist für Anhänge, das Auflisten oder Widerrufen von Notizen, Empfängerverifizierung und Öffnungsbenachrichtigungen erforderlich.
Referenz
| Name | Beschreibung |
|---|---|
| create_private_note | Nur Vorschau: contentFilePath oder filePaths, Ablauf, Löschen nach dem Lesen sowie optional sendChannel und sendRecipient übergeben. |
| confirm_private_note | Verschlüsselt nach der Bestätigung. Akzeptiert nur confirmationId und gibt secureUrl zurück. |
| sendAuthorized | Nur wahr, wenn die bestätigte Vorschau Kanal und Empfänger nennt. Andernfalls die URL an den Nutzer zurückgeben. |
| sign_in / whoami / sign_out | Im Browser bestätigen. Die MCP-Sitzungsdatei ist vom Website-Cookie getrennt. |
| list_sent_notes / revoke_sent_note | Bezahlter Tarif und Anmeldung erforderlich. Zeigt Ereignisse und widerruft ungeöffnete Notizen; gibt niemals Klartext zurück. |
| PRIVATENOTE_API_BASE_URL | API für selbst gehostete Instanzen überschreiben. Auch PRIVATENOTE_WEB_ORIGIN konfigurieren. |
Verwandte Integrationen
CLI
Leiten Sie Geheimnisse von stdin oder Dateien. Lokal verschlüsseln, Einmal-Link ausgeben — ohne Klartext in Shell-Historie oder Build-Logs.
DokumentationEditor-Erweiterung
Erstellen Sie Notizen aus VS Code, Cursor oder Codex IDE heraus, ohne den Kontext zu wechseln. Nutzen Sie die Seitenleiste, einen Befehl für markierten Text oder die Aktion in der Titelleiste.
DokumentationCodex-Plugin
Installieren Sie das mitgelieferte Plugin für MCP und Skills oder fügen Sie privatenote-mcp zu ~/.codex/config.toml hinzu. Für Geheimnisse, die der Agent nie sehen soll, nutzen Sie in Codex IDE dieselbe VS-Code-Erweiterung.
DokumentationChrome-Erweiterung
Verschlüsseln Sie markierten Text in jedem Tab per Kontextmenü, Symbolleiste oder Tastenkürzel — ohne die Website zu öffnen.
DokumentationMCP-Server für KI-Agenten
Verwenden Sie diese Option, wenn ein Agent ein sicheres Übergabetool benötigt.
