Интеграции для разработчиков

Передавайте секреты из инструментов, где работа идёт на самом деле

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.
Открыть документацию

Плагин Codex

Стабильный

MCP и навыки для OpenAI Codex CLI и IDE.

codex mcp add privatenote -- npx -y privatenote-mcp
Открыть документацию

Рецепты

Типичные сценарии

Начните с задачи — выберите интеграцию, которая соответствует тому, где находится секрет и как его нужно передать.

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

Только предварительный просмотр — не промышленная среда на своей инфраструктуре. Расширение Chrome жёстко привязано к privatenote.ai и не может обращаться к самостоятельно размещённому API; используйте CLI (--insecure для локального http://), MCP или VS Code. Управляемые корпоративные развёртывания в планах — напишите нам, если хотите дать ранний отзыв.

Где это уместно

Небольшой инструмент для неудобных моментов

Команды разработчиков по-прежнему передают друг другу пароли баз данных, коды восстановления, токены API, детали передачи в поддержку и диагностику по конкретному клиенту. Эти секреты часто оказываются в истории чата, комментариях к заявкам, обсуждениях запросов на слияние или промптах ИИ, потому что безопасный путь слишком медленный.

PrivateNote нужен, чтобы сделать безопасный путь быстрым. Интеграция должна ощущаться как создание ссылки, а реализация оставляет конфиденциальный текст зашифрованным до того, как он попадёт на сервер.

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

Один и тот же контракт на каждом пути

Архитектура

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

Каждая интеграция соблюдает одну и ту же границу. Открытый текст никогда не покидает ваше устройство незашифрованным; сервер никогда не получает ключ расшифровки.

Шифрование локально

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

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

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

Ключ в #fragment

Ключ расшифровки остаётся в хэше URL. Браузеры не отправляют фрагменты в HTTP-запросах.

privatenote.ai/note/…#key

  • Открытый текст шифруется локально до загрузки.

  • Сервер хранит шифротекст и метаданные заметки, а не ключ расшифровки.

  • Ключ остаётся во фрагменте URL, который не отправляется в запросах HTTP.

  • Лимиты чтений и срок действия обеспечивает служба заметок.

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

Как работает шифрование

Начните с интеграции, ближайшей к секрету

Используйте веб-приложение для редкой передачи, расширение редактора для ежедневной работы разработчика, CLI для скриптов и CI, а MCP — когда агенту нужна безопасная операция передачи.

Расширение, MCP, CLI, Chrome и веб-приложение используют одну и ту же границу шифрования.

Релизы и журналы изменений

PrivateNote on LaunchNest