Cloudflare WorkersでMCP Hosting:createMcpHandlerの手順・制限・stdioサーバー対策を検証【2026年】
Cloudflare WorkersでのMCPサーバーのホスティングを検証。createMcpHandlerでのデプロイ手順、npm installが失敗するSDKのバージョン指定、128 MB・CPU 10 msなどの制限、stdioサーバーが動かない理由とContainersでの対処、4つの費用シナリオを解説。
最終更新:2026年11月7日 / 対象:MCP仕様 2026-07-28、Cloudflare Agents SDK(
agents)0.33.0、@modelcontextprotocol/server2.4.0、Wrangler 4.158.0、Workersの制限ページ(2026年10月29日更新)、Workersの料金ページ(2026年10月2日更新)、Containersの料金ページ(2026年4月21日更新)。検証は2026年11月7日にwrangler devでローカル実行しました(方法は2章)。
結論(30秒で読める要約)
Cloudflare WorkersでのMCP Hostingとは、MCPサーバーをWorkerとして動かし、https://<名前>.<アカウント>.workers.dev/mcp でStreamable HTTPのリクエストに答えさせる方法です。Workers向けにTypeScriptで書いたMCPサーバーなら安くて速い一方、GitHubで見つかるMCPサーバーの多くはstdioのプログラムで、Workerの中ではそもそも動きません。
検証してわかったこと:
McpAgentではなくcreateMcpHandlerを使う。 CloudflareのドキュメントはMcpAgentを「非推奨・機能凍結」としています。新しいハンドラーはステートレスで、Durable Objectは不要です。- SDKのバージョンは
agentsが要求するものに合わせる。 ドキュメントの手順は@modelcontextprotocol/server@2.3.1を入れますが、agents0.33.0 のpeer dependencyは2.4.0で、合わせるまでnpmがERESOLVEで失敗しました。 - 2026-07-28版のプロトコルで話し、古いクライアントも受け付ける。
server/discoverは200、旧来のinitialize(2025-11-25)も200、pingは404、GET /mcpは405でした。 - stdioサーバーは動かない。
child_process.spawnは「not implemented」で例外になりました。人気のstdioサーバー@modelcontextprotocol/server-filesystem2.2.0 はバンドル自体は通りました(1,352 KiB)が、起動時にクラッシュしました。 - Workersの制限がそのままツールの制限になる。 1つのisolateあたりメモリ128 MB、CPU時間はFreeで1リクエスト10 ms(Paidは既定30秒・最大5分)、同時に開ける外向き接続は6本、
/tmpはリクエストごとに消えます。 - stdioサーバーを動かすCloudflareの選択肢はContainers(Workers Paid、月5ドルから)。アイドル時にスリープする256 MiBの
liteコンテナなら無料枠内に収まり、常時起動でもCPUを除き月1.74ドルほどの追加です。
目次
-
- Cloudflare WorkersでのMCP Hostingとは
-
- 検証方法
-
- Workers・McpAgent・Containersのどれを使うか
-
- 手順:createMcpHandlerでMCPサーバーをデプロイする
-
- デプロイしたエンドポイントの実際の挙動(検証結果)
-
- Workersの制限をMCPツールの制限に読み替える
-
- GitHubのstdio MCPサーバーがWorkersで動かない理由
-
- Cloudflare Containersでstdio MCPサーバーを動かす
-
- 費用:4つのシナリオ
-
- Workersでの認証
-
- チェックリスト
-
- よくあるハマりどころ(症状→原因→対処)
-
- NodeFlareならこう解決できる
-
- よくある質問
- まとめ
1. Cloudflare WorkersでのMCP Hostingとは
Cloudflare WorkersでのMCP Hostingとは、MCP(Model Context Protocol)サーバーをCloudflare Workerとして動かすことです。WorkerはCloudflareのネットワーク上のV8 isolateで動くJavaScript/TypeScriptの関数で、クライアントからはStreamable HTTPで呼ばれます。Claude、Cursor、自作エージェントがWorkerの /mcp にPOSTし、WorkerはCloudflareのAgents SDKで応答を組み立てます。
この仕組みから、Workersが自分のサーバーに合うかを決める3つの性質が出てきます。
| 性質 | MCPサーバーにとっての意味 |
|---|---|
| コンテナではなくisolateで動く | プロセスもネイティブバイナリもなく、実行時の npx や uvx も使えない |
| 課金はリクエスト数とCPUミリ秒 | 外部APIの応答待ちは無料、重いパース処理は有料 |
| ストレージを足さない限りリクエスト間で状態を持たない | セッション・キャッシュ・ファイルはKV、D1、R2、Durable Objectに置く |
Workers、Cloud Run、VPS、MCP専用ホスティングのどれにするかまだ決めていない場合は、先にMCP Hostingの6つの選択肢の比較を読んでください。この記事はCloudflareだけを深掘りします。
2. 検証方法
Cloudflare公式の最小サンプルでサーバーを作り、本番と同じ workerd ランタイムを使う wrangler dev で起動して、curlで生のHTTPリクエストを送りました。
| 項目 | バージョン・設定 |
|---|---|
| Agents SDK | agents 0.33.0 |
| MCPサーバーSDK | @modelcontextprotocol/server 2.4.0、zod 4.6.7 |
| Wrangler | 4.158.0、compatibility_date 2026-11-06、nodejs_compat フラグ |
| Node.js(ツール用) | 22.23.4 |
| ツール | hello と、child_process.spawn を呼ぶツール、/tmp に書いて読むツール |
ローカルの workerd は本番のCPU・メモリ制限を課さないため、6章の制限値はCloudflareのドキュメントの数値で、私たちの測定値ではありません。有料アカウントへのデプロイとContainersの実行はしておらず、8章と9章のContainersの数値はCloudflareの料金・制限ページによるものです。
3. Workers・McpAgent・Containersのどれを使うか
CloudflareでMCPを提供する方法は3つあり、どれが合うかはトラフィックではなくサーバーの書き方で決まります。
createMcpHandler のWorker |
McpAgent のWorker(旧方式) |
Worker経由のContainer | |
|---|---|---|---|
| ドキュメント上の位置づけ | 推奨 | 「非推奨・機能凍結」、削除時期は未発表 | Workers Paidで利用可能 |
| 状態 | ステートレス。リクエストごとに新しいMcpServerを作る | セッションごとに1つのDurable Object(専用のSQLデータベース付き) | スリープするまでプロセスがメモリに持つもの |
| トランスポート | Streamable HTTPのみ | Streamable HTTPとSSE | サーバーやブリッジが提供するもの |
| GitHubのstdioサーバーをそのまま動かせるか | いいえ | いいえ | はい(イメージ内にブリッジが必要) |
| メモリ | isolateあたり128 MB | isolateあたり128 MB | 256 MiB(lite)〜12 GiB |
| 最安のプラン | Free | Free(SQLite版Durable Objectのみ) | Workers Paid(最低月5ドル) |
| 向いている用途 | 新規のTypeScriptサーバー | 移行中の既存サーバー | stdioサーバー、Python、Go、依存の重いサーバー |
Cloudflareのガイドは、ステートレスなハンドラーではセッション機能の一部が使えないとも書いています。互換レーンではサーバーから押し出すelicitation、sampling、rootsの要求が失敗し、通知は「isolate内にとどまる」とのことです。2026-07-28版の仕様ではほとんどのサーバーにこれらは不要ですが、使っている McpAgent サーバーを移行する前には確認してください。
4. 手順:createMcpHandlerでMCPサーバーをデプロイする
デプロイはコマンド4つとファイル1つで終わります。テンプレートはCloudflareの認証なしデモなので、URLを共有する前に認証(10章)を追加してください。
手順1:テンプレートからプロジェクトを作る。
npm create cloudflare@latest -- remote-mcp-server-authless --template=cloudflare/ai/demos/remote-mcp-authless
cd remote-mcp-server-authless
手順2:SDKのバージョンを確認する。 Cloudflareのハンドラーのページは @modelcontextprotocol/server@2.3.1 を入れる手順で、Agentsのリリースが要求する正確なバージョンを使うよう書いています。2026年11月7日時点で npm view agents peerDependencies を見ると、agents 0.33.0 は "@modelcontextprotocol/server": "2.4.0" を要求しており、2.3.1を一緒に入れると ERESOLVE で失敗しました。対応する組み合わせで入れます。
npm view agents version peerDependencies
npm i agents@0.33.0 @modelcontextprotocol/server@2.4.0 zod@4
手順3:サーバーのコード。 実際に動かした形です(Cloudflareの最小サンプルを基に、ハンドラーのリファレンスと同じくスキーマを z.object で書いています)。
import { createMcpHandler } from "agents/mcp/server";
import { McpServer } from "@modelcontextprotocol/server";
import { z } from "zod";
function createServer() {
const server = new McpServer({ name: "my-mcp-server", version: "1.0.0" });
server.registerTool(
"hello",
{ description: "Returns a greeting", inputSchema: z.object({ name: z.string().optional() }) },
async ({ name }) => ({ content: [{ type: "text", text: `Hello, ${name ?? "World"}!` }] }),
);
return server;
}
export default {
fetch(request: Request, env: unknown, ctx: ExecutionContext) {
return createMcpHandler(createServer)(request, env, ctx);
},
} satisfies ExportedHandler;
createServer はリクエストのたびに実行されます。ツールの登録だけにして、データベース接続や設定の取得はここで行わないでください。
手順4:ローカルで動かしてからデプロイする。
npx wrangler dev # http://localhost:8787/mcp で起動(テンプレートの npm start は8788番)
npx wrangler deploy --dry-run --outdir dist # デプロイせずにバンドルサイズを確認
npx wrangler deploy # https://<名前>.<アカウント>.workers.dev が表示される
今回のバンドルは1,233 KiB(gzip後213 KiB)で、Workerのサイズ上限(非圧縮64 MiB)を大きく下回りました。
手順5:クライアントをつなぐ。 Claude Codeなら次のとおりです。
claude mcp add --transport http my-server https://<名前>.<アカウント>.workers.dev/mcp
Claude.aiのコネクタ、Cursor、VS Code、エージェントのAPIも、それぞれの設定形式で同じ https://…/mcp のURLを指定します。
5. デプロイしたエンドポイントの実際の挙動(検証結果)
ローカルのWorkerに次のリクエストを送り、応答を記録しました。特に断りがなければ、2026-07-28版のヘッダー(MCP-Protocol-Version、Mcp-Method、ツール呼び出しでは Mcp-Name)を付けた /mcp へのPOSTです。
| # | リクエスト | 結果 |
|---|---|---|
| 1 | _meta に io.modelcontextprotocol/clientCapabilities がない server/discover |
400、-32602「Invalid _meta envelope … clientCapabilities: missing」 |
| 2 | _meta がそろった server/discover |
200、supportedVersions: ["2026-07-28"] |
| 3 | tools/list |
200、ツール3個 |
| 4 | tools/call の hello |
200、約6 ms |
| 5 | GET /mcp |
405 |
| 6 | MCPヘッダーなし、protocolVersion: "2025-11-25" の旧来の initialize |
200(SSEイベント)、protocolVersion: "2025-11-25" |
| 7 | ping(2026-07-28版で削除) |
404、-32601 Method not found |
| 8 | Host: mcp.example.com |
200(Hostの検査なし) |
| 9 | Origin: https://evil.example |
403 |
| 10 | https://app.example.com からの OPTIONS プリフライト |
403 |
| 11 | Accept: application/json のみ |
200 |
実務での意味は次のとおりです。
- 手書きのcurlテストには
_meta一式が必要。protocolVersionだけを入れた2026-07-28版のリクエストは、このSDKでは400になりました(1行目)。実際のクライアントは自動で送ります。 - 独自ドメインはそのまま使える。 MCP Python SDKは既定のDNSリバインディング対策で未知のHostに421を返しますが、Workersのハンドラーはどのホスト名でも受け付けました(8行目)。デプロイ後にだけ起きる失敗が1つ減ります。
- ブラウザから動くクライアントは既定で拒否される。 9・10行目は、仕様どおりOriginの検査が効いていることを示しています。デスクトップやCLIのクライアントはOriginを送らないので影響はありませんでした。Webアプリから呼ぶ必要があるなら、Cloudflareのハンドラーのリファレンスに沿ってそのOriginを許可するか、
fetch()のラッパーでプリフライトに自分で応答してください。 - 古いクライアントも互換レーン経由で接続できる(6行目)。ただしリクエスト間でセッションは保持されません。
6. Workersの制限をMCPツールの制限に読み替える
Workersの制限は、そのまま「1回のツール呼び出しでできること」の制限になります。左の2列はCloudflareの制限ページ(2026年10月29日更新)の数値、右の列はMCPにとっての意味です。
| 制限 | Free | Paid | ツール呼び出しへの影響 |
|---|---|---|---|
| isolateあたりのメモリ | 128 MB | 128 MB | isolate内の全リクエストで共有。大きなAPI応答のパースやPDFの保持で使い切ることがある |
| HTTPリクエストあたりのCPU時間 | 10 ms | 既定30秒、最大5分 | 数えるのはCPUだけ。外部APIの待ち時間は無料だが、JSONのパース、正規表現、画像処理は数えられる |
| HTTPリクエストの所要時間 | 制限なし | 制限なし | クライアントが接続している限り、長いツール呼び出しも続く |
| 1回の実行あたりのサブリクエスト | 50 | 10,000 | 60ページ分のAPIを順に取るツールはFreeでは失敗する |
| 同時に開ける外向き接続 | 6 | 6 | 並列に取りに行くツールは7本目から待たされる |
| 起動時間(グローバルスコープ) | 1秒 | 1秒 | 大きなスキーマやSDKクライアントをトップレベルで読み込まない |
| Workerのサイズ(非圧縮) | 64 MiB | 64 MiB | 問題になることはまれ。今回のサーバーは1.2 MiB |
| リクエスト数 | 1日100,000 | 制限なし | エージェントの1セッションで数十リクエストになることもある |
数値と同じくらい重要な、ランタイムの性質が2つあります。
/tmpはリクエストごと。 検証では、ツールが/tmp/state.txtに書いて「saved」を返したのに、次の呼び出しでは「(missing)」でした。Cloudflareのドキュメントも、Workersのファイルシステムは「メモリベース」で、/tmpのファイルは永続せずリクエストごとに別物だと説明しており、128 MBのメモリ上限にも数えられます。- プロセスがない。
node:child_processは動作しないスタブとして掲載されています。検証のspawnは「The child_process.spawn method is not implemented」で例外になりました。
時間のかかるツールでも、クライアント側のタイムアウトは別にかかります。進捗通知を送って、クライアントが途中で諦めないようにしてください。
7. GitHubのstdio MCPサーバーがWorkersで動かない理由
GitHubにあるMCPサーバーの多くは、クライアントが子プロセスとして起動するstdioのプログラムで、Workerはプロセスを起動することも標準入力を読むこともできません。そのため、よくある3つの形はすべて使えません。
| READMEにある形 | Workersで動かない理由 |
|---|---|
npx -y some-mcp-server |
実行するプロセスがなく、実行時のインストールもできない |
uvx some-mcp-server、GoやRustのバイナリ |
JavaScriptではない(Python Workersは独自のツールチェーンとパッケージ構成) |
StdioServerTransport を使うNode.jsサーバー |
Workerの中に標準入出力のトランスポートがない |
それでも近道を試しました。@modelcontextprotocol/server-filesystem 2.2.0 をWorkerにimportすると、Wranglerは問題なくバンドルしました(1,352 KiB、gzip後245 KiB)が、ランタイムは「Uncaught TypeError: The argument 'path' … Received 'undefined'」で起動を拒否しました。このサーバーはトップレベルのコードでコマンドライン引数から許可ディレクトリを読みますが、Workerには引数がありません。バンドルが通っても、stdioサーバーが動くかどうかは何もわからないということです。
進め方は3つです。
createMcpHandlerでツールを書き直す。 サーバーがHTTP APIの薄いラッパーなら現実的です。- ブリッジ入りのContainerで動かす(8章)。
- stdioサーバーをそのまま動かせる別のホストを使う。 自分でやる場合のsupergateway、mcp-proxy、FastMCPの比較はstdio MCPサーバーをリモートで動かす手順にまとめています。
8. Cloudflare Containersでstdio MCPサーバーを動かす
Cloudflare ContainersはWorkerの隣でDockerイメージを動かす仕組みで、stdioをStreamable HTTPに変換するブリッジをイメージに入れておけば、どのstdio MCPサーバーでも動かせます。コンテナのインスタンスはそれぞれ専用のDurable Objectに対応し、Workerが /mcp へのリクエストをそこへ振り分けます。
イメージは、ブリッジを起動コマンドにした普通のMCPサーバー用Dockerfileです。
FROM node:24-slim
# サーバーとブリッジはビルド時にインストールし、起動時には入れない
RUN npm install -g supergateway @modelcontextprotocol/server-filesystem@2.2.0
USER node
EXPOSE 8080
CMD ["supergateway", "--stdio", "mcp-server-filesystem /tmp", "--outputTransport", "streamableHttp", "--port", "8080"]
MCP用Dockerfileのいつものルールがそのまま当てはまります。標準出力にはJSON-RPC以外を出さない、起動時に npx しない、シークレットをイメージに焼き込まない、の3つです。WorkerとDurable Objectの設定は、Wranglerのリリースごとに設定キーが変わるので、CloudflareのContainersのスタートガイドに従ってください。
Containersの制限ページにあるインスタンスタイプは次のとおりです。
| インスタンスタイプ | vCPU | メモリ | ディスク |
|---|---|---|---|
lite |
1/16 | 256 MiB | 2 GB |
basic |
1/4 | 1 GiB | 4 GB |
standard-1 |
1/2 | 4 GiB | 8 GB |
standard-2 |
1 | 6 GiB | 12 GB |
standard-3 |
2 | 8 GiB | 16 GB |
standard-4 |
4 | 12 GiB | 20 GB |
MCP用にContainersを選ぶ前に知っておくべき点:
- Workers Paidが必要で、コンテナの料金に加えてWorkerとDurable Objectの利用分も課金されます。
- コンテナは自分で設定した無操作タイムアウトでスリープし(Cloudflareの例は10分)、スリープ中は課金が止まります。コールドスタートの時間は公表されていないので、スリープ後の最初の
tools/listまでの時間は自分で測ってください。 - コンテナのディスクはエフェメラルで、VPSのディスクとは違います。状態はR2、D1、KVに置きます。
- サイズは測ってから決める。 Node.jsやPythonのMCPサーバーの多くは256〜512 MBで動きますが、ブラウザ自動化系のサーバーはずっと多く必要です。
9. 費用:4つのシナリオ
Workersはリクエスト数とCPUミリ秒、Containersは起動中のメモリとディスク、稼働中のCPUで課金されます。単価はCloudflareの料金ページ、ドル換算は私たちの計算です。
| 単価 | Workers Paid(月5ドル)に含まれる量 | 超過分 |
|---|---|---|
| Workersのリクエスト | 月1,000万 | 100万あたり0.30ドル |
| WorkersのCPU時間 | 月3,000万ms | 100万msあたり0.02ドル |
| コンテナのメモリ | 月25 GiB時間 | GiB秒あたり0.0000025ドル(GiB時間あたり0.009ドル) |
| コンテナのCPU(稼働時のみ) | 月375 vCPU分 | vCPU秒あたり0.000020ドル(vCPU時間あたり0.072ドル) |
| コンテナのディスク | 月200 GB時間 | GB秒あたり0.00000007ドル |
| シナリオ | 使用量 | 月額の目安 |
|---|---|---|
| A. WorkersのTypeScriptサーバー | ツール呼び出し30万回 × CPU約5 ms = 150万CPU ms | すべての呼び出しがCPU 10 ms・1日10万リクエスト以内ならFreeで0ドル。超えるならPaidで5ドル |
B. アイドル時にスリープする lite コンテナのstdioサーバー |
月60時間稼働:メモリ15 GiB時間、ディスク120 GB時間 | 5ドル(無料枠内)+375 vCPU分を超えた稼働CPU |
C. 同じ lite コンテナを常時起動 |
730時間:メモリ182.5 GiB時間、ディスク1,460 GB時間 | 約5+1.42+0.32=6.74ドル+CPU |
D. basic(1 GiB)コンテナを常時起動 |
メモリ730 GiB時間、ディスク2,920 GB時間 | 約5+6.35+0.69=12.04ドル+CPU |
コンテナからの送信データは別料金です(北米・欧州は1 TBまで込み、その後1 GBあたり0.025ドル)。MCP Hostingの比較記事のGB時間の計算と同じく、どのプラットフォームを選ぶかより、使っていないMCPサーバーを止めておけるかのほうが費用に効きます。
10. Workersでの認証
テンプレートは認証なしで、createMcpHandler 自体も「リクエストヘッダーから識別情報を取り出したり、アクセストークンを検証したりしない」ため、URLを共有する前に認証を追加する必要があります。
| 方法 | Cloudflareでの実装 | 向いている用途 |
|---|---|---|
Workers OAuth Provider(@cloudflare/workers-oauth-provider) |
認可サーバーのWorkerと、createMcpHandler を包むリソースサーバー。トークンは validateToken で検証し、OAUTH_KV というKV名前空間が必要 |
OAuthを前提にするClaude.aiやChatGPTのコネクタ |
| 外部のIDプロバイダ(GitHub、Google、Auth0、WorkOS、Stytch、Descope) | OAuthフローの /authorize で使う |
既存のアカウントでログインさせる |
| Cloudflare Access | IDプロバイダやワンタイムPINで「MCPサーバーにユーザーをサインインさせられる」 | 社内向けサーバー |
fetch() で自前のBearerキー検査 |
Cloudflareは「独自のトークン検証に置き換える」というプレースホルダー付きで書き方を示している | ヘッダーを送れるClaude Code、Cursor、エージェント |
見落としやすい点として、Cloudflareは requiredScopes について「告知するだけで強制はしない」と書いています。スコープは各ツールのハンドラーの中で確認してください。OAuth側を自分で実装する場合はMCP OAuthサーバー実装の7ステップが参考になります。
11. チェックリスト
- [ ] サーバーがTypeScript/JavaScriptで、
child_process、ネイティブモジュール、stdioトランスポートを使っていない(使っているならContainers) - [ ]
McpAgentではなくcreateMcpHandlerで作っている - [ ]
@modelcontextprotocol/serverのバージョンがagentsのpeer dependencyと一致している - [ ]
createServer()の中でネットワークやデータベースの処理をしていない - [ ] 一番重いツールがプランのCPU上限(Freeは10 ms、Paidは既定30秒)に収まる
- [ ] Freeではツールのサブリクエストが50回以内、並列の取得は6本以内
- [ ]
/tmpやグローバル変数に状態を置かず、永続データはKV、D1、R2、Durable Objectにある - [ ] 認証(OAuth Provider、Access、Bearer検査のいずれか)を入れ、スコープをハンドラー内で確認している
- [ ] デプロイ先のURLに
_meta一式付きのserver/discoverを送って200が返る - [ ] ブラウザから使う場合、許可するOriginを設定した
- [ ] Containersの場合、イメージにブリッジがあり、無操作タイムアウトを設定し、コールドスタートを測った
12. よくあるハマりどころ(症状→原因→対処)
| 症状 | 原因 | 対処 |
|---|---|---|
npm install が ERESOLVE で失敗する |
@modelcontextprotocol/server のバージョンが agents のpeer dependencyと違う |
npm view agents peerDependencies の正確なバージョンを入れる |
curlで400 -32602 Invalid _meta envelope |
_meta に clientCapabilities がない |
2026-07-28版の _meta をすべて送るか、実際のクライアントで試す |
| 「The child_process.spawn method is not implemented」 | stdioサーバーやツールがプロセスを起動している | ツールを書き直すか、Containerを使う |
| GitHubのサーバーをバンドルしたらランタイムが起動しない | トップレベルのコードがCLI引数や標準入力を前提にしている | stdioサーバーなので、ブリッジ入りのContainerを使う |
| あるツール呼び出しで書いたデータが次の呼び出しで消える | /tmp はリクエストごと |
KV、D1、R2、Durable Objectに保存する |
| エラー1102(Workerがリソース上限を超過) | Freeでツールが10 msを超えるCPUを使った | Paidに移るか、パース処理を減らす |
| API呼び出しが50回を超えたところでツールが失敗する | Freeのサブリクエスト上限 | Paid(10,000回)にするか、外部呼び出しを減らす |
| ブラウザ系クライアントでCORSエラー | Origin検査でプリフライトが403 | ハンドラー側でそのOriginを許可する |
| URLをブラウザで開くと405 | GET /mcp は許可されていない |
想定どおり。POSTで試す |
| Claude.aiのコネクタで認証できない | テンプレートが認証なし、またはOAuthが必要な所でBearerキーを使っている | Workers OAuth Providerを追加する |
13. NodeFlareならこう解決できる
Cloudflare Workersは、Workers向けにTypeScriptでMCPサーバーを書くなら有力な選択肢です。この記事で挙げた問題が出るのは、サーバーがGitHub由来のとき、128 MBでは足りないとき、認証やコンテナを自分で組みたくないときです。NodeFlareでの対応は次のとおりです。
| この記事で挙げた課題 | NodeFlareでの対応 |
|---|---|
Workerではstdioサーバーが動かない(child_process はスタブ) |
stdio-adapter.cjs という1つのファイルがstdioサーバーを子プロセスとして起動し、Streamable HTTPと旧来の2024-11-05版HTTP+SSEで提供する。Dockerfileもコード変更も不要 |
| Containersにはイメージ、ブリッジ、Worker、Durable Objectが必要 | GitHubのリポジトリから直接デプロイでき、モノレポのサブディレクトリにも対応。Node.js、Python、Go、Rust、Java、C#/.NET、Dockerを自動判定し、デプロイごとに実際のMCP initialize(バックオフ付きで最大8回)で動作を確認する |
| isolateあたり128 MB | サーバーごとに専用のFirecrackerマイクロVMで動き、メモリは256 MB、512 MB、1 GB、2 GBから選べる(上限はプランによる) |
認証は自前、requiredScopes は強制されない |
すべてのリクエストにBearerトークン(mcp_* のAPIキーかOAuthアクセストークン)が必要で、RFC 8414とRFC 9728のディスカバリーメタデータも提供。tools:call:get_weather のようなスコープはサーバーに届く前に検査し、誤ったキーを送り続けるIPは10分間ロックアウトする |
| 使っていない時間の費用 | アイドル状態が数分続くとスナップショットを取って停止し、次のリクエストで1秒未満で復元する。アイドル中は¥0。Always-On(Pro以上)なら常に1台を温めておける |
/tmp やローカルファイルが消える |
有料プランは永続ディスクを使える(¥15/GB-月)。使わない場合はWorkerと同じく、スケールゼロでファイルシステムがリセットされる |
| クライアントが何を送ったか記録がない | リクエストログにMCPメソッド、ツール名、引数のキー(値は記録しない)、ステータス、所要時間、呼び出し元の種別を記録。保存期間はFreeが7日、Pro・Teamが30日 |
料金:Freeは¥0で、MCPサーバー1つと月30 GB時間のコンピュート。Proは月¥2,980で、サーバー数無制限、300 GB時間と10 GBのストレージ込み、超過分のコンピュートは1 GB時間あたり¥5です。
最小の始め方:
- nodeflare.tech にGitHubでサインインし、MCPサーバーのリポジトリを選ぶ。
- デプロイして、Verified の表示を待つ。
https://<your-server>.nodeflare.tech/mcpとAPIキー(Authorization: Bearer <YOUR_API_KEY>)をClaude、Cursor、エージェントに設定する。
1サーバーまで無料で試せます → nodeflare.tech
14. よくある質問
Cloudflare WorkersでMCPサーバーを無料でホストできる?
できます。createMcpHandler で作ったTypeScriptのサーバーで、各リクエストがFreeプランのCPU 10 ms、サブリクエスト50回、1日10万リクエストに収まる場合です。外部APIの待ち時間はCPU時間に数えられません。重いツールには月5ドルからのWorkers Paidが必要です。
createMcpHandlerとMcpAgentのどちらを使うべき?
新しいサーバーは createMcpHandler を使ってください。Cloudflareのドキュメントは McpAgent を非推奨・機能凍結とし、移行中の既存サーバー向けに残しているだけです。新しいハンドラーはステートレスで、Durable Objectが要りません。
WorkersのMCPサーバーにDurable Objectsは必要?
サーバー自体には不要です。createMcpHandler はリクエストごとに新しいサーバーを作るため、セッション用のオブジェクトは要りません。リクエストをまたいで残すデータがあるときだけ、MCPのセッションIDではなくユーザーをキーにして、Durable Object、D1、KV、R2に保存します。
GitHubのstdio MCPサーバーをCloudflare Workersで動かせる?
動かせません。Workersはプロセスを起動できず標準入力も読めないため、検証では child_process.spawn が「not implemented」になり、バンドルしたstdioサーバーは起動時にクラッシュしました。stdioをHTTPに変換するブリッジを入れたCloudflare Containerで動かすか、createMcpHandler でツールを書き直すか、stdioサーバーをそのまま動かせるホストを使ってください。
CloudflareのMCPハンドラーは2026-07-28版の仕様に対応している?
対応しています。agents 0.33.0 と @modelcontextprotocol/server 2.4.0 の組み合わせで、server/discover は supportedVersions: ["2026-07-28"] を返し、削除された ping は404でした。2025-11-25版の initialize にも200を返したので、古いクライアントも引き続き使えます。
WorkersのMCPハンドラーはSSEに対応している?
提供するのはStreamable HTTPだけで、Cloudflareは旧来のHTTP+SSEトランスポートを非推奨としています。検証では旧来の initialize にStreamable HTTPのSSEイベントで応答しましたが、独立した /sse エンドポイントはありません。2024-11-05版のSSEトランスポートしか話せないクライアントは、更新するか別のホストが必要です。
MCPツールにかかるCloudflare Workersの制限は?
isolateあたりのメモリは128 MBです。リクエストあたりのCPU時間はFreeで10 ms、Paidで既定30秒(最大5分)で、クライアントが接続している間は経過時間の上限はありません。サブリクエストはFreeで50回、Paidで10,000回、同時に開ける外向き接続は6本までです。
CloudflareでMCPサーバーをホストする費用は?
WorkersのTypeScriptサーバーなら、Freeで0ドルか、Paidで月5ドルが一般的です。Paidには月1,000万リクエストと3,000万CPUミリ秒が含まれます。アイドル時にスリープする256 MiBの lite コンテナでstdioサーバーを動かす場合は5ドルの無料枠に収まり、常時起動ならCPUを除き月1.74ドルほど増えます。
次のツール呼び出しで/tmpのデータが消えるのはなぜ?
Workersのファイルシステムはメモリベースで、/tmp はリクエストごとに別物だからです。検証でも、ある呼び出しで書いたファイルが次の呼び出しではありませんでした。残す必要があるものはKV、D1、R2、Durable Objectに保存してください。
Cloudflare WorkersのMCPサーバーに認証を付けるには?
Claude.aiやChatGPTのコネクタ向けには、Workers OAuth Providerでハンドラーを包み、クライアントがOAuthを実行できるようにします。社内向けならCloudflare Accessでサインインさせられ、Claude Code、Cursor、エージェント向けなら fetch() で自分でBearerキーを検査できます。Cloudflareは requiredScopes を「告知するだけで強制しない」としているので、スコープは各ツールで確認してください。
WorkersのMCPサーバーに独自ドメインを使える?
使えます。Workersは自分のドメインに割り当てられ、検証ではMCPハンドラーがどのHostヘッダーでも受け付けたため、ホスト名の許可リストを更新する必要もありません。ただしブラウザから動くクライアントは別で、Originを許可しないと403になります。
まとめ
Cloudflare Workersは、Workers向けに書いたサーバーにとって最も安いMCP Hostingの1つです。createMcpHandler で作り、MCP SDKを agents が要求するバージョンに合わせ、認証を追加し、各ツールを128 MB・プランのCPU上限・サブリクエスト上限に収めれば動きます。検証では、ハンドラーは2026-07-28版のプロトコルで話し、2025-11-25版のクライアントも受け付け、Hostヘッダーは問わず、Originは検査しました。一方で、GitHubで見つかる多くのstdioサーバーはWorkersでは動きません。child_process はスタブで、/tmp は1リクエスト限り、バンドルしたstdioサーバーは起動時にクラッシュしました。こうしたサーバーは、Paidプランでブリッジ入りのCloudflare Containerを使うか、stdioサーバーをそのまま動かせるホストを選んでください。
参考資料
- MCP仕様 2026-07-28、Transports:https://modelcontextprotocol.io/specification/2026-07-28/basic/transports
- Cloudflare、Build a remote MCP server:https://developers.cloudflare.com/agents/model-context-protocol/guides/remote-mcp-server/
- Cloudflare、MCP transport:https://developers.cloudflare.com/agents/model-context-protocol/transport/
- Cloudflare、MCP Server handler API(createMcpHandler):https://developers.cloudflare.com/agents/model-context-protocol/apis/handler-api/
- Cloudflare、McpAgent(deprecated):https://developers.cloudflare.com/agents/model-context-protocol/apis/agent-api/
- Cloudflare、Migrate to MCP SDK v2:https://developers.cloudflare.com/agents/model-context-protocol/guides/migrate-to-mcp-sdk-v2/
- Cloudflare、MCP authorization:https://developers.cloudflare.com/agents/model-context-protocol/authorization/
- Cloudflare Workers、Limits:https://developers.cloudflare.com/workers/platform/limits/
- Cloudflare Workers、Pricing:https://developers.cloudflare.com/workers/platform/pricing/
- Cloudflare Workers、Node.js compatibility:https://developers.cloudflare.com/workers/runtime-apis/nodejs/
- Cloudflare Workers、node:fs:https://developers.cloudflare.com/workers/runtime-apis/nodejs/fs/
- Cloudflare Containers:https://developers.cloudflare.com/containers/
- Cloudflare Containers、Pricing:https://developers.cloudflare.com/containers/pricing/
- Cloudflare Containers、Limits and instance types:https://developers.cloudflare.com/containers/platform-details/limits/
