Volta Notes

@voltanotes/mcp

Volta Notes 向けの MCP サーバーです。あらゆる AI エージェントから、一度読んだら消える暗号化ノートを作成・読み取りできます。

ノートは AES-256-GCM を使用してエンドツーエンドで暗号化されます。復号キーは URL フラグメント内にのみ存在し、サーバーに送信されることはありません。ノートは Internet Computer に保存され、一度読み取られると完全に破棄されます。

理由

AI エージェントは実行時に API キー、パスワード、認証情報などの機密情報を必要とすることがよくあります。現在、ユーザーはそれらをチャットに貼り付けており、会話履歴に永久に保存されています。

この MCP サーバーを使うと、次のようにできます。

1. ユーザーが voltanotes.com でノートを作成し、ワンタイム URL を送信します
2. エージェントが read_volta_note を呼び出します。シークレットが返され、ノートは完全に破棄されます
3. 機密情報がチャット履歴に表示されることはありません

逆方向の使い方として、エージェントが create_volta_note を使い、自己破壊リンクを介してユーザーに認証情報を送信することもできます。

クイックスタート

Claude Code（CLI とデスクトップアプリ）

ステップ 1 — グローバルにインストールします：

npm install -g @voltanotes/mcp

ステップ 2 — サーバーを登録します：

claude mcp add -s user volta -- node $(npm root -g)/@voltanotes/mcp/dist/index.js

これで完了です。Claude Code を再起動すると、create_volta_note ツールと read_volta_note ツールを使用できるようになります。

設定ファイルを編集せずに claude mcp add を使う理由は？ Claude Code は MCP サーバーを ~/.claude/mcp.json ではなく、独自のレジストリから読み込みます。CLI を使うことで、サーバーが正しく登録されます。-s user フラグを指定すると、すべてのプロジェクトで使用できるようになります。

node が見つからない場合：完全なパスを使用してください。node を which node の出力（例：/usr/local/bin/node）に置き換えます。

Claude Desktop（スタンドアロン）

claude_desktop_config.json に追加します：

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

その他の MCP 対応クライアント

上記の npx 設定は、標準の command／args MCP 形式に対応するすべてのクライアントで動作します。Cursor、Windsurf、Cline、Continue.dev などが含まれます。サーバー設定の追加場所については、お使いのクライアントの MCP ドキュメントを確認してください。

Hermes Agent（Nous Research）

Volta MCP は、MCP 統合を介して Hermes Agent で使用できます。Hermes の設定（~/.hermes/config.yaml）にサーバーを追加します：

mcp:
  servers:
    - name: volta
      command: npx
      args:
        - "-y"
        - "@voltanotes/mcp"

Hermes を再起動すると、エージェントで create_volta_note ツールと read_volta_note ツールを使用できるようになります。

エージェント間での使用例： 自律的に動作する Hermes エージェントは、ログやメモリに認証情報を露出させることなく、ワークフロー間で認証情報を受け渡す必要がよくあります。Volta Notes はこの用途のために設計されています。あるエージェントがノートを作成してワンタイム URL を次のエージェントに渡し、読み取り時にシークレットが破棄されます。会話履歴やツール出力ログに情報が残ることはありません。

設定オプションの詳細は、Hermes MCP のドキュメントを参照してください。

Windows（Claude Code CLI）

$(npm root -g) の構文は PowerShell や CMD では動作しません。代わりに次の方法を使ってください：

claude mcp add -s user volta -- node "%APPDATA%\npm\node_modules\@voltanotes\mcp\dist\index.js"

または、上記の Claude Desktop／npx の方法を使ってください。こちらはクロスプラットフォームで動作します。

ツール

create_volta_note

暗号化ノートを作成し、ワンタイム URL を返します。

パラメーター	型	説明
content	string	暗号化するシークレットの内容（最大 2 KB）

戻り値： voltanotes.com の URL です。受信者が一度開いて内容を読むと、ノートは永久に消去されます。

read_volta_note

Volta ノートを読み取り、完全に破棄します。

パラメーター	型	説明
url	string	# フラグメントを含む Volta の完全な URL

戻り値： 復号されたノートの内容です。ノートはキャニスターから完全に削除されるため、2 回目の読み取りは失敗します。

エージェント用プロンプトスニペット

安全な認証情報の受け渡しを有効にするには、任意のエージェントのシステムプロンプトにこれを追加します。

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 による暗号化は、Canister に送信する前にローカルで行われます
• 暗号化キーは URL フラグメント（#...）にのみ存在します。ブラウザーやサーバーがフラグメントを送信することはありません
• ICP Canister には暗号文のみが保存されます。侵害された場合でも、すべてのデータは読み取れません
• メモは初回の読み取り時に破棄されます。未読のメモは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

トラブルシューティング

サーバーが接続されているか確認する

claude mcp list

volta: ... ✓ Connected と表示されるはずです。表示されない場合は、以下を確認してください。

サーバーが表示されない

1. claude mcp add を使用しましたか？ ~/.claude/mcp.json を手動で編集しても機能しません。Claude Code は独自のレジストリからサーバーを読み込みます。サーバーの登録には必ず claude mcp add を使用してください。

2. node は PATH に含まれていますか？ Claude Code のシェルでは PATH が最小限に設定されています。node が見つからない場合は、フルパスを使用してください。

   claude mcp add -s user volta -- $(which node) $(npm root -g)/@voltanotes/mcp/dist/index.js
   

3. 再起動が必要です。 MCP サーバーの追加や変更後は、Claude Code を完全に再起動してください（終了してから再度開きます）。

サーバーが起動したかどうかを確認するには？

起動に成功すると、サーバーは標準エラー出力に Volta MCP server started を記録します。接続状態を確認するには、claude mcp list を実行してください。

要件

• Node.js 18 以上（組み込みの Web Crypto API を使用）

ライセンス

MIT — Unprompted Labs