MCPのシークレット管理:mcp.jsonにAPIキーを直書きしない設定を7クライアント別に解説【MCP Security 2026】
MCPのシークレット管理を解説。2026-07-28仕様とOWASP MCP01の要件、GitGuardianが見つけたMCP設定の漏えい24,008件、漏れる7つの場所、Claude Code・VS Code・Cursor・Codex・Gemini CLIなどの参照記法、引数と環境変数の見え方の検証と設定スキャナーまで。
最終更新:2026年11月6日 / 対象:MCP仕様 2026-07-28 と公式の Local Server Security ガイド、Claude Code、Claude Desktop拡張(MCPBマニフェスト 0.3)、VS Code と Copilot のポータブル形式
.mcp.json、Cursor、OpenAI Codex、Gemini CLI。各クライアントの記法は2026年11月6日に公式ドキュメントで確認しました。
結論(30秒で読める要約)
MCPのシークレット管理とは、MCPサーバーが必要とする認証情報(APIキー、DBの接続文字列、OAuthのクライアントシークレット、Bearerトークンなど)を、設定ファイル・コマンド引数・ログ・モデルのコンテキストに平文で残さずに、実行時だけサーバーへ渡すための設計です。MCP Securityの中でも効果がすぐ出る対策です。いちばん多い漏えいは攻撃ではなく、mcp.json へのAPIキーの直書きだからです。
- 規模は小さくありません。GitGuardianの「State of Secrets Sprawl 2026」によると、公開GitHub上のMCP設定ファイルから24,008件のシークレットが見つかり、そのうち2,117件は有効なままでした(3章)。
- 公式のガイドもはっきりしています。MCPプロジェクトの Local Server Security ガイドは「長期間有効なシークレットを平文の設定に置かない」「シークレットはグローバルではなくサーバーごとに渡す」と書いています(2章)。
- 主要なクライアントはどれも、値そのものではなく参照を書けます。ただし記法がばらばらです。Claude Codeは
${VAR}、VS Codeは${env:NAME}か${input:id}、Cursorは${env:NAME}、Codexはbearer_token_env_var、Gemini CLIは$VAR、Claude Desktop拡張はsensitive: trueです(5章)。 - シークレットを
argsに入れてはいけません。検証では、--api-keyで渡したキーは権限のない別ユーザーからpsで見えましたが、環境変数で渡したキーは見えませんでした(6章)。 - シェルで
exportした変数は、すべてのMCPサーバーに渡ります。子プロセスは親シェルのGITHUB_TOKENをそのまま受け継ぎ、環境を明示的に指定したときだけ受け継ぎませんでした(6章)。 - リモートMCPサーバーなら、クライアントが上流のシークレットを持たない構成がいちばん安全です。上流の認証情報はサーバー側に置き、クライアントにはスコープを絞った失効可能なMCPキーだけを渡します(8章)。
目次
- MCPのシークレット管理とは
- MCP仕様とOWASPはシークレットについて何と言っているか
- 問題の規模:公開されたMCP設定ファイルのシークレット
- MCPのシークレットが漏れる7つの場所
- 7つのMCPクライアントのシークレット参照記法を比較
- 検証:引数・環境変数・継承された環境変数は誰から見えるか
- 検証:MCP設定ファイルの直書きシークレットをスキャンする
- リモートMCPサーバー:上流のシークレットをサーバー側へ移す
- MCPシークレット管理チェックリスト(14項目)
- よくあるハマりどころ(症状→原因→対処)
- NodeFlareならこう解決できる
- よくある質問
1. MCPのシークレット管理とは
MCPのシークレット管理とは、MCPクライアントとMCPサーバーが使う認証情報を、ほかの人・ほかのプロセス・モデルが読める場所に平文で書かずに、保管・受け渡し・権限の絞り込み・ローテーションを行うことです。
扱うシークレットは2種類あり、管理のしかたが違います。
| シークレット | 例 | 持つべき場所 |
|---|---|---|
| 上流の認証情報 | GITHUB_PERSONAL_ACCESS_TOKEN、PostgreSQLの接続文字列、Brave SearchのAPIキー |
MCPサーバー(実行時に注入) |
| MCPへのアクセス用認証情報 | リモートMCPサーバー用のAPIキーやOAuthアクセストークン | MCPクライアント(できればOSのキーチェーンかクライアントの秘密情報ストア) |
この記事では、シークレットを「どこに置き、どう渡すか」を扱います。MCPのアクセスキーそのものの発行・ローテーション・失効は、MCP APIキー管理の実践ガイドにまとめています。
2. MCP仕様とOWASPはシークレットについて何と言っているか
MCP仕様はトークンの扱いにいくつか必須のルールを定めており、公式の Local Server Security ガイドは設定ファイルについて具体的な助言をしています。一次情報を表にまとめます。
| 出典 | 内容 | レベル |
|---|---|---|
| MCP仕様 2026-07-28 Authorization | アクセストークンをURIのクエリ文字列に含めてはならない | MUST NOT |
| MCP仕様 2026-07-28 Authorization のSecurity Considerations | クライアントとサーバーは安全なトークン保存を実装し、OAuth 2.1 Section 7.1 のベストプラクティスに従わなければならない | MUST |
| MCP仕様 2026-07-28 Authorization | stdioの実装はこの認可仕様に従うべきではなく、認証情報は環境から取得する | SHOULD |
| MCP仕様 2026-07-28 Authorization | MCPサーバーは自分宛て以外のトークンを受け取ったり中継したりしてはならない | MUST NOT |
| MCP Local Server Security ガイド | シークレットはサーバーごとに渡す。シェルのプロファイルで export せず、クライアント設定のサーバーごとの環境変数設定を使う |
ガイダンス |
| MCP Local Server Security ガイド | 長期間有効なシークレットを平文の設定に置かない。設定ファイルはディスク上の場所が知られているので、OSのシークレットストアを優先する | ガイダンス |
| OWASP MCP Top 10 MCP01 | 開発者はシークレットを設定ファイル・環境変数・プロンプトテンプレートに埋め込んだり、モデルのコンテキストに残したりしがち | リスク1位 |
| OWASP MCP01 の対策 | 環境変数の注入は実行時だけにし、ビルド時には行わない。ログやテレメトリに書く前にシークレットを伏せる | 対策 |
| OWASP Secrets Management Cheat Sheet | 環境変数はログやシステムダンプに含まれることがある。Dockerの ENV や ARG にシークレットを直書きしてはいけない |
ガイダンス |
まとめると、ルールは1つです。設定ファイルには参照だけを書き、値はシークレットストアに置き、値は実行時にそのサーバーにだけ渡します。
3. 問題の規模:公開されたMCP設定ファイルのシークレット
MCP設定ファイルへのシークレットの直書きは、業界の調査で独立したカテゴリーとして数えられるほど多く見つかっています。GitGuardianの「State of Secrets Sprawl 2026」(2026年3月17日公開)の数字です。
| 調査結果 | 数値 |
|---|---|
| 公開GitHub上のMCP設定ファイルで見つかったユニークなシークレット | 24,008件 |
| そのうち有効なままだったもの | 2,117件(8.8%) |
| MCP設定ファイルで多かった有効なシークレットの種類 | Google APIキー 19.2%、PostgreSQL接続文字列 14%、Firecrawl 11.9%、Perplexity 11.2%、Brave Search 11% |
| 2025年に公開GitHubのコミットへ追加されたハードコードのシークレット | 2,865万件(前年比+34%) |
| 漏えいしたAIサービスのシークレット | 1,275,105件(前年比+81%) |
GitGuardianは、よく読まれているMCPのセットアップ手順の多くが、APIキーを設定ファイル・コマンド引数・接続文字列に直接書くよう勧めていると指摘しています。2026年9月の続報では、認証情報を直書きするとMCP設定ファイルは「平文の認証情報ストアになる」とまで書いています。
原因は単純です。Claude Codeの .mcp.json、VS Codeの .vscode/mcp.json、Cursorの .cursor/mcp.json のようなプロジェクト単位の設定ファイルは、チームで共有する前提で作られているのでコミットされます。そこに貼り付けたキーは、リポジトリにアクセスできる全員に公開されたことになります。
4. MCPのシークレットが漏れる7つの場所
シークレットストアから上流のAPIに届くまでに、シークレットが漏れる場所は7つあります。それぞれに別の対策が必要です。
| # | 漏れる場所 | 漏れ方 | 対策 |
|---|---|---|---|
| 1 | コミットされた設定ファイル | プロジェクトの .mcp.json、mcp.json、config.toml にキーを直書き |
参照記法(5章)と、pre-commitとCIでのシークレットスキャン |
| 2 | コマンド引数 | args に入れた --api-key、接続文字列、トークンがOSのプロセス一覧から見える(CWE-214) |
シークレットは環境変数かファイルだけで渡す |
| 3 | 継承される環境変数 | ~/.zshrc で export した値が、すべてのstdio MCPサーバーを含む子プロセスに渡る |
サーバーごとの env、継承する環境を絞るクライアント |
| 4 | URLのクエリ文字列 | ?api_key=... がプロキシ・CDN・サーバーのアクセスログに残る |
Authorization ヘッダーだけを使う(仕様もクエリ文字列を禁止) |
| 5 | ビルドとイメージ | ARG や ENV の値がコンテナ定義に残る |
実行時に注入する。ビルドで必要ならビルド時のシークレットマウントを使う |
| 6 | ログとエラー | リクエストの丸ごと記録、環境変数を出力するスタックトレース、上流の応答をそのまま返すツールエラー | 引数は値ではなく名前だけ記録し、Authorization と既知のプレフィックスを伏せる |
| 7 | モデルのコンテキスト | ツールが設定ファイルや .env、キーを含むエラーを返し、モデルがそれを繰り返したり別のツールに送ったりする |
ツールの結果にシークレットを含めない。ファイル系ツールはシークレットのないパスに限定する |
1〜4は主にクライアント側の問題で、5〜7章で扱います。5〜7はサーバーを動かす側の責任です。そこで8章では、リモートサーバーについてシークレットをノートPCから完全に外す構成を説明します。
5. 7つのMCPクライアントのシークレット参照記法を比較
主要なMCPクライアントはどれも、設定ファイルに値を書かずに、環境変数やシークレットストアから読み込めるようになりました。ただ、記法がクライアントごとに違うことが、直書きが戻ってくる原因になっています。
| クライアント | 設定ファイル | 参照の記法 | 使えるフィールド | シークレットストア・入力プロンプト | 変数が未設定のとき |
|---|---|---|---|---|---|
| Claude Code | .mcp.json(プロジェクト)、~/.claude.json(ユーザー) |
${VAR}、${VAR:-default} |
command、args、env、url、headers |
headersHelper のコマンドで接続時にヘッダーを渡せる |
claude mcp list と /mcp で警告し、${VAR} のまま読み込む |
| Claude Desktop拡張(MCPB) | バンドル内の manifest.json |
${user_config.KEY} |
mcp_config の args と env |
"sensitive": true で入力を伏せ、安全に保存 |
記載なし |
| VS Code | .vscode/mcp.json |
${env:NAME}、${input:id} |
command、args、env、headers。stdioは envFile も可 |
inputs に "password": true を指定すると初回に入力を求め、値を保存 |
入力を求める |
| Copilotのポータブル形式 | .mcp.json、~/.copilot/mcp-config.json |
${NAME}、${NAME:-default} |
command、args、env、ヘッダーの値 |
なし(envFile も入力プロンプトも非対応) |
記載なし |
| Cursor | .cursor/mcp.json、~/.cursor/mcp.json |
${env:NAME} |
command、args、env、url、headers、OAuthの auth の値 |
envFile はstdioだけ |
記載なし |
| OpenAI Codex | ~/.codex/config.toml |
値ではなく変数名を書く:bearer_token_env_var、env_http_headers、env_vars |
HTTPの認証ヘッダー、HTTPヘッダー、stdioに渡す環境変数 | OAuthは mcp_oauth_credentials_store(auto、file、keyring) |
記載なし |
| Gemini CLI | settings.json |
$VAR、${VAR}、Windowsでは %VAR% |
env ブロック |
*TOKEN*、*SECRET*、*KEY* などに一致する継承変数は、明示しない限り伏せる |
空文字になる |
公式ドキュメントで特に押さえておきたい点が3つあります。
- VS Codeの2つの形式は記法が違います。VS Code形式は
${env:NAME}、Copilotのポータブル形式は${NAME}です。VS Codeのドキュメントは、VS CodeのMCPクライアントが$NAMEを括弧なしで書くと文字列として扱うこと、設定フォームは入力値をそのままファイルに書き込むので値ではなく参照を入力するよう注意しています。 - Gemini CLIは、継承する環境変数を既定で絞ることをドキュメントに明記しています。ホストの「AWSキーやGitHubトークン」が第三者のMCPサーバーに渡らないよう、機密に見える変数を伏せます。
envに明示した変数は伏せられません。 - Codexは値ではなく変数名を保存します。
bearer_token_env_var = "INTERNAL_MCP_KEY"は「どの変数を読むか」だけを指定するので、ファイル自体には秘密が残りません。
そのまま使える設定例
Claude Code(.mcp.json。このままコミットしても安全):
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}" }
},
"internal": {
"type": "http",
"url": "https://mcp.internal.example.com/mcp",
"headers": { "Authorization": "Bearer ${INTERNAL_MCP_KEY}" }
}
}
}
VS Code(.vscode/mcp.json。シェル変数ではなく初回に入力を求める):
{
"inputs": [
{ "type": "promptString", "id": "api-token", "description": "Internal MCP key", "password": true }
],
"servers": {
"internal": {
"type": "http",
"url": "https://mcp.internal.example.com/mcp",
"headers": { "Authorization": "Bearer ${input:api-token}" }
}
}
}
Cursor(.cursor/mcp.json):
{
"mcpServers": {
"internal": {
"url": "https://mcp.internal.example.com/mcp",
"headers": { "Authorization": "Bearer ${env:INTERNAL_MCP_KEY}" }
}
}
}
OpenAI Codex(~/.codex/config.toml):
[mcp_servers.internal]
url = "https://mcp.internal.example.com/mcp"
bearer_token_env_var = "INTERNAL_MCP_KEY"
[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env_vars = ["GITHUB_PERSONAL_ACCESS_TOKEN"]
では、変数の値はどこから入れればよいでしょうか。シェルのプロファイルでの export は避けます(漏れる場所3)。おすすめ順に、クライアント自身の入力プロンプトやキーチェーン連携、クライアントのプロセスにだけ変数を注入するシークレット管理ツールのCLI(1Passwordの op run や、Vaultの環境変数テンプレートなど)、gitの管理対象外にしてシークレットスキャンの対象にしたプロジェクト単位の env ファイル、です。
6. 検証:引数・環境変数・継承された環境変数は誰から見えるか
2026年11月6日に、Linux(カーネル 6.18、procps-ng 4.0.4、hidepid なしの既定の /proc)で3つの確認をしました。ユーザー dev が、引数に偽のキーを1つ、環境変数に別の偽のキーを1つ入れてプロセスを起動し、権限のない別ユーザー other から見えるかを調べました。
# devとして実行
FAKE_API_KEY=sk_test_ENV_SECRET_456 python3 -c "import time; time.sleep(6)" --api-key=sk_test_ARGV_SECRET_123 &
# otherとして実行
ps -eo user,args | grep ARGV_SECRET
cat /proc/<pid>/environ
| 確認内容 | 結果 |
|---|---|
other が ps -eo user,args を実行 |
見えた:dev python3 -c ... --api-key=sk_test_ARGV_SECRET_123 |
other が /proc/<pid>/environ を読む |
Permission denied |
dev が自分の /proc/<pid>/environ を読む |
見えた:FAKE_API_KEY=sk_test_ENV_SECRET_456 |
親シェルで GITHUB_TOKEN を export し、子プロセスを既定の環境で起動 |
子から GITHUB_TOKEN が見えた(True) |
同じ条件で、子プロセスを明示的な環境(PATH だけ)で起動 |
子から見えなかった(False) |
ここからわかること:
- 共有マシンでは、コマンド引数は公開情報と同じです。プロセス一覧を見られるローカルユーザー、監視エージェント、クラッシュレポーターのどれからでも読めます。MITREはこれをCWE-214として分類しています。
- 環境変数は「自分のユーザー」には非公開でも、「そのサーバー」専用ではありません。同じユーザーで動くほかのプロセス、つまりほかのMCPサーバーからも読めます。MCPのガイドがサーバーごとに渡すよう求めているのはこのためです。
- 継承は既定の動作です。クライアントがサーバーごとに環境を組み立てない限り、MCPサーバーはシェルが
exportしたものをすべて受け取ります。悪意のある、あるいは乗っ取られたstdioサーバーは、ほかのツール向けのシークレットまで読めてしまいます。ローカルサーバーをさらに隔離する方法はMCPサーバーのサンドボックス化ガイドを参照してください。
7. 検証:MCP設定ファイルの直書きシークレットをスキャンする
汎用のシークレットスキャナーは既知のキー形式を検出しますが、MCP設定ファイルには見逃されやすい書き方があります。args の中のシークレット、接続文字列に含まれる認証情報、URLの中のトークンです。そこで、${VAR}、${env:NAME}、${input:id}、${user_config.KEY}、$VAR、Codexの *_env_var を安全な参照として扱い、それ以外で秘密に見えるものを指摘する50行ほどのPythonスキャナーを書きました。
REF = re.compile(r'^\$\{(env:|input:|user_config\.)?[A-Za-z_][\w.\-]*(:-[^}]*)?\}$|^\$[A-Za-z_]\w*$|^%[A-Za-z_]\w*%$')
PATTERNS = {
"known prefix": re.compile(r'(ghp_|github_pat_|sk-|sk_live_|xox[bp]-|AKIA|AIza|glpat-|mcp_)[A-Za-z0-9_\-]{8,}'),
"credentials in URL": re.compile(r'://[^/\s:@]+:[^/\s@]+@'),
"token in query string": re.compile(r'[?&](token|key|api_key|apikey|access_token)=', re.I),
}
# 文字列の値ごとに、参照ならスキップし、PATTERNSを当てる。
# *token*、*secret*、*api_key* のようなキーの直書きの値と、
# args内の --token / --api-key / --password も警告する。
5つのサンプル設定での結果(Python 3.13、2026年11月6日):
| 設定 | 内容 | 結果 |
|---|---|---|
| A | env に ghp_... を直書き、args に postgresql://app:password@host/db |
FAIL 2件(既知のプレフィックス、URL内の認証情報) |
| B | args に --api-key、リモートの url に ?api_key= |
FAIL 1件(クエリ文字列)、WARN 1件(引数のシークレット用フラグ) |
| C | Claude Codeで ${GITHUB_TOKEN} と Bearer ${INTERNAL_MCP_KEY} |
OK |
| D | VS Codeで ${input:api-token} と password: true |
OK |
| E | Codexで bearer_token_env_var と env_vars |
OK |
設定Bで限界も1つ見つかりました。--api-key というフラグは検出できましたが、次の引数にある値そのものは、既知のプレフィックスがないため検出できませんでした。args にシークレット用のフラグがあればそれだけで不合格として扱い、GitGuardianの ggshield、gitleaks、trufflehog などの汎用スキャナーと組み合わせて、pre-commitとCIで実行してください。
8. リモートMCPサーバー:上流のシークレットをサーバー側へ移す
リモートMCPサーバーでいちばん強い構成は、クライアントが上流のシークレットをまったく見ない形です。クライアントはMCP用の認証情報を1つだけ持ち、上流APIを呼ぶための認証情報はサーバーが持ちます。
| ローカルのstdioサーバー | リモートサーバー(シークレットはサーバー側) | |
|---|---|---|
| GitHub・DB・SaaSのキーの置き場所 | 開発者全員のノートPC | サーバー側のシークレットストア1か所 |
| ノートPCの設定が盗まれたときに漏れるもの | 上流のキーそのもの(権限が広いことが多い) | 1か所で失効でき、特定のツールに絞れるMCPキー |
| ローテーション | 全マシンで実施 | サーバーで1回 |
| 実行時にシークレットを読めるもの | そのユーザーが動かす全プロセス | サーバーのプロセスだけ |
| 監査 | たいていなし | 呼び出し元ごとのサーバー側リクエストログ |
この構成を安全に保つルールは3つです。
- クライアントのMCPトークンを上流へそのまま転送しない。仕様はトークンのパススルーを禁止しています。サーバーは自分の認証情報で上流を呼ぶか、ユーザーの身元を新しいトークンに交換します。
- 注入は実行時に行い、ビルド時には行わない。OWASP MCP01は「ビルド時には行わない」と書き、チートシートはコンテナ定義の
ENVとARGを使わないよう警告しています。認証情報をイメージのレイヤーに残さないビルドの例はMCPサーバーのDockerfileガイドで紹介しています。 - クライアントの認証情報はツール単位で絞る。上流のキーがリポジトリを削除できるなら、そこにつながるMCPキーは、呼び出し元が必要とする読み取り系のツールだけを呼べるようにします。
9. MCPシークレット管理チェックリスト(14項目)
- [ ]
.mcp.json、mcp.json、config.toml、settings.jsonに直書きのシークレットがない(ユーザー単位のファイルも含む) - [ ] 設定内のシークレットはすべて参照(
${VAR}、${env:NAME}、${input:id}、*_env_var、sensitive: true) - [ ]
argsにシークレットがない(フラグ、接続文字列、URL) - [ ] URLのクエリ文字列にトークンがない
- [ ] シークレットはサーバーごとに
envで渡し、シェルのプロファイルでexportしていない - [ ] 値はOSのキーチェーン、クライアントの入力プロンプト、シークレット管理ツールから来ており、リポジトリ内の平文ファイルではない
- [ ]
envFileで読む env ファイルは.gitignoreに入っている - [ ] pre-commitとCIのシークレットスキャンがMCP設定ファイルを対象にしている
- [ ] リモートサーバーの上流キーはサーバー側にあり、クライアントにはない
- [ ] シークレットは実行時に注入し、イメージやビルド引数に焼き込んでいない
- [ ] ログは
Authorizationヘッダーを伏せ、引数は値ではなく名前で記録している - [ ] ツールが設定ファイル、
.envの中身、環境変数の一覧を返さない - [ ] 認証情報はサーバーごと・端末ごとに分け、動作する範囲で最も狭い権限にしている
- [ ] 長期間有効なシークレットにはローテーション日と担当者が決まっている
10. よくあるハマりどころ(症状→原因→対処)
| 症状 | 原因 | 対処 |
|---|---|---|
| リポジトリのgit履歴にキーが残っている | コミットされるプロジェクト設定に直書きした | まず失効・ローテーションし、そのあと参照に置き換えてスキャンを追加する |
| 変数を設定したのに「invalid token」になる | VS Code形式で括弧なしの $NAME を書き、文字列として扱われた |
.vscode/mcp.json では ${env:NAME}、ポータブル形式では ${NAME} を使う |
| Claude Codeが変数名を挙げて警告する | ${VAR} に値も :-default もない |
クライアントのプロセスに変数を設定するか、秘密でない既定値を付ける |
Gemini CLIのサーバーから GITHUB_TOKEN が見えない |
*TOKEN* に一致する継承変数が伏せられた |
サーバーの env に変数を明示する |
| 第三者のサーバーがクラウドのキーを読めた | キーをグローバルに export し、サーバーが継承した |
サーバーごとの env にし、信頼できないサーバーは隔離する |
| リモートサーバーがローカルでは動くのにCursorで動かない | リモートサーバーに envFile を使った(Cursorはstdioだけ対応) |
環境に設定した変数を ${env:NAME} で参照する |
| 監視ツールにシークレットが表示される | コマンドラインのフラグで渡した | 環境変数かファイルで渡す |
11. NodeFlareならこう解決できる
NodeFlareはMCPサーバーのホスティング基盤です。この記事のうちサーバー側の半分、つまり上流のシークレットをノートPCやビルドから外し、クライアントにはスコープを絞ったキーだけを渡す部分を受け持ちます。この記事で挙げたリスクと、NodeFlareが現在ドキュメントで公開している機能の対応は次のとおりです。
| この記事のリスク | NodeFlareでの対策 |
|---|---|
| 上流のキーを全員のノートPCにコピーしている(4章・8章) | サーバーをNodeFlareで動かし、上流のキーはNodeFlareの環境変数に保存します。クライアントが持つのは mcp_* のAPIキーかOAuthアクセストークンだけで、Authorization: Bearer <YOUR_API_KEY> として送ります |
| シークレットを平文で保存している(漏れる場所1) | 環境変数は保存時に暗号化されます。値ごとのデータ鍵(AES-256-GCM)を、テナント専用の鍵(OpenBao Transit)で包む方式で、マスター鍵は実行ホストから撤去されています |
| 引数やビルドのレイヤーにシークレットが残る(漏れる場所2・5) | 環境変数はVMの起動時にだけ復号・注入され、ビルド引数やargvには渡されず、イメージのレイヤーやログにも残りません |
| あるサーバーが別のサーバーのシークレットを読む(漏れる場所3) | サーバーごとに専用のFirecracker microVMで動き、jailer配下(非root、chroot、cgroup v2、seccomp)で独自のネットワーク名前空間を持ちます |
| 盗まれたクライアントのキーの権限が広すぎる | tools:call:<ツール名>(例:tools:call:get_weather)のようなツール単位のスコープ、resources:read:<uri>、prompts:get:<name> で絞れます。tool_list_filter_by_scope で、呼べないツールを一覧から隠せます |
| キーの総当たり | mcp_* キーはハッシュ化して保存され、5分間に10回失敗するとその送信元IPは10分間ロックアウトされます |
| 乗っ取られたサーバーがシークレットを未知の宛先へ送る(漏れる場所7) | Egress制御で off(既定)、observe、enforce を選べ、最大100件のホスト名またはIPの許可リストを、ホスト側のDNSとnftablesで強制します |
| 漏れたキーがどこからでも使われる | IPv4/IPv6のCIDRで指定する受信IP許可リストを、認証より前にプロキシで確認します。リストが空なら全拒否です(Pro以上) |
| ログにシークレットが残る(漏れる場所6) | リクエストログには tool_name、arg_keys、outcome、caller_kind、client_ip、duration_ms などを記録し、保持期間はFreeで7日、Pro/Teamで30日です |
NodeFlareができないことも書いておきます。Claude CodeやVS Codeなどのクライアントが、ノートPC上でMCPキーをどう保存するかは変えられません。そのキーは5章のとおり参照で書いてください。プロンプトインジェクションそのものは防げず、自分のツールのコードが結果にシークレットを含めて返すことも止められません。NodeFlareが減らすのは、漏れたキーや異常な動きをするサーバーが届く範囲です。
最小の始め方:
- MCPサーバーをNodeFlareにデプロイし、上流のキーをNodeFlareの環境変数に移します。
- 呼び出し元ごとに、必要な
tools:call:<ツール名>だけを持つmcp_*キーを発行し、クライアントの設定ではBearer ${INTERNAL_MCP_KEY}のように参照で書きます。 - Egressを1週間
observeにして実際の通信先を確認し、そのホストを許可リストに入れてenforceに切り替えます。
MCPサーバー1つまでなら無料で試せます。nodeflare.tech から始めてください。
12. よくある質問
MCPサーバーのAPIキーはどこに保存すればいいですか?
値はOSのキーチェーン、クライアントの入力プロンプト、シークレット管理ツールのどれかに置き、MCP設定にはClaude Codeの ${GITHUB_TOKEN} やVS Codeの ${input:api-token} のような参照だけを書きます。渡すときはサーバーごとに env を使い、args には入れません。リモートサーバーなら、上流のキーはサーバー側に置き、クライアントにはスコープを絞ったMCPキーを渡します。
.mcp.jsonはgitにコミットしても大丈夫ですか?
参照だけで、直書きのシークレットがなければ大丈夫です。Claude Codeの .mcp.json のようなプロジェクト単位のファイルはチームで共有する前提なので、貼り付けたキーはそのまま漏えいになります。pre-commitとCIのシークレットスキャンの対象にMCP設定ファイルを加えてください。
Claude Codeの.mcp.jsonで環境変数はどう使いますか?
Claude Codeは command、args、env、url、headers の中の ${VAR} と ${VAR:-default} を展開します。変数が未設定で既定値もない場合は、claude mcp list と /mcp で警告を出し、展開しないままサーバーを読み込みます。接続時に取得する必要があるヘッダーは、headersHelper でコマンドから渡せます。
VS Codeの${env:NAME}と${NAME}の違いは?
${env:NAME} はVS Code独自の .vscode/mcp.json 形式の記法です。${NAME} と ${NAME:-default} は、.mcp.json や mcp-config.json で使うCopilotのポータブル形式の記法です。VS CodeのMCPクライアントは、括弧なしの $NAME を文字列として扱います。
APIキーをMCPサーバーのコマンド引数で渡しても安全ですか?
安全ではありません。コマンド引数は、同じマシンのほかのユーザーからプロセス一覧で見えます。検証では、権限のない別ユーザーが ps でキーを読めましたが、環境変数で渡した同じキーは読めませんでした。MITREはこれをCWE-214として分類しています。
MCPのシークレットを環境変数で渡すのは安全ですか?
設定ファイルや引数よりは安全ですが、秘密が守られるわけではありません。同じユーザーのほかのプロセスから読め、子プロセスには既定で引き継がれ、OWASPはログやシステムダンプに含まれることがあると指摘しています。シークレットストアから、サーバーごとに渡し、グローバルに export しないでください。
MCP仕様にシークレットの保存方法は書かれていますか?
2026-07-28版の仕様は、OAuth 2.1 Section 7.1 に沿った安全なトークン保存を必須とし、URIのクエリ文字列へのトークン記載とトークンのパススルーを禁止しています。stdioサーバーは環境から認証情報を読むよう求めています。さらにMCPプロジェクトの Local Server Security ガイドは、長期間有効なシークレットを平文の設定に置かず、サーバーごとに渡すよう勧めています。
MCP設定ファイルからどれくらいシークレットが漏れていますか?
GitGuardianの「State of Secrets Sprawl 2026」では、公開GitHub上のMCP設定ファイルから24,008件のユニークなシークレットが見つかり、そのうち2,117件が有効なままでした。有効なものではGoogle APIキーとPostgreSQLの接続文字列が多くを占めていました。
MCPサーバーのDockerイメージにシークレットを入れてもいいですか?
入れてはいけません。OWASPは、Dockerの ENV や ARG でシークレットを直書きしないよう明記しています。コンテナの起動時に環境変数かマウントしたファイルで注入し、ビルド自体に認証情報が必要ならビルド時のシークレットマウントを使います。
MCPのAPIキーをコミットしてしまったらどうすればいいですか?
まずキーを失効またはローテーションします。コミットを消しても、フォーク・クローン・キャッシュからは消えないからです。そのあと直書きを参照に置き換え、そのキーの利用ログに見覚えのない呼び出しがないか確認し、MCP設定ファイルをシークレットスキャンの対象に加えます。
まとめ
MCPのシークレット漏えいの多くは、攻撃ではなく設定のミスです。共有される設定へのキーの貼り付け、引数での受け渡し、全プロセスへの export、イメージへの焼き込みが原因になります。主要なクライアントはどれも参照記法に対応しているので、対策の大半は習慣の問題です。値ではなく参照を書く、グローバルではなくサーバーごとに渡す、args とクエリ文字列は使わない、CIで設定ファイルをスキャンする。リモートサーバーならさらに一歩進めて、上流の認証情報をサーバー側に置き、クライアントには1か所で失効できるスコープ付きのキーだけを持たせましょう。
参考資料(一次情報)
- MCP仕様 2026-07-28:Authorization — https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization
- MCP仕様 2026-07-28:Authorization Security Considerations — https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization/security-considerations
- MCP:Security Best Practices — https://modelcontextprotocol.io/docs/2026-07-28/tutorials/security/security_best_practices
- MCP:Local Server Security — https://modelcontextprotocol.io/docs/2026-07-28/tutorials/security/local-server-security
- OWASP MCP Top 10:MCP01 Token Mismanagement & Secret Exposure — https://owasp.org/www-project-mcp-top-10/
- OWASP Secrets Management Cheat Sheet — https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html
- MITRE CWE-214 — https://cwe.mitre.org/data/definitions/214.html
- GitGuardian:State of Secrets Sprawl 2026 — https://www.gitguardian.com/state-of-secrets-sprawl-report-2026
- GitGuardian:AI coding agents and credential security — https://blog.gitguardian.com/ai-coding-agents-credential-security/
- Claude Code ドキュメント:MCP — https://code.claude.com/docs/en/mcp
- MCP Bundles(MCPB)マニフェスト — https://github.com/modelcontextprotocol/mcpb/blob/main/MANIFEST.md
- VS Code:MCP configuration reference — https://code.visualstudio.com/docs/copilot/reference/mcp-configuration
- Cursor ドキュメント:MCP — https://cursor.com/docs/context/mcp
- OpenAI Codex:MCP と設定リファレンス — https://learn.chatgpt.com/docs/extend/mcp
- Gemini CLI:MCP servers — https://geminicli.com/docs/tools/mcp-server/
- NodeFlare ドキュメント — https://nodeflare.tech/docs / セキュリティ — https://nodeflare.tech/security
