本記事は、2026 年 10 月 28 日に Zenn で公開した解説を、Qiita 向けに書き直したものです。原本はこちらです:MCP の 406 Not Acceptable(Client must accept text/event-stream)の原因と解決方法
Cursor や自作クライアントから、Streamable HTTP のリモート MCP サーバーへつなぐと、406 Not Acceptable と一緒に Client must accept text/event-stream というメッセージが返ることがあります。認可の失敗やサーバー障害ではなく、多くの場合は Accept ヘッダーが足りないだけです。先に原因と直し方を書き、そのあと curl での確認手順を置きます。
筆者は MCP Checkup(mcpcheckup.com)の開発者です。
先に結論:原因と直し方
原因:Streamable HTTP の MCP サーバーへ送ったリクエストで、Accept が仕様の要求を満たしていない。
直し方:
POST では Accept: application/json, text/event-stream を付ける。
イベントストリームを開く GET では Accept: text/event-stream を付ける。
クライアント側を直しても同じ応答が続くときは、途中のリバースプロキシや API ゲートウェイが Accept を消していないか、書き換えていないかを見る。
サーバー側に出るメッセージ
公式 TypeScript SDK(@modelcontextprotocol/sdk)のサーバーは、POST の Accept に application/json か text/event-stream のいずれかが無いと、HTTP 406 と次の JSON-RPC ボディを返します。
{"jsonrpc":"2.0","error":{"code":-32000,"message":"Not Acceptable: Client must accept both application/json and text/event-stream"},"id":null}
GET の Accept に text/event-stream が無いときは、次のメッセージです。
Not Acceptable: Client must accept text/event-stream
公式 Python SDK(mcp)にも同じ 2 つのメッセージがあります。JSON レスポンスモードでは、次の形になることがあります。
Not Acceptable: Client must accept application/json
これらは 2026-10-27 時点の typescript-sdk(main と v1.x)および python-sdk(main)のソースで確認しています。
コードが -32000 だからといって「接続が切れた」とは限りません。同じ番号が HTTP レイヤーの別エラーにも使われます。判断はメッセージの本文で行ってください。
なぜ Accept が必要か
対象は Streamable HTTP トランスポートです。MCP 仕様の 2025-03-26、2025-06-18、2025-11-25 では、クライアントに次が求められています。
すべての POST で、Accept に application/json と text/event-stream の両方を入れる。
ストリームを開く GET で、Accept に text/event-stream を入れる。
仕様そのものは「足りなければ 406 を返す」とは書いていません。406 で拒否しているのは SDK、フレームワーク、プロキシ側の実装です。
curl で確認する
curl は -H で Accept を指定しないと Accept: / を送ります。同じコマンドでも、相手の SDK によって結果が分かれます。
公式 TypeScript SDK のサーバーは、Accept に application/json と text/event-stream という文字列がそれぞれ入っているかだけを見ます。/ はどちらにも当たらないので、406 になります。
公式 Python SDK のサーバーは、RFC のワイルドカード規則に従って / を両方受け付けると扱います。こちらでは 406 になりません。
406 になり得る例(Accept を付けない):
Accept: / が送られる
curl -i -X POST https://example.com/mcp
-H 'Content-Type: application/json'
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0.0.1"}}}'
Accept を明示した例:
curl -i -X POST https://example.com/mcp
-H 'Accept: application/json, text/event-stream'
-H 'Content-Type: application/json'
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0.0.1"}}}'
https://example.com/mcp は、確認したいサーバーの URL に置き換えてください。
クライアント側の修正
fetch
const res = await fetch("https://example.com/mcp", {
method: "POST",
headers: {
"Accept": "application/json, text/event-stream",
"Content-Type": "application/json",
},
body: JSON.stringify({
jsonrpc: "2.0",
id: 1,
method: "initialize",
params: {
protocolVersion: "2025-06-18",
capabilities: {},
clientInfo: { name: "my-client", version: "0.0.1" },
},
}),
});
ストリームを開く GET では、Accept: text/event-stream だけ付けます。
const stream = await fetch("https://example.com/mcp", {
method: "GET",
headers: { "Accept": "text/event-stream" },
});
サーバーがセッションを使う場合、GET には initialize の応答で受け取った Mcp-Session-Id も必要です。これが無いと、406 ではなく 400 の Bad Request: Mcp-Session-Id header is required になります。
仕様の 2026-07-28 では GET のストリームが廃止されています。このリビジョンだけに対応するサーバーは、GET に 405 を返します。
curl
上と同じ 2 つのヘッダーを付けます。
-H 'Accept: application/json, text/event-stream' -H 'Content-Type: application/json'
自作クライアントや HTTP ライブラリ
次を順に見てください。
Accept を付け忘れている。
ライブラリのデフォルト(/ だけ、あるいは application/json だけ)がそのまま送られている。
POST と GET で、それぞれ必要なメディアタイプを入れていない。
プロキシを疑うとき
クライアントには正しい Accept を付けているのに 406 が続く場合は、経路を切り分けます。
リバースプロキシや API ゲートウェイが Accept を削除、または書き換えしていないか。
サーバーに届いたリクエストの Accept を、ログでそのまま確認する。
プロキシを外して origin へ直接 curl し、結果が変わるか比べる。
まとめ
Streamable HTTP で出る 406 Not Acceptable は、ほとんどの場合 Accept 不足です。POST には application/json と text/event-stream の両方、ストリーム用の GET には text/event-stream を付けます。curl はデフォルトが / なので、-H で明示してください。クライアントが正しいのに続くときは、プロキシやゲートウェイを確認します。
参考文献
MCP の 406 Not Acceptable(Client must accept text/event-stream)の原因と解決方法(Zenn の原本)
MCP server returns 406 Not Acceptable: how to fix it(mcpcheckup.com の英語版)
MCP error -32000: Connection closed の原因と対処法(stdio とリモート MCP サーバー)(同じ -32000 でもメッセージが違う場合)
筆者は MCP Checkup(mcpcheckup.com)の開発者です。