Comfy Cloud MCP

Documentation Index

Fetch the complete documentation index at: https://docs.comfy.org/llms.txt

Use this file to discover all available pages before exploring further.

​

クイックスタート

​

1. API キーを取得する

1

Visit https://platform.comfy.org/login and Log In

Please visit https://platform.comfy.org/login and log in with the corresponding account

2

Click `+ New` in API Keys to Create an API Key

Click + New in API Keys to create an API Key

3

Enter API Key Name

1. (Required) Enter the API Key name,
2. Click Generate to create

4

Save the Obtained API Key

Since the API Key is only visible upon first creation, please save it immediately after creation. It cannot be viewed later, so please keep it safe. Please note that you should not share your API Key with others. Once it leaked, you can delete it and create a new one.

​

2. インストールと接続

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

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

​

手動設定（代替方法）

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

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

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

​

使い方

​

スラッシュコマンド（Claude Code のみ）

​

利用可能なツール

​

ワークフローによる生成

​

パートナー API による生成（クラウド GPU 費用なし）

​

ディスカバリー

​

入力とチェイニング

​

保存済みワークフロー

​

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

​

フィードバック

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

​

仕組み

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

​

プロンプト例

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

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

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

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

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

​

出力の処理

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

​

既知の制限事項

• 保存されたワークフローを ID で実行できません。 保存されたワークフローの閲覧と確認（list_saved_workflows、get_saved_workflow）は可能ですが、必ずしも直接実行できるわけではありません。保存されたワークフローは ComfyUI グラフ形式を使用しており、API 形式への変換が必要です。AI エージェントはワークフローをゼロから再構築する必要があります。
• 生成されたアセットにワークフローメタデータがありません。 MCP サーバーで作成された画像にはメタデータにワークフロー JSON が含まれないため、ComfyUI で開いてもワークフローは表示されません。
• ワークフローの精度は AI に依存します。 エージェントは自然言語から ComfyUI ワークフローを構築します。複雑なマルチノードワークフローや特殊なノード設定では、反復が必要になる場合があります。

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

• API キーのみ。 認証には X-API-Key ヘッダーで Comfy Cloud API キーを渡す必要があります。ブラウザベースの OAuth はまだ利用できません。

• Claude Desktop — 生成された画像はネイティブの画像アーティファクトではなく、HTML を介してアーティファクトサイドパネルに表示されます。
• Claude Desktop チャットモード — OAuth が必要で、近日対応予定です。それまではコードモードをご利用ください — Claude Code の設定を自動的に引き継ぎます。

​

トラブルシューティング

​

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

​

API キーエラー

​

接続エラー

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