Comfy Cloud MCP

これは Comfy Cloud の機能であり、クラウド版でのみ利用可能です。Comfy Cloud の詳細については、「Comfy Cloud」をご覧ください。

公開ベータ版. Comfy Cloud MCP は公開ベータ版です。API、ツール、動作は開発中に変更される可能性があります。問題の報告や提案はフィードバックをご覧ください。

概要

Comfy Cloud MCP サーバーは、AI エージェントをモデルコンテキストプロトコル（MCP）を通じて Comfy Cloud に接続します。接続後、チャットから画像、動画、オーディオ、3D の生成、モデル、ノード、テンプレートの検索、ComfyUI ワークフローの実行ができます。サーバーは cloud.comfy.org/mcp でリモート実行されます。ワークフローは Comfy Cloud の GPU 上で実行されるため、ローカル GPU は不要です。エージェントは HTTPS 経由でサーバーと通信し、サーバーはツール呼び出しを認証済みのリクエストとして Comfy Cloud に代行送信します。 MCP 互換のクライアントはいずれも同じサーバー URL に接続できます。Claude Code、Claude Desktop、Cursor、Codex については、以下にファーストクラスのセットアップ手順があります。Windsurf、Amp、およびその他のエージェントは、OAuth または APIキーを使用して同じ URL から利用できます。

Comfy Cloud MCP のインストール

接続する前にComfy Cloudアカウントが必要です。まだお持ちでない場合はサインアップしてください。セットアップ時のOAuthログインはComfyアカウントを使用します。

Comfy Cloud MCPは以下で実行されます：

https://cloud.comfy.org/mcp

クライアントを選択:

Claude Code
Claude Desktop
Cursor
Codex
その他のクライアント

comfy-cloudプラグインをインストールします。これにより、MCP接続とスラッシュコマンドが一度に追加されます。このプラグインは、Comfy Skillsリポジトリを通じて公開されています。このリポジトリにはClaude CodeプラグインとComfy向けのコミュニティエージェントスキルがホストされています。

マーケットプレイスを追加

Comfy Skillsマーケットプレイスを登録します（1回のみ）：

/plugin marketplace add Comfy-Org/comfy-skills

プラグインをインストール

/plugin install comfy-cloud@comfy-skills

ログイン

/mcpを実行し、comfy-cloud → 認証を選択します。ブラウザが開いてログインし、トークンは自動的に更新されます。

このプラグインは以下のスラッシュコマンドを追加します：

コマンド	説明
`/comfy-cloud:generate-image`	画像の生成、編集、修正
`/comfy-cloud:generate-video`	動画の生成、編集、拡張
`/comfy-cloud:generate-audio`	オーディオ、音楽、効果音の生成
`/comfy-cloud:generate-3d`	テキストまたは画像から3Dモデルを生成
`/comfy-cloud:remove-background`	画像から背景を削除
`/comfy-cloud:upscale-image`	画像を高解像度にアップスケール
`/comfy-cloud:search-templates`	comfy.org で事前構築されたワークフローテンプレートを検索
`/comfy-cloud:search-models`	利用可能なモデルを検索
`/comfy-cloud:search-nodes`	ノードを検索し、配線の提案を取得
`/comfy-cloud:help`	ComfyUI Cloudでできることを確認

プラグインなしで接続だけを行いたいですか？

サーバーを直接追加：

claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp

その後、/mcpを実行し、comfy-cloud → 認証を選択します。-s userを追加すると、すべてのプロジェクトで利用可能になります。この方法でも、MCPプロンプトとして同じワークフローが公開されます：/mcp__comfy-cloud__generate-image、/mcp__comfy-cloud__search-modelsなど（/mcp__<名前>__プレフィックスは、claude mcp addに渡した名前を使用します）。上記のプラグインは、これらをより親しみやすい/comfy-cloud:*コマンドとしてラップするため、推奨されます。

Claude Desktopは、UIを通じてComfy Cloudをカスタムコネクタとして追加し、OAuthログインを実行します。

カスタマイズを開く

サイドバーでカスタマイズ（ラベル1）をクリックします。

コネクタを開く

コネクタ（ラベル2）をクリックします。

カスタムコネクタを追加

コネクタヘッダーの**+ボタン（ラベル3**）をクリックします。
カスタムコネクタを追加（ラベル4）を選択します。

サーバーの詳細を入力

名前フィールド（ラベル5）に、Comfy Cloud MCPなどの名前を入力します。
Remote MCP server URLをhttps://cloud.comfy.org/mcpに設定します（ラベル6）。
追加（ラベル7）をクリックします。

ログイン

ブラウザが開いたら、ワークスペースを選択します（例：個人ワークスペース）。
続けるをクリックしてコネクタを承認します。接続されます。

Claude DesktopはClaude Codeのスラッシュコマンドをサポートしていません。代わりに、同じワークフローに対してプロンプトピッカーを開きます：

プロンプト	説明
`generate-image`	テキスト説明から画像を生成
`generate-video`	テキストまたは画像から動画を生成
`generate-audio`	オーディオ、音楽、効果音を生成
`generate-3d`	テキストまたは画像から3Dモデルを生成
`upscale-image`	画像を高解像度にアップスケール
`remove-background`	画像から背景を削除
`search-templates`	事前構築されたワークフローテンプレートを検索
`search-models`	モデル（チェックポイント、LoRA、VAE）を検索
`search-nodes`	ノードを検索し、配線の提案を取得
`help`	ComfyUI Cloudでできることを確認

プロンプトをスキップして、平易な言語で質問することもできます。MCPツールは同様に機能します。

CursorはリモートMCPサーバーにHTTPで接続します。Cursorは現在MCP OAuthをサポートしていません。MCP設定にComfy Cloud APIキーを指定してComfy Cloudを追加します。

Cursor設定を開く

右上隅の設定歯車アイコン（ラベル1）をクリックします。

Tools & MCPを開く

サイドバーでTools & MCPs（ラベル2）をクリックします。
+ New MCP Server（ラベル3）→ Add a Custom MCP Serverをクリックします。

APIキーを追加

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）を編集します。サーバーURLを設定し、X-API-KeyヘッダーでComfy Cloud APIキーを渡します。platform.comfy.org/profile/api-keysでキーを作成します（comfyui-で始まります）：

{
  "mcpServers": {
    "comfy-cloud": {
      "url": "https://cloud.comfy.org/mcp",
      "headers": {
        "X-API-Key": "${env:COMFY_API_KEY}"
      }
    }
  }
}

シェルまたはシステム環境にCOMFY_API_KEYを設定します。キーをgitにコミットする可能性のあるファイルに直接記述するよりも、${env:COMFY_API_KEY}を推奨します。

生成を開始

平易な言葉で質問します（「猫の宇宙飛行士の画像を生成して」「Wan 2.2の動画テンプレートを探して」）。Cursorがあなたに代わってMCPツールを呼び出します。

Codexは、Streamable HTTPを介してComfy Cloudに接続します。設定でサーバーを追加し、OAuthでログインします。

設定パネルを開く

Logged in with API keyの下にある設定（ラベル1）をクリックします。
設定（ラベル2）をクリックして、設定パネル全体を開きます。

MCPサーバー設定を開く

設定リストのMCPサーバー（ラベル3）をクリックします。
+ サーバーを追加（ラベル4）をクリックして、新しいMCPサーバーを追加します。

Comfy Cloudに接続

接続タイプとしてStreamable HTTPを選択します。
名前フィールド（ラベル5）にComfy Cloud MCPなどの名前を入力します。
URLフィールド（ラベル6）にhttps://cloud.comfy.org/mcpを入力します。
保存（ラベル7）をクリックします。

認証

保存したサーバーエントリで認証（ラベル8）をクリックします。
ブラウザのポップアップでワークスペースを選択し、続けるをクリックしてログインを完了します。接続されます。

平易な言葉で質問します（「猫の宇宙飛行士の画像を生成して」「Wan 2.2の動画テンプレートを探して」）。Codexがあなたに代わってMCPツールを呼び出します。

代わりにCLIを使いたいですか？

ターミナルから登録してログイン：

codex mcp add comfy-cloud --url https://cloud.comfy.org/mcp
codex mcp login comfy-cloud

これにより、~/.codex/config.toml（または信頼するプロジェクトの.codex/config.toml）にエントリが書き込まれます。

OAuthの代わりにAPIキー（ヘッドレス/CI用）

ブラウザが利用できない場合は、環境変数からヘッダーを取得するサーバーを追加します。platform.comfy.org/profile/api-keysでキーを作成し（comfyui-で始まります）、~/.codex/config.tomlに追加します：

[mcp_servers.comfy-cloud]
url = "https://cloud.comfy.org/mcp"
env_http_headers = { "X-API-Key" = "COMFY_API_KEY" }

シェルまたはシステム環境にCOMFY_API_KEYを設定します。キーをバージョン管理にコミットしないでください。

リモートHTTPトランスポートをサポートするMCPクライアントは、Comfy Cloudに接続できます。サーバーURLは常にhttps://cloud.comfy.org/mcpです。

サーバーURLを追加

https://cloud.comfy.org/mcpを指すリモートMCPエントリを追加します。ほとんどのクライアントはurlフィールドを持つJSON設定を使用します：

{
  "mcpServers": {
    "comfy-cloud": {
      "url": "https://cloud.comfy.org/mcp"
    }
  }
}

Windsurfはurlの代わりにserverUrlを使用します。Ampは設定 → MCPサーバーまたは~/.config/amp/settings.jsonで同じmcpServers構造を使用します。

認証

クライアントがMCP OAuthをサポートしている場合は、ブラウザからログインします。それ以外の場合は、APIキーヘッダーを追加します（下記参照）。

再起動して確認

クライアントを再起動します。comfy-cloudサーバーにComfy Cloudツール（search_templates、submit_workflow、get_outputなど）が登録されているはずです。

ヘッドレス/CI（APIキー）： OAuthが利用できない場合は、platform.comfy.org/profile/api-keysでキーを作成し、X-API-Keyヘッダーとして渡します：

{
  "mcpServers": {
    "comfy-cloud": {
      "url": "https://cloud.comfy.org/mcp",
      "headers": {
        "X-API-Key": "comfyui-…"
      }
    }
  }
}

ターミナルからClaude Codeを使用する場合：

claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp -H "X-API-Key: comfyui-…"

設定ファイルにキーを直接記述するのではなく、${env:COMFY_API_KEY}またはクライアントのシークレット補間を使用することをお勧めします（gitにコミットする設定ファイルで）。

エージェントができること

MCPツールを自分で呼び出す必要はありません。エージェントはリクエスト内容に基づいて適切なツールを選択します。スラッシュコマンドやプロンプト（下記）は、エージェントを一般的なタスクに誘導するショートカットですが、平易な言葉でも動作します（「猫の宇宙飛行士の画像を生成して」「この写真をアップスケールして」「Wan 2.2のビデオテンプレートを探して」など）。典型的な流れ:

発見 – 利用可能なものを調べます（search_templates、search_models、search_nodes、またはグラフ形式の質問にはcql）。
生成を実行 – 一致する事前構築済みテンプレートにはrun_template、カスタムワークフローにはsubmit_workflow（入力画像が必要な場合はupload_fileも併用）、またはFlux、Grok、Gemini、OpenAI、Ideogram、Seedanceなどのパートナーモデルにはpartner_generateを使用します。
待機して出力を取得 – wait_for_jobで待機し、get_outputでダウンロードコマンドを取得します（エージェントがシェルで実行します）。

サーバーは、ワークフローをゼロから構築する前に、事前構築済みテンプレートを優先してマッチングします。これにより、より速く、より良い結果が得られる傾向があります。

MCP ツール

これらは、エージェントが接続後にアクセスできるツールです。名前は MCP クライアントのログやデバッグに表示されるものと一致します。

検索

ツール	説明
`search_templates`	comfy.org からテキスト、タグ、メディアタイプ、またはモデルで事前構築済みのワークフローテンプレートを検索します
`get_template`	テンプレートの完全なワークフロー JSON を取得し、検査や手動編集を行えます
`get_template_schema`	テンプレートのどのパラメータが実行時にオーバーライド可能かを確認します
`search_models`	テキスト、タイプ、ベースモデル、またはソースでモデルカタログを検索します
`search_nodes`	テキスト、カテゴリ、入力/出力タイプで利用可能なノードを検索します。また、サブグラフブループリント（テキストから画像へや背景を削除などの事前配線済みノードグループ）も表示します
`get_node`	特定のノードの完全な入力仕様を取得します（全オプションリストを含む）
`cql`	構造的な質問を行うために CQL グラフクエリを実行します（例：どのノードが画像を生成するか、ノードタイプ間のパスなど）。特定のノードの完全な入力仕様が必要な場合は `search_nodes` を使用してください
`get_prompting_guide`	モデルファミリーごとのプロンプトスタイルと推奨設定（ステップ数、CFG、サンプラー、解像度）

生成

ツール	説明
`run_template`	名前を指定して事前構築済みテンプレートを実行します。オプションでパラメータのオーバーライドが可能。テンプレートが一致する場合の推奨パスです
`submit_workflow`	ComfyUI API 形式のワークフローを Comfy Cloud での実行用に送信します
`partner_generate`	パートナー API モデル（Flux/BFL、Grok、Gemini、OpenAI、Ideogram、Seedream/Seedance など）で生成します
`upload_file`	ワークフローで使用する入力画像やファイルをアップロードします（例：LoadImage を使用する場合）
`apply_slots`	ワークフローの内部値にパラメータのオーバーライドを適用し、変更後のワークフローを返します

ジョブとバッチ

ツール	説明
`get_job_status`	送信したワークフローの実行ステータスをポーリングします
`wait_for_job`	繰り返しポーリングする代わりに、ジョブが完了するまで待機します
`get_output`	完了したワークフローから出力画像、動画、音声を取得します
`use_previous_output`	ある実行の出力を別の実行の入力として再利用し、ワークフローを連鎖させます
`cancel_job`	保留中または実行中のジョブをキャンセルします
`get_queue`	実行中および保留中のジョブの数を確認します
`submit_batch`、`get_batch_status`、`get_batch_output`、`wait_for_batch`	一度の呼び出しで多くの生成を送信し、後でまとめて収集します。バッチ ID はセッションをまたいで有効です

保存済みワークフロー

ツール	説明
`list_saved_workflows`	Comfy Cloud に保存されたワークフローをブラウズします
`get_saved_workflow`	保存済みワークフローのノード、入力、カスタマイズ可能な設定を検査します
`save_workflow`	ワークフローを Comfy Cloud アカウントに保存します
`update_workflow`	既存のワークフローを新しいバージョンとしてその場で更新します（以前のバージョンは復元可能なまま保持されます）
`run_saved_workflow`	ファイル名を指定して保存済みワークフローを実行します。サーバーがエディタ形式から実行可能形式に自動変換します

ワークフローの共有

ツール	説明
`share_workflow`	保存済みワークフローを公開し、誰でも開ける `?share=<id>` URL を返します
`import_shared_workflow`	共有 URL または共有 ID をワークフロー JSON に解決し、オプションでアカウントに保存します

Hub URL 共有 ID： comfy.org/workflows/<slug>-<hex> ハブ URL 内の末尾のハイフン区切り16進トークンが共有 ID です。たとえば、comfy.org/workflows/topaz-starlight-upscale-1c77e82713b7 の共有 ID は 1c77e82713b7 です。そのトークンを share_id として import_shared_workflow に渡します。share_url パラメータは https://cloud.comfy.org/?share=... のような ?share=<id> クエリ URL のみを受け付け、ハブページ URL は受け付けません。

アプリとリンク

ツール	説明
`create_app`	保存済みワークフローをアプリモードのアプリに変換します。選択した入力と出力を持つ簡略化された「このワークフローを実行」ビューです
`get_app_mode_url`	ワークフローを実行可能なアプリとして開く安定したリンクを取得します
`get_workflow_canvas_url`	ワークフローを直接 Comfy Cloud のキャンバスで開き、表示、編集、実行できるリンクを取得します

アカウントとセッション

ツール	説明
`get_billing_status`	あなたのクレジット残高、サブスクリプション階層、請求リンクを確認します
`get_server_info`	エージェントが到達したサーバーを確認します（環境、ホスト、バージョン、認証状態）
`submit_feedback`	ベータ版フィードバック調査のリンクを取得します
`report_session_summary`	匿名化されたセッションサマリーを Comfy チームと共有します。あなたの明示的な同意がある場合のみ。エージェントは事前に許可を求める必要があり、プロンプト、ファイルパス、個人情報は含まれません

クレジットと支出

検索は無料です: search_templates、search_models、search_nodes は Comfy アカウントだけで動作します。生成の実行は Comfy Cloud のクレジットを消費し、サブスクリプションまたはクレジット残高が必要です。実際にお金を使うツールは 出費制限付き です。生成で有料パートナーモデル (partner_generate) や有料 API ノードを含むワークフロー/テンプレート (run_template、run_saved_workflow、submit_batch) を使用する場合、サーバーはエージェントがクレジットを消費することに同意したことを確認するまで実行をブロックします。そのため、それらの実行前にエージェントが確認を求めます。無料のローカルのみのワークフローはプロンプトを表示しません。いつでもエージェントに残高を尋ねることができます（「クレジットはいくつありますか？」）。エージェントは get_billing_status を通じて回答します。

出力とダウンロード

MCP サーバーはクラウド上で動作し、ファイルをあなたのマシンに書き込むことはありません。生成が完了すると、エージェントが get_output を呼び出し、以下のものを返します。

短期間有効な署名付きダウンロード URL（短い期間のみ有効）。
すぐに実行できるシェルコマンド（macOS と Linux では curl、Windows では curl.exe）。

エージェントはそのコマンドをシェルで実行します。コマンドには保存先のパスとファイル名が含まれています。

返されたコマンドはそのまま実行してください。署名付き URL を再エンコードしたり編集したりしないでください。署名はクエリ文字列に含まれており、URL を変更すると壊れます。

MCP クライアントがシェルコマンドを実行できない場合（一部の GUI のみのセットアップ）、コマンドをコピーして、ターミナルで自分で実行してください。

リソース	用途
Comfy Skills	Claude Code プラグインマーケットプレイスおよびコミュニティスキルライブラリ。上記で使用した comfy-cloud プラグインはこちらで配布されています。Comfy ワークフロー用の追加スキルをブラウズしたり、コントリビュートすることができます。
Comfy CLI	ローカル ComfyUI のインストール/起動、およびスクリプトや CI からホスト型パートナーノードを呼び出すためのコマンドラインツール（`comfy generate`、ベータ版）。ターミナルや自動化ワークフローが必要な場合に MCP を補完します。
Share a workflow on Comfy Cloud	Comfy Cloud UI からワークフローを共有します（MCP の `share_workflow` ツールがエージェントセッションからこれを実行します）。

フィードバック

Comfy Cloud MCP は公開ベータ版です。ぜひ試してみて、うまくいく点とそうでない点をお知らせください：

フィードバックアンケート: バグの報告、機能要望、一般の感想の共有など。
Discord: #comfy-mcp-and-cli（Comfy Discord 内）質問やディスカッション用。

既知の制限事項

Comfy Cloud MCP は初期リリースです。以下の制限事項は既知であり、現在対応中です： ワークフロー

エディタ形式から実行可能形式への変換にはまだ粗い部分があります。 保存済みワークフローは run_saved_workflow によりファイル名で実行できます（サーバーが自動的に変換します）が、一部のノード構成では変換が不完全な場合があります。
submit_workflow 経由で生成されたアセットにはワークフローメタデータが埋め込まれない場合があります。 ComfyUI で開いたときに元のワークフローが復元されない可能性があります。
ワークフローの構築はエージェントの精度に依存します。 複雑なマルチノードワークフローでは、リトライや微調整が必要になる場合があります。

ファイル処理

出力にはシェルダウンロード手順が必要です。 出力とダウンロードを参照してください。
アップロードサイズ制限 が MCP クライアントによって適用される場合があります。一部のクライアントはファイルアップロードに独自の制限を設けています。

認証

OAuth または API キー。 Claude Code および Claude Desktop は、1回限りのブラウザ OAuth フローを使用します。Cursor は、MCP 設定で Comfy Cloud API キーを必要とします（OAuth なし）。その他のヘッドレスクライアントは、代わりに X-API-Key ヘッダー経由で Comfy Cloud API キーを渡すことができます。ブラウザを開けないクライアント向けのデバイスコード OAuth フローが計画されています。

FAQ

対応しているクライアントは？

MCP に対応し、リモート HTTP トランスポートをサポートしているクライアントはすべて https://cloud.comfy.org/mcp に接続できます。Claude Code、Claude Desktop、Cursor、Codex のセットアップ方法を文書化しています。Windsurf、Amp、OpenClaw などの他のエージェントも、同じ URL に OAuth または APIキーで接続します。詳細は Comfy Cloud MCP のインストールを参照してください。

APIキーは必要ですか？

OAuth に対応した対話型クライアント（Claude Code、Claude Desktop、Codex など）では不要です。Cursor では、MCP 設定に Comfy Cloud の APIキーが必要です。APIキーは、ブラウザのないヘッドレス環境や CI 環境でも必要です。詳細は Comfy Cloud MCP のインストールの Cursor タブまたは その他のクライアント タブを参照してください。

なぜエージェントは生成前に確認を求めるのですか？

有料の生成は支出ゲートの対象です：実行が Comfy Cloud のクレジットを消費する場合（パートナーモデル、または有料 API ノードを含むワークフロー/テンプレート）、サーバーは実行前に明示的な同意を必要とします。詳細はクレジットと支出を参照してください。

スラッシュコマンドは Claude Desktop でも使えますか？

いいえ。スラッシュコマンドは Claude Code プラグインに含まれています。Claude Desktop は同じ MCP サーバーに接続します（ツールはプレーン言語で質問するか、プロンプトピッカーを使えば機能します）が、Claude Code プラグインやスラッシュコマンドはサポートしていません。

/comfy または /cloud と入力したけど何も表示されません。

/comfy や /cloud というコマンドはありません。コマンドは、接続方法に応じて2つのプレフィックスのいずれかに表示されます。

プラグイン（推奨）： /comfy-cloud:generate-image、/comfy-cloud:generate-video … — すべて表示するには /comfy-cloud: と入力してください。
直接接続（プラグインなし）： /mcp__comfy-cloud__generate-image … — 表示するには /mcp__ と入力してください。

どちらの場合でも、プレーン言語で質問するだけでも構いません（「…の画像を生成して」など）。MCP ツールはモデルによって呼び出されるため、スラッシュコマンドは必要ありません。

サインインでブラウザが開きませんでした。

Claude Code では、/mcp を実行し、comfy-cloud を選択し、認証を選びます。Claude Desktop では、カスタマイズ → コネクタ からコネクタを再度開き、サインインをトリガーします。

エージェントを使って Comfy をローカルで実行する場合は？

Comfy Cloud MCP は当社のホスティングサービスですが、ローカルエージェントワークフローは ComfyUI がオープンソース化されて以来存在しています。なぜクラウドが先にリリースされたか、現在使用できるコミュニティ MCP サーバー、および別のオプションとして Comfy CLI については、Agent Tools の概要ページのローカル ComfyUI についてを参照してください。

​概要

​Comfy Cloud MCP のインストール

​エージェントができること

​MCP ツール

​検索

​生成

​ジョブとバッチ

​保存済みワークフロー

​ワークフローの共有

​アプリとリンク

​アカウントとセッション

​クレジットと支出

​出力とダウンロード

​関連リソース

​フィードバック

​既知の制限事項

​FAQ

概要

Comfy Cloud MCP のインストール

エージェントができること

MCP ツール

検索

生成

ジョブとバッチ

保存済みワークフロー

ワークフローの共有

アプリとリンク

アカウントとセッション

クレジットと支出

出力とダウンロード

関連リソース

フィードバック

既知の制限事項

FAQ