開発者mcp統合セキュリティ

OpenAI Codex で PrivateNote を使用する

更新済み 2026年5月21日5分で読めますPrivateNote.ai

コマンド一つで、すべての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経由でのリポジトリのクローン、プライベートパッケージレジストリからのプル、ステージングデータベースへの接続、内部APIの呼び出しなどを行うには、認証情報を渡す必要があります。

API キーをエージェントのプロンプトに貼り付けることは、Slack に貼り付けることと根本的には変わりません。コンテキスト履歴やログ、あるいはセッション間で保持されるメモリに残る可能性があります。PrivateNote はよりクリーンな方法を提供します。エージェントがシークレットに触れる前に暗号化し、一度読み取ると自己消滅するリンクを共有することで、何も痕跡を残しません。

これら2つを連携させる方法は以下の通りです。

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を再起動してください:

claude_desktop_config.json
{
  "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
  • 「『一時パスワードはXです。24 時間後に期限切れにしてください』という内容の PrivateNote を作成して」
  • 「このデータベースのパスワードを、業者向けの自己破壊型リンクにまとめて」
  • 「SSHキーを安全に送信して。15 分で期限切れ、閲覧後は即削除」
  • 「ステージング環境の認証情報用に PrivateNote を生成して、リンクを教えて」

ツールの実際の動作

AIが create_private_note を呼び出すと、MCP サーバーはマシン上でローカルの Node.js プロセスを実行します。暗号化は、データがネットワークに触れる前の、そのローカル環境で行われます。

サーバーはランダムな 256 ビットの AES キーを生成し、AES-256-GCM でコンテンツを暗号化します。そして、暗号文のみを 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がその情報を全く見ていないということとは異なります。

そのギャップを埋める2つの方法:

  • 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` に書き込みます。必要に応じて、そのファイルを直接編集することも可能です:

~/.codex/config.toml
[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]

セルフホストのインスタンスを指定する

チームでプライベートな PrivateNote サーバーを運用している場合は、MCP 設定内の環境変数を通じてベース URL を設定してください:

~/.codex/config.toml
[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 設定を検証してください。末尾のカンマは最も一般的な構文エラーです。
  • 起動エラーがないか、クライアントの MCP または拡張機能のログを確認してください。
  • マシンが privatenote.ai(またはセルフホストのホスト)にネットワークアクセスできることを確認してください。

覚えておくべきこと

URL がシークレットそのものです。リンクのフラグメント部分に復号キーが含まれています。認証情報自体と同様に慎重に取り扱ってください。コミットしたり、ログに記録したり、公開チャンネルに投稿したりしないでください。

「Burn-after-reading(閲覧後の即時消去)」とは、まさにその通りです。一度リンクが開かれると、消去されます。送信者も受信者も、再度開くことはできません。

共有後はローテーションしてください。AIのプロンプトに認証情報が表示された場合(たとえ一瞬であっても)、閲覧された可能性があるものとして扱ってください。現在の値を PrivateNote で共有した後、新しい値にローテーションしてください。

PrivateNote は受け渡し用であり、保存用ではありません。シークレットを数日間以上アクセス可能な状態にしておく必要がある場合は、適切なシークレットマネージャーを使用してください。PrivateNote は安全な受け渡しステップであり、保管庫(Vault)ではありません。

有効期限は短く設定してください。一度限りのシークレットの場合、15m または 1h でほぼ十分です。受信者が利用できる範囲内で、最も短い期間をデフォルトとして使用してください。

AIアシスタントを PrivateNote に接続する

1つのコマンドまたは1つの JSON ブロックで MCP サーバーが登録されます。それ以降のすべてのセッションには、安全なシークレット共有ツールが組み込まれています。

PrivateNote を試す →
写真: Léna Le Roy · Unsplash.