mcpField
C
comfy

comfy

github.com/comfy-orgクリエイティブ・メディア23984 回インストール6 日前に更新
リポジトリ

comfy について

Comfy Cloudは、エージェントをホスト型ComfyUIに接続し、メディア生成とワークフロー作成を行うスキルです。パートナーモデルとオープンソースのパイプラインに対応し、OAuthまたはAPIキーで認証します。

主な機能

  1. 01画像、動画、音声、3Dの生成
  2. 02テンプレートとモデルリソースの検索
  3. 03カスタムワークフローの実行と保存
  4. 04ジョブ管理と出力の取得
  5. 05複数バリエーションの一括送信

活用シーン

  1. 01指定モデルでのメディア生成
  2. 02テンプレートを使ったオープンソースパイプラインの実行
  3. 03画像をアップロードして編集
  4. 04バッチジョブで複数のバリエーションを作成

MCP 対応

ホスト型Comfy Cloud MCPサーバー `https://cloud.comfy.org/mcp` に接続します。MCPクライアントは生成、検索、ワークフロー、ジョブ管理のツールを利用できます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/comfy-org/comfy-skills --skill comfy

インストール後、Claude Code で/comfyを入力して読み込まれたか確認します。

詳細

Comfy Cloud

Comfy Cloud は ComfyUI をクラウド上で実行し、MCP サーバーとしてエージェントに公開します。パートナーモデル（Ideogram、Flux、Kling、Veo、Seedance など）やオープンソースのパイプラインを使った画像／動画／音声／3D 生成に加え、ComfyUI ワークフローの作成にも全面対応しています。テンプレートの検索、入力値の上書き、カスタムグラフの送信、署名付き URL での出力取得ができます。

対象範囲：このスキルはホスト型の Comfy Cloud MCP サーバーに接続し、Comfy アカウントが必要です。ローカルにインストールした ComfyUI を操作するものではありません。ローカル ComfyUI 用の MCP はロードマップにあり、別のスキルとして提供される予定です。それまでは、ローカルインスタンスについては comfy-cli を参照してください。

接続

このサーバーは 2 つの認証方式に対応しています。OAuth（ブラウザーでサインイン。管理不要のため推奨）と API キー（ヘッドレス環境または CI 用）です。

オプション A — OAuth（推奨）
openclaw mcp set comfy '{"url":"https://cloud.comfy.org/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login comfy
openclaw gateway restart

openclaw mcp login を実行すると認証 URL が表示されます。URL を開いて Comfy アカウントにサインインし、CLI の指示に従ってフローを完了してください（--code <code> を付けて再実行するよう求められる場合があります）。openclaw mcp status --verbose で確認してください。auth: "oauth" を設定すると、OpenClaw はサーバーエントリーの静的な headers を無視するため、両方を併用しないでください。

オプション B — API キー（ヘッドレス環境／CI）

  1. API キーを取得する — cloud.comfy.org にサインインし、Settings → API Keys でキーを作成します。キーは comfyui- で始まります。

  2. キーを環境変数に設定する（シェルのプロファイルまたは OpenClaw の env に記述します）。

    export COMFY_API_KEY="comfyui-..."

  3. OpenClaw に MCP サーバーを登録する：

    openclaw mcp set comfy '{"url":"https://cloud.comfy.org/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${COMFY_API_KEY}"}}'
openclaw gateway restart

    サーバーは X-API-Key: ${COMFY_API_KEY} ヘッダーでのキー指定にも対応していますが、上記の Authorization: Bearer 形式を推奨します。標準ヘッダーはすべてのクライアントのプロキシ層を通過しますが、一部の OpenClaw ビルドでは streamable-http トランスポートでカスタムヘッダーが削除されています（openclaw#65590 を参照）。有効なキーを使っているのに 401 が返される場合は、この問題に該当している可能性があります。Bearer 形式に切り替えるか、mcporter 経由で接続するか、OAuth（オプション A）を使用してください。

どちらの方式でも、ブラウズ／検索ツールはすべてのアカウントで利用できます。生成には Comfy Cloud のクレジットを消費するため、サブスクリプションまたはクレジット残高が必要です。

使用するツール

名前が指定されたモデルによる画像・動画生成（Ideogram、Flux、Gemini、Kling、Veo、 Seedance、…）：partner_generate を呼び出す前に、指定されたモデルファミリーに OSS の利用方法もあるか確認してください。一部のファミリー（2026-08 時点の例では MiniMax H3）は、有料のパートナーノードと、同じ表示名のオープンソースの重みの両方を提供しています。ファミリー名で search_templates と search_nodes を実行してください。両方が見つかった場合は、OSS の選択肢があることをユーザーに伝え（パートナー/API 料金はかかりませんが、実行には通常の Comfy Cloud コンピュートクレジットが消費されます。Comfy Cloud 上で無料なのではなく、パートナー料金がかからないだけです）、どちらを希望するか尋ねてください。パートナー経由の方法しかない場合、またはユーザーが有料の方法を選んだ場合は、partner_generate を呼び出してください。Comfy Cloud 経由でプロバイダーを実行し、結果をアセットライブラリに保存します。名前が指定されたパートナーモデルを使って、単純なテキストから画像・動画を生成するワークフローを手作業で組み立てないでください。

ワークフロー形式のもの全般（オープンソースモデル、LoRA/ControlNet、複数ステップのパイプライン）：テンプレートから始めてください。search_templates → get_template_schema → input_overrides を指定して run_template の順に実行します。完全にカスタムのグラフには submit_workflow を使用してください（グラフの末尾には SaveImage などの出力ノードが必要です。そうでない場合、検証で拒否されます）。save_workflow / run_saved_workflow を使って保存し、再利用できます。

既存の画像を編集する場合：まず upload_file を実行し、その後、アップロードしたファイルを LoadImage ノードから参照してください（または、画像から画像への生成に対応するパートナーには partner_generate に渡してください）。画像データを base64 のままワークフローに直接埋め込まないでください。

結果の取得：wait_for_job → get_output。出力は有効期限付きの署名 URL として返されます。返されたとおりにダウンロードしてください（クエリパラメーターは署名の一部なので編集しないでください）。実行中のジョブは get_queue と cancel_job で管理できます。submit_batch / wait_for_batch を使うと、複数のバリエーションを並行して実行できます。

検索：search_models（プラットフォーム上のチェックポイント/LoRA）、search_nodes（配線のヒント付きで利用可能な ComfyUI ノードを検索）、get_prompting_guide（モデルごとのプロンプト作成のアドバイス）。

プロンプトの例

  • 「雨の午後の居心地のよいブックストアカフェの画像をIdeogramで生成して、./bookstore.pngにダウンロードしてください」
  • 「./product.jpgの背景を削除し、結果を2倍にアップスケールしてください」
  • 「Kling用のテキストから動画を生成するテンプレートを見つけて、プロンプト『雨どいを流れていく紙のボート、シネマティック』で実行し、出力 URL を教えてください」

メモ

  • 生成には Comfy Cloud クレジットが消費されます。検索・発見ツールは無料です。
  • MCP の全ドキュメントとクライアントごとのセットアップ方法：docs.comfy.org/cloud/mcp

コメント

Markdown 対応