> ## 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](/zh/get_started/cloud)。
</Note>

<Info>
  **公开测试版。** Comfy Cloud MCP 目前处于公开测试阶段。API、工具和行为在迭代过程中可能会发生变化。请参阅[反馈](#反馈)来报告问题或分享建议。
</Info>

## 概述

**Comfy Cloud MCP 服务器**通过[模型上下文协议（MCP）](https://modelcontextprotocol.io)将 AI 代理连接到 [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** 和其他代理使用相同的 URL，搭配 OAuth 或 API 密钥。

<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 插件市场（只需一次）：

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

      <Step title="安装插件">
        ```
        /plugin install comfy-cloud@comfy-skills
        ```
      </Step>

      <Step title="登录">
        运行 `/mcp`，选择 **comfy-cloud** → **Authenticate**。你的浏览器会打开并登录，令牌会自动刷新。
      </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** → **Authenticate**。添加 `-s user` 使其在你所有项目中可用。

      此路径仍然会暴露与 MCP 提示词相同的工作流：`/mcp__comfy-cloud__generate-image`、`/mcp__comfy-cloud__search-models` 等（`/mcp__<name>__` 前缀使用你传递给 `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="打开自定义">
        在侧边栏中，点击 **Customize**（标记为 **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="打开连接器">
        点击 **Connectors**（标记为 **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. 选择 **Add custom connector**（标记为 **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. 在 **Name** 字段中输入一个名称，例如 **Comfy Cloud MCP**（标记为 **5**）。
        2. 将 **Remote MCP server URL** 设置为 `https://cloud.comfy.org/mcp`（标记为 **6**）。
        3. 点击 **Add**（标记为 **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`     | 搜索模型（checkpoint、LoRA、VAE） |
    | `search-nodes`      | 搜索节点并获取连接建议               |
    | `help`              | 查看你可以用 ComfyUI Cloud 做什么  |

    你也可以跳过提示词，直接用自然语言提问。MCP 工具的工作方式相同。
  </Tab>

  <Tab title="Cursor">
    Cursor 通过 HTTP 连接到远程 MCP 服务器。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}"
              }
            }
          }
        }
        ```

        在你的 shell 或系统环境中设置 `COMFY_API_KEY`。推荐使用 `${env:COMFY_API_KEY}` 而不是在可能提交到 git 的文件中硬编码密钥。

        <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* 下点击 **Settings**（标记为 **1**）。
        2. 点击 **Settings**（标记为 **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 servers**（标记为 **3**）。
        2. 点击 **+ Add server**（标记为 **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. 在 **Name** 字段中输入一个名称，例如 **Comfy Cloud MCP**（标记为 **5**）。
        3. 在 **URL** 字段中输入 URL `https://cloud.comfy.org/mcp`（标记为 **6**）。
        4. 点击 **Save**（标记为 **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. 点击已保存服务器条目上的 **Authenticate**（标记为 **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="使用 API 密钥代替 OAuth（无界面或 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" }
      ```

      在你的 shell 或系统环境中设置 `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** 使用 `serverUrl` 代替 `url`。**Amp** 在 **Settings → MCP Servers** 或 `~/.config/amp/settings.json` 中使用相同的 `mcpServers` 结构。
      </Step>

      <Step title="认证">
        如果你的客户端支持 MCP OAuth，在提示时通过浏览器登录。否则，添加 API 密钥标头（见下文）。
      </Step>

      <Step title="重新启动并验证">
        重新启动你的客户端。你应该会看到 Comfy Cloud 工具（`search_templates`、`submit_workflow`、`get_output` 等）在 **comfy-cloud** 服务器下注册。
      </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`），或使用 `partner_generate` 调用 Flux、Grok、Gemini、OpenAI、Ideogram、Seedance 等合作伙伴模型。
3. **等待并获取输出**（`wait_for_job`，然后 `get_output` 返回一条下载指令，由您的代理在 shell 中运行）。

服务器倾向于优先匹配 [预构建模板](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>` 链接 |
| `import_shared_workflow` | 将分享链接或纯分享 ID 解析为工作流 JSON，可选择保存到您的账户         |

**Hub 链接分享 ID：** `comfy.org/workflows/<slug>-<hex>` Hub 链接中尾部的连字符分隔的十六进制令牌就是分享 ID。例如，`comfy.org/workflows/topaz-starlight-upscale-1c77e82713b7` 的分享 ID 是 `1c77e82713b7`。将该令牌作为 `share_id` 传给 `import_shared_workflow`。`share_url` 参数只接受类似 `https://cloud.comfy.org/?share=...` 的 `?share=<id>` 查询参数链接，不接受 Hub 页面链接。

### 应用与链接

| 工具                        | 描述                                                   |
| ------------------------- | ---------------------------------------------------- |
| `create_app`              | 将已保存的工作流转换为应用模式（App Mode）应用——带有选定输入和输出、简化的“运行此工作流”视图 |
| `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. 一条可直接运行的 **shell 指令**（macOS 和 Linux 上为 `curl`，Windows 上为 `curl.exe`）。

你的代理应在终端中运行该指令。指令中包含了目标路径和文件名。

<Warning>
  请**逐字运行**返回的指令。请勿重新编码或编辑签名的 URL。签名位于查询字符串中，一旦修改 URL 就会失效。
</Warning>

如果你的 MCP 客户端无法运行 shell 指令（某些仅 GUI 的环境），请复制该指令并自行在终端中运行。

## 相关资源

| 资源                                                         | 用途                                                                                           |
| ---------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) | Claude Code 插件市场与社区技能库。上述使用的 **comfy-cloud** 插件即在此分发；可浏览或贡献适用于 Comfy 工作流的其他技能。               |
| [Comfy CLI](/zh/agent-tools/comfy-cli)                     | 用于在本地安装/启动 ComfyUI，以及从脚本或 CI 中调用托管合作节点的命令行工具（`comfy generate`，测试版）。当需要终端或自动化工作流时，可补充 MCP 使用。 |
| [在 Comfy Cloud 上分享工作流](/zh/cloud/share-workflow)           | 从 Comfy Cloud UI 界面分享工作流（MCP 的 `share_workflow` 工具可在代理会话中完成此操作）。                             |

## 反馈

Comfy Cloud MCP 目前处于公开测试阶段。请试试看，并告诉我们哪些功能好用、哪些不好用：

* **[反馈调查问卷](https://links.comfy.org/cloudmcpbeta)**：反馈错误、请求功能或分享常规印象。
* **Discord**：在 Comfy Discord 上的 [#comfy-mcp-and-cli](https://discord.gg/xWJn6nhE3R) 频道进行提问和讨论。

## 已知限制

Comfy Cloud MCP 为早期版本。以下为已知的限制，团队正在努力解决：

**工作流**

* **编辑器格式到可执行格式的转换尚不完善。** 已保存的工作流可以通过 `run_saved_workflow` 按文件名运行（服务器会自动转换），但某些节点配置的转换仍不够完美。
* **通过 `submit_workflow` 生成的资产可能未嵌入工作流元数据。** 在 ComfyUI 中打开时，可能无法重新打开其原始工作流。
* **工作流构建依赖于智能体的准确性。** 复杂的多节点工作流可能需要重试或优化。

**文件处理**

* **输出需要经过 Shell 下载步骤。** 请参阅[输出与下载](#outputs-and-downloads)。
* **上传大小限制**可能因 MCP 客户端而异。某些客户端对文件上传施加了自己的限制。

**身份验证**

* **OAuth 或 API 密钥。** Claude Code 和 Claude Desktop 使用一次性浏览器 OAuth 流程。**Cursor** 需要你在 MCP 配置中提供 Comfy Cloud API 密钥（不支持 OAuth）。其他无头客户端可以通过 `X-API-Key` 标头传递 Comfy Cloud API 密钥作为替代。计划为无法打开浏览器的客户端提供设备码 OAuth 流程。

## 常见问题

<AccordionGroup>
  <Accordion title="支持哪些客户端？">
    任何支持远程 HTTP 传输的 MCP 兼容客户端都可以连接到 `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 密钥。在没有浏览器的无头或 CI 环境中也需要 API 密钥。请参见[安装 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` 指令。指令根据连接方式显示在以下两个前缀之一下：

    * **插件（推荐）：** `/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**，然后选择 **Authenticate**。在 Claude Desktop 中，重新打开“自定义 → 连接器”中的连接器，并触发登录。
  </Accordion>

  <Accordion title="如何在本地使用代理运行 Comfy？">
    Comfy Cloud MCP 是我们的托管服务，但自 ComfyUI 开源以来，本地代理工作流就已存在。请参阅 Agent Tools 概述中的[关于本地 ComfyUI？](/zh/agent-tools#what-about-local-comfyui)部分，了解 Cloud 首先发布的原因、当前可用的社区 MCP 服务器，以及另一个选择——[Comfy CLI](/zh/agent-tools/comfy-cli)。
  </Accordion>
</AccordionGroup>