StreamableHTTPは、MCPが抱える根本的な問題に対する解決策です。一部のMCP機能はサーバーがクライアントにリクエストを送る必要がありますが、HTTPではこれが困難です。StreamableHTTPがこの制約をどのように回避しているか、そしてその回避策を破る必要がある場合について見ていきましょう。
核心となる問題
サンプリング、通知、ロギングといった一部のMCP機能は、サーバーがクライアントに対してリクエストを開始することに依存しています。しかし、HTTPはクライアントがサーバーにリクエストを送るように設計されており、その逆ではありません。StreamableHTTPは、Server-Sent Events(SSE)を使った巧妙な回避策でこれを解決しています。
StreamableHTTPの仕組み
その仕組みは、クライアントとサーバー間に永続的な接続を確立する複数ステップのプロセスによって実現されています。

初期接続のセットアップ
このプロセスは、通常のMCP接続と同じように始まります。
- クライアントがサーバーに
Initialize Requestを送信する - サーバーが特別な
mcp-session-idヘッダーを含むInitialize Resultで応答する - クライアントがセッションIDを含む
Initialized Notificationを送信する
このセッションIDは極めて重要です。クライアントを一意に識別するものであり、以降のすべてのリクエストに含める必要があります。
SSEによる回避策
初期化後、クライアントはGETリクエストを送信してServer-Sent Events接続を確立できます。これにより、サーバーがいつでもクライアントにメッセージをストリーミングできる、長時間持続するHTTPレスポンスが作成されます。

このSSE接続こそが、サーバーからクライアントへの通信を可能にする鍵です。サーバーはこの永続的なチャネルを通じて、リクエスト、通知、その他のメッセージを送信できるようになります。
ツール呼び出しと二重のSSE接続
クライアントがツール呼び出しを行うと、状況はより複雑になります。システムは2つの別々のSSE接続を作成します。

- プライマリSSE接続: サーバー起点のリクエストに使用され、無期限に開いたままになる
- ツール専用SSE接続: ツール呼び出しごとに作成され、ツールの結果が送信されると自動的に閉じる
メッセージのルーティング
メッセージの種類によって、異なる接続を通じてルーティングされます。
- 進捗通知: プライマリSSE接続を通じて送信される
- ロギングメッセージとツールの結果: ツール専用SSE接続を通じて送信される

回避策を破る設定フラグ
StreamableHTTPには、2つの重要な設定オプションがあります。
stateless_httpjson_response
これらをTrueに設定すると、SSEによる回避策の仕組みが壊れる可能性があります。特定のシナリオではこれらのフラグを有効にしたい場合もありますが、そうすることで、サーバーからクライアントへの通信に依存する完全なMCP機能が制限されます。
重要なポイント
StreamableHTTPは、HTTPの制約を回避する必要があるため、他のMCPトランスポートよりも複雑です。SSEベースの回避策によってHTTP上で完全なMCP機能が実現されますが、デバッグと最適化のためには、この二重接続モデルを理解することが不可欠です。
StreamableHTTPを使ってMCPアプリケーションを構築する際は、初期化後のすべてのリクエストにセッションIDが必要であること、そしてシステムが異なる種類のサーバーからクライアントへの通信を処理するために複数のSSE接続を自動的に管理していることを覚えておいてください。