MCP-Server für KI-Agenten

Verwenden Sie diese Option, wenn ein Agent ein sicheres Übergabetool benötigt.

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-mcp

MCP 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

Vollständiges Diagramm im Developer-Hub
  • 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

NameBeschreibung
create_private_noteNur Vorschau: contentFilePath oder filePaths, Ablauf, Löschen nach dem Lesen sowie optional sendChannel und sendRecipient übergeben.
confirm_private_noteVerschlüsselt nach der Bestätigung. Akzeptiert nur confirmationId und gibt secureUrl zurück.
sendAuthorizedNur wahr, wenn die bestätigte Vorschau Kanal und Empfänger nennt. Andernfalls die URL an den Nutzer zurückgeben.
sign_in / whoami / sign_outIm Browser bestätigen. Die MCP-Sitzungsdatei ist vom Website-Cookie getrennt.
list_sent_notes / revoke_sent_noteBezahlter Tarif und Anmeldung erforderlich. Zeigt Ereignisse und widerruft ungeöffnete Notizen; gibt niemals Klartext zurück.
PRIVATENOTE_API_BASE_URLAPI für selbst gehostete Instanzen überschreiben. Auch PRIVATENOTE_WEB_ORIGIN konfigurieren.

Verwandte Integrationen

MCP-Server für KI-Agenten

Verwenden Sie diese Option, wenn ein Agent ein sicheres Übergabetool benötigt.

PrivateNote on LaunchNestPrivateNote.ai - Share sensitive information without leaving it behind | Product Hunt
Photo by Léna Le Roy on Unsplash.