Kanji
・クラウドエンジニア / フリーランス ・1993年生まれ ・愛媛県出身 / 東京都渋谷区在住 ・AWS歴5年 プロフィールの詳細
目次
2025年後半から社内ツールや個人開発の現場で Antigravity や Claude Code を使い倒す中で、僕が真っ先に取り組んだのが「社内 DB や BigQuery、社内特有の運用スクリプトを叩くためのリモート MCP サーバー構築」でした。
開発当初、MCP(Model Context Protocol)の標準仕様として広く使われていたのは、HTTP SSE(Server-Sent Events)を用いたステートフルなストリーミング通信でした。ローカル環境の localhost で動かしているうちは何の問題もありません。しかし、これを Google Cloud のマネージドコンテナ基盤である Cloud Run へデプロイした瞬間、厄介なトラブルに見舞われました。
localhost
Cloud Run はサーバーレスアーキテクチャのため、リクエスト数に応じてインスタンスがゼロから数十台まで自動でスケールし、アイドル状態になれば容赦なくコンテナが破棄(スケール・トゥ・ゼロ)されます。一方、旧来の MCP 仕様では接続開始時に initialize ハンドシェイクを行い、サーバーが発行した Mcp-Session-Id を後続の tools/call や resources/read リクエストのヘッダーに含めて引き回す設計でした。
initialize
Mcp-Session-Id
tools/call
resources/read
これが原因で、現場では以下のような現象が頻発しました。
404 Session Not Found
min-instances: 1
「サーバーレスで動かしたいのに、プロトコルがステートフルを強要してくる」というこのジレンマを一掃したのが、2026年7月28日に公開された 「MCP 2026-07-28」 の大型仕様改定でした。
▲ ローカル AI エージェントから Cloud Run 上のステートレス MCP サーバーへ Google Cloud IAM 認証経由でアクセスするアーキテクチャ全体像
新仕様「2026-07-28」における最大の変化は、プロトコルコアの 「完全ステートレス化」 です。旧仕様との違いを整理すると、以下の表のようになります。
_meta
Mcp-Method
Mcp-Name
特にサーバーレス運用で画期的なのが MRTR です。
エージェントが実行するツールの中には、「本番環境のデータベースを更新してよいか?」「外部 API へ課金リクエストを送ってよいか?」など、人間の承認(Human-in-the-Loop: HITL)や追加パラメータの入力を求めるものがあります。
旧仕様では、承認待ちの間もサーバーとクライアント間で常時接続を維持し続けなければなりませんでした。しかし新仕様の MRTR では、サーバーは追加情報が必要になった時点で HTTP ステータスとともに input_required レスポンスと継続トークン( continuation_token )を返し、 そのリクエストを一度正常終了(切断) させます。
input_required
continuation_token
クライアント側でユーザーが承認を入力した後は、その回答と継続トークンを含めて再度リクエストを送ります。このとき、リクエストが最初とは別のコンテナインスタンス(インスタンス B)に飛んでも、暗号化された継続トークンや分散ストアからコンテキストが復元されるため、何の問題もなく処理が完了します。
リモート MCP サーバーを公開する際、絶対に避けるべきなのが「独自の静的 API キーを X-Api-Key ヘッダーに乗せてインターネットに晒す」という設計です。API キーはエージェントの設定ファイル( mcp_config.json 等)にハードコードされやすく、誤ってリポジトリへコミットされたり漏洩したりするリスクが常に付きまといます。
X-Api-Key
mcp_config.json
Google Cloud の Cloud Run を使う最大の強みは、 Google Cloud ネイティブの IAM 認証( roles/run.invoker )と OIDC ID トークンによるゼロトラストアクセス がそのまま使える点です。
roles/run.invoker
--no-allow-unauthenticated
https://<service-name>-<hash>-an.a.run.app
Authorization: Bearer <ID_TOKEN>
Google Cloud のフロントエンドプロキシが Cloud Run コンテナへリクエストを渡す前に ID トークンの署名と有効期限を検証するため、不正なアクセスはコンテナの処理に到達する前に HTTP 403 / 401 で遮断されます。
# 0. 呼び出し元のユーザーまたはサービスアカウントに roles/run.invoker を最小権限付与 gcloud run services add-iam-policy-binding mcp-secops-server \ --region=asia-northeast1 \ --member="user:developer@example.com" \ --role="roles/run.invoker" # 1. Cloud Run サービスの URL を取得 SERVICE_URL=$(gcloud run services describe mcp-secops-server --region asia-northeast1 --format 'value(status.url)') # 2. 対象サービス用の ID トークン(aud クレーム一致)を動的に発行 ID_TOKEN=$(gcloud auth print-identity-token --audiences="${SERVICE_URL}") # 3. Mcp-Method ヘッダーと Bearer トークンを付与してステートレスにツール一覧を取得 curl -s -X POST "${SERVICE_URL}/mcp" \ -H "Authorization: Bearer ${ID_TOKEN}" \ -H "Mcp-Method: tools/list" \ -H "Content-Type: application/json" \ -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | jq .
▲ Cloud Run サービスにおける未認証アクセスの拒否(--no-allow-unauthenticated)と IAM プリンシパルへの roles/run.invoker 最小権限付与設定
実際に僕が検証環境で稼働させている、MCP 2026-07-28 仕様準拠のステートレスサーバーの最小構成コードです。Node.js(Express)をベースに、ハンドシェイクなしで単一の POST エンドポイントで直接ツール実行やリソース取得を受け付けます。
// src/server.ts import express, { Request, Response } from 'express'; const app = express(); app.use(express.json()); // ヘルスチェック用エンドポイント(Cloud Run 起動プローブ用) app.get('/healthz', (_req: Request, res: Response) => { res.status(200).send('OK'); }); // MCP 2026-07-28 ステートレス統一エンドポイント app.post('/mcp', async (req: Request, res: Response) => { const mcpMethod = req.header('Mcp-Method') || req.body?.method; const requestId = req.body?.id ?? 1; // 1. サーバー検出 / ツール一覧の返却 if (mcpMethod === 'tools/list' || req.body?.method === 'tools/list') { return res.json({ jsonrpc: '2.0', id: requestId, result: { tools: [ { name: 'query_security_audit_logs', description: 'Cloud Logging から直近のセキュリティ重要イベントを抽出します', inputSchema: { type: 'object', properties: { hoursAgo: { type: 'number', description: '遡る時間(デフォルト: 1)' }, severity: { type: 'string', enum: ['WARNING', 'ERROR', 'CRITICAL'] } }, required: ['severity'] } } ] } }); } // 2. ツール実行 (tools/call) if (mcpMethod === 'tools/call' || req.body?.method === 'tools/call') { const { name, arguments: args } = req.body.params; if (name === 'query_security_audit_logs') { const severity = args?.severity || 'ERROR'; const hoursAgo = args?.hoursAgo || 1; // 実際の GCP 内部処理(Cloud Logging API 呼び出し等)をここに実装 const mockResult = [ { timestamp: new Date().toISOString(), severity: severity, resource: 'projects/my-prod-project/instances/db-01', message: 'IAM permission check failed for service account' } ]; return res.json({ jsonrpc: '2.0', id: requestId, result: { content: [ { type: 'text', text: JSON.stringify(mockResult, null, 2) } ], isError: false } }); } return res.status(404).json({ jsonrpc: '2.0', id: requestId, error: { code: -32601, message: `Tool ${name} not found` } }); } return res.status(400).json({ jsonrpc: '2.0', id: requestId, error: { code: -32600, message: `Unsupported MCP method: ${mcpMethod}` } }); }); const PORT = process.env.PORT || 8080; app.listen(PORT, () => { console.log(`[MCP Server] Stateless Remote MCP listening on port ${PORT}`); });
Cloud Run ではコールドスタート時間を短縮することがユーザー体験に直結します。マルチステージビルドと Node.js Alpine または distroless イメージを採用し、イメージサイズを 100MB 未満に抑えます。
# Multi-stage build for Minimal Stateless MCP Server FROM node:22-alpine AS builder WORKDIR /app COPY package*.json tsconfig.json ./ RUN npm ci COPY src ./src RUN npm run build FROM node:22-alpine AS runner WORKDIR /app ENV NODE_ENV=production COPY package*.json ./ RUN npm ci --only=production COPY --from=builder /app/dist ./dist USER node EXPOSE 8080 CMD ["node", "dist/server.js"]
東京リージョン( asia-northeast1 )へ最小インスタンス 0(スケール・トゥ・ゼロ対応)でデプロイします。
asia-northeast1
PROJECT_ID="your-gcp-project-id" REGION="asia-northeast1" SERVICE_NAME="mcp-secops-server" # コンテナイメージのビルドと Cloud Run へのデプロイ gcloud run deploy "${SERVICE_NAME}" --source . --region "${REGION}" --project "${PROJECT_ID}" --no-allow-unauthenticated --min-instances 0 --max-instances 10 --cpu 1 --memory 512Mi --concurrency 80 --timeout 60s
ローカルの AI エージェントから Cloud Run 上のステートレス MCP サーバーを呼び出す場合、クライアント設定にラッパースクリプトまたは OIDC 認証対応の MCP コネクタを指定します。
たとえば Antigravity や Claude Code で利用するラッパーコマンド( mcp-cloudrun-proxy )を設定する場合の mcp_config.json 定義は以下のようになります。
mcp-cloudrun-proxy
{ "mcpServers": { "cloudrun-secops": { "command": "node", "args": [ "/usr/local/bin/cloudrun-mcp-proxy.js", "--url", "https://mcp-secops-server-xyz-an.a.run.app/mcp" ], "env": { "CLOUD_RUN_AUDIENCE": "https://mcp-secops-server-xyz-an.a.run.app" } } } }
このプロキシスクリプトは、内部で gcloud auth print-identity-token を呼び出して OIDC ID トークンを取得し、エージェントからのリクエストを Cloud Run の /mcp エンドポイントへの HTTP リクエストへと変換します。なお、ローカル開発環境で手早く IAM 認証プロキシを立ち上げたい場合は、Google Cloud SDK 標準の gcloud run services proxy mcp-secops-server --region=asia-northeast1 --port=8080 を実行して http://localhost:8080/mcp へ接続する構成も有効です。
gcloud auth print-identity-token
/mcp
gcloud run services proxy mcp-secops-server --region=asia-northeast1 --port=8080
http://localhost:8080/mcp
▲ リモート検証環境から gcloud auth による ID トークン発行と Mcp-Method ヘッダーを用いたステートレス API 疎通確認ログ
僕が実際に数週間にわたってこの構成を個人検証および開発業務で運用してみて得られた、リアルな数値と運用の注意点をまとめます。
--min-instances 1
cpu: 1
memory: 512Mi
gcloud
Authorization: Bearer <GCP_ID_TOKEN>
Authorization
X-Upstream-Authorization
長らく「ローカルの stdio 前提」や「不安定な常時接続 SSE」に縛られていた MCP サーバー運用ですが、2026-07-28 の大型仕様改定によってようやくクラウドネイティブな世界へ足を踏み入れることができました。
完全ステートレス化されたことで、Cloud Run の強力なオートスケーリング、スケール・トゥ・ゼロ、そして Google Cloud IAM による堅牢なゼロトラスト認証の恩恵をフルに享受できます。
自前のスクリプトや社内データをセキュアに AI エージェントへ開放したいと考えている方は、ぜひこの Cloud Run × ステートレス MCP 構成を試してみてください。
日本株・グローバル企業の適時開示・決算速報をAIクオンツ解析。市場モメンタムや注目銘柄をリアルタイムに可視化するデータポータルです。
本番さながらのAI電話で初通話もデート誘いも余裕に。通話中の対話をリアルタイム解析し、最適な切り返しや好感度アップの助言を即座にサジェスト。24時間いつでも通話練習が可能です(無料体験あり・1レッスン 約150円〜)。
レシートを撮影するだけでGemini AIが品目・金額を高精度OCR解析。LINEログインで友人との面倒な立替・割り勘計算を美しく完結します。
占い師・執事・バーテンダーなどのAIキャラクターが進行役となり、お題やゲームを出題。集まる時間を最高にエキサイティングにするiOSアプリ。
人工甘味料や添加物のNG成分除外フィルターと、有効成分あたりの実質単価を徹底比較・可視化するヘルスケア比較データベースです。