VercelでMCPサーバーを動かす手順はmcp-handler 2.xで変わった:1.xからの移行、401の正体、関数の制限とツール呼び出しあたりのコスト【MCP Hosting 2026】
mcp-handler 2.0以降のVercelでのMCP Hostingを解説。1.xから消えた設定(SSE・Redis・basePath・[transport])、Next.jsのルート例、Deployment ProtectionでMCPクライアントが401になる理由と対処、プラン別の関数制限、4.5MBの上限、stdioサーバーの扱い、5つの月額試算まで。
最終更新:2026年11月10日 / 対象:mcp-handler 2.3.1(2026年11月5日公開のnpm
latest)、@modelcontextprotocol/server2.x、MCP仕様 2026-07-28、2026年8〜9月更新のVercel公式ドキュメント。内容はVercelのドキュメントとchangelog、vercel/mcp-handlerのREADME、npmレジストリに基づきます。課金チームでの負荷試験はしていません。金額はVercelの料金ページにあるiad1の単価を使った私たちの試算です。
結論(30秒で読める要約)
VercelでのMCP Hostingとは、MCP(Model Context Protocol)サーバーをVercel Functionとして公開することです。多くの場合はNext.jsアプリの /api/mcp のようなルートに、Vercel製の mcp-handler パッケージで実装し、Claude・Cursor・自作エージェントからStreamable HTTPで呼び出します。
注意したいのは、ネット上の「Vercel MCP」解説の多くがmcp-handler 1.x時代のものだという点です。2026年7月29日公開のmcp-handler 2.0は互換性のない作り直しでした。
- MCP SDK v2(
@modelcontextprotocol/server^2.0.0)、zod ^4.2、Node.js 20以上が必要です。@modelcontextprotocol/sdk1.xのままのプロジェクトはmcp-handler 1.xを使い続けます。 - 2026-07-28のステートレスなプロトコルをそのまま処理し、それ以前のStreamable HTTPクライアントにもステートレスな互換モードで応答します。
- 旧HTTP+SSEトランスポート、Redis、
basePath、maxDuration、redisUrl、app/[transport]/route.tsの書き方はなくなりました。
そのうえで、動くかどうかと費用を決めるのはVercel側の次の4点です。
- Deployment Protectionが、プレビューURLや自動生成URLへのMCPクライアントの接続にログイン画面か
401を返します。本番ドメインを使うか、x-vercel-protection-bypassヘッダーを付けます。 - ツール呼び出しは関数の最大実行時間で打ち切られます。Hobbyは300秒、Proは最大800秒(ベータで1,800秒)です。
- リクエストと、ストリーミングしないレスポンスの本文は4.5MBまでです。
- ツールが外部APIを待っている間もメモリは課金されます。CPUはI/O待ちの間止まりますが、メモリは止まりません。月10万回呼ばれるチーム用サーバーで、iad1の単価なら使用量は約1.59ドルです。
GitHubで見つけたstdioのMCPサーバーを動かす方法は、Vercelのドキュメントには書かれていません。
目次
- 2026年のVercelでのMCP Hostingの姿
- mcp-handler 1.xと2.xの違い
- 手順:VercelにMCPサーバーをデプロイする
- 401の正体:Deployment ProtectionとMCPクライアント
- withMcpAuthで認証を付ける
- Vercel Functionの制限をMCPツールの制限に読み替える
- Fluid computeでのコールドスタート
- 月額コスト:5つの試算
- GitHubのstdio MCPサーバーはVercelで動くか
- チェックリスト
- トラブルシューティング:症状→原因→対処
- NodeFlareならこう解決できる
- FAQ
1. 2026年のVercelでのMCP Hostingの姿
VercelでのMCP Hostingとは、アプリのルート(例:https://your-app.vercel.app/api/mcp)でStreamable HTTPのPOSTに応答するVercel Functionの中で、MCPサーバーを動かすことです。Vercelが勧める部品はオープンソースの mcp-handler で、公式のMCP TypeScript SDKをWeb標準の Request/Response ハンドラーにつなぎます。
| 特徴 | MCPサーバーにとっての意味 |
|---|---|
| Webアプリの中に同居する | MCPサーバーがNext.js(またはNuxt、SvelteKit、Hono)アプリと一緒に、git push のたびにデプロイされる |
| 設計上ステートレス | mcp-handler 2.xはMCPセッションを持たないため、Redisもスティッキーなルーティングも要らない |
| Fluid compute | 1つのインスタンスが複数のリクエストを同時に処理し、アイドルになると縮小する |
| リクエスト単位の実行 | ツール呼び出しはすべて関数の最大実行時間内に終わる必要がある |
| stdioの手順が公式にない | npx や uvx で起動するGitHubのサーバーは、VercelのMCPドキュメントの対象外 |
なお、Vercel自身が提供する「Vercel MCP」(mcp.vercel.com)とは別物です。こちらはAIクライアントからVercelのプロジェクト・デプロイ・ログを操作するためのホスト型MCPサーバーで、あなたのサーバーをホストするものではありません。
2. mcp-handler 1.xと2.xの違い
mcp-handler 2.xは、独自のルーティングとセッション管理をやめ、MCP仕様2026-07-28のステートレスなモデルに乗り換えました。削除された設定はREADMEの移行セクションに明記されています。
| 項目 | mcp-handler 1.x(多くの解説記事) | mcp-handler 2.x(現行) |
|---|---|---|
| MCP SDK | @modelcontextprotocol/sdk 1.x(1.1.0は1.26.0に固定) |
@modelcontextprotocol/server ^2.0.0、zod ^4.2.0、Node.js 20以上 |
| ルート | app/[transport]/route.ts と basePath |
好きなルートでよい。app/api/mcp/route.ts は「慣例であり必須ではない」 |
| トランスポート | Streamable HTTPとHTTP+SSE(2024-11-05) | 2026-07-28をそのまま処理、2025年版のStreamable HTTPは互換モード、SSEは削除 |
| Redis | SSEや再開可能ストリームに redisUrl が必要 |
「Redisはもう不要で、使われない」 |
| タイムアウト | maxDuration オプション |
プラットフォーム側で設定(ルートファイルの export const maxDuration など) |
| ツール登録 | server.tool(name, shape, fn) |
server.registerTool(name, { inputSchema: z.object(...) }, fn) |
| ツール内の認証情報 | extra.authInfo |
ctx.http?.authInfo |
| セッション操作 | GETのストリーム、DELETEでセッション終了 | GET/DELETEには 405 を返す |
READMEに列挙されている削除済みオプションは、basePath、streamableHttpEndpoint、sseEndpoint、sseMessageEndpoint、disableSse、redisUrl、maxDuration、sessionIdGenerator です。
見落とされがちな影響が2つあります。
- SSEしか話せないクライアントはつながらなくなります。リリース時のVercelのchangelogには、
/sseと/messageへのリクエストは410 Goneを返し、SSEが必要なチームは1.xに留まるよう書かれています。今のクライアントはほぼStreamable HTTPですが、古いmcp-remote --transport sse-onlyの設定は確認してください。 - コピペしたインストールコマンドが古い場合があります。Vercel自身のドキュメントは
mcp-handler@2.1.1を入れていますが、2026年11月10日時点のnpmのlatestは2.3.1です。バージョンを固定する前にnpm view mcp-handler version peerDependenciesで確認しましょう。
3. 手順:VercelにMCPサーバーをデプロイする
Vercelの「Deploy MCP servers to Vercel」とmcp-handler 2.xのREADMEに沿った、Next.js App Routerの例です。
ステップ1:パッケージを入れます。
npm i mcp-handler@2.3.1 @modelcontextprotocol/server@2 zod@4
ステップ2:ルートを作ります。パスは自由です。この例では /api/mcp で受けます。
// app/api/mcp/route.ts
import { createMcpHandler } from "mcp-handler";
import { z } from "zod";
const handler = createMcpHandler(
(server) => {
server.registerTool(
"roll_dice",
{
title: "Roll dice",
description: "Roll an N-sided die",
inputSchema: z.object({ sides: z.number().int().min(2) }),
},
async ({ sides }) => ({
content: [
{ type: "text", text: `You rolled ${1 + Math.floor(Math.random() * sides)}` },
],
}),
);
},
{ serverInfo: { name: "dice-server", version: "1.0.0" } },
);
export { handler as GET, handler as POST };
// ルートごとのタイムアウト(秒)。Hobbyは最大300、Proは最大800
export const maxDuration = 60;
オプション名は、実際に入れるバージョンのREADMEで確認してください。2.xのオプションは「SDKのサーバーオプションに serverInfo、verboseLogs、onEvent を加えたもの」とされています。
ステップ3:ローカルで動かします。npm run dev を実行し、MCPクライアントかMCP Inspectorを http://localhost:3000/api/mcp に向けて tools/list を呼びます。
ステップ4:デプロイします。Vercelに連携したGitリポジトリにpushするか、vercel --prod を実行します。クライアントに渡すのは本番のURLです(理由は4章)。
ステップ5:クライアントをつなぎます。Claude Codeなら次のとおりです。
claude mcp add --transport http dice https://your-app.vercel.app/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
Cursor、VS Code、Codex CLI、エージェントSDKも同じURLをそれぞれの設定形式で書きます。クライアントごとの書き方はリモートMCPクライアント設定チートシートにまとめています。
他のフレームワークについて。READMEの対象は「Next.js、Nuxt/Nitro、SvelteKit、Hono、その他Fetch互換のフレームワーク」です。Expressなど IncomingMessage/ServerResponse 型のフレームワークにはWeb Requestへのアダプターが要ります。VercelのPythonランタイム(Python 3.12〜3.14)はASGIアプリを動かせるので、ステートレスHTTPモードのPython製MCPサーバーという選択肢もありますが、VercelのMCPページが説明しているのはmcp-handlerだけです。
4. 401の正体:Deployment ProtectionとMCPクライアント
デプロイしたばかりのVercelのMCPサーバーが「つながらない」原因で最も多いのは、MCPとは関係のないところにあります。Deployment Protectionは2023年11月から新規プロジェクトで既定で有効になっており、Vercelのドキュメント自身が「AIエージェント、CI/CDパイプライン、MCPサーバー、E2Eテストツールはブラウザでの認証を完了できない。Deployment Protectionが有効なプロジェクトでは、これらはログインページか 401 を受け取る」と書いています。
| クライアントに貼ったURL | Standard Protection(既定) | MCPクライアントから見た結果 |
|---|---|---|
| プレビューデプロイのURL(ブランチやPR) | 保護される | 401 またはHTMLのログインページ |
本番デプロイの自動生成URL(project-hash.vercel.app 形式) |
保護される | 401 またはHTMLのログインページ |
| 本番ドメイン(独自ドメイン、またはプロジェクトの本番ドメイン) | 保護されない | MCPのルートに届く |
| 「All Deployments」保護を有効にした場合のURL | 保護される | 401 またはHTMLのログインページ |
対処は次の順に検討します。
- クライアントには本番ドメインを渡します。Standard Protectionは「本番ドメイン以外のすべてのドメインを保護する」ものです。
- プレビューで試すときはバイパス用ヘッダーを送ります。全プランで使える「Protection Bypass for Automation」のシークレットを作り、クライアント設定に
x-vercel-protection-bypass: <secret>を加えます。Claude Code、Cursor、エージェントSDKはヘッダーを送れますが、Claude.aiのカスタムコネクタは基本的に送れないため、プレビューの確認はデスクトップ系のクライアントで行うのが確実です。 - 保護を外すことを認証の代わりにしないでください。公開された本番ドメインにもMCPの認証が必要です(5章)。また、バイパス用シークレットはMCPのルートだけでなくデプロイ全体を開けてしまうので、認証情報として扱い、漏れたら再発行します(再発行には再デプロイが必要です)。
5. withMcpAuthで認証を付ける
mcp-handlerはトークンを検証しますが、発行はしません。READMEにも「このパッケージはトークンを発行せず、認可サーバーも動かさない」とあります。ハンドラーを withMcpAuth で包み、verifyToken 関数を渡します。
// app/api/mcp/route.ts(続き)
import { withMcpAuth } from "mcp-handler";
const verifyToken = async (req: Request, bearerToken?: string) => {
if (!bearerToken) return undefined;
const key = await lookUpKey(bearerToken); // 自前のDBやKVで照合
if (!key) return undefined;
return { token: bearerToken, clientId: key.clientId, scopes: key.scopes };
};
const authHandler = withMcpAuth(handler, verifyToken, {
required: true,
requiredScopes: ["tools:call"],
resourceMetadataPath: "/.well-known/oauth-protected-resource",
});
export { authHandler as GET, authHandler as POST };
Vercelのドキュメントによると、有効なトークンがないリクエストは 401、トークンは有効でも必要なスコープがない場合は 403 になります。ツールの中では、検証済みの情報を ctx.http?.authInfo で参照できます。
Claude.aiやChatGPTのコネクタのようにOAuthを使うクライアント向けには、app/.well-known/oauth-protected-resource/route.ts に protectedResourceHandler({ authServerUrls, resourceUrl }) と metadataCorsOptionsRequestHandler() を置いてProtected Resource Metadataを返し、自前または外部サービス(Auth0、Clerk、WorkOSなど)の認可サーバーを指定します。READMEには、2026-07-28の仕様でDynamic Client Registrationが非推奨になりClient ID Metadata Documents(CIMD)が推奨されたとあるので、使う認可サーバーがCIMDに対応しているか確認してください。認可サーバー側の詳しい実装はMCP OAuthサーバー実装の7ステップで解説しています。
6. Vercel Functionの制限をMCPツールの制限に読み替える
Vercel Functionの制限は、そのままMCPリクエスト1回あたりの制限になります。値はVercelの制限・実行時間・ランタイムの各ページ(2026年8月更新)から引いています。
| 制限 | Hobby | Pro / Enterprise | ツール呼び出しへの影響 |
|---|---|---|---|
| 最大実行時間(Fluid) | 既定・上限とも300秒 | 既定300秒、上限800秒、ベータで1,800秒 | 超えると 504 FUNCTION_INVOCATION_TIMEOUT |
| メモリ/CPU | 2GB/1 vCPU | 既定2GB/1 vCPU、最大4GB/2 vCPU | APIを包むだけのサーバーなら十分。重い解析はもっと要ることも |
| リクエスト/レスポンス本文 | 4.5MB | 4.5MB | 大きな引数は 413。ストリーミングしない大きなJSON結果は失敗し、ストリーミング(SSE)応答は対象外 |
/tmp |
最大500MBの一時領域 | 同じ | インスタンスが消えれば消える。状態の保存には使わない |
| バンドルサイズ | 250MB(Pythonは500MB) | 同じ。ベータで最大5GB | 大きなSDKも載る |
| リージョン | 既定は iad1 |
Proは最大3リージョン | ユーザーではなく、ツールが呼ぶAPIの近くに置く |
| バーストスケーリング | リージョンごとに10秒あたり1,000同時実行 | 同じ | 超えると 503 FUNCTION_THROTTLED |
| ファイルディスクリプタ | 同時実行全体で1,024 | 同じ | 1インスタンス内の並列ソケットはこれを分け合う |
実務での読み替えは次のとおりです。
- 長いツール:プランの最大実行時間を超えうるなら、処理を分けるか、MCPのTasksのような仕組みを使います。クライアント側のタイムアウトも別にあるので、進捗通知を送りましょう。
- 大きな結果:数MBのJSONをそのまま返さず、リソースへのリンクやページ分割で返します。
- リージョン:ツール呼び出しの時間の大半は外部APIやDBの待ち時間です。日本の利用者が多くても、呼び出し先のサービスが米国東部にあるなら
iad1のままが速いことがあります。呼び出し先が東京なら東京リージョン(hnd1)を検討してください。
7. Fluid computeでのコールドスタート
Vercelには最小インスタンス数の設定はなく、コールドスタート対策は自動で行われます。Fluid computeのドキュメントには、同時リクエスト間でのインスタンス再利用、バイトコードキャッシュ(Node.js 20以上、本番のみ)、本番デプロイでの事前ウォームアップの3つが挙がっています。一方で「トラフィックが少ない時期などには、コールドスタートが起こりうる」とも書かれています。
たまにしか使わないMCPサーバーでは、次の2点が効いてきます。
- アーカイブ:本番で2週間(プレビューで3日)呼ばれなかった関数はアーカイブされ、次のコールドスタートは「少なくとも1秒長くなる」とされています。月に1回しか使わない個人用サーバーはこれに当たります。
- プレビューは遅め:バイトコードキャッシュはプレビューに適用されないので、レイテンシは本番で測ります。
ルートのモジュール直下は軽く保ちます。ツールの登録は createMcpHandler のコールバック内で行い、DBクライアントは初回利用時に作るようにすれば、コールドスタートがネットワーク待ちで延びません。
8. 月額コスト:5つの試算
Fluid computeの課金は3つに分かれ、MCPで効いてくるのはメモリです。Vercelは「Active CPUはコードが実際に動いている間だけ課金する。リクエストがI/Oを待っている間、CPUの課金は止まるがメモリの課金は続く」と説明しています。
| 単価(iad1) | 価格 | Hobbyの月間無料枠 |
|---|---|---|
| Active CPU | 1時間あたり0.128ドル | 4時間 |
| プロビジョニングされたメモリ | 1GB時間あたり0.0106ドル | 360GB時間 |
| 呼び出し回数 | 100万回あたり0.60ドル(Pro) | 100万回 |
Proはデプロイできるメンバー1人あたり月20ドルで、月20ドル分の使用量クレジットが付きます。Hobbyは無料ですが「非商用の個人利用に限る」とされています。単価はリージョンで異なり、最も高いgru1ではCPU1時間あたり0.221ドルです。
試算は既定の2GBの関数、待ち時間が大半のツール呼び出し、特記のない限り同時実行の重なりなしを前提にしています。
| シナリオ | 使い方 | 月額の使用量(試算) |
|---|---|---|
| A. 個人用サーバー | 3,000回、1回あたり実時間1.5秒・CPU 50ミリ秒 | 約0.03ドル(Hobbyの無料枠内) |
| B. 小規模チーム | 10万回、実時間2秒・CPU 100ミリ秒 | 約1.59ドル(CPU 0.36+メモリ1.18+呼び出し0.06)。Proの20ドル分クレジット内 |
| C. 利用の多いサーバー(重なりなし) | 100万回、実時間2秒・CPU 100ミリ秒 | 約15.93ドル(CPU 3.56+メモリ11.78+呼び出し0.60) |
| D. Cと同じで、10件ずつ同じインスタンスで同時処理 | メモリ時間が10分の1 | 約5.33ドル |
| E. 長時間ツール | 10分かかる呼び出しを1,000回、CPU各5秒 | 約3.71ドル。Proのみ(Hobbyは300秒で打ち切り) |
数字から言えることは3つです。
- 効いてくるのはCPUではなくメモリです。MCPのツールはほとんどAPIを待っているため、シナリオCではメモリにCPUの3倍以上を払っています。
- 最大のレバーはFluidの同時実行です。同じインスタンスで呼び出しが重なると(シナリオD)メモリが共有され、請求は3分の1になります。
- Hobbyは個人用なら収まりますが、チーム用には向きません。シナリオCのメモリ約1,111GB時間はHobbyの360GB時間の3倍で、そもそも商用利用にも当たります。
表に含めていないもの:帯域、ビルド時間、追加メンバー、監視系のオプション。
9. GitHubのstdio MCPサーバーはVercelで動くか
Vercelが案内している方法はありません。GitHubにあるMCPサーバーの多くは、クライアントが npx や uvx で起動して動かし続けるstdioのプログラムです。一方、Vercel Functionはリクエスト単位で起動し、アイドルになれば片付けられます。VercelのMCPドキュメントが扱うのはmcp-handlerで作ったサーバーだけで、stdioサーバーを包む手順は見つかりませんでした。
| Vercel上の選択肢 | 位置づけ | GitHubのstdioサーバーへの適性 |
|---|---|---|
| ツールをmcp-handlerで書き直す | 公式に説明あり | サーバーがHTTP APIの薄いラッパーなら現実的 |
| Functionの中でstdioサーバーを起動する | 説明なし | 動いたとしても、新しいインスタンスのたびに起動とインストールをやり直し、最大実行時間内に収める必要がある |
| Vercel Sandbox | 公式にあるがMCPホスティング用ではない | Firecrackerのマイクロ VMで、セッションはHobbyで最大45分、Proで最大24時間。VercelのMCP事例はツール呼び出しごとにSandboxでコマンドを実行する形で、stdioサーバーを常駐させるものではない |
| FunctionsのContainerランタイム | ランタイムとして説明あり | リクエスト単位のままで、MCP向けの案内はない |
必要なのがstdioのプログラムなら、ブリッジの後ろでプロセスとして動かせるホストに置くのが素直です。自分で行う手順はstdioのMCPサーバーをリモートで動かすチュートリアルで、supergateway・mcp-proxy・FastMCPを比べながら解説しています。
10. チェックリスト
- [ ] mcp-handler 2.xと
@modelcontextprotocol/server^2、zod ^4.2、Node.js 20以上の組み合わせになっている(またはSDK v1とmcp-handler 1.xのまま) - [ ] 1.xの設定(
basePath、redisUrl、maxDuration、[transport]ルート)が残っていない - [ ] ツールは
registerToolとz.object(...)で登録している - [ ]
export const maxDurationが最も遅いツールより長く、プランの上限以内 - [ ] クライアントに本番ドメインを渡している。プレビューは
x-vercel-protection-bypassで接続している - [ ]
withMcpAuthをrequired: trueで使い、スコープを確認している。OAuthクライアント向けにProtected Resource Metadataを返している - [ ] ストリーミングしない応答で4.5MBを超える結果を返すツールがない
- [ ] 残すべきデータを
/tmpやモジュールのグローバル変数に書いていない - [ ] 関数のリージョンを、呼び出し先のAPIやDBの近くにしている
- [ ] SSEしか話せないクライアントを洗い出し、更新した(またはmcp-handler 1.xに留めた)
- [ ] Vercelチームで支出の管理を設定した
11. トラブルシューティング:症状→原因→対処
| 症状 | 考えられる原因 | 対処 |
|---|---|---|
JSONではなくHTMLが返る、またはMCPのエラーなしで 401 |
プレビューや自動生成URLにDeployment Protectionがかかっている | 本番ドメインを使うか、x-vercel-protection-bypass を送る |
正しそうなキーなのに自前のルートが 401 |
verifyToken が undefined を返した、または Bearer が抜けている |
verifyToken の中でログを取り、ヘッダーの形式を確認する |
tools/call で 403 |
トークンに requiredScopes のスコープがない |
スコープ付きのキーを発行するか、requiredScopes を見直す |
/sse や /message で 410 Gone |
クライアントが削除済みのHTTP+SSEを使っている | クライアントをStreamable HTTPに切り替えるか、mcp-handler 1.xに留める |
GETやDELETEで 405 |
2.xはセッション操作に対応していない | 仕様どおり。クライアントはPOSTを使う |
アップグレード後に server.tool で型エラー |
可変長引数の書き方が2.xで廃止 | registerTool と完全な z.object に書き換える |
504 FUNCTION_INVOCATION_TIMEOUT |
ツールが maxDuration を超えた |
上限を上げる(Proは800秒まで)か、処理を分ける |
413 FUNCTION_PAYLOAD_TOO_LARGE |
リクエスト本文が4.5MB超 | データを直接渡さず、URLやリソース参照で渡す |
| 数週間ぶりの最初の呼び出しだけ遅い | 2週間呼ばれず関数がアーカイブされた | 仕様どおり。初回だけ1秒以上長くなる |
| インストール時にpeer dependencyのエラー | mcp-handler 2.xと @modelcontextprotocol/sdk 1.xの混在 |
2章の表の組み合わせに合わせる |
12. NodeFlareならこう解決できる
すでにVercelにデプロイしているNext.jsアプリの中にMCPサーバーを置くなら、Vercelは良い選択です。この記事で挙げた課題が出てくるのは、サーバーがGitHub由来のとき、MCPクライアントがプラットフォームの保護と自作の認証を越えなければならないとき、ツールの待ち時間にもメモリが課金されるときです。NodeFlareではそれぞれ次のように解決します。
| この記事の課題 | NodeFlareでの解決策 |
|---|---|
| GitHubのstdioサーバーを動かす公式の方法がない | GitHubリポジトリ(モノレポのサブディレクトリも可)を選ぶだけで、BuilderがNode.js・Python・Go・Rust・Java・C#/.NETのランタイムと起動コマンドを検出します。stdioしか話せないサーバーはstdioアダプターがHTTPエンドポイントとして公開するので、Dockerfileもコード変更も要りません |
| mcp-handler 2.xで旧SSEトランスポートが消えた | 各サーバーがStreamable HTTPと旧2024-11-05のHTTP+SSEの両方に応答します |
Deployment Protectionの401と、withMcpAuth で自作する認証 |
すべてのリクエストにBearerトークン(mcp_* のAPIキーかOAuthのアクセストークン)が必要で、RFC 8414とRFC 9728に沿ったディスカバリメタデータも用意されます。tools:list や tools:call:get_weather のようなスコープはリクエストごとにサーバーへ届く前に検査され、誤ったキーを繰り返し送るIPは10分間ロックされます |
| ツールがAPIを待つ間も2GB分のメモリが課金される | メモリは256MB・512MB・1GB・2GBから選べます。約1か月の実使用量をもとに適正サイズを提案し、承認したときだけ適用、メモリ不足になれば自動で元に戻します |
| 関数のアーカイブや閑散期のコールドスタート | 数分アイドルが続くとVMをスナップショットして停止し、次のリクエストでスナップショットから1秒未満で復元します。アイドル中は¥0です。Always-On(Pro以上)を使えばスケール to ゼロの対象から外せます |
/tmp は一時領域にすぎない |
Proの永続ディスクは、スケール to ゼロ・再デプロイ・再起動をまたいでデータを残します(¥15/GB・月) |
| デプロイは成功したのにMCPのルートが壊れている | 本物のMCP initialize が往復して初めてデプロイ成功と判定します(バックオフ付きで最大8回再試行) |
| 暴走したエージェントによる想定外の使用量 | 任意のスペンドキャップを設定でき、当月のコストが上限に達するとサーバーはHTTP 402で一時停止します。上限を上げるか翌月になるまで止まります |
| プラットフォームのログはHTTPしか見えない | リクエストログにMCPのメソッド、ツール名、ステータス、レイテンシ、呼び出し元の種類が残ります。保持期間はFreeで7日、Pro・Teamで30日です |
料金:Freeは¥0で、MCPサーバー1つと月30 GB時間のコンピュート。Proは月¥2,980で、サーバー数無制限、コンピュート300 GB時間とストレージ10GBを含みます。超過分はコンピュート¥5/GB時間(CPU・エグレス込み)、ストレージ¥15/GB・月です。
最小の始め方:
- nodeflare.techにGitHubでサインインし、MCPサーバーのリポジトリを選ぶ。
- デプロイして、MCPの
initializeチェックが通るのを待つ。 https://<your-server>.nodeflare.tech/mcpとAuthorization: Bearer <YOUR_API_KEY>をClaude Code・Cursor・自作エージェントに設定する。
1サーバーまで無料で試せます → nodeflare.tech
13. FAQ
VercelでMCPサーバーをホストできますか?
できます。Vercelは自社の mcp-handler で作ったMCPサーバーを、Next.js・Nuxt・SvelteKit・Honoアプリの /api/mcp のようなルートとしてデプロイする方法を公式に案内しています。クライアントは本番URLにStreamable HTTPで接続します。GitHubのstdioサーバーはVercelのドキュメントの対象外です。
VercelでのMCPサーバーは無料で使えますか?
非商用の個人利用なら、たいてい無料枠に収まります。Hobbyには月にActive CPU 4時間、メモリ360GB時間、呼び出し100万回が含まれ、数千回程度の個人用サーバーならごく一部しか使いません。チームや商用で使うならProが必要で、デプロイできるメンバー1人あたり月20ドル、20ドル分の使用量クレジット付きです。
mcp-handler 2.0で何が変わりましたか?
2026年7月のmcp-handler 2.0で、MCP SDK v2のパッケージと、ステートレスな2026-07-28のプロトコルに移行しました。HTTP+SSEトランスポート、Redis、basePath、maxDuration、redisUrl、[transport] ルートが削除され、server.tool は registerTool に、認証情報は ctx.http?.authInfo に変わりました。@modelcontextprotocol/sdk 1.xのプロジェクトはmcp-handler 1.xを使い続けます。
VercelのMCPサーバーにRedisはまだ必要ですか?
mcp-handler 2.xでは不要です。READMEにも「Redisはもう不要で、使われない」とあります。サーバーがステートレスになり、Redisを必要としていたSSEトランスポートが削除されたためです。Redisが必要だったのは1.xでSSEや再開可能ストリームを使う場合だけでした。
VercelのMCPサーバーが401やログイン画面を返すのはなぜですか?
ほとんどの場合、既定で有効なDeployment Protectionが原因です。プレビューURLや自動生成されたデプロイURLが保護され、MCPクライアントはブラウザでのログインができないため、ログインページか 401 を受け取ります。本番ドメインを使うか、Protection Bypass for Automationのシークレットを x-vercel-protection-bypass ヘッダーで送ってください。
VercelでMCPのツール呼び出しは最長何秒まで動きますか?
Hobbyは300秒、ProとEnterpriseは最大800秒で、一部のランタイムではベータで1,800秒まで延ばせます。ルートファイルに export const maxDuration = N と書いて設定します。上限に達すると 504 FUNCTION_INVOCATION_TIMEOUT が返ります。
GitHubのstdio MCPサーバーをVercelで動かせますか?
Vercelはその方法を案内していません。Functionはリクエスト単位で動き、アイドルになると縮小するため、npx や uvx のプロセスを動かし続ける作りではありません。ツールをmcp-handlerで書き直すか、stdio→HTTPのブリッジの後ろでプロセスとして動かせるホストを使います。
mcp-handlerはSSEに対応していますか?
2.xでは対応していません。旧2024-11-05のHTTP+SSEトランスポートは削除され、Vercelのchangelogでは /sse と /message は 410 Gone を返すとされています。SSEしか話せないクライアントは更新するか、サーバー側をmcp-handler 1.xに留める必要があります。
VercelのMCPサーバーにOAuthを付けるには?
ハンドラーを withMcpAuth と verifyToken 関数で包み、/.well-known/oauth-protected-resource で protectedResourceHandler によるProtected Resource Metadataを返します。mcp-handlerはトークンを発行しないので、自前か外部サービスの認可サーバーも必要です。トークンがなければ 401、スコープが足りなければ 403 になります。
Vercel MCPとmcp-handlerの違いは?
Vercel MCPは、Vercel自身が mcp.vercel.com で提供するホスト型のMCPサーバーで、AIクライアントからVercelのプロジェクト・デプロイ・ログを操作するためのものです。mcp-handlerは、自分のMCPサーバーを作ってVercelでホストするためのオープンソースのパッケージです。提供元が同じというだけで、役割は別です。
VercelでMCPサーバーを動かすといくらかかりますか?
iad1の単価で試算すると、月10万回のチーム用サーバーで使用量は約1.59ドル、月100万回で重なりなしなら約16ドルで、いずれもProの月20ドル分のクレジット内かその近辺です。ツールがAPIを待つ間もメモリが課金されるためメモリ代が大半を占め、同じインスタンスで呼び出しが重なるほど安くなります。
VercelのMCPサーバーはどのリージョンで動かすべきですか?
既定は iad1(米国ワシントンD.C.)です。ツールが最もよく呼ぶAPIやDBのリージョンに合わせてください。ツール呼び出し1回で外部へのリクエストは何度も発生しますが、クライアントとの往復は1回だけだからです。日本の利用者向けでも、呼び出し先が東京にあるなら hnd1 が候補になります。Proでは関数ごとに最大3リージョンまで選べます。
まとめ
MCPサーバーを、すでにVercelで動かしているWebアプリの中に置くなら、VercelでのMCP Hostingは相性の良い選択です。作るならmcp-handler 2.xで、MCP SDK v2、ステートレスな2026-07-28のサーバー、SSE・Redis・[transport] ルートなしという前提になります。そのうえで、Deployment Protectionにログイン画面を返されないよう本番ドメインを渡し、withMcpAuth で認証を付け、ツールをプランの最大実行時間と4.5MBの上限に収め、待ち時間にもメモリが課金されることを覚えておきます。個人やチームのサーバーなら使用量はわずかです。残る課題はGitHubのstdioサーバーで、Vercelはその動かし方を案内していません。
参考資料
- Vercel「Deploy MCP servers to Vercel」:https://vercel.com/docs/mcp/deploy-mcp-servers-to-vercel
- vercel/mcp-handler README:https://github.com/vercel/mcp-handler
- npm mcp-handler:https://www.npmjs.com/package/mcp-handler
- Vercel changelog「Latest MCP spec now supported in mcp-handler」:https://vercel.com/changelog/latest-mcp-spec-now-supported-in-mcp-handler
- Vercel Functionsの制限:https://vercel.com/docs/functions/limitations
- Vercel 最大実行時間の設定:https://vercel.com/docs/functions/configuring-functions/duration
- Vercel Fluid compute:https://vercel.com/docs/fluid-compute
- Vercel Functionsの使用量と料金:https://vercel.com/docs/functions/usage-and-pricing
- Vercel Proプラン:https://vercel.com/docs/plans/pro-plan
- Vercel Hobbyプラン:https://vercel.com/docs/plans/hobby
- Vercel Deployment Protection:https://vercel.com/docs/deployment-protection
- Vercel 自動化エージェントからのアクセス:https://vercel.com/docs/deployment-protection/automated-agent-access
- Vercel Protection Bypass for Automation:https://vercel.com/docs/deployment-protection/methods-to-bypass-deployment-protection/protection-bypass-automation
- Vercel Sandbox:https://vercel.com/docs/sandbox
- Vercel MCP:https://vercel.com/docs/agent-resources/vercel-mcp
- MCP仕様 バージョニング:https://modelcontextprotocol.io/specification/versioning
