0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

MCPサーバーに関して⑧:リモートMCPサーバーとデプロイ

0
Last updated at Posted at 2026-11-19

MCPサーバーに関して⑧:リモートMCPサーバーとデプロイ

連載⑤〜⑦ではローカルで動くサーバー(stdioトランスポート)を作りました。今回はそれをネットワーク越しに公開するリモートMCPサーバーにします。Streamable HTTPの仕組み、AWSでのホスティングの選び方、認証の基本を解説します。

この記事はMCP仕様の最新版 2026-07-28 をもとに書いています。この版でプロトコルはステートレスになり、セッションや初期ハンドシェイクがなくなりました。連載②で紹介したセッションIDの管理は、最新版では不要です。

この記事で分かること

  • stdioとStreamable HTTPの違い
  • Streamable HTTP(仕様 2026-07-28)の通信の流れ
  • 最小のサーバーをHTTPで公開するコード(Python)
  • AWSでのホスティングの選び方(ECS Fargate / Lambda / App Runner)
  • 認証(OAuth 2.1)の基本と、デプロイ時のつまずきやすい点

まず整理:stdioとStreamable HTTPの違い

連載②でも触れたとおり、MCPのトランスポートは標準で2つだけです。ローカルでクライアントが子プロセスとして起動するのがstdio、ネットワーク越しに使うのがStreamable HTTPです。

stdio Streamable HTTP
動く場所 クライアントと同じマシン どこでも
通信 標準入出力 HTTP POST(1つのエンドポイント)
利用者 自分だけ 複数人で共有できる
認証 不要(環境変数で済む) 必要(公開する以上、誰でも呼べる)

リモート化で一番変わるのは、サーバーが常駐プロセスになることです。stdioでは使うたびに起動・終了しますが、リモートでは常に待ち受け、複数のクライアントをさばきます。

Streamable HTTPの仕組み(仕様 2026-07-28)

Streamable HTTPは、2025-03-26で旧来のHTTP+SSEに代わって導入されたトランスポートです。仕組みはシンプルです。

  • サーバーは1つのMCPエンドポイント(例:https://example.com/mcp)を用意し、POSTだけを受け付けます。
  • クライアントはJSON-RPCのメッセージ1件ごとに、新しいPOSTを送ります。
  • サーバーはリクエストごとに、単一のJSONか、そのリクエスト専用のSSEストリームのどちらかで答えます。進捗通知はSSEの中に載ります。
  • 2026-07-28ではプロトコルレベルのセッションがありません。Mcp-Session-Idも初期ハンドシェイクも廃止され、どのリクエストもどのインスタンスでも処理できます。

リクエストには、本文の内容を映したヘッダーも付きます。MCP-Protocol-Version(本文の_metaと一致しないと400エラー)、Mcp-Method(全リクエストに必須)、Mcp-Name(tools/callなどで必須)の3つです。ゲートウェイはJSONの中身を開かずに振り分けや認可ができます。

セキュリティの決まりも2つあります。

  • Originヘッダーを検証すること。 DNSリバインディング攻撃を防ぐため、不正なOriginは403で拒否します。
  • ローカルで動かすときはlocalhostだけにバインドすること。 0.0.0.0で全インターフェースに開くのは避けます。

一覧変更の通知は、クライアントがsubscriptions/listenで開くストリームで受け取ります。サーバーからの確認(サンプリングやエリシテーション)は、MRTRという仕組みで結果の中に埋め込みます。常時開きっぱなしの双方向ストリームは不要です。

最小のサーバーをHTTPで公開する

ツールの中身は⑤〜⑦と同じで、変えるのはトランスポートだけです。Python SDKでは、サーバーの起動方法を決めるのは mcp.run() で、トランスポートはその引数で切り替えます。

from mcp.server import MCPServer

mcp = MCPServer("handbook")

@mcp.tool()
def greet(name: str) -> str:
    """名前を渡すと挨拶文を返す。"""
    return f"こんにちは、{name}さん"

if __name__ == "__main__":
    mcp.run(transport="streamable-http", host="127.0.0.1", port=8000, streamable_http_path="/mcp")

ポイントは3つです。

  • 引数なしの mcp.run() はstdio、transport="streamable-http" でHTTPサーバーになります。 host(既定 127.0.0.1)、port(既定 8000)、streamable_http_path(既定 /mcp)も run() の引数です。裏側ではStarletteのアプリがuvicornで動きます。
  • トランスポートの指定はコンストラクタではなく run() に渡します。 MCPServer("handbook", port=8000) のように書くと、MCP以前にPythonの TypeError で落ちます。コンストラクタには名前やバージョンなど「サーバーが何か」を、run() には「どう公開するか」を書く、と覚えます。
  • 状態はインスタンスに持たせません。 2026-07-28ではセッションがなく、リクエストは1件ごとに完結します。ツールが要する情報は引数で受け渡し、残したい状態は外部のDBなどに置きます。

クライアント側はURLを書くだけです。Claude Codeなら次のように追加できます。

claude mcp add --transport http handbook http://127.0.0.1:8000/mcp

公開時に必須:HostとOriginの許可リスト

Python SDKは、既定でDNSリバインディング保護が有効です。許可される Host ヘッダーは 127.0.0.1 や localhost などローカル向けだけに絞られていて、実在のホスト名で公開すると全リクエストが 421 Misdirected Request で拒否されます。公開時は transport_security で許可リストを明示します。transport_security は mcp.run() のキーワード引数としても渡せますが、ここではデプロイで使うアプリ取り出し形(mcp.streamable_http_app() でASGIアプリを取り出す形)で書きます。

from mcp.server import MCPServer
from mcp.server.transport_security import TransportSecuritySettings

mcp = MCPServer("handbook")

@mcp.tool()
def greet(name: str) -> str:
    """名前を渡すと挨拶文を返す。"""
    return f"こんにちは、{name}さん"

security = TransportSecuritySettings(
    allowed_hosts=["mcp.example.com", "mcp.example.com:*"],
    allowed_origins=["https://app.example.com"],
)

app = mcp.streamable_http_app(transport_security=security)
  • allowed_hosts は完全一致の文字列で、"mcp.example.com" はポートなしの Host、"mcp.example.com:*" は任意のポートに一致します。両方書くのが基本です。
  • allowed_origins はブラウザ対策です。Origin を送るのはブラウザだけなので、ブラウザから直接呼ばないサーバーでは影響しません。不正なOriginは403で拒否されます。
  • host="0.0.0.0" のようにlocalhost以外を run() に渡しても、許可リストにはなりません。むしろ保護そのものが外れて、あらゆるHostとOriginを通してしまいます。許可したい名前は transport_security で言うのが正解です。
  • 前段のリバースプロキシが Host を管理している構成なら、TransportSecuritySettings(enable_dns_rebinding_protection=False) で検証を切る選択肢もあります。

複数ワーカーで動かすとき

streamable_http_app() で取り出したアプリは、通常のASGIアプリと同じようにスケールできます。uvicornのワーカーで増やすのが基本形です。

uvicorn server:app --workers 4

2026-07-28のクライアント相手なら、どのリクエストがどのワーカーに届いても問題ありません。セッション自体がないためです。ワーカーのメモリにセッションが残るのは、2025-11-25以前のレガシーなクライアントを相手にする場合だけで、そのときはスティッキーセッションにするか、stateless_http=True を渡してセッションなしに寄せます(その代わり、サーバーからクライアントへの確認などの双方向通信は使えなくなります)。

AWSでのホスティングの選び方

サーバーを常駐させるAWSの代表的な3つの選択肢を比べます。いずれも作ったPythonアプリをどう載せるかの違いで、ECSとApp Runnerはコンテナでアプリを起動する形、Lambdaは関数として実行する形です。決め手は**「リクエストがどれくらい長く続くか」**です。ツール呼び出しは数秒で終わることもあれば、SSEストリームで長く開き続けることもあります。

ECS on Fargate Lambda App Runner
形態 常駐コンテナ 関数(イベント駆動) 常駐コンテナ(マネージド)
長いリクエスト 制限なし。タスクが生きている限り続く 最大15分(1回の呼び出し)。Function URLならそのまま使える 120秒で打ち切られる(変更不可)
前段の注意点 ALBのアイドルタイムアウトは既定60秒。1〜4,000秒まで設定できる API Gateway(REST)経由は既定で29秒。Function URLで回避 設定項目が少なく、HTTPSのURLが最初から付く

選び方の目安はこうなります。

  • まず試すならApp Runner。 イメージを渡すだけでHTTPSのURLが付きます。ただし120秒の壁があり、長い処理や開きっぱなしのストリームには向きません。
  • 呼び出しが短く、利用がまばらならLambda。 Function URLでAPI Gatewayの29秒の壁を避けられ、SSEにはレスポンスストリーミングを使います。
  • 本番で腰を据えるならECS on Fargate。 コンテナでは uvicorn server:app でアプリを起動します。常駐コンテナで時間制限がなく、ALBのタイムアウトも調整できます。設定の手間と引き換えに自由度が一番高くなります。

認証の基本:OAuth 2.1

公開したら次は「誰が呼べるか」です。MCPの認可仕様はOAuth 2.1が土台で、HTTPのサーバーはこれに沿うことが求められます(stdioのサーバーは対象外で、環境変数から認証情報を取ります)。

流れは、よくあるOAuthとほぼ同じです。

仕組みの要点は次の4つです。

  • サーバーはリソースサーバー。 トークンを発行するのは別の認可サーバーで、MCPサーバーは検証だけをします。
  • 発見はメタデータで。 未認証のリクエストに401を返し、/.well-known/oauth-protected-resourceのメタデータ(RFC 9728)で「どの認可サーバーを使うか」を教えます。
  • クライアントの登録はCIMDが推奨。 2026-07-28では従来の動的クライアント登録(DCR)は非推奨で、Client ID Metadata Documents(CIMD) が推奨です。クライアントの情報を置いたHTTPSのURLをclient_idとして使います。
  • トークンはサーバーにひも付ける。 クライアントは認可要求とトークン要求の両方でresourceパラメータ(RFC 8707)を送り、トークンが「このサーバー宛て」であることを示します。サーバーは自分宛てでないトークンを拒否します。

認可サーバーを自作する必要はありません。Amazon CognitoなどのIdPや既存の認可サーバーを使うのが現実的です。詳細な実装は次回⑨で掘り下げます。

デプロイ時のつまずきやすい点

つまずき 原因 対策
SSEが届かない・遅れる 途中のプロキシがレスポンスをため込む X-Accel-Buffering: noを返す。ALBのタイムアウトも確認する
長い処理が途中で切れる 前段のタイムアウト(App Runner 120秒、API Gateway 29秒など) 上限に合わせて選ぶ。長時間の処理はタスク化する
ブラウザから呼べてしまう transport_securityの許可が広すぎる、または保護を切っている allowed_originsに実際の送信元だけを書く
状態が消える インスタンスをまたいで状態を持たせている 状態はツールの引数や外部のDBに持たせる
デプロイ直後、全リクエストが421になる Hostの許可リストがlocalhostのまま transport_securityに allowed_hosts を設定する
HTTPSのはずがhttpへのリダイレクトで失敗する TLSを前段で終端し、後段のuvicornがスキームを誤認している uvicornに --proxy-headers を付け、プロキシのアドレスを信頼させる
確認付きツールが複数ワーカーで時々失敗する request_stateの封印キーがワーカーごとに違う RequestStateSecurity(keys=[...]) で全インスタンスに同じ鍵を渡し、サーバー名も統一する

まとめ

  • リモートMCPサーバーはStreamable HTTPで公開します。1つのエンドポイントにPOSTを送り、JSONかSSEで答えます。
  • 仕様 2026-07-28 ではセッションがなくなり、どのインスタンスでも処理できます。
  • ツールの中身は変えず、トランスポートだけを差し替えるのが移行の基本です。Pythonでは mcp.run() の引数で切り替わります。
  • 公開時は transport_security でHostの許可リストを設定します。既定のままだと、実ホスト名からのリクエストは全て拒否されます。
  • AWSでの選び方は、App Runnerは手軽さ、Lambdaはまばらな利用、ECS on Fargateは本番の自由度が目安です。決め手はリクエストの長さです。
  • 公開するならOAuth 2.1の認証が必須級です。サーバーはリソースサーバーとしてトークンを検証します。

次回はセキュリティと運用を取り上げ、権限管理やログ・監視など、サーバーを守る側の話を解説します。

関連記事

参考リンク

用語集

  • Streamable HTTP:MCPのリモート用トランスポート。1つのHTTPエンドポイントにPOSTを送り、JSONかSSEで応答を受け取る。2025-03-26で導入され、旧来のHTTP+SSEに代わった。
  • stdio:標準入出力を使ったローカル用のトランスポート。クライアントがサーバーを子プロセスとして起動する。
  • MCPエンドポイント:Streamable HTTPでサーバーが公開する1つのURL。クライアントはすべてのメッセージをここへPOSTする。
  • SSE(Server-Sent Events):サーバーからクライアントへイベントを流すためのHTTPの仕組み。レスポンスを開いたまま、出来事があるたびに送る。
  • ステートレス:リクエストごとに完結し、サーバー側でセッション状態を持たない設計。どのインスタンスでも処理できる。
  • ASGI:PythonのWebアプリとサーバーの間の標準インターフェース。Starletteなどのフレームワークがこの形でアプリを提供する。
  • uvicorn:ASGIアプリを動かすサーバー。Python SDKのStreamable HTTPは裏側でuvicornが使われる。
  • スティッキーセッション:同じクライアントのリクエストを常に同じワーカー(インスタンス)に届ける振り分け方。セッションがワーカーのメモリに残る構成で必要になる。
  • requestState:MRTRでサーバーがクライアントに預ける不透明なトークン。再試行のときに、サーバーが途中経過を開くために使う。
  • Originヘッダー:リクエストの送信元のオリジン(スキーム・ホスト・ポート)を示すHTTPヘッダー。検証することでDNSリバインディング攻撃を防ぐ。
  • DNSリバインディング攻撃:攻撃者のドメインを経由して、利用者のブラウザからローカルのサーバーへ不正にアクセスさせる攻撃。
  • MRTR(Multi Round-Trip Requests):サーバーがクライアントに確認を求めるとき、結果の中に「必要な入力」を埋め込んで返す仕組み。2026-07-28で導入された。
  • subscriptions/listen:変更通知を受け取るためのリクエスト。クライアントが開いたストリームに、サーバーが通知を流し続ける。
  • ECS on Fargate:AWSのコンテナ実行環境。サーバーを常駐させ、ALBと組み合わせて公開できる。
  • Lambda:AWSのサーバーレス関数。イベントごとに実行され、最大15分まで動く。
  • Function URL:Lambda関数に直接付くHTTPSのエンドポイント。API Gatewayを介さずに呼べる。
  • App Runner:AWSのマネージドなコンテナ実行サービス。イメージを渡すだけでHTTPSのURL付きで公開できる。
  • ALB(Application Load Balancer):AWSのロードバランサ。複数のコンテナにHTTPリクエストを振り分ける。
  • アイドルタイムアウト:通信がない状態が続いたときに、ロードバランサなどが接続を切るまでの時間。
  • OAuth 2.1:認可のための標準仕様。認可サーバーがアクセストークンを発行し、クライアントがそれを提示してリソースにアクセスする。
  • リソースサーバー:OAuthで、保護されたリソース(ここではMCPサーバー)を持ち、トークンを検証する側。
  • 認可サーバー:OAuthで、トークンを発行する側。ユーザーの認証と同意を扱う。
  • PKCE:認可コードの横取りを防ぐための仕組み。クライアントが作った秘密の値と、そのハッシュを組み合わせて使う。
  • Protected Resource Metadata(RFC 9728):保護されたリソースが「どの認可サーバーを使うか」を示すための公開文書。
  • CIMD(Client ID Metadata Documents):クライアントが自分の情報を置いたHTTPSのURLをclient_idとして使う登録方法。2026-07-28で推奨。
  • DCR(Dynamic Client Registration):クライアントが認可サーバーに動的に登録してclient_idをもらう方法。2026-07-28で非推奨。
  • リソースインジケータ(RFC 8707):トークン要求時に「どのサーバー宛てのトークンか」を示すresourceパラメータ。トークンを特定のサーバーにひも付ける。
  • IdP:Identity Provider(IDプロバイダー)の略。ユーザーの認証情報を管理し、認証を行うサービス。Amazon Cognitoなどが該当する。
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?