Skip to main content
Comfy Registry で公開されました。 ComfyUI-Manager から ComfyUI Agent Panel (comfyui-agent-panel) をインストールするか、最新ビルドが欲しい場合は git から インストールしてください（下の セットアップ を参照）。
comfyui-mcp-panel は ComfyUI の サイドバーに自律型エージェントを組み込みます。画像・ワークフロー・変更を頼めば、実際の ComfyUI を相手に作業してその場で返答します。プロバイダーを選ぶと — Claude、 ChatGPT、Gemini、Ollama（ローカル） のいずれか — 対応するエージェントが バックグラウンドで動きます: サブスクリプションなら API キー不要、ローカルモデルなら アカウントすら不要 です（Ollama バックエンドは OpenAI 互換のホスト型エンドポイントにも 接続できます）。対応表は バックエンド を、各モデルクラスが実際にどれだけ 動くのかは LLM アリーナ を参照してください。
サブスクリプション型のプロバイダーでは API キーもトークン単位の課金も不要 で、 ローカルモデルなら完全に無料・オフラインで動きます。エージェントはディスク上のログイン 情報で認証します（Ollama の場合はローカルのデーモンと通信するだけです）。1 つの オーケストレーターが 1 つのループバックブリッジポート（ws://127.0.0.1:9180）で すべてのプロバイダーを受け持ち、各パネルタブはハンドシェイク時に自分のプロバイダーを 選びます。ブリッジはループバック専用で、パネルはグラフ操作コマンドの 固定された許可リスト だけを実行します（任意の JavaScript は実行しません）。
はじめての方へ: バックエンド / プロバイダー では、プロバイダーの 選択 UI、プロバイダーに依存しない AgentBackend ポート、機能対応表（Claude と ChatGPT で同一の部分と、いくつかある相違点）を説明しています。

​
セットアップ

  1. パックをインストール — ComfyUI-Manager で comfyui-agent-panel を検索するか、git から:
    Manager のバージョンのドロップダウンでは、Nightly ではなく Latest を選んでください。 名前に反して、Manager の Nightly は毎晩ビルドされるわけではありません: インストール時に リポジトリを 一度だけ クローンし、以後そのブランチを追跡することはありません。その日 たまたま main だったコミットに固定される一方、Latest はリリースごとに追随します — つまり Nightly は往々にして Latest より 古く、放置するほど静かに遅れが広がります。更新なしと 表示されるのは、Nightly の視点では本当に更新がないからです。実際にどこにいるのかを確認するには、Node Pack Info → Version の SHA を リポジトリのコミット履歴 と比べてください。抜け出すには、同じドロップダウンで Latest (x.y.z) を選ぶか — git のまま 運用したいなら — custom_nodes/comfyui-mcp-panel で git pull を実行してください。 きれいに fast-forward されます。
  2. バックグラウンドのエージェントがサブスクリプションを使えるように、使いたいプロバイダーに 一度サインイン しておきます:
  3. 自分のマシンで オーケストレーターを起動 し、そのまま実行し続けてください — 詳しくは パネルオーケストレーターを起動する を参照:
  4. ComfyUI を再起動 し、エージェント タブを開いて プロバイダーを選び（Claude / ChatGPT のチップ）、接続 をクリックします。パネルがオーケストレーターのループバック ブリッジに繋がります。リクエストを入力すればエージェントが応答します。切断 すると リンクは解除されますが、オーケストレーターは自分で止めるまで動き続けます。
claude mcp add も API キーも不要です。パネルは純粋なフロントエンドの拡張機能であり、 オーケストレーターを自分で起動することはできません。そのためオーケストレーターは常に ユーザーが起動するプロセスであり — パネルはすでに動いているブリッジに自動接続するだけです。 前提条件は PATH に通った Node.js/npx と、上記のプロバイダーへのログインです。ブリッジ ポートは COMFYUI_MCP_BRIDGE_PORT で変更できます。
リモートの ComfyUI を操作する場合（クラウド GPU のポッドや LAN 上の別のマシンなど）も 上記のセットアップはそのまま当てはまりますが、オーケストレーターはリモート側ではなく 自分のマシンで 実行してください: npx -y comfyui-mcp@latest connect <remote-url> を 実行すれば、ポッドの HTTPS ページへ戻る安全なトンネルを含め、残りは自動で処理されます。 あとはパネルで接続をクリックするだけです。手順の全体は クラウドデプロイ を参照してください。
プロバイダーのオンボーディング。 接続時にパネルは各プロバイダーの準備状況を確認します （PATH 上の CLI + ディスク上のログイン。macOS のキーチェーンにも対応しています）。 オンボーディングカードは どのプロバイダーにも サインインしていないときだけ表示されます。 保存された選択が使えない場合、パネルは 準備できているプロバイダーへ自動で切り替え （保存した設定はそのまま保持されます）、準備できていないプロバイダーの行には、一度きりの claude / codex login の手順を始める 「セットアップ」 アクションが表示されます。 詳しくは バックエンド → 準備状況とオンボーディング を参照してください。

​
できること

エージェント（Claude または ChatGPT）は comfyui-mcp のモデルスキル（IDEOGRAM、WAN、 LTX、Qwen など）を読み込むため、あなたが動かしているモデルをすでに把握しています — Claude はネイティブに、ChatGPT は同じ知識を MCP ツールとして公開した形で利用します （知識のパリティ）。画像・動画・音声を生成し、ComfyUI を 調べて管理し、あなたの環境について推論したうえで、パネルのチャットで返答できます。 さらに ワークフローやインストーラーパック全体を一度に読み込む ことができ （panel_load_workflow pack:<name>）、コストも意識 します: 同梱パックはローカル GPU / 無料で、その場で組んだグラフについてはエージェントがランタイムを確認し（list_packs の action:"check_runtime"）、有料の API クレジットを使う前に確認します。 スキル・パック・ランタイムコスト を参照してください。

​
ライブグラフの操作

自律型エージェントは panel_* コマンドの 固定された許可リスト を通じて、実際の ComfyUI を操作します — 任意の JavaScript は実行しません。グラフへの変更はすべて LiteGraph の変更追跡を経由するため、いずれも Ctrl+Z で取り消せます。同じ panel_* の面が両方のバックエンドに同一に公開されるので（Claude はインプロセス、ChatGPT/Codex は ループバックの HTTP MCP 経由）、パリティ は自動的に保たれます。

​
読み取り

​
グラフの編集（取り消し可能）

​
サブグラフ

​
空間レイアウト

エージェントはノードのジオメトリを見られます — panel_query_graph の詳細行は各ノードの pos/size、サブグラフの入出力 rails、groups、ノードごとの color/collapsed を 返します — そして対応する書き込み操作でキャンバスを配置し、その結果を スクリーンショット に撮って自分のレイアウトを自ら判断します。workflow-layout スキルはこれらを、依存関係で 階層化された重なりのない自動レイアウトへとまとめており、その中心にある原則は 入力と出力を常に露出させておく ことで、そのまますぐ作業を続けられるようにすることです。

​
ワークフロータブ

​
ワークフローを一度に読み込む

​
知識とコストの把握

エージェントは同梱された専門知識を見つけ出し、クレジットを使う前にランタイムのコストを 確認します（両方のバックエンドで同じツールを使います — 詳しくは スキル・パック・ランタイムコスト を参照）:

​
実行と表示

​
カスタムノード（内蔵の ComfyUI Manager）

​
MCP とセッション

​
ユーザーとのやり取り

すべてのツールは任意で tab_id を受け取ります — 各ブラウザータブがそれぞれの接続を 持っており、ルーティングは既定で唯一のタブ、またはユーザーが最後に入力したタブに 向きます。

​
巻き戻しとロールバック

過去のメッセージは固定されていません。任意のメッセージにカーソルを合わせると出る ✎ 編集 ボタンでロールバックのモーダルが開きます: コード を戻す（グラフをその ターンのスナップショットへ復元）、会話 を戻す（セッションをその時点までフォーク）、 または その両方 を行い、そこから編集したメッセージを再送信できます。グラフの復元は ターンごとのスナップショットを使うため、あるターンを取り消すと、そのターンが始まった 時点のグラフが正確に戻ります。 よくあるケースは 2 つのショートカットでカバーできます:
  • /revert — 直前のターンでのグラフ編集を取り消します。
  • Esc 2 回 — 直前のターンを手早く巻き戻します: グラフを戻し、メッセージをコンポーザーに 呼び戻して編集・再送信できます。
コード（グラフ）のロールバックは 両方のプロバイダー で動作します — ターンごとの スナップショットとしてオーケストレーターの中にあるためです。会話 のロールバック （過去のターンへチャットをフォークすること）は現在 Claude 専用 です。ChatGPT/Codex バックエンドはスレッド全体の再開しかできないため、パネルはこの範囲を無効にしています。 機能対応表 を参照してください。

​
保留メッセージのトレイ

エージェントが処理中でも入力でき、そのメッセージがチャットに埋もれることもありません — ダウンロードトレイの上に固定された 保留 トレイで、チャットの流れとは別に待機します。 保留中のメッセージにはそれぞれ 編集、今すぐ送信、削除 のボタンと、エージェントが どの順で処理するかを 並べ替える ためのドラッグハンドル（≡、左側）が付いています。 今すぐ送信 は現在のターンを中断して、その場で方向を修正します。保留メッセージが キューから取り出されると、チャットの 一番下 に現れるため、記録はエージェント（Claude または ChatGPT）が実際に処理した順序そのままで読めます。

​
破壊的な操作の確認

取り消せない操作は先に確認します。panel_clear（すべてのノードを削除）と panel_restart_comfyui は「はい / いいえ」のカードを出し、はい のときだけ実行されます — エージェントが黙ってグラフを消したり、ComfyUI を再起動したりすることはありません。

​
再接続の堅牢性

固まったオーケストレーターがパネルを取り残すことはなくなりました。以前の オーケストレーターがまだブリッジポートを掴んでいても、接続 をクリックすれば失敗する 代わりにそのゾンビを回収します — 行き詰まる代わりに、パネルは再接続します。

​
コンポーザーの添付ファイル

コンポーザーには、添付・ドラッグ＆ドロップ・貼り付けができます。画像に加えて、 コンポーザーは 動画、ワークフローの .json、テキスト ファイルも受け付ける ようになったので、参考用のクリップ、手を加えたいワークフロー、メモのファイルをそのまま エージェントに渡せます。

​
エージェントの返信に含まれるリッチメディア

実行結果のメディアがエージェントに渡されるとき、その出力は単なる画像ブロックでは ありません — エージェントが推論できる メタデータ を伴います: 各出力のパス （サブフォルダー基準）、ファイルサイズ、ピクセル寸法、そして アセットセットのまとまり （同じ実行の「N 個中 K 番目の出力」と兄弟ファイル名、または「単一出力」）、さらに レンダリング所要時間と完了時刻です。動画のストーリーボードは、ペイロードに含まれていれば フォーマットと実際のフレーム数 / fps も加えます。そのためエージェントは実際に保存された 成果物を正確に呼び分け、サイズ・寸法・その実行が生成したファイル数について話せます。

​
コードブロックのコピーと折り返し

レンダリングされたコードブロックには、ホバーで現れる コピー ボタンと、保存される 全体設定の 行の折り返し トグルが付きます（既定はオフ — オンにするまで、長い行は 横スクロールします）。インラインコードにも専用のコピーが付きます。どちらもパネルに 合わせたスタイルです。

​
レンダー停滞の警告

オーケストレーターは ComfyUI のキューを受動的に監視するウォッチドッグを走らせます: ノード / 進捗が進まなくなったレンダーは 停滞 としてフラグが立ち、エージェントに 伝えられます（そのため、固まったジョブの後ろへやみくもにジョブを積み上げません）。 しきい値は 設定 → Comfy MCP Agent → 一般 にある レンダー停滞の警告（秒） の 設定です（既定 180 秒、範囲 15–3600）。この値は接続時に送られ、ライブで 反映されます — 変更しても再接続は不要です。 設定 → COMFYUI_MCP_STALL_S を参照してください。

​
バックグラウンドタブでの安定性

ComfyUI のタブが バックグラウンド にあっても、ストリーミングされた返信が描画される ようになりました。以前は返信のタイプライター表示が requestAnimationFrame で動いており、 ブラウザーは隠れたタブではこれを停止します — そのため長い多段階の実行の途中で別のタブへ 切り替えると、吹き出しが空のままストリーミングのカーソルが止まり、ターンはすでに 終わっているのにエージェントが「考えたまま固まっている」ように見えていました。現在は タブが隠れると返信が同期的に確定し、visibilitychange ハンドラーが非表示時に保留中の 返信をフラッシュして、戻ってきたらタイプライターを再開します。フォアグラウンドの アニメーションは変わりません。

​
RunPod のクラウド制御

ツールバーの ホストピル には 🟢 ローカル · 自分のマシン または **🔵 RunPod · <pod> · GPU · /hr∗∗が表示され、クリックすると∗∗RunPodのコントロールパネル∗∗が開きます:ライブのステータスカード（GPU/VRAM/稼働時間//hr** が表示され、クリックすると **RunPod のコントロール パネル** が開きます: ライブのステータスカード（GPU / VRAM / 稼働時間 / ·hr / ComfyUI の URL / アイドル自動停止までのカウントダウン）、ポッドを 名前で 一覧するドロップダウン、 接続 / 開始 / 停止 / ローカルを使用、そして確認を挟む デプロイ です。API キーの カードで RUNPOD_API_KEY を一度設定しておけば、RunPod のコンソールに触れることなく、 デプロイ・監視・ローカル⇄ポッドの切り替え・クラウド GPU の停止ができます — ホストピルは常に、次のレンダリングがどこで走るのかを教えてくれます。 クラウドデプロイ とブログ記事 レンタルしたクラウド GPU で ComfyUI を動かす を参照してください。

​
CivitAI ブラウザー

ツールバーの Civitai ボタンを押すと、フル機能の CivitAI ブラウザーが開きます — 画像、動画、チェックポイント、LoRA、ワークフローを検索・フィルタし、全画面のビューアーで 見られます。結果を選んで エージェントと共有 する、自分のマシンにダウンロード する、 埋め込まれたワークフローをキャンバスに保存 する、といったことができます。詳しくは: ComfyUI の中の CivitAI。

​
関連情報