Utilizzo di PrivateNote con OpenAI Codex

Che cos’è MCP?

MCP (Model Context Protocol) è un protocollo aperto che permette alle applicazioni IA di connettersi a strumenti, fonti dati e servizi tramite server standardizzati. Qualsiasi client compatibile MCP, come Claude Desktop, Cursor, Codex, Windsurf o un altro assistente, può chiamare gli strumenti esposti da un server MCP.

Il server MCP di PrivateNote espone un solo strumento: create_private_note. Quando un’IA lo chiama, un processo Node.js locale cifra il contenuto prima che tocchi la rete. Il risultato è un link sicuro e in scadenza che puoi condividere con chiunque.

Requisiti

Prima dell’installazione, assicurati di avere:

• Un client compatibile MCP: Claude Desktop, Cursor, Codex CLI, Windsurf o qualsiasi client che implementi la specifica MCP
• Node.js 18 o successivo, da verificare con: node --version
• npx disponibile, da verificare con: npx --version
• Accesso di rete a privatenote.ai o alla tua istanza self-hosted

Il percorso più veloce: un comando (Codex)

Se usi Codex CLI, aggiungere PrivateNote come server MCP globale richiede un solo comando:

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

• Il server viene registrato globalmente in ~/.codex/config.toml
• Ogni nuova sessione Codex ha accesso allo strumento create_private_note
• Non serve configurazione a livello di progetto: ti segue tra repository diversi

Claude Desktop e altri client MCP

La maggior parte dei client MCP accetta un file di configurazione JSON. Per Claude Desktop, apri il file di configurazione del tuo sistema operativo:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Aggiungi la voce seguente, salva il file e riavvia Claude Desktop:

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

• Dopo il riavvio, Claude rileverà il server ed esporrà automaticamente in chat lo strumento create_private_note
• Cursor: aggiungi la stessa voce in Settings → MCP
• Qualsiasi altro client conforme alla specifica MCP usa lo stesso blocco JSON

Cosa puoi chiedere ora al tuo assistente IA

Una volta collegato il server MCP, puoi usare linguaggio naturale:

# Esempio di risposta dell’assistente:

PrivateNote created:
https://privatenote.ai/note/xK9m2p...#A3f7...

Expires in 24 hours · Burns after reading

• "Create a PrivateNote that says: The temporary password is X. Make it expire in 24 hours."
• "Wrap this database password in a self-destructing link for the contractor"
• "Send the SSH key securely — 15-minute expiry, burn after reading"
• "Generate a PrivateNote for the staging credentials and give me the link"

Che cosa fa davvero lo strumento

Quando l’IA chiama create_private_note, il server MCP esegue un processo Node.js locale sul tuo computer. La cifratura avviene lì, prima che qualcosa tocchi la rete.

Il server genera una chiave AES casuale a 256 bit, cifra il contenuto con AES-256-GCM e invia a privatenote.ai solo il testo cifrato. La chiave non è nella richiesta.

La chiave di decifratura vive solo nel frammento dell’URL, la parte dopo # che i browser non inviano mai ai server. Quello che torna è un link. Chi apre il link decifra la nota nel browser. La nota si elimina subito dopo.

privatenote.ai conserva blob cifrati. Senza il frammento, quei blob sono privi di significato.

Opzioni comuni dello strumento

Lo strumento create_private_note accetta questi parametri:

# Esempio di prompt strutturato:

Create a PrivateNote with:
content: "The deployment token is ghp_abc123"
expiresIn: "15m"
burnAfterReading: true

• content: il testo sensibile da cifrare e conservare (obbligatorio)
• expiresIn: per quanto tempo la nota resta accessibile: 15m, 1h, 24h o 7d (default: 24h)
• burnAfterReading: distrugge la nota dopo la prima visualizzazione (default: true)
• title: etichetta opzionale anteposta al contenuto prima della cifratura

La cautela privacy da capire

La parte onesta è questa: quando digiti un segreto in un prompt Codex, Codex lo legge prima che lo strumento MCP venga eseguito. I server di OpenAI elaborano quel messaggio.

Quindi “create a PrivateNote for sk_live_abc123” significa che il valore sk_live_abc123 è apparso brevemente in un contesto cloud. Il passaggio PrivateNote fa sì che non resti in Slack, e-mail o cronologia chat, ma non equivale a dire che l’IA non lo abbia mai visto.

Ci sono due modi per chiudere questo divario:

• Usa l’estensione VS Code quando sei in Codex IDE: seleziona il segreto nell’editor, clic destro → Share as PrivateNote. Il segreto passa direttamente dall’editor al link cifrato. Codex non è coinvolto
• Usa un modello locale per la sessione dell’agente. Nulla lascia il computer finché non è già cifrato

Usare l’estensione VS Code in Codex IDE

Codex gira dentro un editor compatibile con VS Code. L’estensione VS Code di PrivateNote si installa e funziona lì esattamente come in VS Code standard.

code --install-extension PrivateNote.privatenote-vscode

• Dopo l’installazione compare un’icona a busta nella barra attività: cliccala per aprire il pannello PrivateNote
• Seleziona testo nell’editor, clic destro → Share as PrivateNote per un invio rapido
• L’icona a lucchetto nella barra del titolo dell’editor appare quando hai testo selezionato
• Con questo percorso, Codex non tocca mai il testo in chiaro: l’estensione cifra localmente nel processo host di VS Code

Se preferisci il file di configurazione

Puoi anche aggiungere manualmente il server MCP. Il comando codex mcp add scrive in ~/.codex/config.toml, ma puoi modificare direttamente quel file:

[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]

Puntare a un’istanza self-hosted

Se il tuo team gestisce un server PrivateNote privato, imposta l’URL base tramite una variabile d’ambiente nella configurazione MCP:

[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]

[mcp_servers.privatenote.env]
PRIVATENOTE_API_BASE_URL = "https://notes.your-domain.com"

• Tutti i segreti restano sulla tua infrastruttura: nulla raggiunge privatenote.ai
• Si applica la stessa cifratura AES-256-GCM; cambia solo la destinazione dello storage

Risoluzione dei problemi

Se lo strumento PrivateNote non appare nel client dopo la configurazione:

• Riavvia il client MCP: le modifiche di configurazione non vengono lette mentre l’app è in esecuzione
• Conferma che Node.js sia installato e nel PATH: node --version
• Conferma che npx funzioni: npx --version
• Valida la configurazione JSON: una virgola finale è l’errore di sintassi più comune
• Controlla i log MCP o dell’estensione del client per errori di avvio
• Assicurati che il computer abbia accesso di rete a privatenote.ai o al tuo host self-hosted

Alcune cose da ricordare

L’URL è il segreto. Il link contiene la chiave di decifratura nel frammento. Trattalo con la stessa cura della credenziale stessa: non committarlo, non loggarlo, non pubblicarlo in un canale pubblico.

Burn-after-reading significa esattamente questo. Una volta aperto il link, è sparito. Né tu né il destinatario potete riaprirlo.

Ruota dopo la condivisione. Se una credenziale è apparsa in un prompt IA, anche brevemente, trattala come potenzialmente vista. Condividi il valore corrente con PrivateNote, poi ruotalo.

PrivateNote serve alla consegna, non all’archiviazione. Se un segreto deve restare accessibile per più di pochi giorni, usa un vero secrets manager. PrivateNote è il passaggio sicuro di consegna, non il vault.

Usa finestre di scadenza brevi. Per segreti monouso, 15m o 1h sono quasi sempre sufficienti. Scegli per impostazione predefinita la finestra più breve che funzioni per il destinatario.