Comfy Cloud MCP

​

概述

​

安装 Comfy Cloud MCP

https://cloud.comfy.org/mcp

• Claude Desktop
• Claude Code
• Cursor
• Codex
• OpenClaw
• 其他客户端

Claude Desktop 通过其 UI 将 Comfy Cloud 添加为自定义连接器，然后运行 OAuth 登录。

1

打开自定义

在侧边栏中，点击 Customize（标记为 1）。

2

打开连接器

点击 Connectors（标记为 2）。

3

添加自定义连接器

1. 点击连接器标题中的 + 按钮（标记为 3）。
2. 选择 Add custom connector（标记为 4）。

4

输入服务器详情

1. 在 Name 字段中输入一个名称，例如 Comfy Cloud MCP（标记为 5）。
2. 将 Remote MCP server URL 设置为 https://cloud.comfy.org/mcp（标记为 6）。
3. 点击 Add（标记为 7）。

5

登录

1. 当浏览器打开时，选择你的工作区（例如个人工作区）。
2. 点击继续以授权连接器。你已连接。

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 工具的工作方式相同。

安装 comfy-cloud 插件。它将 MCP 连接和斜杠指令集成为一步操作。该插件通过 Comfy Skills 仓库发布，该仓库托管了 Claude Code 插件以及适用于 Comfy 的社区代理技能。

1

添加插件市场

添加 Comfy Skills 插件市场（只需一次）：

/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 设置

点击右上角的设置齿轮（标记为 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}"
      }
    }
  }
}

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

4

开始生成

用自然语言提问（“生成一张猫宇航员的图像”、“找一个 Wan 2.2 视频模板”）。Cursor 会代表你调用 MCP 工具。

Codex 通过 Streamable HTTP 连接到 Comfy Cloud。在设置中添加服务器，然后使用 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 字段中输入一个名称，例如 Comfy Cloud MCP（标记为 5）。
3. 在 URL 字段中输入 URL https://cloud.comfy.org/mcp（标记为 6）。
4. 点击 Save（标记为 7）。

4

认证

1. 点击已保存服务器条目上的 Authenticate（标记为 8）。
2. 在浏览器弹窗中，选择你的工作区并点击继续完成登录。你已连接。

用自然语言提问（“生成一张猫宇航员的图像”、“找一个 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）。

使用 API 密钥代替 OAuth（无界面或 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" }

在你的 shell 或系统环境中设置 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 工具。

使用 API 密钥代替 OAuth（无界面或 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，推荐使用 Authorization: Bearer 而非自定义的 X-API-Key 标头。某些 OpenClaw 构建会在 streamable-http 传输上丢弃自定义标头；Bearer 更可靠地通过代理。将 COMFY_API_KEY 放入你的 shell 配置或 OpenClaw 环境变量中。不要提交密钥。

任何支持 远程 HTTP 传输的 MCP 客户端都可以连接到 Comfy Cloud。服务器 URL 始终为 https://cloud.comfy.org/mcp。

1

添加服务器 URL

添加一个指向 https://cloud.comfy.org/mcp 的远程 MCP 条目。大多数客户端使用带有 url 字段的 JSON 配置：

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

Windsurf 使用 serverUrl 而不是 url。Amp 在 设置 → MCP Servers 或 ~/.config/amp/settings.json 中使用相同的 mcpServers 结构。

2

认证

如果你的客户端支持 MCP OAuth，在提示时通过浏览器登录。否则，添加一个 API 密钥标头（见下文）。

3

重新启动并验证

重新启动你的客户端。你应该会看到 Comfy Cloud 工具（search_templates、submit_workflow、get_output 等）注册在 comfy-cloud 服务器下。

无界面 / 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-…"

优先使用 ${env:COMFY_API_KEY} 或你客户端的机密插值，而不是在提交到 git 的配置文件中硬编码密钥。

​

您的代理能做什么

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 中运行）。

​

MCP 工具

​

发现

​

生成

​

作业与批处理

​

已保存的工作流

​

共享工作流

​

应用与链接

​

账户与会话

​

积分与消费

​

输出与下载

1. 一个临时签名下载 URL（在短时间内有效）。
2. 一条可直接运行的 shell 指令（macOS 和 Linux 上为 curl，Windows 上为 curl.exe）。

​

相关资源

​

相关：Comfy In-App Agent

​

反馈

• 反馈调查问卷：反馈错误、请求功能或分享常规印象。
• Discord：在 Comfy Discord 上的 #comfy-mcp-and-cli 频道进行提问和讨论。

​

已知限制

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

• 输出需要经过 Shell 下载步骤。 请参阅输出与下载。
• 上传大小限制可能因 MCP 客户端而异。某些客户端对文件上传施加了自己的限制。

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

​

常见问题