@voltanotes/mcp

Volta Notes를 위한 MCP 서버 — 모든 AI 에이전트에서 읽은 후 삭제되는(burn-after-read) 암호화된 노트를 생성하고 읽을 수 있습니다.

노트는 AES-256-GCM을 사용하여 **종단간 암호화(E2E)**됩니다. 복호화 키는 URL 프래그먼트에만 존재하며, 서버로 전송되지 않습니다. 노트는 Internet Computer에 저장되며 한 번 읽으면 영구적으로 파괴됩니다.

목적

AI 에이전트는 런타임에 API 키, 비밀번호, 자격 증명과 같은 민감한 정보를 정기적으로 필요로 합니다. 현재 사용자는 이를 채팅창에 붙여넣고 있으며, 이는 대화 기록에 영구적으로 저장됩니다.

이 MCP 서버를 사용하면 다음과 같은 패턴이 가능합니다:

사용자가 voltanotes.com에서 노트를 생성하고 일회용 URL을 전송합니다.
에이전트가 read_volta_note를 호출하면 비밀 정보가 반환되고 노트는 영구적으로 파괴됩니다.
채팅 기록에는 민감한 정보가 전혀 남지 않습니다.

또는 반대로, 에이전트가 create_volta_note를 사용하여 자동 파괴 링크를 통해 사용자에게 자격 증명을 보낼 수도 있습니다.

빠른 시작

Claude Desktop

claude_desktop_config.json에 다음을 추가하세요:

{
  "mcpServers": {
    "volta": {
      "command": "npx",
      "args": ["-y", "@voltanotes/mcp"]
    }
  }
}

Claude Code

claude mcp add volta -- npx -y @voltanotes/mcp

도구

`create_volta_note`

암호화된 노트를 생성하고 일회용 URL을 반환합니다.

매개변수	타입	설명
`content`	string	암호화할 비밀 내용 (최대 2 KB)

반환값: voltanotes.com URL. 수신자가 한 번 열어서 내용을 읽으면 영원히 사라집니다.

`read_volta_note`

Volta 노트를 읽고 영구적으로 파괴합니다.

매개변수	타입	설명
`url`	string	`#` 프래그먼트를 포함한 전체 Volta URL

반환값: 복호화된 노트 내용. 노트는 캐니스터에서 영구적으로 삭제되므로 두 번째 읽기는 실패합니다.

에이전트 프롬프트 스니펫

안전한 자격 증명 전달을 활성화하려면 에이전트의 시스템 프롬프트에 다음을 추가하세요:

When you need a secret from the user (API key, password, credentials):
1. Ask them to go to voltanotes.com and paste the secret into the note field
2. They'll get a one-time URL — ask them to send it to you
3. Use the read_volta_note tool with that URL to retrieve the secret
The secret is permanently destroyed after you read it — it never appears in chat history.

보안 모델

AES-256-GCM 암호화는 캐니스터로 전송되기 전에 로컬에서 수행됩니다.
암호화 키는 URL 프래그먼트(#...)에만 존재하며, 브라우저와 서버는 프래그먼트를 전송하지 않습니다.
ICP 캐니스터는 암호문만 저장하므로, 침해되더라도 모든 데이터는 읽을 수 없습니다.
노트는 첫 번째 읽기 시 파괴됩니다. 읽지 않은 노트는 7일 후에 만료됩니다.
계정, 로그인, 추적이 없습니다.

작동 원리

Agent calls create_volta_note("secret-api-key-123")
  → Local: generate AES-256 key + encrypt
  → ICP canister: store ciphertext → returns noteId
  → Return URL: voltanotes.com/r/{noteId}#{key}

User opens URL → read gate → clicks "Read note"
  → Browser: fetch ciphertext from canister (canister deletes it)
  → Browser: decrypt using key from # fragment
  → Display plaintext — note is gone forever

요구 사항

Node.js 18+ (내장 Web Crypto API 사용)

라이선스

MIT — Unprompted Labs

volta-mcp-server