Comfy Cloud MCP

クローズドベータ — 招待制。 Comfy Cloud MCPは現在、ユーザーごとの機能フラグによるアクセス制御を行うクローズドベータ段階です。機能、ツール、動作はプロジェクトの進化に伴い変更される可能性があります。まだアクセス権がない場合は、ウェイトリストに登録してください。

Comfy Cloud MCPは、モデルコンテキストプロトコル（MCP）を通じて、Claude Desktop、Claude Code、Cursor、Amp などの AI アシスタントを Comfy Cloud に接続します。AI エージェントがクラウド GPU 上で画像、動画、音声、3D コンテンツの生成、モデルやノードの検索、ComfyUI ワークフローの実行を行うことができ、ローカル GPU は不要です。

クイックスタート

始める前にご確認ください：

有効な Comfy Cloud サブスクリプション（ワークフロー送信に必要）
メールアドレスが クローズドベータ の許可リストに登録されていること（上記の注意を参照）
サインイン方法：OAuth（対応クライアントでは推奨）または Comfy API キー（comfyui- で始まる）

OAuth または API キーでサインイン

OAuth（API キーの貼り付け不要） — Claude Code または Claude Desktop でリモートサーバー https://cloud.comfy.org/mcp を追加し、クライアントの Authenticate から Comfy アカウントでサインインします。接続後はパートナー生成もワークフローも同じツールで利用できます。 API キー — 引き続き完全にサポートされています。OAuth に未対応のクライアント、またはキーを使いたい場合は、下記のワンクリックインストールまたは手動設定をご利用ください。

OAuth の段階的ロールアウト。 MCP サーバーは本番で OAuth を受け付けますが、次の Comfy Cloud 本番デプロイが完了するまで（ディスカバリーエンドポイントの同期が必要）、一部のユーザーでは端到端のサインインがまだ動作しない場合があります。OAuth が使えない間は API キーをご利用ください。既存の API キー設定に変更はありません。

API キーを使用する場合で、まだお持ちでない場合は以下のガイドをご覧ください：

API キーを取得する

Cloud API、パートナーノードなどにアクセスするための Comfy Platform API キーの作成方法と管理方法を学びます。

インストールと接続（API キー）

ワンクリックインストーラは MCP クライアント（Claude Code、Cursor、Amp）を自動検出し、Comfy API キーを確認してリモート MCP サーバーを設定します。Node.js やその他の依存関係は不要です。

macOS / Linux
Windows (PowerShell)

curl -fsSL https://raw.githubusercontent.com/Comfy-Org/comfy-cloud-mcp/main/install.sh | bash

irm https://raw.githubusercontent.com/Comfy-Org/comfy-cloud-mcp/main/install.ps1 | iex

API キーで手動設定

Comfy Cloud MCPは https://cloud.comfy.org/mcp でホストされています。MCP クライアントをその URL に向け、API キーを設定します：

Claude Code
Claude Desktop
Cursor

claude mcp add comfyui-cloud \
  --transport http \
  https://cloud.comfy.org/mcp \
  -H "X-API-Key: your-api-key-here"

Claude Desktop の設定ファイルに以下を追加してください：

OS	設定ファイルのパス
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

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

Cursor の MCP 設定（プロジェクト内の .cursor/mcp.json またはグローバル設定）に以下を追加してください：

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

詳細は Cursor の MCP ドキュメントを参照してください。

サーバーを追加した後、新しい設定を反映するために MCP クライアントを再起動してください。

使い方

質問するだけ。 エージェントが自動的に適切なツールを選択します —— “宇宙に浮かぶ猫の宇宙飛行士の画像を生成して”、“SDXL チェックポイントを検索して”、“この画像をアップスケールして”。

生成ルーティング

エージェントは次の 2 つのパスから選択します。

パス	ツール	用途
パートナー API	`partner_generate`	指定プロバイダー（Flux、Grok、Nano Banana、Ideogram、GPT-image、Seedream など）
カスタムワークフロー	`submit_workflow`	OSS モデル、LoRA/ControlNet、多段パイプライン、`partner_generate` でカバーされないもの

パートナープロバイダーでは、partner_generate は常にまず実際の Comfy Cloud ワークフロー実行を試みます。出力はアセットライブラリに保存され、エディターで再オープンできるようワークフローが埋め込まれます。ツールは prompt_id を返すので、get_job_status でポーリングし、get_output で取得します（他のワークフローと同じ）。画像入力のリクエストや、まだ永続化対象に含まれないモデルでは、サーバーが自動的にパートナープロキシの直接応答（即時ダウンロード URL）にフォールバックします。このフォールバックは内部処理であり、オン/オフはできません。直接応答の結果はアセットライブラリに保存されません。

利用可能なツール

ワークフロー実行

ツール	説明
`submit_workflow`	ComfyUI API 形式のワークフローを Comfy Cloud で実行するために送信
`get_job_status`	送信されたワークフローの実行状態をポーリング
`get_output`	完了したワークフローの出力画像、動画、または音声を取得
`cancel_job`	保留中または実行中のジョブをキャンセル
`get_queue`	実行中および保留中のジョブ数を確認

パートナー API 生成

ツール	説明
`partner_generate`	パートナー API で生成（Flux、Nano Banana、Grok、GPT-image、Ideogram、Seedream など）。デフォルトは Comfy Cloud ワークフロー経由。`prompt_id` を返しアセットライブラリに保存。`get_job_status` / `get_output` で他のワークフローと同様に取得。未対応の場合は即時プロキシ URL に自動フォールバック。

ディスカバリー

ツール	説明
`search_templates`	テキスト、タグ、メディアタイプ、またはモデルで comfy.org のプリビルトワークフローテンプレートを検索
`search_models`	テキスト、タイプ、ベースモデル、またはソースでモデルカタログを検索
`search_nodes`	テキスト、カテゴリ、または入力/出力タイプで利用可能なノードを検索
`cql`	Comfy クエリ言語を実行して高度な検索

入力とチェイニング

ツール	説明
`upload_file`	ワークフローで使用する入力画像やファイルをアップロード（例：LoadImage）
`use_previous_output`	あるワークフローの出力を別のワークフローの入力として再利用し、ワークフローを連鎖

保存済みワークフロー

ツール	説明
`list_saved_workflows`	Comfy Cloud に保存されたワークフローを閲覧
`get_saved_workflow`	保存されたワークフローのノード、入力、設定を確認
`save_workflow`	ワークフローをワークスペースに保存（保存形式または API 形式；API 形式は自動変換）
`run_saved_workflow`	保存済みワークフローを取得し、API 形式に変換して実行を送信

フィードバック（ベータ）

ツール	説明
`submit_feedback`	評価とコメントでフィードバックを送信
`report_session_summary`	同意に基づくセッションサマリーを報告（プロンプト、ファイルパス、個人情報は含まれません）

サーバーはゼロからワークフローを構築する前に、一致するプリビルドテンプレートがないか確認します。これにより、より良い結果とより高速な生成が実現します。

フィードバック

これはクローズドベータです — 改善のためフィードバックをお寄せください。

エージェント内： エージェントに submit_feedback（評価 + コメント）または report_session_summary（同意に基づくセッションサマリー；プロンプト/ファイルパス/個人情報は含まれません）の呼び出しを依頼してください。
アンケート： links.comfy.org/cloudmcpbeta
問題報告： このリポジトリで Issue を報告してください

ツールエラーにはセッションごとに一度だけフィードバックチャンネルへのポインタが含まれるため、覚えておく必要はありません。

仕組み

┌──────────────┐    HTTPS/MCP    ┌─────────────────────────────────────────────┐
│  AI エージェ │◄───────────────►│            Comfy Cloud                      │
│  ント        │  API キーまたは │  cloud.comfy.org/mcp → クラウド GPU 上で   │
│  (Claude,    │  OAuth Bearer   │                        ワークフロー実行     │
│   Cursor,    │                 │                                             │
│   Amp)       │                 │                                             │
└──────────────┘                 └─────────────────────────────────────────────┘

AI エージェントは cloud.comfy.org/mcp でホストされている MCP サーバーに直接接続します。サーバーは MCP ツールコールを Comfy Cloud GPU 上のワークフロー実行に変換します。ローカルサーバーや GPU は不要です。パートナーモデルでは、エージェントは通常まず partner_generate（ワークフロー + ライブラリ保存）を呼び出します。それ以外はディスカバリーツール（search_templates、search_nodes、cql）で ComfyUI API 形式のワークフロー JSON を構築し、submit_workflow で送信します。やりたいことを自然言語で説明するだけです。

プロンプト例

インストール後、AI アシスタントで以下のプロンプトを試してみてください：

宇宙に浮かぶ猫の宇宙飛行士の画像を生成して、カートゥーンスタイルで

テキストから動画を生成するワークフローテンプレートを探して

SDXL チェックポイントモデルを検索して、利用可能なものを教えて

山と夕暮れ時に光る川のあるファンタジー風景を生成して

画像のアップスケーリングに使えるノードは？

エージェントは一致するテンプレートを検索し、ComfyUI ワークフローを構築して Comfy Cloud に送信し、生成された画像を会話内で直接返します。

出力の処理

画像は会話内にインラインで表示（Claude Code）、またはアーティファクトサイドパネルに表示（Claude Desktop）されます
動画と音声の出力はダウンロード可能なリンクとして返されます
アニメーション画像（GIF、WebP）は保存されますが、アニメーションを保持するためインラインプレビューは表示されません
インライン画像プレビューは効率的な表示のため 1024px にリサイズされます。フル解像度の出力は常に get_output ツールで取得できます

既知の制限事項

これは早期リリースです。以下の制限事項が判明しており、積極的に改善中です。

ワークフロー

run_saved_workflow のカバレッジ。 保存済みワークフローを取得し、保存形式 → API 形式に変換して送信します。複雑な入力上書きや未対応ノードがある場合は、手動修正や submit_workflow による再構築が必要な場合があります。
ワークフローメタデータはパスによって異なります。 partner_generate（ワークフローパス）の出力はアセットライブラリに保存され、エディターで再オープンできるグラフが埋め込まれます。submit_workflow や partner_generate の直接フォールバックの出力には、ライブラリに完全なメタデータが含まれない場合があります。
ワークフローの精度は AI に依存します。 エージェントは自然言語から ComfyUI ワークフローを構築します。複雑なマルチノードワークフローや特殊なノード設定では、反復が必要になる場合があります。
partner_generate の範囲。 永続化対象モデルセットのテキスト→画像は保存ワークフローとして実行されます。画像入力、未マップモデル、非画像モダリティは、ワークフロー永続化の拡張まで直接プロキシフォールバック（即時 URL、ライブラリ非保存）を使用します。

ファイル処理

アップロードサイズの制限は MCP クライアントによって異なる場合があります。
画像プレビューはリサイズされます。 インラインプレビューは 1024px（JPEG）に制限されます。フル解像度のファイルはディスクに保存されます。

認証

API キーまたは OAuth。 手動設定では X-API-Key ヘッダーに Comfy Cloud API キーを指定します。Comfy OAuth でサインインする MCP クライアントは Authorization: Bearer を送信します。ホスト型サーバーは両方に対応しています。

クライアント固有

Claude Desktop — 生成された画像はネイティブの画像アーティファクトではなく、HTML を介してアーティファクトサイドパネルに表示されます。

トラブルシューティング

MCP サーバーが表示されない

MCP クライアントを再起動してください（Claude Code、Claude Desktop、Cursor、Amp を閉じて再度開く）。MCP サーバーは起動時に読み込まれます。設定内のサーバー URL が正確に https://cloud.comfy.org/mcp であることを再確認してください。

API キーエラー

platform.comfy.org/profile/api-keys で API キーが有効であることを確認してください。手動設定では X-API-Key ヘッダーでキーを渡してください — comfyui- キーを Bearer トークンとして送らないでください。OAuth 接続のクライアントは、Comfy サインインフローからの Authorization: Bearer を使用し、X-API-Key は使用しません。必要に応じて新しい API キーを生成し、クライアント設定を更新してください。

接続エラー

MCP クライアントがサーバーに接続できない場合、以下を確認してください：

アクティブなインターネット接続があること
ファイアウォールやプロキシが cloud.comfy.org をブロックしていないこと
アクティブな Comfy Cloud サブスクリプションがあること

Documentation Index

​クイックスタート

​OAuth または API キーでサインイン

API キーを取得する

​インストールと接続（API キー）

​API キーで手動設定

​使い方

​生成ルーティング

​利用可能なツール

​ワークフロー実行

​パートナー API 生成

​ディスカバリー

​入力とチェイニング

​保存済みワークフロー

​フィードバック（ベータ）

​フィードバック

​仕組み

​プロンプト例

​出力の処理

​既知の制限事項

​トラブルシューティング

​MCP サーバーが表示されない

​API キーエラー

​接続エラー

クイックスタート

OAuth または API キーでサインイン

インストールと接続（API キー）

API キーで手動設定

使い方

生成ルーティング

利用可能なツール

ワークフロー実行

パートナー API 生成

ディスカバリー

入力とチェイニング

保存済みワークフロー

フィードバック（ベータ）

フィードバック

仕組み

プロンプト例

出力の処理

既知の制限事項

トラブルシューティング

MCP サーバーが表示されない

API キーエラー

接続エラー