Comfy Cloud MCP

这是 Comfy Cloud 云端功能，仅在云端版本中可用，本地版本不支持此功能。了解更多关于 Comfy Cloud 的信息，请参阅 Comfy Cloud。

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

概述

Comfy Cloud MCP 服务器通过模型上下文协议（MCP）将 AI 代理连接到 Comfy Cloud。连接后，你可以通过代理对话生成图像、视频、音频和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 密钥。

安装 Comfy Cloud MCP

你需要有一个 Comfy Cloud 账户才能连接。如果你还没有，请注册。设置期间的 OAuth 登录会使用你的 Comfy 账户。

Comfy Cloud MCP 运行于：

https://cloud.comfy.org/mcp

选择你的客户端：

Claude Code
Claude Desktop
Cursor
Codex
其他客户端

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

添加插件市场

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

/plugin marketplace add Comfy-Org/comfy-skills

安装插件

/plugin install comfy-cloud@comfy-skills

运行 /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:* 指令。

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

打开自定义

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

打开连接器

点击 Connectors（标记为 2）。

添加自定义连接器

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

输入服务器详情

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

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

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

Cursor 通过 HTTP 连接到远程 MCP 服务器。Cursor 目前不支持 MCP OAuth。在 MCP 配置中使用 Comfy Cloud API 密钥添加 Comfy Cloud。

打开 Cursor 设置

点击右上角的设置齿轮（标记为 1）。

打开 Tools & MCP

在侧边栏中，点击 Tools & MCPs（标记为 2）。
点击 + New MCP Server（标记为 3）→ Add a Custom MCP Server。

添加你的 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 的文件中硬编码密钥。

开始生成

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

Codex 通过 Streamable HTTP 连接到 Comfy Cloud。在设置中添加服务器，然后使用 OAuth 登录。

打开设置面板

在 Logged in with API key 下点击 Settings（标记为 1）。
点击 Settings（标记为 2）打开完整设置面板。

打开 MCP 服务器设置

在设置列表中点击 MCP servers（标记为 3）。
点击 + Add server（标记为 4）添加新的 MCP 服务器。

连接到 Comfy Cloud

选择 Streamable HTTP 作为连接类型。
在 Name 字段中输入一个名称，例如 Comfy Cloud MCP（标记为 5）。
在 URL 字段中输入 URL https://cloud.comfy.org/mcp（标记为 6）。
点击 Save（标记为 7）。

认证

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

用自然语言提问（“生成一张猫宇航员的图像”、“找一个 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。不要将密钥提交到版本控制。

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

添加服务器 URL

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

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

Windsurf 使用 serverUrl 代替 url。Amp 在 Settings → MCP Servers 或 ~/.config/amp/settings.json 中使用相同的 mcpServers 结构。

认证

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

重新启动并验证

重新启动你的客户端。你应该会看到 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 的配置文件中硬编码密钥。

您的代理能做什么

您无需自行调用 MCP 工具。您的代理会根据您的请求自动选择合适的工具。斜杠命令和提示（如下所示）是引导代理完成常见使用例的快捷键，但自然语言也同样有效（例如“生成一张猫宇航员的图像”、“放大这张照片”、“找一份 Wan 2.2 视频模板”）。典型流程：

发现可用资源（使用 search_templates、search_models、search_nodes，或对画面风格的问题使用 cql）。
运行生成任务：如果找到匹配的预构建模板则使用 run_template，自定义工作流则使用 submit_workflow（需要输入图像时配合 upload_file），或使用 partner_generate 调用 Flux、Grok、Gemini、OpenAI、Ideogram、Seedance 等合作伙伴模型。
等待并获取输出（wait_for_job，然后 get_output 返回一条下载指令，由您的代理在 shell 中运行）。

服务器倾向于优先匹配预构建模板，而不是从头构建工作流，这样往往能更快地获得更好的结果。

MCP 工具

这些是您的代理连接后可访问的工具。名称与 MCP 客户端日志和调试中显示的名称保持一致。

发现

工具	描述
`search_templates`	按文本、标签、媒体类型或模型从 comfy.org 搜索预构建的工作流模板
`get_template`	获取模板的完整工作流 JSON，用于检查或手动编辑
`get_template_schema`	查看模板的哪些参数可以在运行时覆盖
`search_models`	按文本、类型、基础模型或来源搜索模型目录
`search_nodes`	按文本、类别或输入/输出类型搜索可用节点。还能列出子图蓝图（预连线的节点组，如文本转图像或移除背景）
`get_node`	获取特定节点的完整输入说明，包括完整的选项列表
`cql`	运行 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 团队分享匿名化的会话摘要——仅在你明确同意的情况下；代理必须先征求你的同意，且摘要中不包含任何提示词、文件路径或个人信息

积分与消费

探索功能免费：search_templates、search_models 和 search_nodes 只需一个 Comfy 账户即可使用。运行生成会消耗 Comfy Cloud 积分，且需要订阅或积分余额。实际花费金钱的工具是消费门槛限定的。当生成使用付费合作伙伴模型（partner_generate）或包含付费 API 节点的工作流/模板（run_template、run_saved_workflow、submit_batch）时，服务器会阻止执行，直到你的智能体确认你同意花费积分——因此，在这些运行之前，智能体会先与你确认。免费的本地工作流永远不会提示。你可以随时向智能体询问你的余额（“我还有多少积分？”）——它会通过 get_billing_status 回答。

输出与下载

MCP 服务器在云端运行，绝不会将文件写入你的机器。当生成完成时，你的代理会调用 get_output，它会返回：

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

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

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

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

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

反馈

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

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

已知限制

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

编辑器格式到可执行格式的转换尚不完善。 已保存的工作流可以通过 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 流程。

常见问题

支持哪些客户端？

任何支持远程 HTTP 传输的 MCP 兼容客户端都可以连接到 https://cloud.comfy.org/mcp。我们为 Claude Code、Claude Desktop、Cursor 和 Codex 提供了最优先的配置说明。Windsurf、Amp、OpenClaw 和其他代理使用相同的 URL，通过 OAuth 或 API 密钥连接。参见安装 Comfy Cloud MCP。

是否需要 API 密钥？

对于支持 OAuth 的交互式客户端（Claude Code、Claude Desktop、Codex 等）不需要。Cursor 需要在你的 MCP 配置中提供 Comfy Cloud API 密钥。在没有浏览器的无头或 CI 环境中也需要 API 密钥。请参见安装 Comfy Cloud MCP 下的 Cursor 标签或 其他客户端 标签。

为什么我的代理在生成前会先询问我？

付费生成受消费确认保护：当一次运行会消耗 Comfy Cloud 积分时（使用合作伙伴模型，或包含付费 API 节点的工作流/模板），服务器会要求你明确同意后才执行。请参阅积分与消费。

在 Claude Desktop 中能否使用斜杠指令？

不能。斜杠指令是 Claude Code 插件的一部分。Claude Desktop 可以连接到同一个 MCP 服务器（如果你用自然语言提问或使用提示选择器，这些工具也能正常工作），但它不支持 Claude Code 插件或斜杠指令。

我输入了 /comfy 或 /cloud 但没有反应。

没有 /comfy 或 /cloud 指令。指令根据连接方式显示在以下两个前缀之一下：

插件（推荐）： /comfy-cloud:generate-image、/comfy-cloud:generate-video……输入 /comfy-cloud: 即可看到所有指令。
直接连接（无插件）： /mcp__comfy-cloud__generate-image……输入 /mcp__ 即可查看。

无论哪种方式，你也可以直接用自然语言提问（例如“生成一张……的图像”）。MCP 工具由模型调用，无需斜杠指令。

登录时没有打开浏览器。

在 Claude Code 中，运行 /mcp，选择 comfy-cloud，然后选择 Authenticate。在 Claude Desktop 中，重新打开“自定义 → 连接器”中的连接器，并触发登录。

如何在本地使用代理运行 Comfy？

Comfy Cloud MCP 是我们的托管服务，但自 ComfyUI 开源以来，本地代理工作流就已存在。请参阅 Agent Tools 概述中的关于本地 ComfyUI？部分，了解 Cloud 首先发布的原因、当前可用的社区 MCP 服务器，以及另一个选择——Comfy CLI。

​概述

​安装 Comfy Cloud MCP

​您的代理能做什么

​MCP 工具

​发现

​生成

​作业与批处理

​已保存的工作流

​共享工作流

​应用与链接

​账户与会话

​积分与消费

​输出与下载

​相关资源

​反馈

​已知限制

​常见问题

概述

安装 Comfy Cloud MCP

您的代理能做什么

MCP 工具

发现

生成

作业与批处理

已保存的工作流

共享工作流

应用与链接

账户与会话

积分与消费

输出与下载

相关资源

反馈

已知限制

常见问题