リモート / ホスト型コネクタ

comfyui-mcp は、ホスト型コネクタが使うのと同じ Streamable-HTTP MCP トランスポートを話します（例: Comfy 自身の cloud.comfy.org/mcp カスタムコネクタ）。ワンコマンドで、公開 HTTPS トンネルの背後にあるトークン認証サーバーとして動き、Claude Desktop → Connectors に追加したり、どこからでもヘッドレスに呼び出したりできます。

これはオプトインです。既定の stdio トランスポート（およびループバック上の素の --http）はこれまでどおり — 開いていてローカルです。認証とトンネルが有効になるのは、トークンを設定したときまたは --tunnel を渡したときだけです。

代わりにエージェントパネルでリモートの ComfyUI ポッド（例: RunPod）を操作したいですか？ それは別の機能です — クラウドデプロイを参照してください。このページは comfyui-mcp の MCP サーバー自体 を Claude Desktop のようなリモートクライアントに公開する話です。ComfyUI にもパネルブリッジにも触れません。どちらも裏で cloudflared のクイックトンネルを使うので、混同しやすいです。

ワンコマンドのトンネル

npx -y comfyui-mcp@latest --tunnel

これは 4 つのことをします:

HTTP トランスポートを強制します（MCP_TRANSPORT=http）。
まだ設定していなければ、強いランダムな認証トークンを生成します。
ローカルの MCP ポートへ cloudflared のクイックトンネルを開始します。
そのまま貼れるブロックを表示します: 公開の https://…/mcp URL、トークン、Claude Desktop コネクタのスニペット。

出力は次のようになります:

════════════════════════════════════════════════════════════════════
 ComfyUI MCP — Remote / Hosted Connector is LIVE
════════════════════════════════════════════════════════════════════
 Public MCP URL : https://shiny-otter-1234.trycloudflare.com/mcp
 Auth token     : 9f2c…<redacted>
 ...
════════════════════════════════════════════════════════════════════

ターミナルは開いたままにしてください。cloudflared の クイックトンネル は一時的です — URL は実行のたびに変わり、プロセスが終了すると閉じます。安定したホスト名が欲しい場合は、ローカルの HTTP ポートを向いた自分の名前付き cloudflared トンネルを動かしてください。

cloudflared がインストールされていない場合

cloudflared は任意依存として同梱されています。バイナリが見つからない場合、サーバーはローカルで動き続け、インストール手順を表示します:

npm install -g cloudflared          # cross-platform
brew install cloudflared            # macOS
winget install cloudflare.cloudflared  # Windows

それから --tunnel でもう一度実行してください。

Claude Desktop に追加する

Claude Desktop → Settings → Connectors → カスタムコネクタを追加 を開き、次を入力します:

項目	値
名前	`ComfyUI`
URL	表示された `https://…/mcp` URL
ヘッダー	`X-API-Key: <token>`（または `Authorization: Bearer <token>`）

保存し、チャットでコネクタを有効にします。ComfyUI のツールは、ローカルの stdio サーバーと同じように現れます。

ヘッドレス / プログラム用の設定

リモートの Streamable-HTTP サーバーに対応した任意の MCP クライアントが動きます。URL と認証ヘッダーを渡してください:

{
  "mcpServers": {
    "comfyui": {
      "url": "https://shiny-otter-1234.trycloudflare.com/mcp",
      "headers": { "X-API-Key": "<token>" }
    }
  }
}

/mcp への すべての リクエストで、どちらのヘッダー形式も受け付けます:

# X-API-Key (matches Comfy Cloud's convention)
curl -H "X-API-Key: <token>" https://…/mcp

# Authorization: Bearer
curl -H "Authorization: Bearer <token>" https://…/mcp

手動セットアップ（自分のトンネル / プロキシを使う）

公開エンドポイントを自分で管理したい場合は、固定トークン付きで HTTP トランスポートを動かし、自分のリバースプロキシ、トンネル、または VPN の背後に置きます:

COMFYUI_MCP_HTTP_TOKEN=my-long-random-secret \
  npx -y comfyui-mcp@latest --http --host 0.0.0.0 --port 9100

それからトンネル / プロキシを http://127.0.0.1:9100/mcp に向けます。

ループバック以外のホスト（例: 0.0.0.0）にトークンなしでバインドするのは 即失敗 です — サーバーは、箱の外に開いた /mcp エンドポイントを晒すより起動を拒否します。 COMFYUI_MCP_HTTP_TOKEN を設定する（推奨）、--tunnel を使う、またはループバックホストにバインドしてください。本当に開いたエンドポイントが欲しい場合（例: 自分の認証プロキシの背後）は、 --allow-unauthenticated-non-loopback（環境変数 COMFYUI_MCP_ALLOW_UNAUTH=1）で明示的にオプトインすると、失敗が警告に下がります。

認証リファレンス

設定	効果
`COMFYUI_MCP_HTTP_TOKEN`	`/mcp` で要求される共有シークレットトークン。未設定 → エンドポイントは開いています。
`--token <value>`	環境変数と同じ。CLI フラグが環境変数より優先されます。
`--tunnel` / `MCP_TUNNEL=1`	HTTP を強制し、未設定ならトークンを自動生成し、cloudflared トンネルを開きます。
`--http` / `MCP_TRANSPORT=http`	トンネルなしの HTTP トランスポート（トークンがあれば認証は適用されます）。
`--host`、`--port`	バインドアドレス（既定 `127.0.0.1:9100`）。
`--allow-unauthenticated-non-loopback` / `COMFYUI_MCP_ALLOW_UNAUTH=1`	ループバック以外のホストで開いた `/mcp` をオプトイン。なしではその組み合わせは起動時の即失敗です。

トークンは定数時間で比較され、ゲートは MCP エンドポイントのすべての HTTP メソッド（POST/GET/DELETE）で強制されます。トークンなしでループバック以外のホストにバインドするのは、上の逃げ道を設定しない限り起動時に拒否されます。

ロードマップ: OAuth

いまの認証は 手動の共有シークレットトークン（Bearer / X-API-Key）で、ヘッドレスと Claude Desktop のカスタムコネクタの両方をカバーします。ブラウザーベースの完全な OAuth サインインフロー（Comfy のホスト型コネクタのようなもの）は予定されている後続です — より重い変更で、手動接続には不要です。

はじめに

設定

リモート / ホスト型コネクタ

ワンコマンドのトンネル

cloudflared がインストールされていない場合

Claude Desktop に追加する

ヘッドレス / プログラム用の設定

手動セットアップ（自分のトンネル / プロキシを使う）

認証リファレンス

ロードマップ: OAuth

関連情報

​ワンコマンドのトンネル

​cloudflared がインストールされていない場合

​Claude Desktop に追加する

​ヘッドレス / プログラム用の設定

​手動セットアップ（自分のトンネル / プロキシを使う）

​認証リファレンス

​ロードマップ: OAuth

​関連情報

ワンコマンドのトンネル

cloudflared がインストールされていない場合

Claude Desktop に追加する

ヘッドレス / プログラム用の設定

手動セットアップ（自分のトンネル / プロキシを使う）

認証リファレンス

ロードマップ: OAuth

関連情報