MCPクライアントの許可リスト:CIMDで接続元を制限する信頼ポリシーとSSRF対策、localhostなりすましの限界を検証(MCP Security、2026年)
MCPサーバーに接続できるクライアントを制限するMCP Securityガイド。2026-07-28版仕様の4つの登録方式、CIMDが証明すること・しないこと(localhostなりすまし)、SSRFを防ぐ取得ルール、4区分の信頼ポリシー、検証済みチェッカー(21/21、素朴な実装は4/10)、KeycloakとEntraの対応状況を解説。
最終更新:2026年11月22日 / 対象:MCP仕様 2026-07-28(Authorization、Client Registration、Authorization Security Considerations)、draft-ietf-oauth-client-id-metadata-document-03(2026年11月2日)、Keycloak MCP連携ガイド(CIMDは実験的機能)、Microsoft Entra のCIMD対応(パブリックプレビュー)。検証スクリプトは2026年11月22日に Python 3.13.18 で実行。Claude、Claude Code、VS Code のクライアントメタデータも同日に確認しました。
結論(30秒で読める要約)
MCPクライアントの許可リストとは、自社MCPサーバー用のトークンを「どのMCPクライアント(Claude、Claude Code、VS Code、社内エージェントなど)に発行してよいか」を認可サーバー側で決める仕組みです。2026-07-28版の仕様では、その中心が Client ID Metadata Document(CIMD)です。client_id そのものがHTTPSのURLになっていて、認可サーバーはその先のJSONを取得してクライアントを確認します。MCP Securityの観点で言えば、CIMDは許可リストに載せられる安定したIDを与えてくれますが、「接続してきたソフトウェアが本当にそのクライアントか」までは証明しません。
- 仕様上、許可リストは任意です。認可サーバーはCIMDに対して「ドメインベースの信頼ポリシーを実装してもよい(MAY)」とされているだけで、何もしなければ「Claude」を名乗る別ドメインのクライアントも登録できてしまいます(4章)。
- 信頼済みの client_id でも、リダイレクト先が localhost なら信頼済みクライアントとは言えません。仕様自体が「CIMDだけでは localhost URL のなりすましを防げない」と書いています。Claude Code のメタデータに載っているリダイレクトURIは
http://localhost/callbackとhttp://127.0.0.1/callbackだけなので、ローカルで動く任意のプログラムが同じ client_id を名乗れます。https://claude.aiに戻る Claude(Web)とは別の扱いにすべきです(3章)。 - メタデータの取得はSSRFの入口になります。CIMDドラフトは、特殊用途IPに解決されるURLを取得してはならない(MUST NOT)、HTTPリダイレクトを自動で追ってはならない(MUST NOT)、読み込みは5KB程度までにすべき、と定めています(4章)。
- 検証結果:約90行のチェッカーは21ケースすべてで期待どおりに動き、素朴な実装は10ケース中4ケースしか正しく判定できませんでした。素朴な実装は「Claude」を名乗る偽クライアント、共有シークレット方式のクライアント、平文HTTPのリダイレクトURIを通し、内部URLへのリダイレクトを追い、さらにポートがランダムな本物の Claude Code を拒否しました(6章)。
- 登録は1つの層にすぎません。受け入れたクライアントに何をさせるかは、ツール単位のスコープ、短いトークン寿命、ログで決まります(8章)。
目次
- MCPクライアントの許可リストとは
- 2026-07-28版仕様でクライアントIDを得る4つの方法
- CIMDが証明すること、しないこと
- CIMDクライアントを受け入れるときのルール(仕様とIETFドラフト)
- 信頼ポリシーの設計:4つの区分
- 検証:CIMDクライアントの受け入れチェッカー
- 認可サーバーの対応状況:Keycloak と Microsoft Entra
- 受け入れた後の防御層
- チェックリスト(12項目)
- よくあるハマりどころ(症状→原因→対処)
- NodeFlareならこう解決できる
- よくある質問
- まとめ
1. MCPクライアントの許可リストとは
MCPクライアントの許可リストとは、認可サーバーに設定するポリシーで、承認済みのMCPクライアントだけを client_id で識別してOAuthフローに通すものです。「誰がログインできるか」でも「トークンがどのツールを呼べるか」でもなく、「どのアプリがユーザーにアクセス許可を求めてよいか」を決めます。
社内SaaSや顧客向けSaaSをリモートMCPサーバーとして公開するときに特に必要になります。許可リストがないと、次のことが起こり得ます。
| リスク | 具体的な状況 | ログインだけでは防げない理由 |
|---|---|---|
| 同意画面を使ったフィッシング | メタデータに「Claude」と書いたクライアントが、ユーザーにアクセス許可を求める | ユーザーは正しくログインしている。同意画面の名前はクライアントが自分で決めたもの |
| 未承認ツールの接続 | 社員が審査していないエージェントを本番のMCPサーバーにつなぐ | 登録できたOAuthクライアントは、ユーザーが承認すればトークンを得られる |
| 登録経路の悪用 | 大量の新規client_id、社内ネットワークを指すclient_id URL | 新しいクライアントごとに、認可サーバーが書き込みや取得を行う |
この記事でのMCP Securityの整理は次のとおりです。登録で「どのclient_idが来たか」が分かり、信頼ポリシーで「そのIDを通すか」を決め、スコープで「通した後に何ができるか」を決めます。
2. 2026-07-28版仕様でクライアントIDを得る4つの方法
2026-07-28版の仕様では、クライアントは CIMD、事前登録、Dynamic Client Registration(DCR)のいずれかで client_id を取得しなければならない(MUST)とされ、優先順位も示されています。方法によって、認可サーバー側で制御できる範囲が大きく違います。
| 優先順位(クライアント側、SHOULD) | 方法 | 仕様上の位置づけ | クライアントを制限する方法 |
|---|---|---|---|
| 1 | 事前登録 | クライアントは対応すべき(SHOULD) | 自分で作ったクライアントしか存在しない。制御は最も強いが管理の手間も最大 |
| 2 | Client ID Metadata Documents(CIMD) | クライアントと認可サーバーは対応すべき(SHOULD) | client_id URLに対する信頼ポリシー(URL完全一致またはドメイン) |
| 3 | Dynamic Client Registration(RFC 7591) | 任意(MAY)。「非推奨」で後方互換のために残されている | 誰でも叩ける /register へのレート制限やポリシー。名前はクライアントが自由に決める |
| 4 | ユーザーがクライアント情報を入力 | 最後の手段 | 管理者の運用次第 |
クライアントは、認可サーバーメタデータの client_id_metadata_document_supported でCIMD対応を知り、registration_endpoint があればDCRにフォールバックします。つまり、古いクライアントのためにDCRを開けたままにしていると、CIMD側の許可リストは意味をなしません。同じクライアントが /register から好きな名前で入ってこられるからです。CIMDを紹介したMCP公式ブログも、認証なしの /register があると管理者は「レート制限やポリシーによる制御」を気にしなければならない、とDCRの問題点を挙げています。
3. CIMDが証明すること、しないこと
CIMDが証明するのは「そのドメインの管理者が、このURLに、このクライアント名とリダイレクトURIを公開した」ことです。ユーザーのPCで実際に動いているプログラムが何かは証明しません。その差は、ほぼリダイレクトURIで決まります。
2026年11月22日に、よく使われる3つのMCPクライアントのメタデータを確認しました。
| クライアント | client_id | redirect_uris | token_endpoint_auth_method |
|---|---|---|---|
| Claude | https://claude.ai/oauth/mcp-oauth-client-metadata |
https://claude.ai/api/mcp/auth_callback |
none |
| Claude Code | https://claude.ai/oauth/claude-code-client-metadata |
http://localhost/callback、http://127.0.0.1/callback |
none |
| Visual Studio Code | https://vscode.dev/oauth/client-metadata.json |
http://127.0.0.1:33418/、https://vscode.dev/redirect |
none |
それぞれ何が言えるかを整理します。
- 自ドメインのHTTPSリダイレクト(Claude):認可コードは
claude.aiにしか届きません。別のアプリがこの client_id を名乗っても、コードは受け取れません。公開クライアントとしては、検証済みに最も近い状態です。 - ループバックのみ(Claude Code):ユーザーのPC上の任意のプログラムが localhost で待ち受け、この client_id を名乗れます。仕様にも「CIMDだけでは localhost URL のなりすましを防げない」とはっきり書かれています。悪意のあるローカルツールが「Claude Code(
claude.ai)」と表示された同意画面を出させることもあり得ます。 - 混在(VS Code):Web側のリダイレクトは強く、ループバック側は Claude Code と同じ弱点を持ちます。client_id だけでなく、リクエストごとに使われたリダイレクトURIを見て判定する必要があります。
実務で効いてくる点がもう2つあります。Claude Code のループバックURIにはポート番号がありません。RFC 9700 とCIMDドラフトはループバックのリダイレクトでは任意のポートを許すので、URIを文字列で完全一致させるだけの認可サーバーは、本物の Claude Code を拒否してしまいます。また、client_name や logo_uri などの表示用の項目はすべて「クライアントが自己申告したもの」です(ドラフト10.10節)。同意画面では client_id のホスト名を並べて表示しましょう。
4. CIMDクライアントを受け入れるときのルール(仕様とIETFドラフト)
MCP仕様は、CIMDのセキュリティ要件の多くをIETFドラフトに委ねています。2026年11月22日に、2026-07-28版の Client Registration と Authorization Security Considerations、そして draft-ietf-oauth-client-id-metadata-document-03 を確認しました。なお、MCP仕様が参照しているのはドラフトの-00版で、現行は-03版です。
| ルール | 強さ | 出典 |
|---|---|---|
client_id URLは https で、/ 以外のパスを持ち、userinfo、. や .. のセグメント、フラグメントを含まない |
MUST(クエリは SHOULD NOT) | ドラフト3節 |
取得した文書の client_id がURLと完全一致する(単純な文字列比較) |
MUST | MCP Client Registration、ドラフト4節 |
| リクエストのリダイレクトURIを文書の記載と照合する | MUST | MCP Client Registration |
client_secret を使わない。client_secret_basic などの共有シークレット方式も不可 |
MUST NOT | ドラフト4.1節 |
| 特殊用途IP(RFC 6890)に解決されるURLは取得しない。ループバックは開発・テスト時のみで、本番では不可 | MUST NOT | ドラフト10.7節 |
| 取得時にHTTPリダイレクトを自動で追わない | MUST NOT | ドラフト6節 |
| 読み込みは5KB程度まで。超えたらエラー扱い | 推奨 | ドラフト10.11節 |
| キャッシュヘッダーに従いつつ、最大・最小のキャッシュ期間を強制する。エラーや不正な文書はキャッシュしない | SHOULD/MUST NOT | ドラフト6.2節 |
| 同意画面に client_id のホスト名を表示する | SHOULD(ドラフト)。リダイレクトURIのホスト名の表示は MUST(MCP) | ドラフト10.6節、MCP Security Considerations |
| localhost のみのリダイレクトURIには警告を出す。追加の証明(attestation)を求めてもよい | SHOULD/MAY | MCP Security Considerations |
| ドメインベースの信頼ポリシー | MAY | MCP Security Considerations、ドラフト10.8節 |
| client_id 不一致が確定したら、そのクライアントのリフレッシュトークンを無効にする | SHOULD | ドラフト6.1節 |
| 同意後にメタデータが変わったら、許可を無効にするか再同意を求めてもよい | MAY | ドラフト10.5節 |
ドラフトは取得のタイムアウト値を定めていません。ユーザーが認可画面で待っている間に取得が走るので、短めに設定しましょう(本記事では3秒)。
5. 信頼ポリシーの設計:4つの区分
信頼ポリシーは、client_id と、そのリクエストで使われたリダイレクトURIの組み合わせを区分に振り分けるものです。多くのMCPサーバーは次の4区分で足ります。
| 区分 | 例 | 認可サーバーの動き |
|---|---|---|
| 信頼済み・HTTPSリダイレクト | https://claude.ai/api/mcp/auth_callback に戻る Claude |
client_id のホスト名を出した通常の同意画面。標準のスコープ |
| 信頼済み・ループバック | 127.0.0.1 に戻る Claude Code や VS Code |
毎回同意を求める(黙って再同意しない)、「ローカルアプリ」である旨の警告、必要ならスコープを狭くしトークン寿命を短くする |
| 自社のクライアント | mcp.internal.example.com 上の社内エージェント |
ドメイン単位で許可。できれば事前登録か private_key_jwt を使う |
| 不明 | それ以外のHTTPS URL | 社内SaaSなら拒否。一般向け製品なら「未確認のアプリ」と明示し、スコープを絞る |
他社クライアントは、ドメイン単位ではなく client_id URLの完全一致で許可リストに載せましょう。claude.ai 上のclient_idをすべて信頼するルールにすると、ベンダーが後から公開した新しいclient_idまで、審査する前に信頼してしまいます。ドメインルールは自社が管理するドメインだけに使います。
各クライアントをなぜ載せたのか、誰が承認したのかも記録しておきます。監査ではアクセス制御を確認するときにこうした一覧から見られるので、そのまま監査証跡になります。
6. 検証:CIMDクライアントの受け入れチェッカー
次のチェッカーは、4章のルールと5章の区分を Python 標準ライブラリだけで実装したものです。URL形式の client_id で認可リクエストが来たら fetch() を呼び、続けてリクエストされた redirect_uri とともに admit() を呼びます。
"""CIMD admission check for an MCP authorization server (stdlib only).
Validates a URL-formatted client_id per draft-ietf-oauth-client-id-metadata-document-03
and the MCP 2026-07-28 spec, then applies a trust policy. Returns (decision, tier, reason)."""
import ipaddress, json, socket, urllib.parse, urllib.request, urllib.error
MAX_BYTES = 5 * 1024 # draft 10.11: recommended read limit 5 KB
TIMEOUT_S = 3 # the draft sets no value; pick a short one
SHARED_SECRET_METHODS = {"client_secret_post", "client_secret_basic", "client_secret_jwt"}
TRUSTED = { # trust policy: exact client_id -> tier
"https://claude.ai/oauth/mcp-oauth-client-metadata": "trusted",
"https://claude.ai/oauth/claude-code-client-metadata": "trusted",
"https://vscode.dev/oauth/client-metadata.json": "trusted",
}
TRUSTED_HOSTS = {"mcp.internal.example.com"} # your own agents, any path
class Reject(Exception): pass
def check_url(cid): # draft section 3
u = urllib.parse.urlsplit(cid)
if u.scheme != "https": raise Reject("client_id must use https")
if u.username or u.password: raise Reject("userinfo not allowed")
if u.path in ("", "/"): raise Reject("path component required")
if any(seg in (".", "..") for seg in u.path.split("/")): raise Reject("dot segments")
if u.fragment or "#" in cid: raise Reject("fragment not allowed")
if u.query: raise Reject("query not accepted by this server") # draft: SHOULD NOT
return u
def check_ip(host, allow_loopback=False): # draft 10.7: no special-use IPs
for info in socket.getaddrinfo(host, 443, proto=socket.IPPROTO_TCP):
ip = ipaddress.ip_address(info[4][0])
if allow_loopback and ip.is_loopback: continue # dev/test only, never production
if not ip.is_global or ip.is_multicast:
raise Reject(f"{host} resolves to non-public address {ip}")
class NoRedirect(urllib.request.HTTPRedirectHandler): # draft 6: MUST NOT follow redirects
def redirect_request(self, *a, **k): raise Reject("redirect not followed")
def fetch(cid, allow_loopback=False, url_override=None):
u = check_url(cid)
check_ip(u.hostname, allow_loopback) # note: pin the resolved IP in production (DNS rebinding)
req = urllib.request.Request(url_override or cid, headers={"Accept": "application/json"})
opener = urllib.request.build_opener(NoRedirect)
try:
with opener.open(req, timeout=TIMEOUT_S) as r:
if r.status != 200: raise Reject(f"status {r.status}")
body = r.read(MAX_BYTES + 1)
except urllib.error.HTTPError as e:
raise Reject(f"status {e.code}")
except (urllib.error.URLError, socket.timeout) as e:
raise Reject(f"fetch failed: {e}")
if len(body) > MAX_BYTES: raise Reject("document larger than 5 KB")
try: return json.loads(body)
except ValueError: raise Reject("not valid JSON")
def is_loopback_uri(uri):
h = urllib.parse.urlsplit(uri).hostname or ""
return h in ("localhost", "127.0.0.1", "::1")
def redirect_ok(requested, registered):
if requested in registered: return True # exact string match
r = urllib.parse.urlsplit(requested) # loopback: any port (RFC 9700 4.1.3)
if r.scheme != "http" or not is_loopback_uri(requested): return False
key = lambda u: (u.scheme, u.hostname, u.path, u.query)
return any(key(urllib.parse.urlsplit(x)) == key(r) for x in registered if is_loopback_uri(x))
def admit(cid, redirect_uri, doc):
if doc.get("client_id") != cid: raise Reject("client_id in document does not match URL")
for f in ("client_name", "redirect_uris"):
if not doc.get(f): raise Reject(f"missing {f}")
if "client_secret" in doc or doc.get("token_endpoint_auth_method") in SHARED_SECRET_METHODS:
raise Reject("shared-secret client authentication not allowed")
uris = doc["redirect_uris"]
if any(not (x.startswith("https://") or is_loopback_uri(x)) for x in uris):
raise Reject("redirect URIs must be https or loopback")
if not redirect_ok(redirect_uri, uris): raise Reject("redirect_uri not in document")
host = urllib.parse.urlsplit(cid).hostname
tier = TRUSTED.get(cid) or ("trusted" if host in TRUSTED_HOSTS else "unknown")
if tier == "unknown":
return ("deny", tier, "client_id not on allowlist") # or: "consent+warning"
if is_loopback_uri(redirect_uri):
# Anyone on the user's machine can claim this client_id with a loopback redirect.
return ("allow", "trusted-loopback", f"show {host} and a local-app warning; no auto-consent")
return ("allow", tier, f"display hostname {host}")
本番で使うときの注意:IPチェックとHTTPリクエストでそれぞれDNSを引くため、攻撃者が管理するドメインは2回目に別のIPを返せます(DNSリバインディング)。本番では確認したIPに直接接続するか、同じルールを強制するEgressプロキシ経由で取得してください。有効な文書は上限付きでキャッシュします。たとえば Keycloak の既定値は最短300秒、最長259,200秒(3日)です。
結果
2026年11月22日に21ケースを実行しました。クライアントの文書は3章のものを使い、取得系のケースはローカルのHTTPサーバーで、そのテストに限ってループバックを許可して確認しています。
| # | ケース | 期待 | 結果 |
|---|---|---|---|
| 1 | HTTPSコールバックを使う Claude | 許可 | 許可(trusted) |
| 2 | ランダムなポートでループバックに戻る Claude Code | 警告付きで許可 | 許可(trusted-loopback) |
| 3 | https://vscode.dev/redirect を使う VS Code |
許可 | 許可(trusted) |
| 4 | 別ドメインで「Claude」を名乗る偽クライアント | 拒否 | 拒否(許可リスト外) |
| 5 | 信頼済み client_id だが redirect_uri が文書にない | 拒否 | 拒否 |
| 6 | 文書の client_id がURLと違う | 拒否 | 拒否 |
| 7 | 文書が client_secret_basic を宣言 |
拒否 | 拒否 |
| 8 | 文書に平文HTTPの非ループバックURIがある | 拒否 | 拒否 |
| 9〜13 | http、フラグメント付き、.. 付き、パスが /、userinfo 付きの client_id |
拒否 | 5件すべて拒否 |
| 14 | 正常な文書 | 取得 | 取得成功 |
| 15 | クラウドのメタデータIPへの302リダイレクト | 拒否 | 拒否(リダイレクトを追わない) |
| 16 | 6KBの文書 | 拒否 | 拒否(5KB超過) |
| 17 | 本番モードでループバックに解決されるホスト | 拒否 | 拒否 |
| 18〜21 | 10.0.0.5、169.254.169.254、100.64.1.1、fd00::1 に解決されるホスト | 拒否 | 4件すべて拒否 |
21ケースすべてで期待どおりでした。比較のため、urllib の既定動作のまま「client_id の一致」と「redirect_uri が載っているか」だけを確認する素朴な実装を、判定系8ケースと取得系2ケースで動かしたところ、正しかったのは10ケース中4ケースでした。
- 偽の「Claude」(ケース4)、共有シークレット方式(ケース7)、平文HTTPのリダイレクトURI(ケース8)を通してしまいました。
- 本物の Claude Code(ケース2)を拒否しました。
http://localhost:53122/callbackはhttp://localhost/callbackと文字列としては一致しないためです。厳しくする場所を間違えると、本物のクライアントが動かなくなります。 - 内部URLへのリダイレクトを追ってその応答を返し、6KBの文書も最後まで読み込みました。
テストの限界:ケースは自作で、判定系は実際の取得ではなく固定データを使い、言語も1つだけです。どのチェックが効くかは示せますが、特定の認可サーバーを保証するものではありません。
7. 認可サーバーの対応状況:Keycloak と Microsoft Entra
多くのチームは、ルールを自前で書くより既存の認可サーバーで設定することになるでしょう。ただ、対応状況はかなり違い、下の2製品はどちらもCIMDについてはまだ正式版ではありません。
| Keycloak | Microsoft Entra ID | |
|---|---|---|
| CIMDの状態 | 実験的機能。--features=cimd で有効化 |
パブリックプレビュー。本番ワークロードには推奨されていない |
| 許可リスト | クライアントポリシーの executor client-id-metadata-document の「Trusted domains」。空にすると全ドメインを拒否 |
CIMD URL用のテナント管理の許可・拒否リストはない。管理者がCIMDクライアントを事前に追加でき、テナントの同意ポリシーが適用される |
| その他の制御 | 「Restrict same domain」「Required properties」「Only Allow Confidential Client」、リソースインジケーターの許可リスト | 既定の同意ポリシーでは、ユーザーがCIMDクライアントに同意できるのは低リスクの権限だけ |
| 取得の制限 | キャッシュは最短300秒・最長259,200秒、文書は5,000バイトまで(既定値) | CIMDのページには記載なし |
| 手順が載っているクライアント | Claude Code、Claude Desktop、VS Code。ChatGPT の文書は token_endpoint_auth_methods_supported を使うため非対応 |
CIMDのページには記載なし |
Keycloak のクライアント別ページから、実務的な点を2つ挙げます。Claude Code ではリダイレクト先が claude.ai ではなく localhost なので、「Restrict same domain」をオフにする必要があります。これは5章の「ループバック」区分に当たります。Claude Desktop はメタデータに jwt-bearer グラントを含むため、「Accept Public Client with Confidential-only Grant Types」をオンにする必要があります。
使っている認可サーバーでCIMDの許可リストをまだ強制できないなら、CIMDを無効にして、承認したクライアントだけを事前登録するのが確実です。事前登録の一覧は、それ自体が許可リストになります。
8. 受け入れた後の防御層
クライアントを受け入れても、そのクライアントに何をさせてよいかは決まりません。それを決めるのは次の層で、CIMD、DCR、事前登録のどれで入ってきても同じように効きます。
| 層 | 制限するもの | 詳しい解説 |
|---|---|---|
| ツール単位のスコープと絞り込んだ tools/list | 受け入れたクライアントのトークンが呼べるツール | MCP OAuthサーバー実装ガイド |
| OAuthプロキシでのクライアントごとの同意 | 上流の同意Cookieを新しいクライアントに使い回されないか | MCPのConfused Deputy攻撃 |
| audience の検証 | 別リソース向けのトークンが自社サーバーで通らないか | MCP仕様:サーバーは audience を検証しなければならない(MUST) |
| 短いアクセストークン、リフレッシュトークンのローテーション | 誤って受け入れたクライアントのトークンが使える期間 | MCP仕様:公開クライアントのリフレッシュトークンはローテーション必須(MUST) |
| クライアントIDを含むログ | 実際にどのクライアントが接続しているか | 認可サーバーでトークンごとに client_id を記録する |
クライアント側の設定も大事です。ユーザーは各クライアントに正しいサーバーURLを登録する必要があります。Claude、Claude Code、VS Code などの接続方法はリモートMCPクライアント設定チートシートにまとめています。
9. チェックリスト(12項目)
- [ ] 接続を許すクライアントを決め、その一覧に担当者がいる
- [ ] 信頼ポリシーを強制できる場合にだけ
client_id_metadata_document_supportedを公開している - [ ] DCRは無効、または同じポリシーで守られている(開いた
/registerはCIMDの許可リストを素通りさせる) - [ ] 他社クライアントは client_id URLの完全一致で許可し、ドメインルールは自社ドメインだけに使っている
- [ ] 文書の client_id がURLと一致しなければ拒否し、リフレッシュトークンを失効させる
- [ ] リダイレクトURIは完全一致で照合し、ポートの例外は http のループバックURIに限っている
- [ ] CIMDクライアントの共有シークレット認証を拒否している
- [ ] メタデータ取得は特殊用途IPを遮断し、リダイレクトを追わず、5KBまでしか読まず、すぐタイムアウトする
- [ ] キャッシュした文書に有効期限の上限があり、エラーはキャッシュしない
- [ ] 同意画面に client_name だけでなく client_id とリダイレクトURIのホスト名を表示している
- [ ] ループバックのみのリダイレクトには警告を出し、黙って再同意しない
- [ ] 受け入れたクライアントにも最小権限のスコープを与え、トークンのログに client_id を残している
10. よくあるハマりどころ(症状→原因→対処)
| 症状 | 原因 | 対処 |
|---|---|---|
| 同意画面に「Claude」と出るが、実際は別のアプリ | client_name だけを表示している | client_id とリダイレクトURIのホスト名も表示し、client_id を完全一致で許可リスト化する |
| Claude Code が「invalid redirect_uri」で失敗する | ループバックURIをポート込みで完全一致させている | RFC 9700 に従い、http のループバックURIではポートを問わない |
| CIMDの許可リストを入れたのに、未知のクライアントが接続できる | DCRが開いたまま | /register を閉じるか、同じポリシーを適用する |
| 社内サービスに認可サーバーからのリクエストが届く | メタデータ取得がリダイレクトを追う、またはプライベートIPを取得している | 特殊用途IPを遮断し、リダイレクトを無効にし、解決したIPに固定する |
| 認可画面が固まる | メタデータ取得にタイムアウトがない | 短いタイムアウトと、有効な文書のキャッシュを入れる |
| 削除したクライアントが使え続ける | 長寿命のリフレッシュトークンがポリシー変更後も生きている | 一覧から外したら、そのクライアントのトークンを失効させる |
| Keycloak でCIMDを有効にしたら全部ブロックされた | 「Trusted domains」が空のまま | 承認したクライアントのドメインを追加する。空は全拒否を意味する |
| クライアントがリダイレクトURIを変えても誰も気づかない | 再取得したメタデータを黙って受け入れている | リダイレクトURIや鍵の変更を再同意のきっかけにする |
NodeFlareならこう解決できる
NodeFlareは、各MCPサーバーの前段に認証プロキシを置くMCPサーバーのホスティング基盤です。ドキュメントには Client ID Metadata Documents、Dynamic Client Registration、OAuthクライアント単位の許可リストについての記載がないため、この記事の信頼ポリシーそのものは認可サーバー側で持つことになります。NodeFlareが担うのはその周りの層です。この記事で挙げたリスクごとに、NodeFlareのドキュメントにある機能を対応させると次のとおりです。
| この記事のリスク | NodeFlareの機能 | NodeFlareのドキュメントにある内容 |
|---|---|---|
| 受け入れたクライアントが全ツールを呼べる(8章) | ツール単位のスコープ | tools:list、tools:call、tools:call:<ツール名>(例:tools:call:get_weather)、resources:read:<uri>、prompts:get:<name> などのスコープを、リクエストごとにMCPメソッドと対象に照らして確認。拒否された呼び出しはJSON-RPCエラーを返し、サーバーには届かない。tool_list_filter_by_scope を有効にすると、tools/list には呼べるツールだけが表示される |
| 自社の認可サーバーでクライアントの許可リストを強制したい(5〜7章) | 認証情報のパススルー | auth_enabled = false にすると、呼び出し元の認証情報がそのまま、自前で認証するサーバーに転送される。このモードでスコープが効くかはドキュメントに記載がないので、スコープはサーバー側でも確認する |
| そもそも未知のアプリがエンドポイントに届く | 受信IPの許可リスト | restricted ポリシーで許可するIPv4/IPv6のCIDRを指定し、認証より前にプロキシで適用。空のリストは全拒否。ネットワークアクセス制限はProプランの機能。Claude などのホスト型クライアントは提供元のIP範囲から接続するため、社内エージェント向けに向いている |
| OAuthを通らずにAPIキーを総当たりされる | 総当たり対策のロック | 5分間に10回失敗すると、その送信元IPを10分間ロック |
| メタデータ取得(またはサーバー自身)が内部アドレスに届く(4章) | ネットワーク分離とEgress制御 | 各サーバーは専用の Firecracker microVM で動き、ホストのファイアウォールがテナントVMから内部サブネット、169.254.x のメタデータアドレス、他テナントへの通信を遮断。Egressは off(既定)、observe、enforce の3モードで、最大100件(ホスト名の完全一致、先頭1つのワイルドカード、IP) |
| どのクライアントが実際に接続しているか分からない | リクエストログ | caller_kind(api_key、oauth、anonymous)、user_agent、client_ip、tool_name、outcome、arg_keys(引数名のみ)などを記録。保持期間は Free が7日、Pro と Team が30日 |
| 自社エージェントの署名鍵やクライアント認証情報の漏えい | 暗号化されたシークレット | 値ごとに AES-256-GCM の鍵で暗号化し、その鍵をテナント固有の鍵(OpenBao Transit)でラップ。VM起動時に環境変数としてのみ注入 |
NodeFlareがしないこと:クライアントのメタデータ文書の取得や検証、同意画面の表示、「このクライアントが本当に Claude か」の判定は行いません。ユーザーが偽のクライアントを承認してしまうことも防げません。これらの判断は認可サーバーに任せ、NodeFlareはスコープ、ネットワーク制限、ログに使ってください。
最小の始め方:
- MCPサーバーをNodeFlareにデプロイし、認可サーバー側では5章の信頼ポリシー(または承認クライアントの事前登録)を維持する。
- 社内エージェントには1つずつAPIキーを発行し、必要なツールだけの
tools:call:<ツール名>に絞り、IP許可リストにそのエージェントの送信元アドレスを登録する。 - 1週間ほどリクエストログの
caller_kindとuser_agentを見て、実際に接続しているクライアントを把握する。
NodeFlareは1サーバーまで無料で試せます:nodeflare.tech
よくある質問
MCPサーバーに接続できるクライアントを制限するには?
認可サーバーで信頼ポリシーを強制します。Claude や VS Code などの他社クライアントは Client ID Metadata Document のURLを完全一致で許可リストに載せ、自社のクライアントは事前登録し、Dynamic Client Registration は閉じるか制限します。そのうえで、受け入れたクライアントには最小権限のスコープを与えます。
MCPの Client ID Metadata Document(CIMD)とは?
HTTPSのURLに置かれたJSON文書で、そのURL自体がクライアントのOAuth client_id になります。認可サーバーはこれを取得して、クライアント名やリダイレクトURIを確認します。2026-07-28版のMCP仕様では、クライアントと認可サーバーは対応すべき(SHOULD)とされ、Dynamic Client Registration に代わる標準になりました。
CIMDで、そのクライアントが本当に Claude や VS Code だと証明できますか?
一部だけです。証明できるのは、ドメインの管理者がその文書を公開したことです。リダイレクトURIがそのドメイン上のHTTPS URLなら、認可コードはそのドメインにしか届きません。リダイレクトURIが localhost の場合は、ローカルの任意のプログラムが同じ client_id を名乗れます。仕様も、CIMDだけでは localhost のなりすましを防げないとしています。
MCPの Dynamic Client Registration は非推奨ですか?
はい。2026-07-28版の仕様では、DCRは非推奨とされ、CIMDに対応していない認可サーバーとの後方互換のために残されています。有効のままにするなら同じクライアントポリシーを適用しないと、CIMDの許可リストを迂回されます。
CIMDにはどんなSSRFのリスクがありますか?
認可サーバーが、クライアントの選んだURLを取得しに行く点です。CIMDドラフトでは、特殊用途IPに解決されるURLを取得してはならず、HTTPリダイレクトを追ってはならず、読み込みは5KB程度までとすべきとされています。DNSリバインディングを避けるため、解決したIPに固定するかEgressプロキシを使いましょう。
MCPのOAuthで使われる Claude の client_id は?
2026年11月22日時点で、Claude の文書は https://claude.ai/oauth/mcp-oauth-client-metadata にあり、リダイレクトURIは https://claude.ai/api/mcp/auth_callback でした。Claude Code は https://claude.ai/oauth/claude-code-client-metadata で、リダイレクトURIは localhost です。内容は変わり得るので、許可リストに載せる前に実際の文書を確認してください。
Claude Code が自社のMCP認可サーバーで失敗するのはなぜ?
よくある原因はリダイレクトURIの照合です。Claude Code はポートなしの http://localhost/callback を登録し、実際にはランダムなポートを使います。RFC 9700 とCIMDドラフトはループバックのリダイレクトで任意のポートを認めているので、認可サーバーはループバックURIをポートを除いて比較する必要があります。
MCPクライアントはドメイン単位とURL単位、どちらで許可すべき?
他社クライアントはclient_id URLの完全一致で、ドメイン単位のルールは自社が管理するドメインだけに使いましょう。URL単位にしておけば、同じベンダーのドメインに審査前の新しいクライアントが現れても、自動的に信頼されることはありません。
Keycloak は Client ID Metadata Documents に対応していますか?
はい。--features=cimd で有効にする実験的機能として対応しています。クライアントポリシーの executor で「Trusted domains」を設定し、空にすると全ドメインが拒否されます。Claude Code、Claude Desktop、VS Code の設定手順が公開されており、ChatGPT の文書には非対応と書かれています。
Microsoft Entra ID はMCPクライアントのCIMDに対応していますか?
パブリックプレビューで対応しており、Microsoft は本番ワークロードには推奨していません。CIMD URL用のテナント管理の許可リストはなく、管理者がCIMDクライアントを事前に追加でき、ユーザーが何を承認できるかはテナントの同意ポリシーで決まります。
IP許可リストがあればクライアントの許可リストは不要ですか?
不要にはなりません。IPのルールはリクエストの送信元を、クライアントの許可リストはトークンを得られるOAuthクライアントを制限するもので、役割が違います。ホスト型のクライアントは提供元のIP範囲を共有しているため、IPだけでは同じ基盤上の別アプリと区別できません。使える場面では両方を組み合わせます。
まとめ
MCPクライアントの許可リストは、どのアプリがユーザーにアクセス許可を求めてよいかを決めるMCP Securityの制御です。2026-07-28版の仕様では、Client ID Metadata Documents によって各クライアントに許可リスト化できるURLが与えられましたが、信頼ポリシーは任意で、作るのは認可サーバーの運用者です。client_id は完全一致で許可し、Dynamic Client Registration は閉じるか制限し、メタデータはリダイレクトを追わず、プライベートIPに行かず、大きな応答を読まずに取得し、ループバックのリダイレクトは弱い区分として扱います。CIMDでは localhost のなりすましを防げないからです。今回の検証では、これらのチェックで21ケースすべてを正しく判定でき、素朴な実装は10ケース中4ケースにとどまり、本物の Claude Code まで拒否しました。受け入れた後は、スコープとログが残りを決めます。
参考資料(一次情報)
- MCP仕様 2026-07-28、Authorization:https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization
- MCP仕様 2026-07-28、Client Registration:https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization/client-registration
- MCP仕様 2026-07-28、Authorization Security Considerations:https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization/security-considerations
- IETF、OAuth Client ID Metadata Document(draft-ietf-oauth-client-id-metadata-document-03):https://datatracker.ietf.org/doc/draft-ietf-oauth-client-id-metadata-document/
- MCP公式ブログ、Evolving OAuth Client Registration in the Model Context Protocol:https://blog.modelcontextprotocol.io/posts/client_registration/
- RFC 9700、OAuth 2.0 Security Best Current Practice:https://www.rfc-editor.org/rfc/rfc9700
- Keycloak、Integrating with Model Context Protocol (MCP):https://www.keycloak.org/securing-apps/mcp-authz-server
- Microsoft Learn、Client ID Metadata Documents in Microsoft Entra ID:https://learn.microsoft.com/en-us/entra/agent-id/client-id-metadata-documents
- NodeFlare ドキュメント:https://nodeflare.tech/docs
