メインコンテンツへスキップ
これは 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 に代行送信します。 現在のサポート範囲は Claude Code と Claude Desktop に限定されており、どちらも OAuth（ブラウザで一度きりのログイン）でログインします。今後、他のクライアントにも対応予定です。

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

MCPツールを自分で呼び出す必要はありません。エージェントがあなたの指示に基づいて適切なツールを選択します。スラッシュコマンドやプロンプト（後述）は、エージェントを一般的なタスクに誘導するショートカットですが、プレーンな言葉でも機能します（「猫の宇宙飛行士の画像を生成して」「この写真をアップスケールして」「Wan 2.2のビデオテンプレートを探して」など）。 典型的な流れ:
  1. 発見：利用可能なものを検索します（search_templates、search_models、search_nodes、またはグラフ形式の質問にはcql）。
  2. 実行：生成またはワークフローを実行します（submit_workflow。入力画像が必要な場合はupload_fileを併用）。
  3. 出力の取得：get_outputが、エージェントがシェルで実行するダウンロードコマンドを返します。
サーバーは、ゼロからワークフローを構築する前に、プリビルトテンプレートとのマッチングを優先します。これにより、より速く良い結果が得られる傾向があります。

​
MCP ツール

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

​
検索

ツール説明
search_templatescomfy.org から、テキスト、タグ、メディア種類、モデルで事前構築済みワークフローテンプレートを検索します。
search_modelsモデルカタログをテキスト、種類、ベースモデル、ソースで検索します。
search_nodes利用可能なノードをテキスト、カテゴリ、入出力タイプで検索します。また、サブグラフブループリント（テキストから画像へ、背景を削除 など、あらかじめ配線されたノードグループ）も表示します。
cql構造的な質問（例：どのノードが画像を生成するか、ノードタイプ間のパスなど）に対して CQL グラフクエリを実行します。特定ノードの完全な入力仕様が必要な場合は search_nodes を使用してください。

​
実行

ツール説明
submit_workflowComfyUI API 形式のワークフローを Comfy Cloud で実行するために送信します。
upload_fileワークフローで使用する入力画像やファイルをアップロードします（例：LoadImage ノード用）。
get_job_status送信したワークフローの実行ステータスをポーリングします。
get_output完了したワークフローから出力画像、動画、オーディオを取得します。
use_previous_outputある実行の出力を別の実行の入力として再利用し、ワークフローを連鎖させます。
cancel_job保留中または実行中のジョブをキャンセルします。
get_queue実行中および保留中のジョブ数を確認します。

​
保存済みワークフロー

ツール説明
list_saved_workflowsComfy Cloud に保存されたワークフローをブラウズします。
get_saved_workflow保存済みワークフローのノード、入力、設定を検査します。
save_workflowワークフローを Comfy Cloud アカウントに保存します。
保存済みワークフローのブラウズや検査は可能ですが、現時点ではエージェントは ID で直接実行できません。保存済みワークフローは ComfyUI グラフ形式であり、実行前に API 形式に変換する必要があります。詳細は「既知の制限」を参照してください。

​
ワークフローの共有

ツール説明
share_workflow保存済みワークフローを公開し、誰でも開ける ?share=<id> URL を返します。
import_shared_workflow共有 URL または bare な共有 ID を解決してワークフロー JSON を取得し、オプションでアカウントに保存します。
ハブ URL の共有 ID: comfy.org/workflows/<slug>-<hex> のような��ブ URL 内の末尾のハイフン区切り16進トークンが共有 ID です。例えば、comfy.org/workflows/topaz-starlight-upscale-1c77e82713b7 の共有 ID は 1c77e82713b7 です。このトークンを import_shared_workflow の share_id に渡してください。share_url パラメータは ?share=<id> クエリ形式の URL（例：https://cloud.comfy.org/?share=...）のみを受け付け、ハブページ URL は受け付けません。

​
インストール

クライアントを選択してください:

Claude Code

プラグインをインストールします。接続とコマンドがワンステップで完了します。

Claude Desktop

アプリでカスタムコネクターを追加し、ログインします。

​
Claude Code

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

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

Comfy Skillsマーケットプレイスを登録します（一度だけ）:
/plugin marketplace add Comfy-Org/comfy-skills
2

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

/plugin install comfy-cloud@comfy-skills
3

ログイン

/mcp を実行し、comfy-cloud → Authenticate を選択します。ブラウザが開いてログインし、トークンは自動的に更新されます。
このプラグインは以下のスラッシュコマンドを追加します:
コマンド機能
/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-templatescomfy.org で事前構築済みのワークフローテンプレートを検索します
/comfy-cloud:search-models利用可能なモデルを検索します
/comfy-cloud:search-nodesノードを検索し、配線の提案を取得します
/comfy-cloud:helpComfyUI Cloud でできることを確認します
サーバーを直接追加します:
claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp
次に /mcp を実行し、comfy-cloud → Authenticate を選択します。-s user を追加すると、すべてのプロジェクトで利用可能になります。この方法でも、同じワークフローがMCPプロンプトとして公開されます: /mcp__comfy-cloud__generate-image、/mcp__comfy-cloud__search-models など（/mcp__<name>__ プレフィックスは claude mcp add に渡した名前を使用します）。上記のプラグインは、これらをより使いやすい /comfy-cloud:* コマンドとしてラップするため、推奨されます。

​
Claude Desktop

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

コネクターを開く

Claude Desktopで カスタマイズ を開き、コネクター を選択します。Claude Desktop コネクター
2

カスタムコネクターを追加

+ ボタンをクリックし、カスタムコネクターを追加 を選択します。カスタムコネクターを追加
3

サーバーURLを入力

任意の名前を付け（例: Comfy Cloud）、Remote MCP server URL を次のように設定します:
https://cloud.comfy.org/mcp
コネクター詳細
4

ログイン

Add をクリックし、プロンプトに従ってClaude Desktopからログインします。接続が完了します。Claude Desktopからログイン
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ノードを検索し、配線の提案を取得
helpComfyUI Cloud でできることを確認
プロンプトをスキップして、平易な言葉で質問することもできます。MCPツールは同じように動作します。

​
ヘッドレス / CI (APIキー)

Claude CodeとClaude DesktopはOAuthを使用するため、APIキーは必要ありません。ブラウザが利用できないヘッドレスまたはCI環境では、代わりにAPIキーで認証します:
1

キーを作成

platform.comfy.org/profile/api-keys にアクセスし、New API Key をクリックしてコピーします（comfyui- で始まります）。
2

キーヘッダーでサーバーを追加

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

​
出力とダウンロード

MCP サーバーはクラウド上で動作し、ファイルをあなたのマシンに書き込むことはありません。生成が完了すると、エージェントが get_output を呼び出し、以下のものを返します。
  1. 短期間有効な署名付きダウンロード URL（短い期間のみ有効）。
  2. すぐに実行できるシェルコマンド（macOS と Linux では curl、Windows では curl.exe）。
エージェントはそのコマンドをシェルで実行します。コマンドには保存先のパスとファイル名が含まれています。
返されたコマンドはそのまま実行してください。署名付き URL を再エンコードしたり編集したりしないでください。署名はクエリ文字��に含まれており、URL を変更すると壊れます。
MCP クライアントがシェルコマンドを実行できない場合（一部の GUI のみのセットアップ）、コマンドをコピーして、ターミナルで自分で実行してください。

​
関連リソース

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

​
フィードバック

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

​
既知の制限事項

Comfy Cloud MCP は初期リリースです。以下の制限事項は既知であり、現在対応中です： ワークフロー
  • 保存済みワークフローは ID で実行できません。 エージェントは保存済みワークフローの一覧表示と検査は可能ですが、実行前にそれらを再構築するか API 形式に変換する必要があります。
  • 生成されたアセットにワークフローメタデータが埋め込まれない場合があります。 MCP 経由で作成された画像は、ComfyUI で開いたときにワークフローが復元されない可能性があります。
  • ワークフローの構築はエージェントの精度に依存します。 複雑なマルチノードワークフローでは、リトライや微調整が必要になる場合があります。
ファイル処理
  • 出力にはシェルダウンロード手順が必要です。 出力とダウンロード を参照してください。
  • アップロードサイズ制限 が MCP クライアントによって適用される場合があります。一部のクライアントはファイルアップロードに独自の制限を設けています。
認証
  • OAuth または API キー。 Claude Code および Claude Desktop は、1回限りのブラウザ OAuth フローを使用します。ヘッドレスクライアントは、代わりに X-API-Key ヘッダー経由で Comfy Cloud API キーを渡すことができます。ブラウザを開けないクライアント向けのデバイスコード OAuth フローが計画されています。

​
FAQ

Claude Code と Claude Desktop が現在対応しており、どちらも OAuth でサインインします。さらに多くのクライアントへの対応も予定しています。
Claude Code や Claude Desktop では不要です。これらは OAuth を使用します。APIキーは、ブラウザがないヘッドレスまたはCI環境でのみ必要です。
いいえ。スラッシュコマンドは Claude Code プラグインに含まれています。Claude Desktop は同じ MCP サーバーに接続します（ツールはプレーン言語で質問するか、プロンプトピッカーを使えば機能します）が、Claude Code プラグインやスラッシュコマンドはサポートしていません。
/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 Cloud MCP は当社のホスティングサービスですが、ローカルエージェントワークフローは ComfyUI がオープンソース化されて以来存在しています。なぜクラウドが先にリリースされたか、現在使用できるコミュニティ MCP サーバー、および別のオプションとして Comfy CLI については、Agent Tools の概要ページの ローカル ComfyUI について を参照してください。