ииmcpразработчикбезопасность

Пусть ИИ передаёт секреты, не получая к ним доступа

Как PrivateNote MCP передает файлы через email, Slack, Discord и WhatsApp — так, чтобы модель их не прочитала

Обновлено 11 сентября 2026 г.7 мин чтенияPrivateNote.ai

Ассистент может отправить договор, пароль или CSV, не читая содержимое. Передайте локальные пути файлов в PrivateNote MCP и отправьте только самоуничтожающуюся ссылку через привычный канал.

Ключевые выводы

  • Pass file paths, not file bytes—the local MCP encrypts so the model never needs the payload.
  • You approve a preview that binds exact bytes, options, and destination. Creating a note is not permission to send it.
  • Email, Slack, Discord, and WhatsApp should carry only the PrivateNote URL after sendAuthorized — never the file. Leave one-shot off if the agent can also send messages.
  • The decryptable URL is a bearer capability the agent can see after confirm. Do not log it. After delivery, poll open status or revoke an unopened note.

Польза ИИ-ассистента не в том, что он может прочитать контракт, файл с паролями или экспорт клиентов. Пользу в том, что он может доставить этот контент нужному человеку по тому каналу, которым тот уже пользуется, не превращая самого ассистента в копию секрета.

В этом заключается ежедневная работа: отправить PDF клиенту по почте, передать пароль от стейджинга коллеге в Slack, отдать токен бота модератору в Discord или поместить одноразовый логин в ветку WhatsApp. Люди и так делают это через копирование. Агенты ускоряют процесс копирования, но и увеличивают риск утечки, так как секрет теперь также находится в контексте модели, в истории чата и во всех логах хоста.

Сервер MCP системы PrivateNote построен на обратном принципе. Агент управляет процессом. Локальный процесс обрабатывает секрет. Вы одобряете конкретный файл и место назначения. Email, Slack, Discord и WhatsApp несут только ссылку. Модели дается команда передавать пути к файлам, а не байты файлов. Шифрование происходит на вашей машине после вашего подтверждения. В ответ приходит URL, фрагмент которой содержит ключ — по той же модели одноразовой секретной ссылки, что и веб-приложение. Создание заметки не является разрешением на ее отправку.


Задача — отправлять, а не знать

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

Доставка — это логистическая задача: какой файл, какой человек, какой канал, как долго должен действовать доступ, должен ли он удалиться после первого просмотра. Ни одно из этих решений не требует наличия открытого текста. Для этого нужен инструмент, который может прочитать локальный путь, зашифровать данные и вернуть дескриптор, который разрешено видеть остальной части стека.

Для этого и предназначен privatenote-mcp. Хостам, соблюдающим инструкции MCP, сообщается в следующем порядке: если пользователь указал локальный файл, передайте абсолютный путь; не открывайте, не выводите через cat и не резюмируйте его; вызовите create_private_note (предпросмотр); дождитесь вашего одобрения; затем вызовите confirm_private_note. Только после этого другой инструмент может отправить URL — и только по тому адресу, который вы одобрили.

Правило

Если ассистент может выполнить задачу, используя путь, он не должен выполнять её, используя содержимое. Вставка в промпт — это крайняя мера, когда секрет уже попал в чат.

Почему каналы, которые вы уже используете, сохраняют неверную копию

Email, Slack, Discord и WhatsApp хороши для общения. Они плохие хранилища. Шифрование при передаче или даже сквозное шифрование не определяет, как долго ищущая копия будет оставаться на устройствах, в экспортах рабочих пространств, в облачных бэкапах или в превью уведомлений. Это то же самое различие, что и в вопросах почему email — худшее место для секретов и почему секреты никогда не следует вставлять в чат.

  • Email хранит вложения в почтовых ящиках, на почтовых серверах, в юридических архивах и в «поиске по всей почте». Пересылка множит копии, которые вы не сможете отозвать позже.
  • Slack индексируется рабочим пространством. Администраторы, экспорт для комплаенса и функции ИИ, резюмирующие каналы, могут обнаружить пароль спустя месяцы.
  • Discord кажется эфемерным в загруженном сервере. Это не так. Закрепленные сообщения, поиск и личные сообщения хранят токены ботов и секреты приглашений администраторов рядом с мемами.
  • WhatsApp часто является единственным каналом, который подрядчик или клиент действительно откроет. Это также «семейный почтовый ящик»: скриншоты пересылаются, связанные компьютеры синхронизируются, а бэкапы переживают завершение проекта.

Суть не в том, чтобы отказаться от этих инструментов. Суть в том, чтобы перестать помещать в них полезную нагрузку. Они должны оставаться конвертом. Заметка — это письмо. Получателям по-прежнему не нужен аккаунт PrivateNote: они открывают ссылку в браузере так же, как открыли бы любую другую URL, которую вы им уже отправляли.


Разделение на три части

РольЧто может видетьЧего не должен видеть
ИИ-агент (Cursor, Claude, Codex)Кто, какой путь, какой канал, срок действия, удаление после прочтения. После вашего подтверждения: расшифруемый URLБайты файла, пароли, тело заметки. Он не должен отправлять URL, пока вы не одобрите место назначения
PrivateNote MCP (локальный процесс Node)Файлы на диске, только для шифрованияНичего, что он затем возвращает в виде открытого текста
Email / Slack / Discord / WhatsAppPrivateNote URL (и понятная человеку тема)Вложение, учетные данные, парольная фраза

MCP не отправляет email или сообщение Slack за вас. Создание заметки не является авторизацией на её отправку. После того как вы одобрите предпросмотр с указанием конкретного канала и получателя, результат может включать sendAuthorized: true — тогда почтовый или чат-инструмент может отправить только URL по этому адресу. Если место назначения не было одобрено, sendAuthorized принимает значение false, и агент должен выдать вам URL для вставки, а не запускать другой инструмент.

URL — это возможность предъявителя: любой, у кого он есть, может открыть заметку. Текущий хост MCP возвращает secureUrl в результате работы инструмента, чтобы агент мог увидеть ссылку, даже если он не может видеть байты файла. Не логируйте её, не фиксируйте в коммите и не копируйте в несвязанные инструменты. Относитесь к ней как к секрету.

Остальная часть возвращаемой нагрузки невелика: noteId, expiresAt, burnAfterReading, а также, если применимо, passwordProtected и attachedFileNames. Имена файлов — это метаданные, а не содержимое, но всё же избегайте помещения секрета в имя файла.


Что MCP на самом деле делает на вашей машине

Когда агент вызывает create_private_note, локальный процесс Node.js — а не модель — канонизирует путь, проверяет его по белому списку рабочей области, хеширует файл и показывает вам превью. Он не возвращает расшифруемый URL сразу. После вашего одобрения confirm_private_note повторно открывает тот же файл, проверяет устройство, inode, размер и SHA-256, а затем шифрует эти байты. Если файл изменился, подтверждение не удастся; агенту придется начать сначала. Шифртекст AES-256-GCM отправляется методом POST на PrivateNote. Ключ расшифровки помещается во фрагмент URL (#…). Браузеры не отправляют фрагменты на серверы. API хранит зашифрованный блоб. Без фрагмента этот блоб — просто шум.

Предпочтительнее использовать параметры пути, чтобы хосту никогда не приходилось передавать секрет в аргументах вызова инструмента, сформированных моделью:

  • contentFilePath — файл UTF-8, который становится телом заметки (пароль, код восстановления или короткая инструкция).
  • filePath / filePaths — локальные вложения (PDF, CSV, изображения). Требуется sign_in. Максимум 20 файлов в совокупности.
  • passwordFilePath — первая строка локального файла становится паролем для раскрытия (Argon2id wrap). Отправляйте этот пароль вне основного канала, никогда не в том же сообщении, что и ссылка.
  • content и password — крайние меры, только если пользователь уже вставил секрет в чат и файл отсутствует.

Политика по умолчанию соответствует передаче, а не архивированию: burnAfterReading установлено в true, expiresIn по умолчанию составляет 24 часов. Чем короче срок, тем лучше, если получатель ждет на другой стороне Slack. Мультипросмотр (burnAfterReading: false) требует Premium-аккаунта. Прикрепление файлов, проверка получателя, уведомления об открытии и управление списком/отзывом требуют авторизованной сессии; доступ к шлюзам и оповещениям также требуют платного плана.

Пути ограничены. По умолчанию можно читать только файлы внутри рабочей области (рабочая директория процесса MCP). Установите PRIVATENOTE_MCP_ALLOWED_ROOTS, если необходимо добавить папки. SSH-ключи, директории с облачными учетными данными и файл сессии MCP всегда заблокированы, даже если вы разрешите $HOME или /.


Вы одобряете конкретную передачу, а не путь к файлу

Агент, который может создавать расшифруемую ссылку и отправлять электронную почту или Slack, является «запутавшимся заместителем» (confused deputy): он может за один ход зашифровать не тот файл или отправить правильную ссылку не тому человеку. По умолчанию в PrivateNote вы авторизуете три вещи одновременно: точные байты файла, точные параметры заметки (срок действия, удаление после прочтения) и точный адрес назначения.

Превью должно показывать место назначения при запросе отправки, например: «Отправить через: Email / Получатель: alice@example.com». Одобрение этого действия никогда не должно авторизовать другой адрес или канал Slack. confirm_private_note принимает только confirmationId. Агент не может переопределить путь, получателя, канал, срок действия или политику уничтожения при подтверждении.

Создание заметки без указания места назначения возвращает sendAuthorized: false. Это сделано намеренно. Ссылка в чате все еще конфиденциальна, но она не является разрешением на ее отправку по почте.

Не включайте режим «в один шаг» (one-shot), если агент может отправлять сообщения

PRIVATENOTE_MCP_ALLOW_ONE_SHOT пропускает просмотр человеком. Агент не может включить это как аргумент инструмента, а последующее изменение переменных окружения не даст эффекта до перезапуска сервера MCP. Оставьте эту функцию выключенной. Включение этой функции, когда тот же хост может отправлять email, Slack, Discord или файлы, позволяет модели создать расшифруемую ссылку и отправить ее за один шаг — включая неверный файл или неверного получателя. Белый список путей все еще применяется; это не замена вашему одобрению.

Подключите это один раз

Требуется Node.js версии 18+. После сохранения перезапустите клиент MCP, чтобы загрузились текущие схемы инструментов и инструкции. Полные заметки по установке доступны на странице интеграции MCP.

~/.cursor/mcp.json · Claude Desktop использует тот же блок
{
  "mcpServers": {
    "privatenote": {
      "command": "npx",
      "args": ["-y", "privatenote-mcp"]
    }
  }
}

Codex CLI: codex mcp add privatenote -- npx -y privatenote-mcp. Это записывает ~/.codex/config.toml. Заметки, специфичные для Codex, находятся в Использование PrivateNote с OpenAI Codex.

Self-hosted: установите PRIVATENOTE_API_BASE_URL и PRIVATENOTE_WEB_ORIGIN в блоке MCP env, чтобы шифртекст никогда не покидал вашу инфраструктуру. Опционально установите PRIVATENOTE_MCP_ALLOWED_ROOTS. Не добавляйте PRIVATENOTE_MCP_ALLOW_ONE_SHOT, если у вас нет узкоспециализированного хоста автоматизации без инструментов отправки.


Ежедневное использование: email

Email по-прежнему используется компаниями для отправки контрактов, NDA, счетов с банковскими реквизитами и выгрузок данных клиентов. Ошибочный сценарий — прикрепление файла. В этом случае почтовый ящик хранит расшифруемую копию годами, включая сторону получателя, следы BCC и системы электронного раскрытия документов (e-discovery).

Паттерн MCP: агенту уже известен адрес Alice и два локальных PDF-файла. Он не должен открывать эти PDF. При необходимости он входит в систему, вызывает create_private_note с filePaths, sendChannel и sendRecipient, чтобы в превью отображалось имя Alice, ждет вашего одобрения, а затем confirm_private_note. Только после этого инструмент электронной почты может поместить в тело письма только secureUrl. Если вы используете проверку получателя, читатель должен доказать, что владеет адресом, прежде чем заметка разблокируется — этот шлюз не отправляет письмо; это по-прежнему делает ваш почтовый инструмент.

Что вы говорите
Send these two files to Alice by email.
Protect them with the password in /absolute/path/client-password.txt.
Don't expose the files or password to the model:
/absolute/path/contract.pdf
/absolute/path/nda.pdf
  • Агент вызывает sign_in, если сессия плагина отсутствует, затем create_private_note с filePaths, passwordFilePath, sendChannel: "email" и sendRecipient. Вы одобряете превью. Затем confirm_private_note.
  • Тема письма может содержать «пакет документов» — в ней не должно цитироваться положения из PDF.
  • Отправьте парольную фразу в отдельном сообщении, звонком или через общий доступ в менеджере паролей — никогда не отправляйте её в том же письме, что и ссылку. См. как безопасно поделиться паролем.
  • Для именованного получателя на платном тарифе: requireRecipientVerification: true и recipientEmail: "alice@example.com".

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


Ежедневное использование: Slack

Slack — это место, где происходит дежурство. Пароли от баз данных стейджинга, токены развертывания и «CSV из финансового отдела» сбрасываются в ветку, потому что все уже там. Затем поиск по рабочему пространству превращает этот сброс в постоянную внутреннюю вики секретов.

Запрашивайте передачу данных на основе пути и короткий срок действия. Пятнадцати минут достаточно, если коллега онлайн. Удаляйте после прочтения, чтобы при последующем поиске ссылка была нерабочей, а не живым учетным данным. Относитесь к URL как к секрету: не публикуйте его в публичном канале; используйте личные сообщения или выделенный приватный канал.

Что вы говорите
Send Mark the database password from /absolute/path/secrets/db-password.txt in Slack.
Make it read-once and expire in 15 minutes.
Don't read the file into the chat.
  • create_private_note с contentFilePath, expiresIn: "15m", burnAfterReading: true и назначением Slack, привязанным при просмотре. Одобрите, затем confirm_private_note.
  • Если Slack подключен как другой инструмент MCP, агент может отправить только secureUrl в одобренное место назначения после того, как sendAuthorized станет истинным. В противном случае он выдаст вам URL для вставки.
  • После того как Mark откроет его, смените пароль, если это был общий секрет стейджинга — заметка уменьшила количество оставшихся копий, но она не сделала общий учетный идентификатор уникальным.

Ежедневное использование: Discord

Discord — это стандартный операционный канал для многих продуктовых сообществ и команд, связанных с играми. Токены ботов, ключи Cloudflare и «вот таблица с зарегистрированными пользователями» вставляются в личные сообщения модераторам, потому что Discord — это место, где находятся модераторы.

Сообщение в Discord всё равно является сохраненным сообщением. Участники сервера с соответствующей ролью, резервные копии устройств и собственный поиск Discord сохранят его. Паттерн MCP идентичен Slack: зашифруйте файл или токен локально, поместите ссылку в личные сообщения, установите короткий срок действия. Если токен уже вставлялся ранее в том же сервере, смените его — оборачивание утекшего секрета не отменяет его утечку.

Что вы говорите
DM the community lead the bot token in /absolute/path/secrets/discord-bot.txt
and the moderation export at /absolute/path/reports/export.csv.
Read-once, 1 hour, don't open those files.
  • Вложениям требуется sign_in. Заметка только с токеном может использовать contentFilePath без сессии.
  • Привяжите место назначения Discord при просмотре, одобрите его, затем confirm_private_note. Только после этого инструмент Discord может отправить URL.
  • Предпочитайте личные сообщения пользователю, а не вставку в канал модераторов. «Приватный канал» — это всё равно лог переписки.
  • Если экспорт включает персональные данные, добавьте файл с парольной фразой и сообщите парольную фразу руководителю по голосовой связи.

Ежедневное использование: WhatsApp

WhatsApp — это канал, который вы используете, когда другой человек не присоединится к Slack и не проверит электронную почту до понедельника. Подрядчик, ассистент семейного офиса, клиент с телефона. Сквозное шифрование реально. Сохранность данных также реальна: чат является записью, часто на нескольких устройствах, часто с резервным копированием.

Им не нужно устанавливать PrivateNote. Им нужно просто нажать на ссылку. Задача ассистента — подготовить эту ссылку из локального файла, который у вас уже есть (счет PDF, пароль от Wi-Fi, одноразовый код портала), не считывая его сначала в Cursor или ветку Claude. Вы всё равно одобряете превью (точный файл и место назначения WhatsApp), прежде чем confirm_private_note создаст URL.

Что вы говорите
Send the onboarding pack at /absolute/path/client/onboarding.pdf
to Ana on WhatsApp. Burn after reading, expire tomorrow.
Don't read the PDF.

WhatsApp будет показывать превью URL-адресов. Это превью является целевой страницей PrivateNote, а не расшифрованным файлом. Тем не менее: не помещайте пароль в тот же чат. Если число может быть неверным, создайте заметку, отправьте ссылку и отзовите ее, если она ее так и не открыла. Юристы и другие профессиональные отправители, которым нужна брендированная страница раскрытия данных вместо «зеленого облачка» (iMessage), должны прочитать безопасную доставку клиентам для юристов.


Войдите в систему, если полезная нагрузка является файлом

Текстовые заметки от contentFilePath можно создавать без аккаунта, при этом действуют те же публичные ограничения частоты запросов, что и на сайте. Прикрепление файлов работает иначе. Сначала необходимо вызвать MCP, затем sign_in. Это откроет страницу подтверждения в браузере (разрешение уже находится в URL — вводить код не нужно). После нажатия кнопки «Approve» агент снова вызывает sign_in с pollDeviceCode. Сессия сохраняется в ~/.config/privatenote/mcp-session.json и отправляется как Authorization: Bearer. Это не заменяет сессию cookie вашего веб-сайта.

  • Агент запускает sign_in() — открывается браузер
  • Вы нажимаете Approve на странице PrivateNote
  • Агент опрашивает систему с помощью pollDeviceCode, затем whoami()
  • Агент вызывает create_private_note с путями к файлам (превью — без URL)
  • Вы подтверждаете конкретные файлы, срок действия и место назначения
  • Агент вызывает confirm_private_note, затем вы (или другой инструмент) отправляете только secureUrl через человеческий канал связи

whoami показывает авторизованный аккаунт. sign_out удаляет файл сессии плагина. Относитесь к этому файлу как к учетным данным для данной машины.

Установите privatenote-mcp в Cursor, Claude Desktop или Codex. Агент управляет рабочим процессом; локальный процесс хранит секрет.

Открыть руководство по настройке MCP

После отправки ссылки

Качественная передача данных не заканчивается в момент, когда сообщение покидает Slack. Платные авторизованные сессии могут рассматривать доставку как события, а не контент: создано, открыто, истекло, отозвано. list_sent_notes возвращает id, статус и openedAt — но никогда не возвращает открытый текст. revoke_sent_note аннулирует неоткрытую заметку. notifyOnOpen отправляет письмо на ваш аккаунт PrivateNote, когда заметка открывается впервые; агент узнает об открытии путем опроса list_sent_notes. Push-вебхуков в Cursor не существует.

Бизнес-процесс под управлением агента
sign_in()
create_private_note({
  filePaths: [
    "/absolute/path/signed-contract.pdf",
    "/absolute/path/customer-export.csv"
  ],
  expiresIn: "24h",
  burnAfterReading: true,
  requireRecipientVerification: true,
  recipientEmail: "john@example.com",
  notifyOnOpen: true,
  label: "contract-for-john",
  sendChannel: "email",
  sendRecipient: "john@example.com"
})
# wait for user approval of that exact destination
confirm_private_note({ confirmationId: "<from preview>" })
# email or Slack only secureUrl to John
# later: list_sent_notes() and look for openedAt on that noteId

Верификация получателя — это шлюз разблокировки в PrivateNote, а не замена отправке сообщения. Для получения уведомлений об открытии требуется подтвержденный email отправителя в аккаунте. О получении только статуса читайте в как узнать, когда была открыта секретная ссылка. Агентам с широким доступом к инструментам все равно требуется модель разрешений, описанная в обеспечении безопасности ИИ-агентов как сотрудников.


Честное предостережение о конфиденциальности

Строгое утверждение — «ИИ никогда не видел байты файла» — справедливо, если хост соблюдает инструкции, приоритетные для путей, и вы никогда не вставляли полезную нагрузку в промпт. Это не означает, что агент не может видеть secureUrl после подтверждения. Обычный вызов инструмента MCP все еще может раскрыть аргументы хосту. Вот почему инструменты предпочитают пути: аргументом является /Users/you/secrets/db-password.txt, а не пароль.

Если вы введете create a PrivateNote for sk_live_abc123, облачный провайдер модели может обработать эту строку до запуска MCP. PrivateNote все равно будет хранить только шифротекст, а Slack все равно получит только ссылку. Вы улучшили защиту от утечки на конечном этапе. Вы не удержали секрет от модели. Для максимальной конфиденциальности храните секреты в файлах (или используйте расширение VS Code / Cursor, чтобы редактор шифровал данные без участия агента) и сообщайте ассистенту только путь.

  • Не просите модель «сначала проверить PDF» или резюмировать его. Это принудительно запускает чтение с помощью другого инструмента.
  • Не помещайте пароль в тот же Slack/WhatsApp/email, что и URL.
  • Относитесь к secureUrl как к секрету. Агент может видеть его в результате работы инструмента. Не фиксируйте его в коде, не записывайте в логи и не вставляйте в публичные каналы Discord.
  • Перезагрузите клиент MCP после обновления privatenote-mcp, чтобы инструкции и схемы оставались актуальными. Отключите режим one-shot.

Частые вопросы

Отправляет ли PrivateNote MCP саму Slack, Discord, WhatsApp или электронное письмо?

Нет. Он шифрует данные локально и возвращает URL плюс метаданные. Доставка осуществляется через то, что вы уже используете — другой сервер MCP (Gmail, Slack, …) или путем самостоятельной вставки ссылки. Создание заметки не дает разрешения на ее отправку. sendAuthorized возвращает true только в том случае, если вы одобрили именно этот канал и получателя в режиме превью.

Почему я должен подтверждать действие перед созданием ссылки?

Подтверждение фиксирует точные байты файла, параметры заметки и место назначения. Без него агент, имеющий доступ к инструментам почты или чата, может за один ход зашифровать не тот файл или отправить верную ссылку не тому человеку. Режим «one-shot» пропускает это предварительное окно. Оставляйте его выключенным, особенно если тот же хост может отправлять сообщения или файлы.

Может ли агент видеть расшифруемую URL?

Да, в текущем хосте MCP. secureUrl возвращается в результате работы инструмента, чтобы инструмент доставки мог его отправить. Агент по-прежнему не должен видеть байты файла. Обладание URL может разблокировать заметку — относитесь к этому как к возможности использования токена, а не как к ситуации «модель не может получить доступ к секрету».

Должен ли получатель что-то устанавливать?

Нет. Они просто открывают полную ссылку в обычном браузере. Для просмотра заметки не требуется аккаунт PrivateNote. Им все еще может потребоваться пароль или подтверждение по электронной почте, если вы включили эти ограничения.

Могу ли я прикреплять файлы без входа в систему?

Нет. Прикрепление файлов, просмотр/отзыв, верификация получателя и уведомления об открытии требуют sign_in. Текстовую заметку из contentFilePath можно создать без сессии, в рамках публичных лимитов.

Что если ассистент все равно прочитает файл?

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

Останавливает ли функция «удаление после прочтения» создание скриншотов?

Нет. Как только законный получатель расшифрует заметку, он сможет скопировать, сделать скриншот или повторно загрузить ее. Функция «удаление после прочтения» и срок действия уменьшают количество оставшихся копий в сервисе и истории чата. Они не могут удаленно удалить то, что кто-то уже запечатлел. Для документов доступ к файлам только для просмотра на Business снижает вероятность случайного скачивания, но не является запретом на фотографирование.

Пусть агент отправляет ссылку. Держите файл подальше от модели.

Установите privatenote-mcp, укажите локальные пути и продолжайте использовать электронную почту, Slack, Discord и WhatsApp как конверты, а не как хранилища. Выключайте режим «one-shot», если тот же хост может отправлять сообщения или файлы.

Фото: Léna Le Roy · Unsplash.