Docker MCP GatewayをリモートのMCP Hostingにする方法:streaming設定・Bearerトークン・docker.sock問題と静的モード【v0.44.3対応】
Docker MCP GatewayをリモートのMCP Hostingとして使い、Claude Code・Cursor・自作エージェントから接続する方法を解説。streamingの/mcp、未設定だと再起動ごとに変わるMCP_GATEWAY_AUTH_TOKEN、Compose+Caddyの構成、docker.sock不要の静的モード、セッション単位のメモリ試算、Originの403まで、ソースで確認しました。
最終更新:2026年11月22日 / 対象:
docker/mcp-gatewayv0.44.3(2026年10月26日タグ付け、プレリリース扱い)とmainブランチのコミット4b5180c(2026年11月19日)、MCP仕様 2026-07-28。フラグと既定値はDockerのCLIリファレンスと、同タグのGoソースコードを読んで確認しました。自分で確かめられるよう、該当ファイルのパスも書いています。
結論(30秒で読める要約)
Docker MCP GatewayをMCP Hostingとして使うとは、サーバー上で docker mcp gateway run --transport=streaming を動かし、Claude Code・Cursor・自作エージェントからStreamable HTTPでゲートウェイの /mcp に接続させることです。ゲートウェイは裏でカタログのMCPサーバーを1つずつDockerコンテナとして起動します。MITライセンスの無料ソフトで実用になりますが、ノートPCで使うDocker DesktopのMCP Toolkitとは、リモートで動かすときの前提がかなり違います。
| 確認したいこと | v0.44.3での答え |
|---|---|
| 外部のクライアントから接続できるか | できる。--transport=streaming(別名 http・streamable・streamable-http)なら /mcp、--transport=sse なら /sse |
| 認証 | 共有のBearerトークン1つ。既定で必須。MCP_GATEWAY_AUTH_TOKEN から読み、未設定なら起動のたびにランダム生成する |
| クライアント向けのOAuth | なし。ゲートウェイのOAuthは、GitHubなど外部サービスへ接続するためのもの |
| TLS | なし。Caddy・nginx・トンネルを前に置く |
| 既定の待ち受けアドレス | 全インターフェース(--host の既定値が空) |
| ブラウザから使うクライアント | Origin ヘッダーが localhost・127.0.0.1・::1 以外だと 403 |
| ホストに必要なもの | Docker Engine。既定の動的モードでは、ゲートウェイにDockerソケットのマウントも必要 |
| サーバーごとの上限 | 既定で1コンテナあたり --cpus 1(整数のみ)、--memory 2Gb |
| プロトコルバージョン | 同梱のGo SDK v1.4.1が知っているのは2025-11-25まで。2026-07-28は含まれない |
| GitHubのstdioサーバーをそのまま動かせるか | できない。イメージとカタログ(またはサーバー定義)が必要 |
「Docker MCP Toolkitをリモートで使う」系の解説で抜けがちな点が4つあります。
- トークンを固定しないと、再起動のたびに変わる。
MCP_GATEWAY_AUTH_TOKENが未設定だと、pkg/gateway/auth.goが起動ごとに50文字のトークンを作り直してログに出します。コンテナが再起動しただけで、全クライアントの接続が切れます。 - 動的モードでは、ゲートウェイにDockerデーモンの操作権を渡すことになる。 公式のCompose例は、必要なときに
docker runするために/var/run/docker.sockをゲートウェイにマウントしています。静的モード(--static=true)なら、サーバーをComposeのサービスとして先に起動しておくので、ソケットは不要です。 --long-livedはサーバー単位ではなく、クライアントのセッション単位。 コンテナを使い回すときのキーは「サーバー名とクライアントセッションの組」です。クライアント5つ × サーバー3つなら15コンテナになり、既定ではそれぞれ最大2GBまで使えます。- ゲートウェイのプロトコルバージョンは、最新のクライアントより古い。 2026-07-28を求めるクライアントは、Go SDKが対応する版に下げて接続します。またサーバーは
Mcp-Session-Idを使うステートフルなセッションを持つので、複数台に分けるときはスティッキーなルーティングが必要です。
目次
- Docker MCP GatewayをMCP Hostingに使うとは
- ローカルのMCP Toolkitとリモートのゲートウェイの違い
- リモートで使うときに設定するフラグ
- 手順:Docker ComposeとCaddyでリモートゲートウェイを立てる
- 静的モード:ゲートウェイにDockerソケットを渡さない
- サーバーコンテナの起動タイミングとメモリへの影響
- Claude Code・Cursor・自作エージェントからの接続
- ソースを読んで分かった6つの挙動
- 公開前チェックリスト
- よくあるハマりどころ(症状→原因→対処)
- Docker MCP Gatewayが向かないケース
- NodeFlareならこう解決できる
- よくある質問 まとめ
1. Docker MCP GatewayをMCP Hostingに使うとは
Docker MCP Gatewayとは、複数のMCPサーバーをクライアントからは1つのMCPサーバーとして見せ、それぞれを専用のコンテナで動かすオープンソースのMCPプロキシです。docker mcp というCLIプラグインとして提供され、docker/mcp-gateway イメージとしても配布されています。Dockerのドキュメントは処理の流れを「どのサーバーがそのツールを担当するかを特定し、起動していなければDockerコンテナとして起動する」「必要な認証情報を注入し、セキュリティ制限をかけてからリクエストを転送する」と説明しています。
ノートPCでは、Docker DesktopのMCP Toolkitがゲートウェイをstdioで起動し、IDEがそれをローカルのコマンドとして呼び出します。これをMCP Hostingとして使うには、次の3点が変わります。
- ゲートウェイがstdioではなく、HTTPのトランスポートでTCPを待ち受ける
- クライアントとは別のマシン(VPS、自宅サーバー、クラウドのVM)で、Docker Desktopなしで動く
- クライアントがインターネット越しに接続するので、TLS、固定のトークン、公開ホスト名が必要になる
Dockerは、ゲートウェイが「Docker DesktopのMCP Toolkitとは独立して動き」「Docker Engineがあればどこでも動く」と書いています。Docker Desktopがない環境では、GitHubのリリースページからプラグインのバイナリを取得して ~/.docker/cli-plugins/docker-mcp に置くか、docker/mcp-gateway イメージを使います。このイメージには、Desktopの存在チェックを飛ばす DOCKER_MCP_IN_CONTAINER=1 が最初から設定されています。
2. ローカルのMCP Toolkitとリモートのゲートウェイの違い
| Docker DesktopのMCP Toolkit(ローカル) | サーバー上のDocker MCP Gateway(リモート) | |
|---|---|---|
| トランスポート | stdio(既定) | streaming で /mcp、または sse で /sse |
| ゲートウェイを起動するのは | MCPクライアント(子プロセスとして) | systemdやDocker Compose(常時起動) |
| クライアント | 同じマシンの1つ | URLに届くあらゆる場所から複数 |
| シークレット | Docker Desktopのシークレットストア(--secrets=docker-desktop) |
--secrets で渡す .env ファイル(Composeのsecret) |
| 認証 | stdioでは不要 | Bearerトークン。v0.43.1から既定で必須 |
| TLS | 不要 | リバースプロキシで用意する |
| 使うサーバーの指定 | Toolkitの画面とプロファイル | --servers・--catalog・--profile のフラグやファイル |
| Dockerへのアクセス | Desktop自身のバックエンド | ゲートウェイにDockerソケットをマウント、または静的モード |
クライアントがすべてDockerを動かしているマシン上にあるなら、ここから先の作業は要りません。以降は、クライアントが別の場所にある前提で説明します。
3. リモートで使うときに設定するフラグ
リモート用に設定する docker mcp gateway run のフラグです。既定値はCLIリファレンスと、v0.44.3の cmd/docker-mcp/commands/gateway.go で確認しました。
| フラグ | 既定値 | リモートでの設定 |
|---|---|---|
--transport |
stdio |
streaming(/mcp でStreamable HTTP)。sse は旧トランスポート(2024-11-05)を /sse で提供 |
--port |
なし(stdio) | TCPポート。例:8811 |
--host |
空=全インターフェース | 同じホストのComposeの外でリバースプロキシを動かすなら 127.0.0.1。Composeのネットワーク内なら空のまま |
--servers |
なし | カタログ名をカンマ区切りで。例:duckduckgo,fetch |
--profile |
default プロファイル |
プロファイルID。--servers とは同時に使えない |
--secrets |
docker-desktop |
Dockerの公式Compose例と同じ docker-desktop:/run/secrets/mcp_secret。中身は github.personal_access_token=... のような .env 形式 |
--static |
false | 起動済みのサーバーコンテナにつなぐなら true(5章) |
--long-lived |
false | 状態を持つサーバーなら true。クライアントのセッション単位で効く(6章) |
--cpus / --memory |
サーバーごとに 1 / 2Gb |
小さいホストでは --memory を下げる(例:512m)。--cpus は整数として扱われる |
--block-network |
false | true にすると、サーバーの通信先をカタログで許可したホストに限定できる |
--verify-signatures |
有効(v0.43.1のリリースノートより) | 有効のままにする。その場合、Docker Hubの mcp/... イメージはダイジェストで固定する |
--log-calls |
true |
有効のまま。v0.43.1から引数の値そのものは記録されない |
--allow-unauthenticated |
false | 外から届く待ち受けでは使わない。使うとゲートウェイが警告を出す |
--host と --allow-unauthenticated の2つは、CLIリファレンスの表には載っていませんが、v0.44.3のソースには存在します。トークンを渡す環境変数は MCP_GATEWAY_AUTH_TOKEN です。
4. 手順:Docker ComposeとCaddyでリモートゲートウェイを立てる
Docker Engineを入れたLinuxホスト1台で、ゲートウェイとCaddyを動かす構成です。CaddyがTLSを終端し、Composeのネットワーク経由でゲートウェイに転送します。mcp.example.com は、DNSをそのサーバーに向けた自分のホスト名に置き換えてください。
手順1:固定のトークンとシークレットのファイルを作る
mkdir -p ~/mcp-gw && cd ~/mcp-gw
echo "MCP_GATEWAY_AUTH_TOKEN=$(openssl rand -hex 32)" > .env.gateway
# MCPサーバー用のシークレット。名前は <サーバー名>.<シークレット名>
echo "github.personal_access_token=ghp_xxx" > mcp-secrets.env
chmod 600 .env.gateway mcp-secrets.env
手順2:compose.yaml
services:
gateway:
image: docker/mcp-gateway:latest # 本番ではダイジェストで固定する
restart: unless-stopped
env_file: .env.gateway # MCP_GATEWAY_AUTH_TOKEN を渡す
command:
- --transport=streaming
- --port=8811
- --servers=duckduckgo,fetch
- --secrets=docker-desktop:/run/secrets/mcp_secret
- --memory=512m
- --block-network
volumes:
- /var/run/docker.sock:/var/run/docker.sock # 動的モード。5章を参照
secrets:
- mcp_secret
caddy:
image: caddy:2
restart: unless-stopped
ports:
- "443:443"
- "80:80"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
secrets:
mcp_secret:
file: ./mcp-secrets.env
volumes:
caddy_data:
ゲートウェイはホストにポートを公開していません。外から届くのはCaddyだけです。
手順3:Caddyfile
mcp.example.com {
reverse_proxy gateway:8811 {
flush_interval -1
}
}
flush_interval -1 は、ストリームで返るレスポンスをCaddyがためずにすぐ流すための設定です。ツール呼び出しがイベントストリームで返るときに効いてきます。
手順4:起動してログを確認する
docker compose up -d
docker compose logs gateway | grep -E "Gateway URL|Bearer"
# > Gateway URL: ...:8811/mcp
# > Use Bearer token from MCP_GATEWAY_AUTH_TOKEN environment variable
ログに Use Bearer token: <値> と出た場合は、環境変数がコンテナに届いていません。ゲートウェイが自分でトークンを作っており、次の再起動で変わります。
手順5:クライアントを設定する前に、エンドポイントを直接試す
TOKEN=$(cut -d= -f2 .env.gateway)
curl -si https://mcp.example.com/mcp \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'
正しく動いていれば 200 と、レスポンスヘッダーの Mcp-Session-Id が返ります。Authorizationヘッダーがないと、WWW-Authenticate: Bearer realm="MCP Gateway" 付きの 401 になります。GET /health はトークンなしで応答するので、死活監視はここに向けます。
5. 静的モード:ゲートウェイにDockerソケットを渡さない
/var/run/docker.sock をマウントすると、ゲートウェイのコンテナがDockerデーモンを操作できるようになります。Docker自身のセキュリティドキュメントは「Dockerデーモンを操作できるのは信頼できるユーザーだけにすべき」と注意しており、ゲートウェイのセキュリティモデルもDockerデーモンを「信頼する側」に置いています。インターネットに面したサーバーでは、ゲートウェイのプロセス1つが破られるとホスト全体に影響する構成になります。
静的モードなら、このソケットが要りません。各サーバーを自分でComposeのサービスとして起動しておき、ゲートウェイは docker run せずにComposeのネットワーク越しに接続します。ソース(pkg/gateway/clientpool.go)では、静的モードのサーバーに socat で TCP:mcp-<名前>:4444 へつなぎます。対応するサービス定義はDockerの examples/compose-static(「Experimental」と表記)にあります。
services:
gateway:
image: docker/mcp-gateway:latest
env_file: .env.gateway
command:
- --transport=streaming
- --servers=duckduckgo
- --port=8811
- --static=true
depends_on:
- mcp-duckduckgo
# docker.sock はマウントしない
mcp-duckduckgo:
image: mcp/duckduckgo@sha256:68eb20db6109f5c312a695fc5ec3386ad15d93ffb765a0b4eb1baf4328dec14f
entrypoint: ["/docker-mcp/misc/docker-mcp-bridge", "python", "-m", "duckduckgo_mcp_server.server"]
init: true
cpus: 1
mem_limit: 2g
security_opt:
- no-new-privileges
labels:
- docker-mcp=true
- docker-mcp-tool-type=mcp
- docker-mcp-name=duckduckgo
- docker-mcp-transport=stdio
volumes:
- type: image
source: docker/mcp-gateway
target: /docker-mcp
サービス名は mcp-<サーバー名> にする必要があります。エントリーポイントでは、サーバー本来のコマンドを docker-mcp-bridge で包みます。このブリッジがポート4444で待ち受け、TCPとサーバーのstdioをつなぎます。その代わり、全サーバーが常に起動したままになり、各サーバーのイメージとコマンドをカタログから書き写す手間と、シークレットを各サービスの環境変数に自分で渡す手間がかかります。
| 動的モード(既定) | 静的モード(--static=true) |
|
|---|---|---|
| ゲートウェイへのDockerソケット | 必要 | 不要 |
| サーバーコンテナ | 必要なときに起動 | 常時起動。自分で定義する |
| アイドル時のメモリ | 使っていないサーバーはほぼゼロ | 全サーバーぶんを常に使う |
| 最初の呼び出しの遅さ | コンテナの起動時間が乗る | 起動時間は乗らない |
| 保守 | カタログ名を書くだけ | イメージ・エントリーポイント・ラベルを自分で管理 |
6. サーバーコンテナの起動タイミングとメモリへの影響
ゲートウェイのコンテナには3つのライフサイクルがあります。どれも pkg/gateway/clientpool.go で確認できます。
| モード | コンテナが起動するとき | 止まるとき | 同時に存在する数 |
|---|---|---|---|
| 既定 | ツール呼び出しのたびに docker run --rm -i --init --security-opt no-new-privileges で起動 |
その呼び出しのクライアントを解放したとき | 実行中の呼び出しごとに1つ |
--long-lived(またはサーバー定義の longLived: true) |
クライアントセッションで最初に呼び出したとき | そのセッションが終わるか、ゲートウェイが止まったとき | サーバー数 × 接続中のセッション数 |
--static=true |
Composeを起動したとき | Composeを止めたとき | サーバーごとに1つ |
さらにゲートウェイは、設定を読み込んだ時点で、有効なサーバーを並列に起動してツールの一覧を取得します(pkg/gateway/capabilitites.go)。カタログ内のリモートサーバーはコンテナを使わないので、常に使い回しの対象です。
--long-lived のメモリへの影響は、キャッシュのキーが {serverName, session} であるため見落としやすい点です。既定の --memory 2GBで計算すると次のとおりです。
| 接続中のクライアントセッション | 有効なサーバー | 常駐するコンテナ | メモリ上限の合計(既定2GB) | --memory=512m の場合 |
|---|---|---|---|---|
| 1 | 3 | 3 | 6 GB | 1.5 GB |
| 5 | 3 | 15 | 30 GB | 7.5 GB |
| 20 | 3 | 60 | 120 GB | 30 GB |
これは上限の合計で、実測値ではありません。小さなPythonやNodeのサーバーなら実際の使用量は2GBよりずっと少ないことが多いですが、メモリを割り当てすぎたホストでカーネルがコンテナを強制終了するかどうかは、この上限で決まります。--long-lived を付けなければアイドル時のメモリはかかりませんが、毎回コンテナの起動を待つことになり、メモリ上に状態を持つサーバー(ブラウザ、DB接続、一時ファイルなど)は呼び出しごとに状態を失います。
7. Claude Code・Cursor・自作エージェントからの接続
どのクライアントでも必要なのは3つです。https://mcp.example.com/mcp、Streamable HTTPのトランスポート、Authorization: Bearer <トークン> です。
Claude Code
claude mcp add --transport http docker-gw https://mcp.example.com/mcp \
--header "Authorization: Bearer ${MCP_GATEWAY_AUTH_TOKEN}"
Cursor(~/.cursor/mcp.json)
{
"mcpServers": {
"docker-gw": {
"url": "https://mcp.example.com/mcp",
"headers": { "Authorization": "Bearer ${env:MCP_GATEWAY_AUTH_TOKEN}" }
}
}
}
自作エージェント:Streamable HTTPのトランスポートでHTTPヘッダーを指定できるMCPクライアントライブラリなら使えます。上のcurlの例と同じく、URLと Authorization ヘッダーを渡します。
Claude(Web・デスクトップ・モバイル)とChatGPT は各社のクラウドから接続し、カスタムコネクタにはOAuthか認証なしを前提としています。ゲートウェイが提供するのは固定のBearerトークンだけなので、組織でClaudeのリクエストヘッダー機能(ベータ)が使える場合を除き、相性はよくありません。自作エージェントやIDE系のクライアントなら、固定ヘッダーだけで足ります。
8. ソースを読んで分かった6つの挙動
v0.44.3のタグで読んだ、リモート運用の成否を分ける挙動です。
| 挙動 | 場所 | 運用への影響 |
|---|---|---|
MCP_GATEWAY_AUTH_TOKEN が未設定だと、起動ごとに新しいトークンをランダム生成する |
pkg/gateway/auth.go |
必ず環境変数を設定する。でないと再起動で全クライアントの設定が無効になる |
Origin が localhost・127.0.0.1・::1 以外のリクエストは403 |
pkg/gateway/transport.go(originSecurityHandler) |
CLIやIDEのクライアントは Origin を送らないので通る。別オリジンのブラウザ上のクライアントはつながらない |
--host の既定値は空で、全インターフェースで待ち受ける |
pkg/gateway/run.go |
ports: で公開すると、平文HTTPのゲートウェイに直接届いてしまう。公開するのはプロキシだけにする |
/ は /mcp(または /sse)へリダイレクトし、/health は認証を通らない |
pkg/gateway/transport.go、auth.go |
死活監視は /health に向ける。クライアントには /mcp まで含めたURLを渡す |
| TLSで待ち受ける処理がない | pkg/gateway/run.go は素の http.Server を使う |
TLSはリバースプロキシかトンネルで用意する |
| Streamable HTTPの処理はGo SDK v1.4.1の既定で、ステートフル。対応バージョンは2025-11-25まで | go.mod、同梱の go-sdk/mcp/shared.go |
2026-07-28を求めるクライアントは古い版に下げて接続する。ゲートウェイを複数台にするなら、同じセッションを同じ台に振り分ける |
もう1点、例のファイルについて。examples/client/compose.yaml は今も MCP_GATEWAY_AUTH_TOKEN なしでstreamingのゲートウェイを起動しています。v0.43.1でBearer認証が既定になったため、この例のクライアントが接続するには、ログに出た生成トークンを渡す必要があります。
9. 公開前チェックリスト
- [ ]
MCP_GATEWAY_AUTH_TOKENをシークレットから設定し(32バイト以上のランダム値)、ログに「from MCP_GATEWAY_AUTH_TOKEN」と出ている - [ ] ポートを公開しているのはリバースプロキシだけで、ゲートウェイのポートには外から届かない
- [ ] 公開ホスト名でTLSが動き、ストリームのレスポンスがバッファされない
- [ ]
--allow-unauthenticatedを付けていない - [ ]
--serversか--profileに、公開するつもりのサーバーだけが入っている - [ ] Docker Hubの
mcp/...イメージをダイジェストで固定し、署名検証を有効にしている - [ ] セッション数 × サーバー数がホストに収まるよう
--memoryを決めた(6章) - [ ]
--block-networkを有効にしたか、外部通信が必要なサーバーを把握している - [ ] Dockerソケットを渡すかどうかを意識して決め、静的モードも検討した
- [ ] シークレットは
command:ではなく、chmod 600のファイルをComposeのsecretとして渡している - [ ]
/healthを監視している - [ ] IDEを設定する前に、curlの
initializeで接続を確認した
10. よくあるハマりどころ(症状→原因→対処)
| 症状 | 原因 | 対処 |
|---|---|---|
昨日まで動いていたのに、再起動後に 401 Unauthorized |
トークンが固定されず、自動生成されていた | env_file で MCP_GATEWAY_AUTH_TOKEN を設定し、クライアントを一度だけ更新する |
403 Forbidden: Origin, if set, must be localhost... |
ブラウザ上のクライアントが自分の Origin を送った |
CLIやIDEのクライアントを使うか、バックエンドから呼ぶ |
| 接続中のまま止まり、タイムアウトする | プロキシがストリームをバッファしている | Caddyなら flush_interval -1、nginxなら proxy_buffering off |
URLが 404 |
--transport=streaming なのに /sse を指定している(またはその逆) |
streamingなら /mcp、sseなら /sse に合わせる |
Docker Desktop is not running と出る |
Docker Engine上でプラグインのバイナリを使っている | DOCKER_MCP_IN_CONTAINER=1 を設定するか、イメージを使う |
| サーバーを起動できず、ソケットでpermission denied | ソケットをマウントしていない、または権限が違う | /var/run/docker.sock をマウントするか、静的モードに切り替える |
| シークレットがないと言われてツールが失敗する | .env のキー名が違う |
カタログの定義どおり <サーバー名>.<シークレット名> で書く |
| イメージのpullを拒否される | 署名検証が有効で、mcp/... イメージをダイジェストで固定していない |
ダイジェストで固定する(検証時だけなら --verify-signatures=false) |
| 負荷がかかるとホストのメモリが尽きる | --long-lived × 多数のセッション × 2GBの上限 |
--memory を下げ、ステートレスなサーバーでは --long-lived を外す |
| 状態を持つサーバーが呼び出しのたびに状態を失う | 既定の、呼び出しごとのコンテナ | そのサーバーだけ longLived: true にする |
11. Docker MCP Gatewayが向かないケース
Docker MCP Gatewayがリモートのホストとして向いているのは、クライアントを自分で管理でき、Dockerのカタログにある構築済みのイメージを使いたく、Dockerホストの運用に抵抗がない場合です。次の場合は向きません。
- 使いたいのがカタログのイメージではなく、GitHubのリポジトリ。 Dockerfileを書いてイメージをビルド・pushし、サーバー定義(
type: server、image:)を書かないと、ゲートウェイでは動かせません。最初の手順はMCPサーバーのDockerfileガイドで解説しています。 - ユーザーごとに別の認証が必要。 トークンは全クライアント共通の1つだけで、ゲートウェイ自体にはユーザーごとのOAuthやツール単位の権限がありません。それらを持つゲートウェイはMCPゲートウェイのランキングで比較しています。
- Claude.aiやChatGPTのコネクタから使いたい。 これらはOAuthか認証なしを前提にしています。
- ホストを運用したくない。 パッチ適用、TLS、バックアップ、ディスクの管理は自分の仕事として残ります。それでも自前で運用する場合、ホスト側の作り方は月6ドルのVPSでのセルフホスト解説が参考になります。
12. NodeFlareならこう解決できる
NodeFlareはMCP専用のホスティングです。stdioのものも含めてMCPサーバーのGitHubリポジトリを指定すると、認証付きのStreamable HTTPのURLを発行します。この記事で挙げた課題に、NodeFlareのドキュメントと料金ページに書かれている機能で答えると次のようになります。
| リモートのDocker MCP Gatewayでの課題 | NodeFlareでの対応 |
|---|---|
| 動的モードでは、ゲートウェイにDockerソケットを渡す必要がある | 自分でDockerホストを運用する必要がない。サーバーはそれぞれ専用のFirecrackerマイクロVMで動く |
| カタログのイメージしか動かせず、GitHubのリポジトリにはDockerfileとサーバー定義が必要 | GitHubのリポジトリを選ぶだけ(モノレポのサブディレクトリも可)。マニフェストからランタイム(Node、Python、Go、Rust、Java、.NETなど)を自動判定し、Dockerfileは不要 |
| stdioのサーバーにはブリッジが必要 | 組み込みのstdioアダプターが、https://<your-server>.nodeflare.tech/mcp でStreamable HTTPと旧来のHTTP+SSEの両方を提供 |
| トークンは共有の1つだけで、未設定だと再起動で変わる | リクエストごとに mcp_* のAPIキーかOAuth 2.0のアクセストークン(RFC 8414 / 9728のディスカバリー)が必要。tools:call:<ツール名> のようにツール1つ単位までスコープを絞れる |
| TLSがなく、Caddyを自分で動かす | 発行されるURLは最初からHTTPS。有料プランでは独自ドメインも使え、TLS証明書は自動で発行される |
| 呼び出しごとのコンテナ起動か、セッションごとの常駐コンテナ | アイドル状態が数分続くとスナップショットを取って停止し、次のリクエストで1秒未満で復元。Always-On(Pro以上)なら温まったレプリカを1つ常に残せる |
| 1コンテナあたり既定2GBの上限 | サーバーごとに256MB・512MB・1GB・2GBから選べる |
| ツール呼び出しのログはコンテナの標準出力だけ | MCPメソッド、ツール名、引数のキー(値は記録しない)、ステータス、結果、duration_ms を含むリクエストログ。保存期間はFreeで7日、Pro・Teamで30日 |
--block-network とサーバーごとの allowHosts |
外向き通信の制御に、記録だけのobserveモードと遮断するenforceモードがあり、許可リストは最大100件 |
料金は、Freeが月0円で1サーバー、計算資源は月30GB時間まで(アイドル時はゼロまで縮小)。Proは月2,980円でサーバー数無制限、計算資源300GB時間とストレージ10GBを含み、超過分は1GB時間あたり5円(CPUと外向き通信を含む)です。
いちばん小さな始め方:
- GitHubでサインインし、MCPサーバーのリポジトリを選ぶ
- 必要なAPIキーをシークレットに登録してデプロイする
- 発行された
/mcpのURLとAPIキーを、Claude Code・Cursor・自作エージェントに貼る
13. よくある質問
Docker MCP Gatewayはリモートで使える?
使えます。docker mcp gateway run --transport=streaming --port=8811 で起動すると、クライアントはBearerトークン付きで http://<ホスト>:8811/mcp に接続できます。ゲートウェイ自体にTLSの機能はないので、HTTPSにするにはリバースプロキシを前に置きます。
Docker MCP GatewayのエンドポイントURLは?
--transport=streaming なら、指定したポートの /mcp です。--transport=sse なら /sse です。ルートの / はエンドポイントにリダイレクトされ、/health はトークン不要の死活確認用です。
Docker MCP Gatewayの認証トークンはどう設定する?
ゲートウェイを起動する前に、環境変数 MCP_GATEWAY_AUTH_TOKEN を設定します。未設定だと、ゲートウェイは起動のたびに50文字のランダムなトークンを作ってログに出すため、再起動ごとにトークンが変わります。
Docker Desktopなしでも動く?
動きます。GitHubのリリースから docker-mcp プラグインのバイナリを取得して ~/.docker/cli-plugins/ に置くか、Docker Engine上で docker/mcp-gateway イメージを動かします。シークレットはDesktopのストアの代わりに、--secrets で .env ファイルを渡します。
ゲートウェイにDockerソケットは必要?
既定の動的モードでは必要です。ゲートウェイがサーバーのコンテナを自分で起動するためで、Dockerの例も /var/run/docker.sock をマウントしています。静的モード(--static=true)では、サーバーをComposeのサービスとして先に起動しておくので、ソケットは要りません。
Docker MCP Gatewayはクライアント向けのOAuthに対応している?
接続してくるクライアント向けのOAuthサーバー機能は、ドキュメントに書かれていません。受け付けるのは固定のBearerトークン1つです。ゲートウェイのOAuth対応は、MCPサーバーの代わりにGitHubなどの外部サービスへ接続するためのものです。
Claude.aiのカスタムコネクタからDocker MCP Gatewayに接続できる?
多くの場合はできません。ClaudeのWeb・デスクトップ・モバイルのコネクタはAnthropicのクラウドから接続し、OAuthか認証なしを前提としています。固定のリクエストヘッダーは一部の組織向けのベータです。Claude CodeやCursorは Authorization ヘッダーを指定できるので使えます。
Docker MCP Gatewayはサーバー1つあたりどれくらいメモリを使う?
既定では、サーバーのコンテナ1つにつきメモリ2GB・CPU 1の上限がかかります(--memory、--cpus)。--long-lived を付けると、サーバーごと・クライアントセッションごとにコンテナが1つずつ常駐するので、接続するクライアントが増えるほど上限の合計も増えます。
--long-lived は何をする?
ツール呼び出しが終わってもサーバーのコンテナを削除せず、動かしたままにします。状態を持つサーバーに必要な設定です。コンテナは、そのクライアントセッションが終わるか、ゲートウェイが止まるまで残ります。付けない場合は、呼び出しのたびに新しい --rm のコンテナで動きます。
GitHubのリポジトリにあるMCPサーバーをDocker MCP Gatewayで動かせる?
直接は動かせません。ゲートウェイが動かすのはイメージなので、リポジトリからイメージをビルドしてpushし、サーバー定義か --server docker.io/<namespace>/<repo>:<tag> で指定する必要があります。カタログのサーバーは最初からイメージになっています。
Docker MCP Gatewayが対応するMCPのプロトコルバージョンは?
v0.44.3はMCP Go SDK v1.4.1を使っており、対応するのは2024-11-05から2025-11-25までです。2026-07-28の仕様で話すクライアントは、initialize の時点でそのどれかに下げて接続します。
まとめ
Docker MCP Gatewayは --transport=streaming という1つのフラグでリモートのMCP Hostingになりますが、きちんと動かすにはさらに5つの判断が要ります。MCP_GATEWAY_AUTH_TOKEN の固定、前段のTLSプロキシ、公開するのはプロキシだけにすること、Dockerソケットを渡すか静的モードにするかの選択、そしてセッション数 × サーバー数に合わせた --memory です。クライアントを自分で管理でき、Dockerのカタログのイメージを使いたい開発者には合います。ユーザーごとの認証、GitHubリポジトリのサーバー、ブラウザ上のクライアントが必要なら、それに合わせて作られたホストを選んでください。
参考資料
- Docker:docker mcp gateway run CLIリファレンス
- Docker:MCP Gatewayのドキュメント
- Docker:GitHubのdocker/mcp-gateway(README、
docs/security.md、docs/server-entry-spec.md、examples/compose-static、examples/secrets) - Docker:docker/mcp-gatewayのリリース(v0.43.1の認証とバインドマウントの変更、v0.44.3)
- Docker:Docker Engineのセキュリティ(デーモンの攻撃対象領域)
- MCP:トランスポート(仕様 2026-07-28)
- MCP:Go SDK
- Caddy:reverse_proxyディレクティブ
