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 - Model Context Protocol(仕様 2026-07-28)
- The 2026-07-28 Specification - Model Context Protocol Blog
- Authorization - Model Context Protocol(仕様 2026-07-28)
- Running your server | MCP Python SDK
- Deploy & scale | MCP Python SDK
- Developing application code for App Runner - AWS Documentation
- Quotas for configuring and running a REST API in API Gateway - AWS Documentation
用語集
- 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などが該当する。