Использование PrivateNote с OpenAI Codex
Одна команда подключает 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:
{
"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 для учетных данных staging и дай мне ссылку"
Что на самом деле делает инструмент
Когда ИИ вызывает 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 в IDE Codex — выделите секрет в редакторе, нажмите правую кнопку мыши → 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 — вы можете редактировать этот файл напрямую, если хотите:
[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]Указание на self-hosted экземпляр
Если ваша команда использует частный сервер PrivateNote, установите базовый URL через переменную окружения в конфигурации MCP:
[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 — это секрет. Ссылка содержит ключ дешифрования в своем фрагменте. Относитесь к ней так же бережно, как к самому учетному данным: не фиксируйте в коммитах, не записывайте в логи и не публикуйте в открытых каналах.
Функция «сжечь после прочтения» означает именно это. Как только ссылка открыта, она исчезает. Ни вы, ни получатель не сможете открыть её снова.
Ротируйте данные после передачи. Если учетные данные попали в промпт ИИ — даже ненадолго — считайте их потенциально скомпрометированными. Передайте текущее значение через PrivateNote, а затем замените его на новое.
PrivateNote предназначен для передачи, а не для хранения. Если секрет должен быть доступен более нескольких дней, используйте полноценный менеджер секретов. PrivateNote — это шаг безопасной передачи, а не хранилище.
Используйте короткие окна истечения срока действия. Для одноразовых секретов 15m или 1h почти всегда достаточно. По умолчанию выбирайте кратчайшее окно, которое будет удобно получателю.
Подключите своего ИИ-ассистента к PrivateNote
Одна команда или один блок JSON регистрирует сервер MCP. После этого в каждой сессии будет встроен инструмент для безопасного обмена секретами.
Попробовать PrivateNote →