Utilizarea PrivateNote cu OpenAI Codex
O singură comandă conectează PrivateNote MCP în fiecare sesiune Codex. Pașii de configurare, ce poate face Codex și cum să eviți introducerea secretelor în promptul agentului.
Puncte esențiale
- Wire PrivateNote MCP once so Codex can create encrypted notes safely.
- Keep raw secrets out of the agent prompt and chat logs.
- Use short-lived notes for handoffs between humans and tools.
- Treat MCP output links as sensitive—same as the secret itself.
OpenAI Codex este un agent de codare AI. Descrii ceea ce dorești — să repari un bug, să adaugi o funcționalitate, să scrii un test — iar acesta face acest lucru autonom într-un mediu izolat (sandbox).
Dar agenții au nevoie de secrete. Ei trebuie să cloneze repozitorii prin SSH, să tragă pachete din registre private, să se conecteze la baze de date de staging, să apeleze API-uri interne. Asta înseamnă transmiterea de acreditări către ei.
Lipirea unei chei API într-un prompt de agent nu este fundamental diferită de lipirea ei în Slack — aceasta ajunge în istoricul contextului, posibil în loguri, posibil în memoria care persistă între sesiuni. PrivateNote îți oferă o cale mai curată: criptează secretul înainte ca agentul să îl vadă, partajează un link care se autodistruge după o singură citire și nu lasă nimic în urmă.
Iată cum poți conecta cele două.
Ce este MCP?
MCP (Model Context Protocol) este un protocol deschis care permite aplicațiilor AI să se conecteze la instrumente, surse de date și servicii prin intermediul unor servere standardizate. Orice client compatibil cu MCP — Claude Desktop, Cursor, Codex, Windsurf sau un alt asistent — poate apela instrumentele expuse de un server MCP.
Serverul PrivateNote MCP expune un singur instrument: create_private_note. Când un AI îl apelează, un proces local Node.js îți criptează conținutul înainte ca orice să atingă rețeaua. Rezultatul este un link securizat, cu expirare, pe care îl poți partaja cu oricine.
Cerințe
Înainte de instalare, asigură-te că ai:
- Un client compatibil cu MCP: Claude Desktop, Cursor, Codex CLI, Windsurf sau orice client care implementează specificația MCP
- Node.js 18 sau versiune ulterioară — verifică cu: node --version
- npx disponibil — verifică cu: npx --version
- Acces la rețea pentru privatenote.ai (sau instanța ta găzduită propriu)
Cea mai rapidă cale: o singură comandă (Codex)
Dacă folosești Codex CLI, adăugarea PrivateNote ca server MCP global se face printr-o singură comandă:
codex mcp add privatenote -- npx -y privatenote-mcp- Atât cât!
- Fiecare sesiune nouă Codex are acces la instrumentul create_private_note
- Nu este necesară nicio configurare la nivel de proiect — vă însoțește în toate depozitele
Claude Desktop și alți clienți MCP
Majoritatea clienților MCP acceptă un fișier de configurare JSON. Pentru Claude Desktop, deschideți configurația pentru sistemul de operare utilizat:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Adăugați următoarea intrare, salvați fișierul și reporniți Claude Desktop:
{
"mcpServers": {
"privatenote": {
"command": "npx",
"args": ["-y", "privatenote-mcp"]
}
}
}- După restart, Claude va detecta serverul și va expune automat instrumentul create_private_note în chat
- Cursor: adăugați aceeași intrare la Settings → MCP
- Orice alt client care respectă specificația MCP folosește același bloc JSON
Ce poți întreba acum asistentului tău AI
Odată ce serverul MCP este conectat, poți folosi limbaj natural simplu:
# Example response from the assistant:
PrivateNote created:
https://privatenote.ai/note/xK9m2p...#A3f7...
Expires in 24 hours · Burns after reading- "Creează un PrivateNote care să spună: Parola temporară este X. Să expire în 24 ore."
- "Împachetează această parolă de bază de date într-un link cu autodistrugere pentru contractor"
- "Trimite cheia SSH în siguranță — expirare în 15 minute, se distruge după citire"
- "Generează un PrivateNote pentru datele de autentificare de staging și dă-mi link-ul"
Ce face instrumentul de fapt
Când AI-ul apelează create_private_note, serverul MCP rulează un proces local Node.js pe mașina ta. Criptarea are loc acolo — înainte ca orice să atingă rețeaua.
Serverul generează o cheie AES aleatorie de 256 biți, criptrează conținutul cu AES-256-GCM și trimite prin POST doar textul criptat către privatenote.ai. Cheia nu se află în cerere.
Cheia de decriptare există doar în fragmentul URL — partea care începe cu # și pe care browserele nu o trimit niciodată către servere. Ceea ce revine este un link. Oricine deschide link-ul îl decriptează în propriul browser. Nota se șterge imediat după.
privatenote.ai stochează blocuri de date criptate. Fără fragment, acele blocuri sunt lipsite de sens.
Opțiuni comune ale instrumentului
Instrumentul create_private_note acceptă următorii parametri:
# Structured example prompt:
Create a PrivateNote with:
content: "The deployment token is ghp_abc123"
expiresIn: "15m"
burnAfterReading: true- content — textul sensibil care trebuie criptat și stocat (obligatoriu)
- expiresIn — cât timp rămâne nota accesibilă: 15m, 1h, 24h sau 7d (implicit: 24h)
- burnAfterReading — distruge nota după prima vizualizare (implicit: true)
- title — un etichetă opțională adăugată înaintea conținutului înainte de criptare
Avertismentul privind confidențialitatea pe care ar trebui să îl înțelegeți
Iată partea sinceră: când scrii un secret într-un prompt Codex, Codex îl citește înainte ca instrumentul MCP să ruleze. Serverele OpenAI procesează acel mesaj.
Deci, „creează un PrivateNote pentru sk_live_abc123” înseamnă că valoarea sk_live_abc123 a apărut scurt într-un context cloud. Pasul PrivateNote asigură faptul că aceasta nu persistă în Slack, e-mail sau istoricul chat-ului — dar nu este același lucru cu faptul că AI-ul nu a văzut-o niciodată.
Două modalități de a închide această lacună:
- Folosiți extensia VS Code când sunteți în Codex IDE — selectați secretul în editor, click dreapta → Share as PrivateNote. Secretul merge direct din editorul dvs. către link-ul criptat. Codex nu este implicat niciodată.
- Folosiți un model local pentru sesiunea agentului. Nimic nu părăsește mașina dvs. până când nu este deja criptat.
Utilizarea extensiei VS Code în Codex IDE
Codex rulează într-un editor compatibil cu VS Code. Extensia PrivateNote VS Code se instalează și funcționează acolo exact la fel ca în VS Code standard.
code --install-extension PrivateNote.privatenote-vscode- După instalare, o pictogramă sub formă de plic apare în bara de activitate — faceți clic pe ea pentru a deschide panoul PrivateNote
- Selectați orice text în editor, click dreapta → Share as PrivateNote pentru o utilizare rapidă, ocazională
- Pictograma cu lacăt din bara de titlu a editorului apare ori de câte ori aveți un text selectat
- Prin această metodă, Codex nu atinge niciodată textul în clar — extensia criptrează local în procesul gazdă VS Code
Dacă preferați fișierul de configurare
Puteți adăuga, de asemenea, serverul MCP manual. Comanda codex mcp add scrie în ~/.codex/config.toml — puteți edita direct acel fișier dacă preferați:
[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]Indicarea unei instanțe auto-găzduite
Dacă echipa dvs. rulează un server PrivateNote privat, setați URL de bază printr-o variabilă de mediu în configurarea MCP:
[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]
[mcp_servers.privatenote.env]
PRIVATENOTE_API_BASE_URL = "https://notes.your-domain.com"- Toate secretele rămân pe infrastructura dvs. — nimic nu ajunge la privatenote.ai
- Se aplică aceeași criptare AES-256-GCM; doar destinația de stocare se schimbă
Depanare
Dacă instrumentul PrivateNote nu apare în clientul dvs. după configurare:
- Reporniți clientul MCP — modificările de configurare nu sunt detectate cât timp aplicația rulează
- Confirmați că Node.js este instalat și în PATH-ul dvs.: node --version
- Confirmați că npx funcționează: npx --version
- Validați configurarea JSON — o virgulă la final este cea mai comună eroare de sintaxă
- Verificați log-urile de MCP sau de extensie ale clientului dvs. pentru erori la pornire
- Asigurați-vă că mașina dvs. are acces la rețeaua privatenote.ai (sau la gazda dvs. auto-găzduită)
Câteva lucruri de reținut
URL este secretul. Link-ul conține cheia de decriptare în fragmentul său. Tratați-l cu aceeași atenție ca pe credențialul în sine — nu îl faceți commit, nu îl logați, nu îl postați într-un canal public.
„Burn-after-reading” înseamnă exact acest lucru. Odată ce link-ul este deschis, acesta dispare. Nici dvs., nici destinatarul nu o puteți redeschide.
Rotiți după partajare. Dacă o credențială a apărut într-un prompt AI — chiar și scurt — tratați-o ca fiind potențial văzută. Partajați valoarea curentă prin PrivateNote, apoi rotiți către una nouă.
PrivateNote este pentru livrare, nu pentru stocare. Dacă ai nevoie ca un secret să fie accesibil mai mult de câteva zile, folosește un manager de secrete adecvat. PrivateNote este pasul de transfer securizat, nu seiful.
Folosește ferestre de expirare scurte. Pentru secrete utilizate o singură dată, 15m sau 1h este aproape întotdeauna suficient. Optează implicit pentru cea mai scurtă fereastră care funcționează încă pentru destinatarul tău.
Conectează asistentul tău AI la PrivateNote
O singură comandă sau un singur bloc JSON înregistrează serverul MCP. Orice sesiune de după aceea are un instrument de partajare securizată a secretelor integrat.
Încearcă PrivateNote →