> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-feat-openapi-i18n.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy Cloud MCP

> Claude Code、Claude Desktop、Cursor、Codex、またはMCP互換エージェントからComfy Cloud MCPに接続: 画像・ビデオ・オーディオ・3Dの生成、モデルとノードの検索、ワークフローの実行。

<Note>
  これは **Comfy Cloud** の機能であり、クラウド版でのみ利用可能です。Comfy Cloud の詳細については、「[Comfy Cloud](/ja/get_started/cloud)」をご覧ください。
</Note>

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

## 概要

**Comfy Cloud MCP サーバー**は、AI エージェントを [モデルコンテキストプロトコル（MCP）](https://modelcontextprotocol.io) を通じて [Comfy Cloud](https://cloud.comfy.org) に接続します。接続後、チャットから画像、動画、オーディオ、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 から利用できます。

<a id="install-comfy-cloud-mcp" />

## Comfy Cloud MCP のインストール

<Info>
  接続する前に[Comfy Cloud](https://cloud.comfy.org)アカウントが必要です。まだお持ちでない場合は[サインアップ](https://cloud.comfy.org)してください。セットアップ時のOAuthログインはComfyアカウントを使用します。
</Info>

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

```
https://cloud.comfy.org/mcp
```

クライアントを選択:

<Tabs>
  <Tab title="Claude Code">
    **comfy-cloud**プラグインをインストールします。これにより、MCP接続とスラッシュコマンドが一度に追加されます。このプラグインは、[Comfy Skills](https://github.com/Comfy-Org/comfy-skills/)リポジトリを通じて公開されています。このリポジトリにはClaude CodeプラグインとComfy向けのコミュニティエージェントスキルがホストされています。

    <Steps>
      <Step title="マーケットプレイスを追加">
        Comfy Skillsマーケットプレイスを登録します（1回のみ）：

        ```
        /plugin marketplace add Comfy-Org/comfy-skills
        ```
      </Step>

      <Step title="プラグインをインストール">
        ```
        /plugin install comfy-cloud@comfy-skills
        ```
      </Step>

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

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

    | コマンド                             | 説明                                                     |
    | -------------------------------- | ------------------------------------------------------ |
    | `/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](https://comfy.org) で事前構築されたワークフローテンプレートを検索 |
    | `/comfy-cloud:search-models`     | 利用可能なモデルを検索                                            |
    | `/comfy-cloud:search-nodes`      | ノードを検索し、配線の提案を取得                                       |
    | `/comfy-cloud:help`              | ComfyUI Cloudでできることを確認                                 |

    <Accordion title="プラグインなしで接続だけを行いたいですか？">
      サーバーを直接追加：

      ```bash theme={null}
      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:*`コマンドとしてラップするため、推奨されます。
    </Accordion>
  </Tab>

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

    <video controls className="w-full aspect-video rounded-xl" src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/Claude_desktop.mp4?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=8c2a9971596dcb77c24f409d483ae0e6" data-path="images/agent_tools/Claude_desktop.mp4" />

    <Steps>
      <Step title="カスタマイズを開く">
        サイドバーで**カスタマイズ**（ラベル**1**）をクリックします。

        <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/claude_desktop_mcp_setup_step1.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=9e1f8d126781c5a8e3e3fa517d199e60" alt="Claude Desktop — カスタマイズを開く" width="712" height="842" data-path="images/agent_tools/claude_desktop_mcp_setup_step1.png" />
      </Step>

      <Step title="コネクタを開く">
        **コネクタ**（ラベル**2**）をクリックします。

        <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/claude_desktop_mcp_setup_step2.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=aba88d50b7815257191a84cc45bad90b" alt="Claude Desktop — コネクタを開く" width="856" height="811" data-path="images/agent_tools/claude_desktop_mcp_setup_step2.png" />
      </Step>

      <Step title="カスタムコネクタを追加">
        1. コネクタヘッダーの\*\*+**ボタン（ラベル**3\*\*）をクリックします。
        2. **カスタムコネクタを追加**（ラベル**4**）を選択します。

                   <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/claude_desktop_mcp_setup_step3.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=4f3b3bb3a1ed1394c370a6562d60c630" alt="Claude Desktop — カスタムコネクタを追加" width="1314" height="792" data-path="images/agent_tools/claude_desktop_mcp_setup_step3.png" />
      </Step>

      <Step title="サーバーの詳細を入力">
        1. **名前**フィールド（ラベル**5**）に、**Comfy Cloud MCP**などの名前を入力します。
        2. **Remote MCP server URL**を`https://cloud.comfy.org/mcp`に設定します（ラベル**6**）。
        3. **追加**（ラベル**7**）をクリックします。

                   <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/claude_desktop_mcp_setup_step4.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=e8e54b2e283b288adf499f9298e52ffa" alt="Claude Desktop — コネクタの詳細" width="1535" height="955" data-path="images/agent_tools/claude_desktop_mcp_setup_step4.png" />
      </Step>

      <Step title="ログイン">
        1. ブラウザが開いたら、ワークスペースを選択します（例：**個人ワークスペース**）。
        2. **続ける**をクリックしてコネクタを承認します。接続されます。

                   <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/auth.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=a171f57a26fca2ecdb0f873dc80d4919" alt="Comfy Cloud MCP認証" width="2718" height="1480" data-path="images/agent_tools/auth.png" />
      </Step>
    </Steps>

    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ツールは同様に機能します。
  </Tab>

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

    <Steps>
      <Step title="Cursor設定を開く">
        右上隅の**設定**歯車アイコン（ラベル**1**）をクリックします。

        <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/cursor_mcp_setup_step1.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=bfd03e9ed75b0db8ef04bf4a4a48b675" alt="Cursor — 設定を開く" width="2150" height="1516" data-path="images/agent_tools/cursor_mcp_setup_step1.png" />
      </Step>

      <Step title="Tools & MCPを開く">
        1. サイドバーで**Tools & MCPs**（ラベル**2**）をクリックします。
        2. **+ New MCP Server**（ラベル**3**）→ **Add a Custom MCP Server**をクリックします。

                   <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/cursor_mcp_setup_step2.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=50ee7c05c28446323c1f132f5709973f" alt="Cursor — Tools & MCPs" width="2150" height="1516" data-path="images/agent_tools/cursor_mcp_setup_step2.png" />
      </Step>

      <Step title="APIキーを追加">
        `~/.cursor/mcp.json`（グローバル）または `.cursor/mcp.json`（プロジェクト）を編集します。サーバーURLを設定し、`X-API-Key`ヘッダーでComfy Cloud APIキーを渡します。[platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)でキーを作成します（`comfyui-`で始まります）：

        ```json theme={null}
        {
          "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}`を推奨します。

        <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/cursor_mcp_setup_step3.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=222313ee885ab66f4f83ac899877ea7a" alt="Cursor — APIキーを含むmcp.json" width="2150" height="1516" data-path="images/agent_tools/cursor_mcp_setup_step3.png" />
      </Step>

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

  <Tab title="Codex">
    [Codex](https://developers.openai.com/codex/cli)は、Streamable HTTPを介してComfy Cloudに接続します。設定でサーバーを追加し、OAuthでログインします。

    <video controls className="w-full aspect-video rounded-xl" src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/CodeX_Oauth_mcp.mp4?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=e82ec15480672fce98fddc65ae823253" data-path="images/agent_tools/CodeX_Oauth_mcp.mp4" />

    <Steps>
      <Step title="設定パネルを開く">
        1. *Logged in with API key*の下にある**設定**（ラベル**1**）をクリックします。
        2. **設定**（ラベル**2**）をクリックして、設定パネル全体を開きます。

                   <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/codex_mcp_setup_step1.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=f5eea0882841df78c09481b511c9395b" alt="Codex設定パネル — ステップ1" width="1868" height="1278" data-path="images/agent_tools/codex_mcp_setup_step1.png" />
      </Step>

      <Step title="MCPサーバー設定を開く">
        1. 設定リストの**MCPサーバー**（ラベル**3**）をクリックします。
        2. **+ サーバーを追加**（ラベル**4**）をクリックして、新しいMCPサーバーを追加します。

                   <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/codex_mcp_setup_step2.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=e39629c43953e7ec6e5320e6dbc48201" alt="Codex MCPサーバー — ステップ2" width="1888" height="1364" data-path="images/agent_tools/codex_mcp_setup_step2.png" />
      </Step>

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

                   <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/codex_mcp_setup_step3.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=c83d45614c8542e67c42e7901712d3ad" alt="Codex MCPサーバー追加 — ステップ3" width="1888" height="1364" data-path="images/agent_tools/codex_mcp_setup_step3.png" />
      </Step>

      <Step title="認証">
        1. 保存したサーバーエントリで**認証**（ラベル**8**）をクリックします。

                   <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/codex_mcp_setup_step4.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=049d986b7a7a1f7cb778cd5872c73dbe" alt="Codex MCPサーバー認証 — ステップ4" width="1888" height="1364" data-path="images/agent_tools/codex_mcp_setup_step4.png" />

        2. ブラウザのポップアップでワークスペースを選択し、**続ける**をクリックしてログインを完了します。接続されます。

                   <img src="https://mintcdn.com/dripart-feat-openapi-i18n/QzZhnfxwJ2LqQsCT/images/agent_tools/auth.png?fit=max&auto=format&n=QzZhnfxwJ2LqQsCT&q=85&s=a171f57a26fca2ecdb0f873dc80d4919" alt="Comfy Cloud MCP認証" width="2718" height="1480" data-path="images/agent_tools/auth.png" />
      </Step>
    </Steps>

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

    <Accordion title="代わりにCLIを使いたいですか？">
      ターミナルから登録してログイン：

      ```bash theme={null}
      codex mcp add comfy-cloud --url https://cloud.comfy.org/mcp
      codex mcp login comfy-cloud
      ```

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

    <Accordion title="OAuthの代わりにAPIキー（ヘッドレス/CI用）">
      ブラウザが利用できない場合は、環境変数からヘッダーを取得するサーバーを追加します。[platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)でキーを作成し（`comfyui-`で始まります）、`~/.codex/config.toml`に追加します：

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

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

  <Tab title="その他のクライアント">
    **リモートHTTP**トランスポートをサポートするMCPクライアントは、Comfy Cloudに接続できます。サーバーURLは常に`https://cloud.comfy.org/mcp`です。

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

        ```json theme={null}
        {
          "mcpServers": {
            "comfy-cloud": {
              "url": "https://cloud.comfy.org/mcp"
            }
          }
        }
        ```

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

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

      <Step title="再起動して確認">
        クライアントを再起動します。**comfy-cloud**サーバーにComfy Cloudツール（`search_templates`、`submit_workflow`、`get_output`など）が登録されているはずです。
      </Step>
    </Steps>

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

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

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

    ```bash theme={null}
    claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp -H "X-API-Key: comfyui-…"
    ```

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

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

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

典型的な流れ:

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`でダウンロードコマンドを取得します（エージェントがシェルで実行します）。

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

## MCP ツール

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

### 検索

| ツール                   | 説明                                                                                                                                              |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `search_templates`    | [comfy.org](https://comfy.org/workflows) からテキスト、タグ、メディアタイプ、またはモデルで事前構築済みのワークフローテンプレートを検索します                                                     |
| `get_template`        | テンプレートの完全なワークフロー JSON を取得し、検査や手動編集を行えます                                                                                                         |
| `get_template_schema` | テンプレートのどのパラメータが実行時にオーバーライド可能かを確認します                                                                                                             |
| `search_models`       | テキスト、タイプ、ベースモデル、またはソースでモデルカタログを検索します                                                                                                            |
| `search_nodes`        | テキスト、カテゴリ、入力/出力タイプで利用可能なノードを検索します。また、**サブグラフブループリント**（テキストから画像へや背景を削除などの事前配線済みノードグループ）も表示します                                                    |
| `get_node`            | 特定のノードの完全な入力仕様を取得します（全オプションリストを含む）                                                                                                              |
| `cql`                 | 構造的な質問を行うために [CQL](https://github.com/Comfy-Org/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 チームと共有します。**あなたの明示的な同意がある場合のみ**。エージェントは事前に許可を求める必要があり、プロンプト、ファイルパス、個人情報は含まれません |

<a id="credits-and-spending" />

## クレジットと支出

検索は無料です: `search_templates`、`search_models`、`search_nodes` は [Comfy アカウント](https://cloud.comfy.org) だけで動作します。生成の実行は Comfy Cloud のクレジットを消費し、サブスクリプションまたはクレジット残高が必要です。

実際にお金を使うツールは **出費制限付き** です。生成で有料パートナーモデル (`partner_generate`) や有料 API ノードを含むワークフロー/テンプレート (`run_template`、`run_saved_workflow`、`submit_batch`) を使用する場合、サーバーはエージェントがクレジットを消費することに同意したことを確認するまで実行をブロックします。そのため、それらの実行前にエージェントが確認を求めます。無料のローカルのみのワークフローはプロンプトを表示しません。

いつでもエージェントに残高を尋ねることができます（「クレジットはいくつありますか？」）。エージェントは `get_billing_status` を通じて回答します。

## 出力とダウンロード

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

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

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

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

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

## 関連リソース

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

## フィードバック

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

* **[フィードバックアンケート](https://links.comfy.org/cloudmcpbeta)**: バグの報告、機能要望、一般の感想の共有など。
* **Discord**: [#comfy-mcp-and-cli](https://discord.gg/xWJn6nhE3R)（Comfy Discord 内）質問やディスカッション用。

## 既知の制限事項

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

**ワークフロー**

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

**ファイル処理**

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

**認証**

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

## FAQ

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

  <Accordion title="APIキーは必要ですか？">
    OAuth に対応した対話型クライアント（Claude Code、Claude Desktop、Codex など）では不要です。**Cursor** では、MCP 設定に Comfy Cloud の APIキーが必要です。APIキーは、ブラウザのないヘッドレス環境や CI 環境でも必要です。詳細は [Comfy Cloud MCP のインストール](#install-comfy-cloud-mcp) の **Cursor** タブまたは **その他のクライアント** タブを参照してください。
  </Accordion>

  <Accordion title="なぜエージェントは生成前に確認を求めるのですか？">
    有料の生成は支出ゲートの対象です：実行が Comfy Cloud のクレジットを消費する場合（パートナーモデル、または有料 API ノードを含むワークフロー/テンプレート）、サーバーは実行前に明示的な同意を必要とします。詳細は [クレジットと支出](#credits-and-spending) を参照してください。
  </Accordion>

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

  <Accordion title="/comfy または /cloud と入力したけど何も表示されません。">
    `/comfy` や `/cloud` というコマンドはありません。コマンドは、接続方法に応じて2つのプレフィックスのいずれかに表示されます。

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

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

  <Accordion title="サインインでブラウザが開きませんでした。">
    Claude Code では、`/mcp` を実行し、**comfy-cloud** を選択し、**認証** を選びます。Claude Desktop では、**カスタマイズ → コネクタ** からコネクタを再度開き、サインインをトリガーします。
  </Accordion>

  <Accordion title="エージェントを使って Comfy をローカルで実行する場合は？">
    Comfy Cloud MCP は当社のホスティングサービスですが、ローカルエージェントワークフローは ComfyUI がオープンソース化されて以来存在しています。なぜクラウドが先にリリースされたか、現在使用できるコミュニティ MCP サーバー、および別のオプションとして [Comfy CLI](/ja/agent-tools/comfy-cli) については、Agent Tools の概要ページの [ローカル ComfyUI について](/ja/agent-tools#what-about-local-comfyui) を参照してください。
  </Accordion>
</AccordionGroup>