Comfy MCP

​

概要

​

どの接続を選ぶべきか

​

Comfy Cloud MCP 接続

​

クラウド接続のセットアップ

https://cloud.comfy.org/mcp

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

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

1

Customize を開く

サイドバーで、Customize（1 と表示）をクリックします。

2

Connectors を開く

Connectors（2 と表示）をクリックします。

3

カスタムコネクタを追加

1. Connectors のヘッダーにある + ボタン（3 と表示）をクリックします。
2. Add custom connector（4 と表示）を選択します。

4

サーバーの詳細を入力

1. Name フィールド（5 と表示）に、Comfy Cloud MCP などの名前を入力します。
2. Remote MCP server URL を https://cloud.comfy.org/mcp に設定します（6 と表示）。
3. Add（7 と表示）をクリックします。

5

サインイン

1. ブラウザが開いたら、ワークスペースを選択します（例：Personal Workspace）。
2. Continue をクリックしてコネクタを認証します。接続されました。

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

1

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

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

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

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

1

Cursor Settings を開く

右上隅にある Settings ギア（1 と表示）をクリックします。

2

Tools & MCP を開く

1. サイドバーで、Tools & MCPs（2 と表示）をクリックします。
2. + New MCP Server（3 と表示）→ Add a Custom MCP Server をクリックします。

3

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} を使用することを推奨します。

4

生成を開始

自然言語で依頼します（「猫の宇宙飛行士の画像を生成して」「Wan 2.2 動画テンプレートを探して」など）。Cursor が MCP ツールを代わりに呼び出します。

Codex は Streamable HTTP 経由で Comfy Cloud に接続します。Settings でサーバーを追加し、OAuth でサインインします。

1

設定パネルを開く

1. Logged in with API key の下にある Settings（1 と表示）をクリックします。
2. フル設定パネルを開くために Settings（2 と表示）をクリックします。

2

MCP サーバー設定を開く

1. 設定リスト内の MCP servers（3 と表示）をクリックします。
2. + Add server（4 と表示）をクリックして新しい MCP サーバーを追加します。

3

Comfy Cloud に接続

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

4

Authenticate

1. 保存したサーバーエントリの Authenticate（8 と表示）をクリックします。
2. ブラウザのポップアップでワークスペースを選択し、Continue をクリックしてサインインを完了します。接続されました。

自然言語で依頼します（「猫の宇宙飛行士の画像を生成して」「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 を設定してください。キーをバージョン管理にコミットしないでください。

ClawHub から Comfy Cloud スキルをインストールします。OpenClaw をホストされた MCP サーバー（cloud.comfy.org/mcp）に接続します。クラウド専用で、ローカルの ComfyUI インストールは操作しません。

1

スキルをインストール

openclaw skills install @comfy-org/comfy

スキルページ: clawhub.ai/comfy-org/skills/comfy。

2

OAuth で接続（推奨）

MCP サーバーを登録し、Comfy アカウントでサインインします:

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 を表示します。それを開いてサインインし、CLI の指示に従ってフローを完了します（--code 付きで再実行が必要になる場合があります）。openclaw mcp status --verbose で確認します。

auth: "oauth" が設定されている場合、OpenClaw はそのサーバーエントリの静的 headers を無視します。OAuth とハードコードされた API キーヘッダーを併用しないでください。

3

生成を開始

自然言語で依頼します（「猫の宇宙飛行士の画像を生成して」「Wan 2.2 動画テンプレートを探して」など）。OpenClaw が MCP ツールを代わりに呼び出します。

OAuth の代わりに API キー（ヘッドレスまたは CI）

platform.comfy.org/profile/api-keys でキーを作成し（comfyui- で始まります）、エクスポートしてからサーバーを登録します:

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

OpenClaw では、カスタム X-API-Key ヘッダーよりも Authorization: Bearer を優先してください。一部の OpenClaw ビルドでは streamable-http トランスポートでカスタムヘッダーが削除されることがあります。Bearer の方がプロキシをより確実に通過します。COMFY_API_KEY をシェルプロファイルまたは OpenClaw 環境に設定してください。キーをコミットしないでください。

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

1

サーバー URL を追加

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

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

Windsurf では url の代わりに serverUrl を使用します。Amp は Settings → MCP Servers または ~/.config/amp/settings.json 内で同じ mcpServers 形式を使います。

2

認証

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

3

再起動して確認

クライアントを再起動します。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-…"

設定ファイルを Git にコミットする可能性がある場合、キーを直接ハードコーディングする代わりに ${env:COMFY_API_KEY} やクライアントのシークレット補間を使用することを推奨します。

​

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

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

​

クラウド MCP ツール

​

クレジットと利用料金

​

アップロードとダウンロード

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

​

既知の制限

• 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 フローが計画されています。

​

ローカル Comfy MCP 接続

​

要件

• Python 3.10+
• comfy-cli を PATH 上にインストール（pip install comfy-cli）。すべてのツールがラップするエンジンです
• ComfyUI ワークスペース。ない場合は comfy install で作成します（既存のチェックアウトは comfy set-default <path> で動作します）
• 稼働中の ComfyUI。ツールを使用する前に comfy launch で起動してください。ここで暗黙的に ComfyUI が起動することはありません

​

インストール

pip install comfy-mcp

​

手動設定

{
  "mcpServers": {
    "comfy-mcp": {
      "command": "comfy-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}

claude mcp add comfy-mcp -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-mcp

{
  "mcpServers": {
    "comfy-mcp": {
      "command": "comfy-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}

{
  "mcpServers": {
    "comfy-mcp": {
      "command": "comfy-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}

​

クイックスタート

git clone https://github.com/Comfy-Org/comfy-mcp
cd comfy-mcp
pip install "comfy-cli>=1.14.0"  # the engine
comfy install             # create a ComfyUI workspace (skip if you have one)
pip install comfy-mcp            # this MCP server → the `comfy-mcp` command

comfy launch

​

ツール

​

関連リソース

​

関連: Comfy アプリ内エージェント

​

フィードバック

• Feedback survey: バグの報告、機能のリクエスト、一般的なご感想の共有。
• Discord: ご質問やディスカッションは Comfy Discord の #comfy-mcp-and-cli チャンネルで。

​

よくある質問

​

はじめに

​

コストとアクセス

​

使用方法

​

トラブルシューティング