FastMCP 4.2.1の認証の修正を4.2.0と比べて検証|有効になる前のJWT、消えていたスコープ要件、client_secretの送り先
FastMCP 4.2.1は認証まわりを直したセキュリティ更新
PythonでMCPのサーバーとクライアントを作るライブラリ「FastMCP」の4.2.1が、日本時間2026年11月18日の早朝に公開されました(4.2.1のリリースノート、PyPIの4.2.1)。MCP(Model Context Protocol)は、AIのアプリが外部のツールやデータにつながるための共通の仕組みです。FastMCPはPrefectが開発しているオープンソースのライブラリで、数行のPythonでMCPサーバーを書けます。
リリースノートは4.2.1を、4.2.0に対するセキュリティと正しさの修正と説明しています。修正の中心は認証です。JWT(署名付きのアクセストークン)の確かめ方と、Supabaseなどのプロバイダーに自作の検証器を渡したときのスコープの確認が直りました。事前に登録したOAuthクライアントには、秘密(client_secret)を送る認可サーバーを固定する指定(issuer)が加わりました。
この記事では、PyPIから4.2.0と4.2.1を別々の仮想環境に入れ、同じ検証用のサーバーとクライアントを手元で動かして比べました。当てはまるコードの書き方、4.2.0で起きたこと、更新の手順と更新後に確かめることを順に説明します。
要点
認証を使うFastMCPのサーバーとクライアントは4.2.1へ。client_secretを渡すクライアントは、issuerの指定も書き足す
4.2.0と4.2.1を、同じ検証用のコードで比べた結果です。
有効になる前のJWT
nbfが1時間後のトークンを、4.2.0は通し、4.2.1は401で断った
nbfは、JWTに書く「この時刻より前は無効」という項目です。4.2.1は30秒までのずれを許します。
自作の検証器とスコープ
required_scopesにadminを指定しても、4.2.0はreadだけのトークンを通した
SupabaseProviderなど6つのプロバイダーに、自作のtoken_verifierを渡した場合です。4.2.1は403で断りました。
client_secretの送り先
4.2.1でissuerを指定すると、MCPサーバーがissuerと違う認可サーバーを案内したとき、1件も送らずに止まった
issuerを指定しないと、4.2.1でも、MCPサーバーが案内した別の認可サーバーへclient_secretが届きました。
IdPへの問い合わせ
MCPサーバーの公開の/.well-knownへ50回GETすると、IdPへの問い合わせが50回から1回に減った
Supabase・Auth0MCPなど6つのプロバイダーを使うサーバーで、4.2.1はIdPから取ってきた設定情報を5分間覚えて返します。
4.2.0と4.2.1を同じ手順で比べた結果
検証では、FastMCPで立てたMCPサーバーで、JWTとスコープの確認と、IdP(ログインやトークンの発行を受け持つサービス)の設定情報の取り次ぎを試しました。OAuthのクライアントは、MCPサーバーが別の認可サーバーを案内する状況を作って試しました。IdPと認可サーバーの役は、受けた要求を記録するだけの小さなプログラムで、すべて手元のMac(127.0.0.1)の中で動かしています。
表の見方:1行が1つの修正です。右端の列の書き方をしているコードが、その修正の対象になります。
| 確かめたこと | 4.2.0 | 4.2.1 | 当てはまる書き方 |
|---|---|---|---|
| nbfが1時間後のJWT | 200(通した) | 401(断った) | JWTVerifierでトークンを確かめるサーバー(SupabaseProviderなど、内部でJWTVerifierを作るプロバイダーを含む) |
| required_scopesにadmin、トークンのスコープはreadだけ | 200(通した) | 403(スコープ不足) | AuthKit・Supabase・Keycloak・Scalekit・Descope・Auth0MCPのプロバイダーに、required_scopesとtoken_verifierを両方渡すサーバー |
MCPサーバーが別の認可サーバーを案内し、クライアントはissuerを指定 |
issuerを渡せずTypeError。渡さないと案内先にclient_secretが届いた |
送る前にOAuthFlowError(案内先への要求0件) |
client_idとclient_secretを渡すOAuthクライアント |
ログインなしで/.well-known/oauth-authorization-serverを50回GET |
IdPへ50回 | IdPへ1回 | Auth0MCP・AuthKit・PropelAuth・Scalekit・Supabase・Descopeのプロバイダーを使うサーバー |
| 同意を覚える設定で、readとread writeを求めた場合 | 同じ同意の記録として扱う | 別の同意の記録として扱う | OAuthProxyのrequire_authorization_consent="remember" |
| ツール名「get forecast」のSKILL.md | call-tool get forecast |
call-tool 'get forecast' |
fastmcp generate-cliで書き出したファイル |
1・2・4・5行目は、4.2.1へ上げるとサーバーやクライアントの振る舞いが変わります。3行目は上げたうえでissuerを書き足したとき、6行目は4.2.1のgenerate-cliで書き出し直したときに効きます。
まだ有効になっていないJWTを、4.2.1は401で断る
JWTには、有効期限(exp)のほかに、「この時刻より前は無効」を示すnbf(not before)という項目を入れられます。翌日から使わせるトークンを前日のうちに発行しておく、といった使い方です。
4.2.0までのJWTVerifier(FastMCPでJWTを確かめるクラス)は、有効期限は確かめていましたが、nbfは見ていませんでした(修正のプルリクエスト#6512)。JWTVerifierだけで守るMCPサーバーに、nbfの違うトークンを送って、最初の要求(initialize)の応答を比べました。
nbfなし
4.2.0:200
4.2.1:200
nbfが1時間後
4.2.0:200
4.2.1:401
nbfが60秒後
4.2.0:200
4.2.1:401
nbfが20秒後
4.2.0:200
4.2.1:200
4.2.1は、nbfが今から30秒より先のトークンを断ります。30秒の余裕は、時計が少し進んでいる発行元のトークンを、発行した直後に断らないためのものです。20秒後のトークンが4.2.1で通ったのは、この余裕の内側だからです。
この修正の対象は、JWTVerifierでトークンを確かめるサーバーです。SupabaseProviderのように、検証器を渡さないときに内部でJWTVerifierを作るプロバイダーも含みます。nbfを先の時刻にしてトークンを発行している仕組みがあれば、4.2.1ではそのトークンが、nbfに書いた時刻の30秒前まで401になります。
token_verifierを渡しても、required_scopesが効くようになった
スコープは、トークンに「何をしてよいか」を書いておく仕組みです。FastMCPのプロバイダーにrequired_scopes=["admin"]と書くと、adminのスコープを持たないトークンをMCPサーバーの入口で断ります。
4.2.0では、AuthKitProvider、SupabaseProvider、KeycloakAuthProvider、ScalekitProvider、DescopeProvider、Auth0MCPProviderの6つで、自作の検証器(token_verifier)を一緒に渡すと、プロバイダーに書いたrequired_scopesが使われていませんでした(#6535)。入口で確かめるスコープは、検証器の側の設定だけで決まっていました。手元では、次のサーバーで比べました。
from fastmcp import FastMCP
from fastmcp.server.auth.providers.jwt import JWTVerifier
from fastmcp.server.auth.providers.supabase import SupabaseProvider
auth = SupabaseProvider(
project_url="http://127.0.0.1:8001", # 手元の偽のIdP
base_url="http://127.0.0.1:8000",
required_scopes=["admin"],
token_verifier=JWTVerifier(public_key=public_key, issuer=ISS, audience=AUD),
) # public_key・ISS・AUDは、検証用の公開鍵と発行元・宛先の値
mcp = FastMCP("auth-check", auth=auth)
4.2.0のサーバーが持っていたrequired_scopesは空で、スコープがreadだけのトークンも200で通りました。4.2.1では['admin']が残り、同じトークンに403(error="insufficient_scope"、Required scope: admin)を返しました。readとadminの両方を持つトークンは、どちらの版でも通りました。
Keycloakの既定のスコープ(openid)は、既定の検証器を使うときだけ加わるので、自作の検証器を渡しているKeycloakのサーバーは、4.2.1へ上げてもopenidを求めません。
この組み合わせで動かしているサーバーは、4.2.1へ上げると、必要なスコープを持たないクライアントを403で止めるようになります。上げる前に、使っているクライアントのトークンにrequired_scopesのスコープが入っているかを確かめておくと、更新後に急に接続できなくなる事態を避けられます。
client_secretは、issuerで決めた認可サーバーにだけ送る
ここからはクライアント側の修正です。FastMCPのOAuthクラスは、MCPサーバーへOAuthでログインするためのクラスで、認可サーバーに事前に登録したclient_idとclient_secretを渡せます。
MCPの認証では、どの認可サーバーへ行くかを、つなぎ先のMCPサーバーが案内します。4.2.0のOAuthクラスは、案内された認可サーバーへ、事前登録の資格情報をそのまま送っていました。FastMCPのドキュメントは、悪意のある、または乗っ取られたMCPサーバーが自分の認可サーバーを案内すれば、client_secretを集められると説明しています(OAuthクライアントのドキュメント、#6536)。
手元では、別の認可サーバーを案内するMCPサーバーを作り、案内先の認可サーバーに届いた要求を記録しました。ブラウザーでのログインは、認可のURLを開いてリダイレクトに従うだけの関数で置き換えています。
4.2.0
案内先の/tokenにclient_secretが届いた
issuerの引数はなく、渡すとTypeErrorになります。
4.2.1・issuerなし
4.2.0と同じく、案内先にclient_secretが届いた
更新しただけでは、送り先の確認は働きません。
4.2.1・issuerあり
案内先が違うと分かった時点で止まり、要求は0件
内部でOAuthFlowErrorが起き、接続をやめました。
4.2.1で止まったときは、内部でOAuthFlowErrorが起き、Clientの呼び出し側にはRuntimeError: Client failed to connect: The MCP server advertises authorization server ...として届きました。issuerに案内先と同じ認可サーバーを指定した場合は、これまでどおりの流れで進みました。issuerには、client_idを登録した認可サーバーのメタデータ(/.well-known/oauth-authorization-server)にあるissuerの値を書きます。
from fastmcp import Client
from fastmcp.client.auth import OAuth
async with Client(
"https://mcp.example.com/mcp",
auth=OAuth(
client_id="my-registered-client-id",
client_secret="my-client-secret",
issuer="https://auth.example.com", # 4.2.1で追加された引数
),
) as client:
await client.list_tools()
client_secretを渡しているクライアントは、4.2.1への更新と合わせて、このissuerを書き足します。issuerが防ぐのは、これから先の送信です。issuerを指定しないまま、自分で管理していないMCPサーバーへclient_secret付きでつないだことがあるなら、認可サーバーの側でclient_secretを作り直しておきます。
公開の/.well-knownへのGETが、IdPへの問い合わせを増やさなくなった
Auth0MCP、AuthKit、PropelAuth、Scalekit、Supabase、Descopeのプロバイダーは、MCPサーバーに/.well-known/oauth-authorization-serverという公開の窓口を作り、IdPから取ってきた設定情報(メタデータ)を返します。クライアントはこの情報から、ログインに使うURLを知ります。4.2.0では、この窓口へのGETのたびにIdPへ取りに行っていました。ログインしていない誰でも、GETを繰り返すだけで、運営者のIdPへ同じ数の要求を送らせられます(#6531)。
ログインなしのGETを50回送ったとき、IdPに届いたメタデータの要求
4.2.0
50回
4.2.1
1回
SupabaseProviderのサーバーで計測。50回の応答はどちらの版もすべて200でした。
4.2.1は、取ってきたメタデータを5分間覚えて返し、IdPへ取りに行く処理は同時に1つだけにします。取得に失敗したときは、直前に取れたメタデータを返し、5秒あけてから取り直します。一度取れていれば、IdPがアクセスの多さで応答を絞った場合も、MCPのクライアントは直前のメタデータでログインの入口を見つけられます。
OAuth Proxyの「同意を覚える」設定と、そのほかの修正
ここまでの4つのほかに、4.2.1には次の修正も入っています。修正の全体はリリースノートにあります。メタデータの取り次ぎ、同意の記録、upstream_claimsの更新、URIテンプレートの修正の4件は、Microsoftの監査(MDASH)で見つかった項目だと、プルリクエストに書かれています。
OAuthProxyの同意を覚える設定は、スコープの組み合わせごとに記録する
OAuthProxy(外部のOAuthサービスとMCPのクライアントを仲立ちするクラス)でrequire_authorization_consent="remember"にすると、一度承認したクライアントは次から同意画面なしで通ります。4.2.0は、readを承認したクライアントがあとでread writeを求めても、同意画面を出さずに通していました(#6530)。4.2.1は、クライアント、redirect URI(クエリを含む)、スコープの組み合わせごとに記録します。手元で記録のキーを作る関数を呼ぶと、readとread writeで4.2.0は同じキー、4.2.1は別のキーになりました。更新後は、利用者に同意画面がクライアントごとにもう一度出ます。既定のTrue(毎回確認する)は変わりません。
OAuthProxyが上流のトークンを更新したとき、upstream_claimsも新しくする
OAuthProxyを使うプロバイダーのうち、AzureProviderのように上流のOAuthサービスのトークンから中身(クレーム)を取り出すものは、それをFastMCPが発行するトークンのupstream_claimsに入れて渡します。4.2.0では、期限の切れた上流のトークンを裏で更新しても、upstream_claimsは最初に発行したときのままでした(#6532)。IdPで利用者の役割を減らしても、FastMCPのトークンの期限が切れるまで古い役割が残ります。4.2.1は、更新のたびに取り直したクレームを使います。AzureProviderなどでupstream_claimsを使って権限を判断しているサーバーが対象です。
generate-cliのSKILL.mdで、ツール名を引用符で囲む
fastmcp generate-cliは、MCPサーバーを呼ぶコマンドラインのスクリプトと、AIのエージェント向けの説明書(SKILL.md)を書き出します。ツール名に空白があると、SKILL.mdのコマンドが書かれたとおりには動きませんでした(#6534)。手元で、4.2.0の書き方(call-tool get forecast)はUnknown command "get"になり、4.2.1の書き方(call-tool 'get forecast')は結果を返しました。4.2.0で書き出したSKILL.mdは、4.2.1へ上げても書き換わりません。ツール名に空白などを含むサーバーは、fastmcp generate-cli <サーバー> cli.py -fで書き出し直します。ファイルがすでにあると、-fなしでは止まります。-fはcli.pyも書き直すので、手で直したところがあれば先に控えておきます。4.2のスキル配信はFastMCP 4.2のスキル配信の記事で扱っています。
opentelemetry-apiの必要な版を引き上げた
トレースの情報を運ぶヘッダー(traceparent)の処理で、正規表現が長く止まる問題(ReDoS)を直した版(1.45.2)以上を求めます。リリースノートは、pipで入れていてopentelemetry-sdkも使っている場合、FastMCPと一緒に更新するよう案内しています。
このほか、プロキシ先のMCPサーバーが細工したURIテンプレートで、正規表現の処理が長く止まる問題も直っています(#6533)。
4.2.1へ更新する手順と、更新後に確かめること
更新そのものは、パッケージを上げるだけです。版を確かめてから上げ、当てはまる書き方があれば設定を見直します。
手順1
いま動いている版を確かめる
fastmcp version
1行目にFastMCP version:と版が出ます。手元の4.2.0では、続けて「FastMCP update available: 4.2.1」と更新の案内も出ました。
手順2
4.2.1へ上げる
# uvのプロジェクト
uv add "fastmcp>=4.2.1"
# pip
pip install -U fastmcp
# pip で、opentelemetry-sdkも入っている環境
pip install -U fastmcp opentelemetry-sdk
# さらにexporterも入っている環境は、入っているものを並べる(例はotlp)
pip install -U fastmcp opentelemetry-sdk opentelemetry-exporter-otlp
uvのプロジェクトで4.2.0からuv add "fastmcp>=4.2.1"を実行すると、pyproject.tomlの指定が書き換わり、4.2.1が入りました。pipでopentelemetry-sdkも入っている環境は、2つを一緒に上げます。FastMCPのプルリクエスト#6513によると、opentelemetry-sdkは対応するopentelemetry-apiの版を固定しているので、fastmcpだけを上げると古いsdkが読み込みで失敗します。同じプルリクエストは、opentelemetry-exporterのパッケージも一緒に上げるよう書いています。
手順3
もう一度fastmcp versionで4.2.1を確かめる
サーバーを動かしている環境(コンテナーやデプロイ先)でも同じコマンドで確かめます。
更新後に確かめること
required_scopesとtoken_verifierを両方渡しているサーバー:クライアントのトークンに、そのスコープが入っているか。403のinsufficient_scopeが出たら、トークンを発行する側のスコープの設定を見直します- nbfを先の時刻にしてトークンを発行している仕組み:nbfに書いた時刻の30秒前までは401になります
client_secretを渡すクライアント:issuerを書き足したかrequire_authorization_consent="remember"のサーバー:利用者に、同意画面がもう一度出ることを伝えたかgenerate-cliで書き出したSKILL.md:ツール名に空白などがあれば、4.2.1で-fを付けて書き出し直したか
チェックリストのどれにも当てはまらなくても、4.2.1へ上げるだけで、JWTVerifierでトークンを確かめるサーバーはnbfの確認漏れが、Auth0MCP・AuthKit・PropelAuth・Scalekit・Supabase・Descopeのプロバイダーを使うサーバーは公開の窓口がIdPへの要求を増やす問題が直ります。
参考資料
- FastMCP 4.2.1のリリースノート
- PyPIのfastmcp 4.2.1
- 修正のプルリクエスト: #6512(nbf)、#6535(required_scopes)、#6536(issuer)、#6531(メタデータの取り次ぎ)、#6530(同意の記録)、#6532(upstream_claims)、#6534(SKILL.md)、#6513(opentelemetry-api)
- FastMCPのドキュメント:OAuthクライアント
- FastMCPのドキュメント:OAuth Proxy
検証環境
- macOS 27.2.1(Apple Silicon)、Python 3.13.14、uv 0.11.32
- FastMCP 4.2.0・4.2.1(PyPI、どちらもMCPのPython SDK 2.3.0)
- 検証日: 2026年11月18日
この記事は、AIが調査と下書きを担当し、上記の環境で実際に動かして結果を確かめ、下書きとは別の担当が公開前に本文と出典を確認しています。制作と訂正の方針は編集・訂正方針で公開しています。












