MCP server voor AI-agents

Gebruik dit wanneer een agent een veilige overdrachtstool nodig heeft.

Waarom

Geef een MCP-client een lokale tool die PrivateNote-links maakt wanneer een agent een geheim moet doorgeven.

Voeg de MCP-server toe aan Codex, Cursor, Claude Desktop, Continue.dev, Zed of een andere MCP-client. De makelaar ontvangt een create_private_note tool, en het lokale MCP proces maakt de gecodeerde link.

Een notitie maken geeft geen toestemming om deze te versturen. sendAuthorized is alleen waar als het goedgekeurde voorbeeld het kanaal en de ontvanger noemt; geef anders de URL aan de gebruiker.

Snel beginnen

Vereist Node.js 18 of nieuwer. Herstart de MCP-client na het opslaan van de configuratie.

npx -y privatenote-mcp

{
  "mcpServers": {
    "privatenote": {
      "command": "npx",
      "args": ["-y", "privatenote-mcp"]
    }
  }
}

codex mcp add privatenote -- npx -y privatenote-mcp

MCP in een gesprek met een agent

Voorbeeldgesprek. Deze demonstratie leest geen bestanden en maakt geen echte notitie.

1. Je instructie

Maak een link voor eenmalig lezen van /workspace/secret.txt, geldig voor 24 uur. Zet de bestandsinhoud niet in de chat en laat me het voorbeeld zien voordat je de link maakt.

2. MCP-toolaanroep

create_private_note({
  "contentFilePath": "/workspace/secret.txt",
  "expiresIn": "24h",
  "burnAfterReading": true
})

3. Antwoord

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:51:57.497Z",
  "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. De MCP-host vraagt om goedkeuring

confirm_private_note({
  "confirmationId": "cnfg_example"
})

De link voor /workspace/secret.txt maken, met één opening en een geldigheid van 24 uur?

Een notitie maken geeft geen toestemming om deze te versturen. sendAuthorized is alleen waar als het goedgekeurde voorbeeld het kanaal en de ontvanger noemt; geef anders de URL aan de gebruiker.

Beveiliging

AES-256-GCM op uw apparaat — browser, editor, terminal of MCP-proces.

De server slaat cijfertekst en notitie-metagegevens op, niet de decoderingssleutel.

De sleutel blijft in het URL-fragment, dat niet wordt verzonden in HTTP-verzoeken.

Als een geheim in een cloud AI-prompt wordt getypt, kan de modelaanbieder dit zien voordat de MCP-tool wordt uitgevoerd. Voor de sterkste privacyhouding gebruikt u de MCP-stroom met een lokaal model.

Laat PRIVATENOTE_MCP_ALLOW_ONE_SHOT oningesteld als dezelfde host berichten of bestanden kan versturen. De directe modus slaat de goedkeuringsvoorvertoning over.

Lokaal versleutelen

AES-256-GCM op uw apparaat — browser, editor, terminal of MCP-proces.

Ciphertext uploaden

Alleen versleutelde bytes en notitie-metadata (verval, burn-after-reading) bereiken de server.

Sleutel in #fragment

De decoderingssleutel blijft in de URL-hash. Browsers sturen fragmenten niet mee in HTTP-verzoeken.

privatenote.ai/note/…#key

Volledig diagram op developer hub
  • confirm_private_note accepteert alleen confirmationId. De agent kan het pad, de vervaltijd of de bestemming tijdens de bevestiging niet wijzigen.

  • Standaard zijn alleen bestanden in de werkruimte leesbaar. PRIVATENOTE_MCP_ALLOWED_ROOTS voegt mappen toe; SSH-sleutels, cloudgegevens en het MCP-sessiebestand blijven geblokkeerd.

  • sign_in is vereist voor bijlagen, het weergeven of intrekken van notities, ontvangerverificatie en meldingen bij openen.

Referentie

NaamBeschrijving
create_private_noteAlleen een voorbeeld: geef contentFilePath of filePaths, vervaltijd, vernietiging na lezen en eventueel sendChannel en sendRecipient door.
confirm_private_noteVersleutelt na goedkeuring. Accepteert alleen confirmationId en retourneert secureUrl.
sendAuthorizedAlleen waar als het goedgekeurde voorbeeld het kanaal en de ontvanger noemt. Geef anders de URL aan de gebruiker.
sign_in / whoami / sign_outGoedkeuren in de browser. Het MCP-sessiebestand staat los van de websitecookie.
list_sent_notes / revoke_sent_noteEen betaald account en aanmelden zijn vereist. Toont gebeurtenissen en trekt ongeopende notities in; geeft nooit leesbare inhoud terug.
PRIVATENOTE_API_BASE_URLVervang de API voor eigen hosting. Configureer ook PRIVATENOTE_WEB_ORIGIN.

Gerelateerde integraties

MCP server voor AI-agents

Gebruik dit wanneer een agent een veilige overdrachtstool nodig heeft.

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