OpenAI Codex에서 PrivateNote 사용하기
명령어 하나로 모든 Codex 세션에 PrivateNote MCP을 연결합니다. 설정 단계, 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는 AI 코딩 에이전트입니다. 버그 수정, 기능 추가, 테스트 작성 등 원하는 내용을 설명하면 샌드박스 환경에서 자율적으로 수행합니다.
하지만 에이전트에는 비밀 정보가 필요합니다. SSH를 통해 레포지토리를 클론하거나, 프라이빗 패키지 레지스트리에서 풀(pull)을 받고, 스테이징 데이터베이스에 연결하거나, 내부 API를 호출해야 합니다. 즉, 에이전트에 자격 증명을 전달해야 한다는 의미입니다.
에이전트 프롬프트에 API 키를 붙여넣는 것은 Slack에 붙여넣는 것과 근본적으로 다르지 않습니다. 해당 정보는 컨텍스트 히스토리, 로그, 또는 세션 간에 유지되는 메모리에 남을 수 있습니다. PrivateNote는 더 깔끔한 방법을 제공합니다. 에이전트가 확인하기 전에 비밀 정보를 암호화하고, 한 번 읽으면 자동으로 파기되는 링크를 공유하여 아무것도 남기지 마세요.
두 서비스를 연결하는 방법은 다음과 같습니다.
MCP이란 무엇인가요?
MCP (Model Context Protocol)는 AI 애플리케이션이 표준화된 서버를 통해 도구, 데이터 소스 및 서비스에 연결할 수 있도록 하는 개방형 프로토콜입니다. Claude Desktop, Cursor, Codex, Windsurf 또는 기타 어시스턴트와 같은 모든 MCP 호환 클라이언트는 MCP 서버가 제공하는 도구를 호출할 수 있습니다.
PrivateNote MCP 서버는 create_private_note라는 단일 도구를 제공합니다. AI가 이를 호출하면 로컬 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의 경우, 사용 중인 OS의 설정 파일을 여세요:
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 블록을 사용합니다
이제 AI 어시스턴트에게 요청할 수 있는 것들
MCP 서버가 연결되면, 다음과 같이 일상적인 언어로 요청할 수 있습니다:
# Example response from the assistant:
PrivateNote created:
https://privatenote.ai/note/xK9m2p...#A3f7...
Expires in 24 hours · Burns after reading- "다음 내용이 담긴 PrivateNote를 생성해줘: 임시 비밀번호는 X입니다. 24시간 후에 만료되도록 설정해줘."
- "이 데이터베이스 비밀번호를 계약업체용 self-destructing 링크로 감싸줘"
- "SSH 키를 안전하게 전송해줘 — 15분 만료, 읽은 후 즉시 삭제"
- "스테이징 자격 증명을 위한 PrivateNote를 생성하고 링크를 알려줘"
도구의 실제 작동 방식
AI가 create_private_note를 호출하면, MCP 서버가 사용자의 기기에서 로컬 Node.js 프로세스를 실행합니다. 암호화는 데이터가 네트워크에 닿기 전, 해당 로컬 환경에서 이루어집니다.
서버는 무작위 256비트 AES 키를 생성하고, AES-256-GCM으로 콘텐츠를 암호화한 뒤, 암호문(ciphertext)만을 privatenote.ai에 POST 방식으로 전송합니다. 키는 요청에 포함되지 않습니다.
복호화 키는 URL 프래그먼트, 즉 브라우저가 서버로 절대 전송하지 않는 #this-part에만 존재합니다. 결과물로 반환되는 것은 링크입니다. 링크를 여는 사람은 자신의 브라우저에서 이를 복호화합니다. 노트는 확인 직후 즉시 삭제됩니다.
privatenote.ai는 암호화된 블롭(blob)을 저장합니다. 프래그먼트가 없다면 해당 블롭들은 아무런 의미가 없습니다.
일반적인 도구 옵션
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 프롬프트에 비밀 정보를 입력하면 MCP 도구가 실행되기 전에 Codex가 이를 읽습니다. OpenAI의 서버가 해당 메시지를 처리하게 됩니다.
따라서 "sk_live_abc123용 PrivateNote를 생성해줘"라는 요청은 sk_live_abc123 값이 클라우드 환경에 잠시 나타났음을 의미합니다. PrivateNote 단계는 해당 정보가 Slack, 이메일 또는 채팅 기록에 남지 않도록 보장하지만, AI가 이를 아예 보지 못하는 것과는 다릅니다.
이 간극을 메우는 두 가지 방법:
- Codex IDE를 사용할 때는 VS Code 확장을 사용하세요 — 에디터에서 비밀 정보를 선택한 후, 마우스 오른쪽 버튼 클릭 → Share as PrivateNote를 선택합니다. 비밀 정보는 에디터에서 암호화된 링크로 직접 전송되며, Codex는 전혀 관여하지 않습니다.
- 에이전트 세션에는 로컬 모델을 사용하세요. 데이터가 암호화되기 전까지는 아무것도 기기를 벗어나지 않습니다.
Codex IDE에서 VS Code 확장 사용하기
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"]셀프 호스팅 인스턴스 지정하기
팀에서 프라이빗 PrivateNote 서버를 운영하는 경우, MCP 설정의 환경 변수를 통해 기본 URL를 설정하세요:
[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 설정을 검증하세요 — 마지막에 붙은 쉼표(trailing comma)가 가장 흔한 구문 오류입니다.
- 클라이언트의 MCP 또는 확장 로그에서 시작 오류를 확인하세요.
- 기기가 privatenote.ai(또는 셀프 호스팅 호스트)에 네트워크로 접속 가능한지 확인하세요.
기억해야 할 몇 가지 사항
URL이 곧 비밀 정보입니다. 링크의 프래그먼트에는 복호화 키가 포함되어 있습니다. 자격 증명 자체와 동일한 주의를 기울여 다루세요 — 커밋하지 말고, 로그에 남기지 말고, 공개 채널에 게시하지 마세요.
Burn-after-reading(읽은 후 파기)은 말 그대로입니다. 링크가 한 번 열리면 사라집니다. 귀하도 수신자도 다시 열 수 없습니다.
공유 후에는 교체(Rotate)하세요. AI 프롬프트에 자격 증명이 아주 잠시라도 나타났다면, 노출된 것으로 간주하고 취급하세요. 현재 값을 PrivateNote를 통해 공유한 다음, 새 값으로 교체하세요.
PrivateNote은 전달을 위한 것이지 저장을 위한 것이 아닙니다. 비밀 정보를 며칠 이상 유지해야 한다면 적절한 Secrets Manager를 사용하세요. PrivateNote은 안전한 전달 단계이지 금고가 아닙니다.
만료 시간을 짧게 설정하세요. 일회성 비밀 정보의 경우 15m 또는 1h면 거의 항상 충분합니다. 수신자에게 적합한 가장 짧은 만료 시간을 기본값으로 사용하세요.
AI 어시스턴트를 PrivateNote에 연결하세요
한 번의 명령 또는 하나의 JSON 블록으로 MCP 서버를 등록합니다. 그 이후의 모든 세션에는 보안 비밀 공유 도구가 내장됩니다.
PrivateNote 시도하기 →