розробникmcpінтеграціябезпека

Використання PrivateNote з OpenAI Codex

Оновлено 21 травня 2026 р.5 хв читанняPrivateNote.ai

Одна команда підключає PrivateNote MCP до кожного сеансу Codex. Налаштування, можливості Codex та способи не передавати секрети в запит агенту.

Головні висновки

  • 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 — це ШІ-агент для програмування. Ви описуєте, що хочете — виправити помилку, додати функцію, написати тест — і він автономно виконує це в ізольованому середовищі.

Але агентам потрібні секрети. Їм потрібно клонувати репозиторії через SSH, завантажувати пакети з приватних реєстрів, підключатися до тестових баз даних, викликати внутрішні API. Це означає передачу їм облікових даних.

Вставлення ключа API у запит агента принципово не відрізняється від вставлення його в Slack — він потрапляє в історію контексту, можливо, у логи або в пам'ять, що зберігається між сесіями. PrivateNote пропонує чистіший шлях: зашифруйте секрет до того, як його побачить агент, поділіться посиланням, що самознищується після одного читання, і не залишайте слідів.

Ось як поєднати ці два підходи.

Що таке MCP?

MCP (Model Context Protocol) — це відкритий протокол, який дозволяє ШІ-додаткам підключатися до інструментів, джерел даних і сервісів через стандартизовані сервери. Будь-який клієнт, сумісний з MCP — Claude Desktop, Cursor, Codex, Windsurf або інший асистент — може викликати інструменти, надані сервером MCP.

Сервер PrivateNote MCP надає один інструмент: create_private_note. Коли ШІ викликає його, локальний процес Node.js шифрує ваш контент ще до того, як він потрапить у мережу. Результатом є безпечне посилання з терміном дії, яким можна поділитися з ким завгодно.

Вимоги

Перед встановленням переконайтеся, що у вас є:

  • Клієнт, сумісний з MCP: Claude Desktop, Cursor, Codex CLI, Windsurf або будь-який клієнт, що реалізує специфікацію MCP
  • Node.js 18 або новіша версія — перевірте за допомогою: node --version
  • npx доступний — перевірте за допомогою: npx --version
  • Мережевий доступ до privatenote.ai (або вашого власного екземпляра)

Найшвидший шлях: одна команда (Codex)

Якщо ви використовуєте Codex CLI, додавання PrivateNote як глобального MCP сервера виконується однією командою:

Термінал
codex mcp add privatenote -- npx -y privatenote-mcp
  • Це все. Сервер зареєстровано глобально у ~/.codex/config.toml
  • Кожна нова сесія Codex має доступ до інструменту create_private_note
  • Конфігурація на рівні проєкту не потрібна — вона супроводжує вас у різних репозиторіях

Claude Desktop та інші MCP клієнти

Більшість MCP клієнтів приймають конфігураційний файл JSON. Для Claude Desktop відкрийте конфігурацію для вашої ОС:

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

Windows: %APPDATA%\Claude\claude_desktop_config.json

Додайте наступний запис, збережіть файл і перезапустіть Claude Desktop:

claude_desktop_config.json
{
  "mcpServers": {
    "privatenote": {
      "command": "npx",
      "args": ["-y", "privatenote-mcp"]
    }
  }
}
  • Після перезапуску Claude автоматично виявить сервер і надасть інструмент create_private_note у чаті
  • Cursor: додайте той самий запис у Settings → MCP
  • Будь-який інший клієнт, що відповідає специфікації MCP, використовує той самий блок JSON

Що тепер ви можете запитати у свого ШІ-асистента

Після підключення сервера MCP ви можете використовувати звичайну природну мову:

Приклад
# Example response from the assistant:

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

Expires in 24 hours · Burns after reading
  • "Створи PrivateNote, що каже: Тимчасовий пароль — X. Зроби так, щоб він діяв 24 годин."
  • "Загорни цей пароль до бази даних у самознищуване посилання для підрядника"
  • "Надішли SSH-ключ безпечно — термін дії 15 хвилин, знищити після прочитання"
  • "Згенеруй PrivateNote для облікових даних стейджингу та надай мені посилання"

Що насправді робить інструмент

Коли ШІ викликає create_private_note, сервер MCP запускає локальний процес Node.js на вашій машині. Шифрування відбувається саме там — до того, як щось потрапить у мережу.

Сервер генерує випадковий 256-бітний ключ AES, шифрує вміст за допомогою AES-256-GCM і надсилає POST-запитом лише зашифрований текст на privatenote.ai. Ключ не передається у запиті.

Ключ дешифрування зберігається лише у фрагменті URL — у частині після #, яку браузери ніколи не надсилають на сервери. У відповідь приходить посилання. Той, хто відкриває посилання, дешифрує його у своєму браузері. Одразу після цього нотатка видаляється.

privatenote.ai зберігає зашифровані об'єкти. Без фрагмента ці об'єкти не мають сенсу.

Поширені варіанти інструментів

Інструмент create_private_note приймає наступні параметри:

Запит
# Structured example prompt:

Create a PrivateNote with:
content: "The deployment token is ghp_abc123"
expiresIn: "15m"
burnAfterReading: true
  • content — конфіденційний текст для шифрування та зберігання (обов'язково)
  • expiresIn — як довго нотатка залишатиметься доступною: 15m, 1h, 24h або 7d (за замовчуванням: 24h)
  • burnAfterReading — знищити нотатку після першого перегляду (за замовчуванням: true)
  • title — необов'язкова мітка, що додається перед вмістом перед шифруванням

Застереження щодо конфіденційності, яке слід розуміти

Ось чесна частина: коли ви вводите секрет у запит Codex, Codex зчитує його перед запуском інструмента MCP. Сервери OpenAI обробляють це повідомлення.

Отже, "створи PrivateNote для sk_live_abc123" означає, що значення sk_live_abc123 ненадовго з'явилося в хмарному контексті. Крок PrivateNote гарантує, що воно не залишиться в Slack, електронній пошті або історії чату, — але це не те саме, що ШІ ніколи його не бачив.

Два способи усунути цей розрив:

  • Використовуйте розширення VS Code, коли перебуваєте в Codex IDE — виберіть секрет у редакторі, натисніть правою кнопкою миші → Share as PrivateNote. Секрет потрапляє безпосередньо з вашого редактора в зашифроване посилання. Codex не бере участі.
  • Використовуйте локальну модель для сесії агента. Нічого не покидає вашу машину, поки воно не буде зашифроване.

Використання розширення VS Code у Codex IDE

Codex працює всередині редактора, сумісного з VS Code. Розширення PrivateNote VS Code встановлюється та працює там точно так само, як у стандартному VS Code.

Термінал
code --install-extension PrivateNote.privatenote-vscode
  • Після встановлення на панелі активності з'явиться іконка конверта — натисніть на неї, щоб відкрити панель PrivateNote
  • Виберіть будь-який текст у редакторі, натисніть правою кнопкою миші → Share as PrivateNote для швидкого разового використання
  • Іконка замка на панелі заголовка редактора з'являється щоразу, коли ви виділяєте текст
  • За цим шляхом Codex ніколи не торкається відкритого тексту — розширення шифрує дані локально в хост-процесі VS Code

Якщо ви віддаєте перевагу конфігураційному файлу

Ви також можете додати сервер MCP вручну. Команда codex mcp add записує дані в ~/.codex/config.toml — ви можете редагувати цей файл безпосередньо, якщо бажаєте:

~/.codex/config.toml
[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]

Вказівка на self-hosted екземпляр

Якщо ваша команда використовує приватний сервер PrivateNote, встановіть базовий URL через змінну середовища в конфігурації MCP:

~/.codex/config.toml
[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]

[mcp_servers.privatenote.env]
PRIVATENOTE_API_BASE_URL = "https://notes.your-domain.com"
  • Усі секрети залишаються на вашій інфраструктурі — нічого не потрапляє на privatenote.ai
  • Застосовується те саме шифрування AES-256-GCM; змінюється лише місце зберігання

Усунення несправностей

Якщо інструмент PrivateNote не з'являється у вашому клієнті після налаштування:

  • Перезапустіть свій клієнт MCP — зміни конфігурації не підтягуються, поки додаток запущений
  • Переконайтеся, що Node.js встановлено та додано до PATH: node --version
  • Переконайтеся, що npx працює: npx --version
  • Перевірте свій конфіг JSON — найпоширенішою синтаксичною помилкою є зайва кома в кінці
  • Перевірте логи MCP або розширень вашого клієнта на наявність помилок під час запуску
  • Переконайтеся, що ваша машина має мережевий доступ до privatenote.ai (або вашого self-hosted хоста)

Кілька речей, які варто пам'ятати

URL — це секрет. Посилання містить ключ дешифрування у своєму фрагменті. Ставтеся до нього так само дбайливо, як до самих облікових даних — не комітьте його, не логуйте та не публікуйте у відкритих каналах.

Принцип «спалити після прочитання» означає саме це. Щойно посилання відкрито, воно зникає. Ні ви, ні отримувач не зможете відкрити його знову.

Оновлюйте дані після передачі. Якщо облікові дані з'явилися в AI-промпті — навіть ненадовго — вважайте їх потенційно переглянутими. Поділіться поточним значенням через PrivateNote, а потім змініть його на нове.

PrivateNote призначений для доставки, а не для зберігання. Якщо вам потрібно, щоб секрет був доступний довше ніж кілька днів, використовуйте повноцінний менеджер секретів. PrivateNote — це етап безпечної передачі, а не сховище.

Використовуйте короткі терміни дії. Для одноразових секретів 15m або 1h майже завжди достатньо. Обирайте найкоротший термін, який все ще підходить вашому отримувачу.

Підключіть свого AI-асистента до PrivateNote

Одна команда або один блок JSON реєструє сервер MCP. Кожна наступна сесія матиме вбудований інструмент для безпечного обміну секретами.

Спробуйте PrivateNote →
Фото: Léna Le Roy · Unsplash.