記事一覧
MCPホスティング

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-gateway v0.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つあります。

  1. トークンを固定しないと、再起動のたびに変わる。 MCP_GATEWAY_AUTH_TOKEN が未設定だと、pkg/gateway/auth.go が起動ごとに50文字のトークンを作り直してログに出します。コンテナが再起動しただけで、全クライアントの接続が切れます。
  2. 動的モードでは、ゲートウェイにDockerデーモンの操作権を渡すことになる。 公式のCompose例は、必要なときに docker run するために /var/run/docker.sock をゲートウェイにマウントしています。静的モード(--static=true)なら、サーバーをComposeのサービスとして先に起動しておくので、ソケットは不要です。
  3. --long-lived はサーバー単位ではなく、クライアントのセッション単位。 コンテナを使い回すときのキーは「サーバー名とクライアントセッションの組」です。クライアント5つ × サーバー3つなら15コンテナになり、既定ではそれぞれ最大2GBまで使えます。
  4. ゲートウェイのプロトコルバージョンは、最新のクライアントより古い。 2026-07-28を求めるクライアントは、Go SDKが対応する版に下げて接続します。またサーバーは Mcp-Session-Id を使うステートフルなセッションを持つので、複数台に分けるときはスティッキーなルーティングが必要です。

目次

  1. Docker MCP GatewayをMCP Hostingに使うとは
  2. ローカルのMCP Toolkitとリモートのゲートウェイの違い
  3. リモートで使うときに設定するフラグ
  4. 手順:Docker ComposeとCaddyでリモートゲートウェイを立てる
  5. 静的モード:ゲートウェイにDockerソケットを渡さない
  6. サーバーコンテナの起動タイミングとメモリへの影響
  7. Claude Code・Cursor・自作エージェントからの接続
  8. ソースを読んで分かった6つの挙動
  9. 公開前チェックリスト
  10. よくあるハマりどころ(症状→原因→対処)
  11. Docker MCP Gatewayが向かないケース
  12. NodeFlareならこう解決できる
  13. よくある質問 まとめ

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と外向き通信を含む)です。

いちばん小さな始め方:

  1. GitHubでサインインし、MCPサーバーのリポジトリを選ぶ
  2. 必要なAPIキーをシークレットに登録してデプロイする
  3. 発行された /mcp のURLとAPIキーを、Claude Code・Cursor・自作エージェントに貼る

1サーバーまで無料で試す →

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リポジトリのサーバー、ブラウザ上のクライアントが必要なら、それに合わせて作られたホストを選んでください。

参考資料

NodeFlare

MCP専用ホスティングサービス

GitHubにあるMCPを簡単デプロイ・簡単運用で最適化
無料で始める

他の記事

MCPトークン2026年11月22日

MCPの「ポーリング税」:長時間ツールの状態確認がMCPトークン消費を増やす仕組みと、Tasks・ロングポーリング・コード実行による4つの安い待ち方【2026年版】

長時間かかるMCPツールをモデルがポーリングすると、確認のたびにコンテキスト全体を読み直します。Claude Sonnet 5.5で試算すると60回で1,000ジョブあたり254.23ドル。MCP Tasks、コード実行、ロングポーリング、5分キャッシュの落とし穴と1時間TTLを比較します。

MCPセキュリティ2026年11月22日

MCPクライアントの許可リスト:CIMDで接続元を制限する信頼ポリシーとSSRF対策、localhostなりすましの限界を検証(MCP Security、2026年)

MCPサーバーに接続できるクライアントを制限するMCP Securityガイド。2026-07-28版仕様の4つの登録方式、CIMDが証明すること・しないこと(localhostなりすまし)、SSRFを防ぐ取得ルール、4区分の信頼ポリシー、検証済みチェッカー(21/21、素朴な実装は4/10)、KeycloakとEntraの対応状況を解説。

MCPトークン2026年11月21日

サブエージェントでMCPのトークン消費は増える?エージェントごとのツール一覧の重複課金、並列起動のキャッシュミス、MCPツールの絞り方【Claude Code・Agent SDK、2026年版】

サブエージェントはそれぞれMCPのツール定義を読み込み、同時に起動するとキャッシュ書き込みも重なります。起動時に読み込むもの、Sonnet 5.5での試算(1,000回あたり348.58ドル→76.58ドル)、任せるべきかの損益分岐、tools・disallowedTools・mcpServersでサブエージェントごとにMCPツールを絞る方法を解説します。

Docker MCP GatewayをリモートのMCP Hostingにする方法:streaming設定・Bearerトークン・docker.sock問題と静的モード【v0.44.3対応】 | Blog | Nodeflare