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への要求を増やす問題が直ります。

参考資料

検証環境

  • 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が調査と下書きを担当し、上記の環境で実際に動かして結果を確かめ、下書きとは別の担当が公開前に本文と出典を確認しています。制作と訂正の方針は編集・訂正方針で公開しています。