aimcp개발자보안

AI에 비밀을 보여주지 않고 전송하게 하세요.

PrivateNote MCP이 모델의 읽기 없이 이메일, Slack, Discord, WhatsApp를 통해 파일을 전달하는 방법

업데이트됨 2026년 9월 11일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.

AI 어시스턴트의 유용함은 계약서, 비밀번호 파일 또는 고객 추출 데이터를 읽을 수 있다는 점에 있지 않습니다. 진정한 유용함은 어시스턴트가 비밀 정보의 복사본이 되지 않으면서도, 해당 페이로드를 수신자가 이미 사용 중인 채널을 통해 적절한 사람에게 전달할 수 있다는 점에 있습니다.

그것은 일상적인 업무입니다. 고객에게 이메일로 PDF을 보내거나, Slack에서 팀원에게 스테이징 비밀번호를 전달하거나, Discord의 모더레이터에게 봇 토큰을 건네거나, WhatsApp 스레드에 일회용 로그인 정보를 올리는 일 말이죠. 사람들은 이미 복사해서 붙여넣는 방식으로 이 일을 하고 있습니다. 에이전트는 그 붙여넣기를 더 빠르게 만들어 주지만, 동시에 유출 규모도 더 키웁니다. 비밀 정보가 이제 모델 컨텍스트, 채팅 기록, 그리고 호스트가 유지하는 모든 로그에 남게 되기 때문입니다.

PrivateNote의 MCP 서버는 정반대의 분리 구조를 위해 구축되었습니다. 에이전트는 조율하고, 로컬 프로세스는 비밀 정보를 처리합니다. 사용자는 정확한 파일과 목적지를 승인합니다. 이메일, Slack, Discord, WhatsApp는 오직 링크만 전달합니다. 모델에는 파일 바이트가 아닌 파일 경로를 전달하도록 지시됩니다. 암호화는 사용자가 확인한 후 사용자의 기기에서 이루어집니다. 결과물로 반환되는 것은 키를 포함한 조각인 URL이며, 이는 웹 앱과 동일한 one-time secret link 모델을 따릅니다. 노트를 생성하는 것이 곧 전송 권한을 의미하지는 않습니다.


업무는 전달하는 것이지, 아는 것이 아닙니다

대부분의 “AI + 비밀 정보” 조언은 여전히 모델이 도움을 주기 위해 반드시 자격 증명을 직접 봐야 한다고 가정합니다. 모델이 파일을 설명하거나, 계약서를 재작성하거나, 키를 디버깅하기를 원한다면 그것이 맞습니다. 하지만 모델이 정보를 전달하기를 원하는 것이라면 그렇지 않습니다.

전달은 물류의 문제입니다. 어떤 파일을, 누구에게, 어떤 채널로 보낼지, 액세스 기간은 얼마로 할지, 첫 열람 후 파기할지 여부 등을 결정하는 것입니다. 이러한 결정 중 어느 것도 평문(plaintext)을 필요로 하지 않습니다. 로컬 경로를 읽고, 암호화하고, 나머지 스택이 볼 수 있는 핸들을 반환할 수 있는 도구가 필요할 뿐입니다.

그것이 바로 privatenote-mcp의 용도입니다. MCP 지침을 준수하는 호스트에게는 다음과 같은 순서로 지시가 내려집니다. 사용자가 로컬 파일을 지정했다면 절대 경로를 전달하되, 파일을 열거나(open), 내용을 출력하거나(cat), 요약하지 마십시오. create_private_note (미리보기)를 호출하고, 사용자의 승인을 기다린 후, confirm_private_note을 호출하십시오. 그 이후에만 다른 도구가 URL를 보낼 수 있으며, 오직 사용자가 승인한 목적지로만 보낼 수 있습니다.

규칙

어시스턴트가 경로만으로 작업을 완료할 수 있다면, 반드시 내용물로 작업을 완료해서는 안 됩니다. 프롬프트에 붙여넣는 것은 비밀 정보가 이미 채팅에 들어간 후의 최후 수단이어야 합니다.

이미 사용 중인 채널들이 왜 잘못된 복사본을 계속 보유하게 되는가

이메일, Slack, Discord, WhatsApp는 대화에는 능숙하지만, 금고로서는 취약합니다. 전송 중 암호화나 종단간 암호화(E2EE)를 하더라도, 검색 가능한 복사본이 기기, 워크스페이스 내보내기, 클라우드 백업 또는 알림 미리보기에 얼마나 오래 남아 있는지는 결정할 수 없습니다. 이는 왜 이메일이 비밀 정보를 보관하기에 최악의 장소인지와 왜 비밀 정보를 채팅에 붙여넣어서는 안 되는지에 대한 이유와 동일한 맥락입니다.

  • 이메일은 수신함, 메일 서버, 법적 보존(legal holds), 그리고 “모든 메일 검색” 기능 모두에 첨부 파일을 저장합니다. 전달(Forwarding)은 나중에 취소할 수 없는 복사본을 기하급수적으로 늘립니다.
  • Slack은 워크스페이스에 의해 인덱싱됩니다. 관리자, 컴플라이언스 내보내기, 채널을 요약하는 AI 기능은 몇 달 후에도 비밀번호를 다시 찾아낼 수 있습니다.
  • Discord은 분주한 서버에서 일시적인 것처럼 보일 수 있지만, 그렇지 않습니다. 핀 고정, 검색, DM 기능은 봇 토큰과 초대 관리자 비밀 정보를 밈(meme) 옆에 그대로 남겨둡니다.
  • WhatsApp은 계약업체나 고객이 실제로 열어보는 유일한 채널인 경우가 많습니다. 또한 가족 공용 편지함과 같아서, 스크린샷이 공유되고, 연결된 컴퓨터가 동기화되며, 백업은 업무가 끝난 후에도 남아 있습니다.

핵심은 이러한 도구들을 버리는 것이 아닙니다. 그 안에 페이로드(payload)를 담는 것을 멈추는 것입니다. 도구들은 여전히 봉투로 남습니다. 노트가 편지입니다. 수신자는 여전히 PrivateNote 계정이 필요하지 않습니다. 이미 보내고 있는 다른 URL을 여는 것과 똑같이 브라우저에서 링크를 열기만 하면 됩니다.


3단계 분리

역할볼 수 있는 것봐서는 안 되는 것
AI 에이전트 (Cursor, Claude, Codex)누구에게, 어떤 경로로, 어떤 채널로, 만료 시간, 열람 후 파기. 사용자가 확인한 후: 복호화 가능한 URL파일 바이트, 비밀번호, 노트 본문. 사용자가 목적지를 승인하기 전까지는 URL을 보내서는 안 됨
PrivateNote MCP (로컬 Node 프로세스)암호화만을 위한 디스크 상의 파일들평문으로 반환하는 것은 없음
Email / Slack / Discord / WhatsAppPrivateNote URL (및 사람이 읽을 수 있는 제목)첨부 파일, 자격 증명, 패스프레이즈

MCP는 사용자를 대신하여 이메일이나 Slack 메시지를 전송하지 않습니다. 노트를 생성하는 것이 전송 권한을 부여하는 것은 아닙니다. 정확한 채널과 수신자가 명시된 미리보기를 승인한 후, 결과에 sendAuthorized: true가 포함될 수 있으며, 이 경우 메일 또는 채팅 도구는 해당 목적지로 URL만 전송할 수 있습니다. 승인된 목적지가 없는 경우 sendAuthorized는 false이며, 에이전트는 다른 도구를 실행하는 대신 붙여넣을 수 있는 URL를 제공해야 합니다.

URL은 bearer capability입니다. 이를 가진 사람은 누구나 노트를 열 수 있습니다. 현재 MCP 호스트는 도구 결과로 secureUrl를 반환하므로, 에이전트가 파일 바이트를 볼 수 없더라도 링크를 확인할 수 있습니다. 이를 로그에 남기거나, 커밋하거나, 관련 없는 도구로 복사하지 마십시오. 비밀 정보처럼 취급하십시오.

반환된 페이로드의 나머지 부분은 작습니다: noteId, expiresAt, burnAfterReading, 그리고 관련이 있는 경우 passwordProtected 및 attachedFileNames. 파일 이름은 메타데이터이며 콘텐츠가 아닙니다. 따라서 파일 이름에 비밀 정보를 넣는 것은 피하십시오.


MCP이 사용자의 기기에서 실제로 수행하는 작업

에이전트가 create_private_note을 호출하면, 모델이 아닌 로컬 Node.js 프로세스가 경로를 정규화하고, 워크스페이스 허용 목록과 대조 확인하며, 파일을 해싱하고, 미리보기를 보여줍니다. 아직 복호화 가능한 URL을 반환하지는 않습니다. 사용자가 승인하면, confirm_private_note가 동일한 파일을 다시 열어 디바이스, inode, 크기 및 SHA-256를 확인하고 해당 바이트를 암호화합니다. 파일이 변경된 경우 확인에 실패하며, 에이전트는 처음부터 다시 시작해야 합니다. AES-256-GCM 암호문은 PrivateNote로 POST됩니다. 복호화 키는 URL 조각(#…)에 배치됩니다. 브라우저는 서버로 조각을 전송하지 않습니다. API은 암호화된 블롭을 저장합니다. 조각이 없으면 해당 블롭은 노이즈에 불과합니다.

호스트가 모델이 생성한 도구 호출 인수에 비밀 정보를 넣을 필요가 없도록 경로 매개변수를 사용하는 것이 좋습니다:

  • contentFilePath — 노트 본문이 되는 UTF-8 파일(비밀번호, 복구 코드, 짧은 지침).
  • filePath / filePaths — 로컬 첨부 파일(PDF, CSV, 이미지). sign_in이 필요합니다. 최대 20개의 파일이 결합될 수 있습니다.
  • passwordFilePath — 로컬 파일의 첫 번째 줄이 공개 패스프레이즈(Argon2id 래핑)가 됩니다. 해당 패스프레이즈는 링크와 같은 메시지에 절대 포함하지 말고 별도의 채널(out of band)로 보내십시오.
  • 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은 사용자의 미리보기를 건너뜁니다. 에이전트는 이를 도구 인자(tool argument)로 켤 수 없으며, 나중에 환경 설정을 변경하더라도 MCP 서버를 재시작하기 전까지는 효과가 없습니다. 이 기능은 꺼두십시오. 동일한 호스트가 이메일, Slack, Discord 또는 파일을 보낼 수 있는 상태에서 이 기능을 켜면, 모델이 복호화 가능한 링크를 생성하고 잘못된 파일이나 잘못된 수신자에게 보내는 것까지 포함하여 단 한 단계 만에 처리할 수 있게 됩니다. 경로 허용 목록(allowlisting)은 여전히 적용되지만, 이것이 사용자의 승인을 대신할 수는 없습니다.

한 번만 연결하십시오

Node.js 18+ 가 필요합니다. 저장 후, 현재 도구 스키마와 지침을 로드할 수 있도록 MCP 클라이언트를 재시작하십시오. 전체 설치 노트는 MCP integration page에서 확인할 수 있습니다.

~/.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 전용 노트는 Using PrivateNote with OpenAI Codex에 있습니다.

Self-hosted: 암호문이 인프라를 절대 벗어나지 않도록 MCP env 블록에 PRIVATENOTE_API_BASE_URL 및 PRIVATENOTE_WEB_ORIGIN을 설정하십시오. 선택적으로 PRIVATENOTE_MCP_ALLOWED_ROOTS를 설정할 수 있습니다. 전송 도구가 없는 엄격하게 제한된 자동화 호스트를 사용하는 경우가 아니라면 PRIVATENOTE_MCP_ALLOW_ONE_SHOT를 추가하지 마십시오.


일상적 사용: email

이메일은 여전히 기업들이 계약서, NDA, 은행 정보가 포함된 인보이스, 고객 데이터 내보내기 파일을 보내는 방식입니다. 실패 사례는 파일을 첨부하는 것입니다. 그러면 수신자 측, BCC 기록, e-discovery를 포함하여 메일함에 복호화 가능한 사본이 수년간 남게 됩니다.

MCP 패턴: 에이전트는 이미 Alice의 주소와 두 개의 로컬 PDF를 알고 있습니다. 에이전트는 해당 PDF를 열어서는 안 됩니다. 필요한 경우 로그인하고, 미리보기 이름이 Alice로 표시되도록 filePaths, sendChannel, sendRecipient와 함께 create_private_note을 호출한 뒤, 사용자의 승인을 기다렸다가 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를 호출한 다음, filePaths, passwordFilePath, sendChannel: "email", sendRecipient와 함께 create_private_note을 호출합니다. 사용자가 미리보기를 승인하면 confirm_private_note이 수행됩니다.
  • 이메일 제목은 “contract pack”이라고 할 수 있지만, PDF의 조항을 인용해서는 안 됩니다.
  • 패스프레이즈는 두 번째 메시지, 전화, 또는 비밀번호 관리자 공유를 통해 전달하십시오. 링크와 같은 메일에 절대 포함하지 마십시오. how to share a password securely를 참조하십시오.
  • 유료 플랜의 지정된 수신자 대상: requireRecipientVerification: true 및 recipientEmail: "alice@example.com".

이는 sending sensitive documents securely와 동일한 전달 모델이지만, 어시스턴트가 해당 팩의 읽기 권한을 갖지 않고도 실행할 수 있도록 허용된다는 점이 다릅니다.


일상적 사용: Slack

Slack은 온콜(on-call)이 발생하는 곳입니다. 스테이징 데이터베이스 비밀번호, 배포 토큰, “재무팀에서 온 CSV” 등이 모두 이미 모여 있는 스레드에 무심코 던져집니다. 그러면 워크스페이스 검색 기능으로 인해 해당 데이터가 영구적인 내부 비밀 위키가 되어 버립니다.

경로 기반(path-based) 핸드오프와 짧은 유효 기간을 요청하십시오. 팀원이 온라인 상태라면 15분이면 충분합니다. 나중에 검색에 걸렸을 때 활성 자격 증명이 아닌 죽은 링크가 되도록 읽은 후 바로 파기하십시오. URL를 비밀 정보처럼 취급하십시오. 공개 채널에 게시하지 말고 DM이나 전용 비공개 채널을 사용하십시오.

사용자가 말하는 내용
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 도구로 연결되어 있다면, 에이전트는 sendAuthorized이 true가 된 후 승인된 목적지에 secureUrl만 게시할 수 있습니다. 그렇지 않으면 붙여넣을 수 있도록 URL를 제공합니다.
  • Mark가 파일을 연 후, 만약 그것이 공유된 스테이징 비밀번호였다면 비밀번호를 교체하십시오. 노트는 남겨진 사본을 줄여준 것이지, 공유 자격 증명을 고유하게 만든 것이 아닙니다.

일상적 사용: Discord

Discord은 많은 제품 커뮤니티와 게임 관련 팀의 기본 운영 채널입니다. 봇 토큰, Cloudflare 키, “신고된 사용자 스프레드시트 여기 있습니다”와 같은 내용이 모더레이터 DM에 붙여넣어지는데, 이는 Discord가 모더레이터들이 있는 곳이기 때문입니다.

Discord 메시지는 여전히 저장된 메시지입니다. 적절한 역할을 가진 서버 멤버, 기기 백업, 그리고 Discord 자체 검색 기능을 통해 메시지가 유지될 수 있습니다. MCP 패턴은 Slack과 동일합니다. 파일을 로컬에서 암호화하거나 토큰을 암호화하고, DM에 링크를 넣고, 짧은 만료 시간을 설정하십시오. 만약 토큰이 이미 동일한 서버의 앞부분에 붙여넣어졌다면 교체하십시오. 유출된 비밀 정보를 암호화한다고 해서 유출되지 않은 상태가 되는 것은 아닙니다.

사용자가 말하는 내용
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을 보낼 수 있습니다.
  • 모더레이터 채널에 붙여넣는 것보다 사용자 DM을 선호하십시오. “비공개 채널”도 결국 기록(transcript)으로 남습니다.
  • 내보내기에 개인 정보가 포함되어 있다면, 패스프레이즈 파일을 추가하고 팀장에게 음성 통화로 패스프레이즈를 알려주십시오.

일상적 사용: WhatsApp

WhatsApp는 상대방이 Slack에 참여하지 않거나 월요일까지 이메일을 확인하지 않을 때 사용하는 채널입니다. 계약업체, 패밀리 오피스 어시스턴트, 전화 중인 클라이언트 등이 대상입니다. 종단간 암호화(End-to-end encryption)는 실제 작동하며, 지속성 또한 실제입니다. 채팅은 기록으로 남으며, 종종 여러 기기에 존재하고 백업되기도 합니다.

상대방이 PrivateNote를 설치할 필요는 없습니다. 상대방은 링크를 클릭하기만 하면 됩니다. 어시스턴트의 역할은 이미 보유하고 있는 로컬 파일(예: PDF 송장, Wi-Fi 비밀번호, 일회용 포털 코드)을 Cursor나 Claude 스레드에 먼저 읽어 들이지 않고 해당 링크를 준비하는 것입니다. confirm_private_note가 URL를 생성하기 전에 사용자는 여전히 미리보기(정확한 파일 및 WhatsApp 목적지)를 승인해야 합니다.

사용자가 말하는 내용
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 랜딩 페이지이며, 복호화된 파일이 아닙니다. 그럼에도 불구하고, 암호(passphrase)를 동일한 채팅에 넣지 마십시오. 번호가 틀릴 가능성이 있다면, 노트를 생성하고 링크를 보낸 뒤, 상대방이 열지 않았다면 취소하십시오. 초록색 말풍선 대신 브랜드화된 공개 페이지가 필요한 변호사 및 기타 전문 발신자는 변호사를 위한 안전한 클라이언트 전달을 읽어보시기 바랍니다.


페이로드가 파일인 경우 로그인

웹사이트와 동일한 공개 속도 제한(rate limits)이 적용되는 contentFilePath의 텍스트 전용 노트는 계정 없이 생성할 수 있습니다. 파일 첨부는 다릅니다. MCP은 먼저 sign_in를 호출해야 합니다. 그러면 브라우저에 승인 페이지가 열립니다(권한은 이미 URL에 포함되어 있어 입력할 코드가 없습니다). 'Approve'를 클릭하면 에이전트가 pollDeviceCode와 함께 sign_in를 다시 호출합니다. 세션은 ~/.config/privatenote/mcp-session.json에 저장되고 Authorization: Bearer로 전송됩니다. 이는 웹사이트 쿠키 세션을 대체하지 않습니다.

  • 에이전트가 sign_in() 실행 — 브라우저 열림
  • PrivateNote 페이지에서 Approve 클릭
  • 에이전트가 pollDeviceCode로 폴링 후, whoami() 호출
  • 에이전트가 파일 경로로 create_private_note 호출 (미리보기 — 아직 URL 아님)
  • 사용자가 정확한 파일, 만료 시간 및 목적지 승인
  • 에이전트가 confirm_private_note를 호출한 후, 사용자(또는 다른 도구)가 인간 채널로 secureUrl만 전송

whoami에 로그인된 계정이 표시됩니다. sign_out은 플러그인 세션 파일을 삭제합니다. 해당 파일을 이 기기의 자격 증명(credential)처럼 취급하십시오.

Cursor, Claude Desktop 또는 Codex에 privatenote-mcp를 설치하십시오. 에이전트는 워크플로우를 유지하고, 로컬 프로세스는 비밀을 유지합니다.

MCP 설정 가이드 열기

링크 전송 후

훌륭한 핸드오프는 메시지가 Slack를 떠날 때 끝나는 것이 아닙니다. 유료 로그인 세션은 전달을 콘텐츠가 아닌 이벤트(생성됨, 열림, 만료됨, 취소됨)로 취급할 수 있습니다. list_sent_notes은 ID, 상태 및 openedAt를 반환하며, 평문(plaintext)은 절대 반환하지 않습니다. revoke_sent_note은 열지 않은 노트를 무효화합니다. notifyOnOpen는 노트가 처음 열릴 때 사용자의 PrivateNote 계정으로 이메일을 보냅니다. 에이전트는 list_sent_notes를 폴링하여 열람 여부를 확인합니다. 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의 잠금 해제 게이트이지, 메시지 전송을 대신하는 것이 아닙니다. 열람 알림을 받으려면 계정에 인증된 발신자 이메일이 있어야 합니다. 상태 전용 영수증에 대한 설명은 비밀 링크가 언제 열렸는지 확인하는 방법을 참조하십시오. 광범위한 도구 액세스 권한을 가진 에이전트도 직원과 같은 AI 에이전트 보안에 명시된 권한 모델이 필요합니다.


정직한 개인정보 보호 주의사항

“AI는 파일 바이트를 절대 보지 못한다”라는 강력한 주장은, 호스트가 경로 우선(path-first) 지침을 준수하고 사용자가 프롬프트에 페이로드를 붙여넣지 않았을 때 성립합니다. 이것이 확인(confirm) 후 에이전트가 secureUrl를 볼 수 없다는 것을 의미하지는 않습니다. 일반적인 MCP 도구 호출은 여전히 호스트에 인자(arguments)를 노출할 수 있습니다. 이것이 도구들이 경로를 선호하는 이유입니다. 인자는 비밀번호가 아니라 /Users/you/secrets/db-password.txt입니다.

create a PrivateNote for sk_live_abc123를 입력하면, MCP이 실행되기 전에 클라우드 모델 제공업체가 해당 문자열을 처리할 수 있습니다. PrivateNote는 여전히 암호문만 저장하고, Slack은 여전히 링크만 받게 됩니다. 즉, 다운스트림(downstream) 유출은 개선했지만, 모델로부터 비밀을 격리한 것은 아닙니다. 최대의 개인정보 보호를 위해 비밀은 파일에 보관하고(또는 에이전트 없이 편집기가 암호화할 수 있도록 VS Code / Cursor 확장 기능을 사용), 어시스턴트에게는 경로만 알려주십시오.

  • 모델에게 “PDF를 먼저 확인해줘” 또는 요약해달라고 요청하지 마십시오. 이는 다른 도구를 통한 읽기를 강제합니다.
  • URL를 Slack/WhatsApp/이메일과 동일한 곳에 넣지 마십시오.
  • secureUrl를 비밀로 취급하십시오. 에이전트는 도구 결과에서 이를 볼 수 있습니다. 이를 커밋하거나, 로그에 남기거나, 공개된 Discord 채널에 붙여넣지 마십시오.
  • privatenote-mcp을 업그레이드한 후에는 지침과 스키마가 최신 상태로 유지되도록 MCP 클라이언트를 다시 로드하십시오. one-shot 모드는 꺼두십시오.

자주 묻는 질문

PrivateNote MCP이 Slack, Discord, WhatsApp 또는 이메일을 직접 전송합니까?

아니요. 로컬에서 암호화한 후 URL와 메타데이터를 반환합니다. 전달에는 사용자가 이미 사용 중인 방식 — 다른 MCP 서버(Gmail, Slack, …) 또는 사용자가 직접 링크를 붙여넣는 방식 — 이 사용됩니다. 노트를 생성하는 것이 전송 권한을 의미하지는 않습니다. sendAuthorized는 사용자가 미리보기에서 정확한 채널과 수신자를 승인한 경우에만 true가 됩니다.

링크가 생성되기 전에 왜 확인 과정을 거쳐야 하나요?

확인을 통해 정확한 파일 바이트, 노트 옵션 및 목적지가 결합됩니다. 확인 절차가 없다면, 메일이나 채팅 도구를 함께 사용하는 에이전트가 한 번의 턴 내에서 잘못된 파일을 암호화하거나 올바른 링크를 잘못된 사람에게 보낼 수 있습니다. one-shot 모드는 이 미리보기를 건너뜁니다. 동일한 호스트가 메시지나 파일을 보낼 수 있는 경우, 이 모드를 꺼두십시오.

에이전트가 복호화 가능한 URL를 볼 수 있습니까?

네, 현재 MCP 호스트에서는 볼 수 있습니다. 전달 도구가 보낼 수 있도록 secureUrl이 도구 결과로 반환됩니다. 하지만 에이전트는 여전히 파일 바이트를 보아서는 안 됩니다. URL을 소유하면 노트를 열 수 있으므로, 이를 '모델이 비밀에 접근할 수 없다'는 의미가 아닌 '소지자 권한(bearer capability)'으로 취급하십시오.

수신자가 무언가를 설치해야 합니까?

아니요. 일반 브라우저에서 전체 링크를 열기만 하면 됩니다. 노트를 확인하기 위해 PrivateNote 계정이 필요하지는 않습니다. 다만 사용자가 해당 관문을 활성화했다면 암호나 이메일 인증이 필요할 수 있습니다.

로그인 없이 파일을 첨부할 수 있습니까?

아니요. 파일 첨부, 목록/취소, 수신자 확인 및 열기 알림에는 sign_in가 필요합니다. contentFilePath를 통한 텍스트 전용 노트는 세션 없이도 공개 제한 범위 내에서 생성할 수 있습니다.

어시스턴트가 어쨌든 파일을 읽는다면 어떻게 되나요?

그렇다면 해당 턴의 개인정보 보호 경계는 이미 깨진 것입니다. MCP 지침은 호스트에게 그렇게 하지 말라고 명시합니다. 클라이언트가 이를 무시한다면 에디터 확장 프로그램이나 웹 앱을 계속 사용하고, 에이전트가 해당 파일을 가리키지 않도록 하십시오. 확장 프로그램이 생성한 URL은 여전히 보낼 수 있습니다.

읽은 후 삭제(burn-after-read) 기능이 스크린샷을 막을 수 있나요?

아니요. 정당한 수신자가 노트를 복호화하면 복사, 스크린샷 또는 재업로드가 가능합니다. 읽은 후 삭제 및 만료 기능은 서비스와 채팅 기록에 남는 잔여 사본을 줄여줍니다. 이미 누군가 캡처한 것을 원격으로 삭제할 수는 없습니다. 문서의 경우, Business의 보기 전용 파일 액세스를 통해 무분별한 다운로드를 줄일 수 있지만, 사진 촬영 자체를 금지하는 것은 아닙니다.

에이전트가 링크를 보내게 하십시오. 파일은 모델에게 노출하지 마십시오.

privatenote-mcp를 설치하고 로컬 경로를 지정하십시오. 그리고 이메일, Slack, Discord, WhatsApp를 금고가 아닌 봉투로 계속 사용하십시오. 동일한 호스트가 메시지나 파일을 보낼 수 있다면 one-shot 모드를 꺼두십시오.

사진: Léna Le Roy · Unsplash.