Інтеграції для розробників

Передавайте секрети з інструментів, де робота справді відбувається

PrivateNote корисний як вебсайт, але командам розробників зазвичай потрібна та сама зашифрована передача в редакторах, локальних ШІ-агентах, скриптах і контрольованих розгортаннях. Ця сторінка показує ці точки входу і межу довіри за ними.

Який інструмент коли обирати

Оберіть шлях, найближчий до місця, де секрет вже є. Кожна інтеграція використовує той самий контракт локального шифрування.

Вебзастосунок

Стабільний

Вставте секрет, оберіть строк дії та ліміти читання, а потім поділіться зашифрованим посиланням з будь-якого браузера.

Вебзастосунок PrivateNote з редактором зашифрованої нотатки, параметрами строку дії та кнопкою «Поділитися приватною нотаткою»
Вебзастосунок на privatenote.ai — напишіть нотатку, налаштуйте строк дії, додайте файли і поділіться з будь-якого браузера.
Відкрийте privatenote.ai → вставте секрет → поділіться зашифрованим посиланням
Як працює шифрування

CLI

Стабільний

Секрети без слідів в історії bash, конвеєрах і CI/CD.

$ echo 'sk-live-...' | npx privatenote-cli --expire 1h --output-url-only
https://privatenote.ai/note/a1b2c3d4#…
Передайте секрет у CLI — шифрування виконується локально, stdout виводить лише одноразовий URL.
Переглянути документацію

VS Code & Cursor

Стабільний

Щоденна робота розробника — бічна панель, виділення й буфер обміну без виходу з редактора.

Бічна панель PrivateNote у VS Code або Cursor із заголовком, вмістом, строком дії та налаштуваннями видалення після прочитання
Бічна панель у VS Code або Cursor — створіть нотатку, задайте строк дії та видалення після прочитання, потім поділіться нею, не виходячи з редактора.
code --install-extension PrivateNote.privatenote-vscode
Переглянути документацію

Розширення Chrome

Стабільний

Шифруйте виділений текст на місці — контекстне меню, спливне вікно й Alt+Shift+P.

Спливне вікно розширення PrivateNote для Chrome із заголовком, вмістом, необов’язковим паролем, строком дії та налаштуваннями видалення після прочитання
Спливне вікно панелі інструментів Chrome — створіть нотатку, задайте строк дії та видалення після прочитання, потім поділіться нею, не відкриваючи privatenote.ai.
# Right-click selected text → Create PrivateNote
# Shortcut: Alt+Shift+P
Переглянути документацію

Сервер MCP

Стабільний

Надайте ШІ-агентам локальний інструмент create_private_note для безпечної передачі.

// попередній перегляд — шлях, не секрет
create_private_note({ "contentFilePath": "/absolute/path/secret.txt" })
// після вашого схвалення
confirm_private_note({ "confirmationId": "cnfg_…" })
Агенти передають шлях до файлу у create_private_note. Ви затверджуєте попередній перегляд, після чого confirm_private_note повертає URL.
Переглянути документацію

Рецепти

Типові сценарії

Почніть із завдання — оберіть інтеграцію відповідно до того, де перебуває секрет і як його треба передати.

CLI

Передайте ключ API з CI

Передайте секрет GitHub Actions у CLI через конвеєр і отримайте одноразовий URL — не допускайте відкритий текст у журнали робочого процесу.

echo "$API_KEY" | privatenote --output-url-only
Переглянути документацію
Chrome

Передайте з браузера

Виділіть текст у Slack, листі або заявці й створіть зашифроване посилання, не відкриваючи privatenote.ai.

Правий клік → Створити PrivateNote
Переглянути документацію
MCP

Агент надсилає код відновлення

Нехай клієнт MCP передасть шлях до файлу в create_private_note, дочекається вашого схвалення й викличе confirm_private_note.

create_private_note({ contentFilePath }) → confirm_private_note
Переглянути документацію
VS Code

Передайте токен із редактора

Виділіть змінні середовища, ключі API або рядки підключення у VS Code чи Cursor і передайте їх без перемикання застосунків — посилання потрапить у буфер обміну.

Правий клік → Поділитися як PrivateNote
Переглянути документацію
Codex

Надайте Codex інструмент безпечної передачі

Зареєструйте сервер MCP один раз, щоб Codex міг створювати зашифровані посилання у процесах агента замість вставлення секретів у чат.

codex mcp add privatenote -- npx -y privatenote-mcp
Переглянути документацію
Веб

Надішліть людині поза вашим середовищем

Використовуйте вебзастосунок, якщо одержувачу потрібне лише посилання — задайте строк дії, видалення після прочитання й необов’язковий пароль у браузері.

Створити нотатку → строк дії + пароль → копіювати посилання
Переглянути документацію

Попередній перегляд самостійного розміщення

Що працює сьогодні: спрямуйте CLI і сервер MCP на ваш API змінною PRIVATENOTE_API_BASE_URL, а розширення VS Code — параметром privatenote.apiBaseUrl. Попередній перегляд у Docker Compose (docker-compose.yml) піднімає локальний стек вебу й API для оцінювання.

npm run self-host:up

Лише попередній перегляд — не промислове середовище on-premise. Розширення Chrome жорстко прив’язане до privatenote.ai і не може звертатися до самостійно розміщеного API; натомість скористайтеся CLI (--insecure для локального http://), MCP або VS Code. Керовані корпоративні розгортання є в планах — зв’яжіться з нами, якщо хочете вплинути на ранньому етапі.

Де це доречно

Невеликий інструмент для незручних моментів

Команди розробників досі передають одне одному паролі баз даних, коди відновлення, токени API, деталі передачі в підтримку і діагностику конкретного клієнта. Ці секрети часто опиняються в історії чату, коментарях заявок, гілках pull request або запитах до ШІ, бо безпечний шлях надто повільний.

PrivateNote має зробити безпечніший шлях швидким. Інтеграція має відчуватися як створення посилання, а реалізація тримає чутливий текст зашифрованим ще до того, як він досягне сервера.

Модель довіри

Той самий контракт на кожному шляху

Архітектура

Шифруйте локально → вивантажте шифротекст → ключ у #fragment

Кожна інтеграція дотримується тієї самої межі. Відкритий текст ніколи не залишає ваш пристрій незашифрованим; сервер ніколи не отримує ключ розшифрування.

Шифрування локально

AES-256-GCM на вашому пристрої — у браузері, редакторі, терміналі або процесі MCP.

Завантаження зашифрованого тексту

На сервер потрапляють лише зашифровані байти й метадані нотатки (строк дії, видалення після прочитання).

Ключ у #fragment

Ключ розшифрування залишається в хеші URL. Браузери не надсилають фрагменти в HTTP-запитах.

privatenote.ai/note/…#key

  • Відкритий текст шифрується локально перед вивантаженням.

  • Сервер зберігає шифротекст і метадані нотатки, а не ключ розшифрування.

  • Ключ залишається у фрагменті URL, який не надсилається в запитах HTTP.

  • Ліміти читання і строк дії забезпечує служба нотаток.

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

Як працює шифрування

Почніть з інтеграції, найближчої до секрету

Вебзастосунок — для разового обміну, розширення редактора — для щоденної роботи розробника, CLI — для скриптів і CI, а MCP — коли агенту потрібен примітив безпечної передачі.

PrivateNote on LaunchNest