記事一覧
MCPセキュリティ

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章)。

目次

  1. MCPのシークレット管理とは
  2. MCP仕様とOWASPはシークレットについて何と言っているか
  3. 問題の規模:公開されたMCP設定ファイルのシークレット
  4. MCPのシークレットが漏れる7つの場所
  5. 7つのMCPクライアントのシークレット参照記法を比較
  6. 検証:引数・環境変数・継承された環境変数は誰から見えるか
  7. 検証:MCP設定ファイルの直書きシークレットをスキャンする
  8. リモートMCPサーバー:上流のシークレットをサーバー側へ移す
  9. MCPシークレット管理チェックリスト(14項目)
  10. よくあるハマりどころ(症状→原因→対処)
  11. NodeFlareならこう解決できる
  12. よくある質問

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つです。

  1. クライアントのMCPトークンを上流へそのまま転送しない。仕様はトークンのパススルーを禁止しています。サーバーは自分の認証情報で上流を呼ぶか、ユーザーの身元を新しいトークンに交換します。
  2. 注入は実行時に行い、ビルド時には行わない。OWASP MCP01は「ビルド時には行わない」と書き、チートシートはコンテナ定義の ENV と ARG を使わないよう警告しています。認証情報をイメージのレイヤーに残さないビルドの例はMCPサーバーのDockerfileガイドで紹介しています。
  3. クライアントの認証情報はツール単位で絞る。上流のキーがリポジトリを削除できるなら、そこにつながる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が減らすのは、漏れたキーや異常な動きをするサーバーが届く範囲です。

最小の始め方:

  1. MCPサーバーをNodeFlareにデプロイし、上流のキーをNodeFlareの環境変数に移します。
  2. 呼び出し元ごとに、必要な tools:call:<ツール名> だけを持つ mcp_* キーを発行し、クライアントの設定では Bearer ${INTERNAL_MCP_KEY} のように参照で書きます。
  3. 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か所で失効できるスコープ付きのキーだけを持たせましょう。

参考資料(一次情報)

NodeFlare

MCP専用ホスティングサービス

GitHubにあるMCPを簡単デプロイ・簡単運用で最適化
無料で始める

他の記事

MCPトークン2026年11月17日

ツール引数は出力トークン:MCPのトークン消費で見落とされる「書く側」のコスト(write_fileとedit_fileを実測・2026年版)

MCPのツール引数は出力トークンで、単価は入力の5倍、キャッシュも効きません。公式Filesystemサーバーで1行の変更がwrite_file 5,549トークン対edit_file 49トークンになった実測、Sonnet 5.5・Opus 5.5・Fable 5.2での料金試算、ツール間の書き写し、max_tokensでの中断、書き直しの損益分岐、置換ツールのコードまで。

MCPセキュリティ2026年11月17日

MCPのきめ細かな認可:スコープでは防げないBOLAを、オブジェクト・引数・項目単位のチェックで止める【MCP Security 2026】

ツール単位のスコープでは防げない、MCPツールのオブジェクト・引数・項目単位の認可を解説。仕様の「スコープだけで十分とみなすのは誤り」、公式Python SDKを含む2026年のCVE3件、チェックの置き場所、8つのルール、検証済みPythonコード(スコープのみ4/14、多層14/14)とCedarポリシー(12/12)。

MCPホスティング2026年11月17日

Hugging Face SpacesはまだMCP Hostingに無料で使える?Gradioのmcp_server=Trueを2026年の有料化後に検証(Gradio 6.32)

2026年のHugging Face SpacesでのMCP Hosting。新規のGradio SpaceはZeroGPU以外PROが必要、無料ハードウェアは48時間でスリープ、Gradioのキューは既定で1件ずつ。Gradio 6.32で検証した /gradio_api/mcp/ の使い方、188 MB・1回約60 msの実測、Space名の接頭辞、ZeroGPUの上限、費用、Claude Code・Cursorの接続を解説。

MCPのシークレット管理:mcp.jsonにAPIキーを直書きしない設定を7クライアント別に解説【MCP Security 2026】 | Blog | Nodeflare