跳转到主要内容
这是 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。 目前支持范围限于 Claude Code 和 Claude Desktop，它们通过 OAuth 登录（一次性的浏览器登录）。更多客户端支持即将推出。

​
你的代理能做什么

你无需自己调用 MCP 工具。你的代理会根据你的请求自动选择合适的工具。斜杠命令和提示词（见下文）是将代理导向常用使用例的快捷键，但自然语言同样有效（例如“生成一张猫宇航员的图像”、“放大这张照片”、“找一个 Wan万相 2.2 视频模板”）。 典型流程：
  1. 探索可用内容（search_templates、search_models、search_nodes，或适用于图形类问题的 cql）。
  2. 运行生成或工作流（submit_workflow，需要输入图像时配合 upload_file）。
  3. 检索输出（get_output 会返回一条下载指令，你的代理会在你的 Shell 中执行）。
服务器会优先匹配预构建模板，然后才从头构建工作流，这样通常能更快得到更好的结果。

​
MCP 工具

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

​
发现

工具描述
search_templates按文本、标签、媒体类型或模型从 comfy.org 搜索预构建的工作流模板
search_models按文本、类型、基础模型或来源搜索模型目录
search_nodes按文本、类别或输入/输出类型搜索可用节点。还能列出子图蓝图（预连线的节点组，如文本转图像或移除背景）
cql运行 CQL 图查询以回答结构性问题（例如，哪些节点生成图像，或节点类型之间的路径）。当需要特定节点的完整输入说明时，请使用 search_nodes

​
执行

工具描述
submit_workflow提交 ComfyUI API 格式的工作流在 Comfy Cloud 上执行
upload_file上传输入图像或文件用于工作流中（例如，与 LoadImage 配合使用）
get_job_status轮询已提交工作流的执行状态
get_output从已完成的工作流中检索输出的图像、视频或音频
use_previous_output通过将一个运行的输出重用作另一个运行的输入来串联工作流
cancel_job取消待定或正在运行的作业
get_queue检查正在运行和待定的作业数量

​
已保存的工作流

工具描述
list_saved_workflows浏览您保存在 Comfy Cloud 中的工作流
get_saved_workflow检查已保存工作流的节点、输入和配置
save_workflow将工作流保存到您的 Comfy Cloud 账户
您可以浏览和检查已保存的工作流，但代理目前无法直接通过 ID 运行它们。已保存的工作流使用 ComfyUI 图格式，在执行前必须转换为 API 格式。请参阅已知限制。

​
共享工作流

工具描述
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 页面链接。

​
安装

选择你的客户端：

Claude Code

安装插件。连接和指令一步完成。

Claude Desktop

在应用中添加自定义连接器，然后登录。

​
Claude Code

安装 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 → 认证。浏览器将打开让你登录，令牌会自动刷新。
该插件添加以下斜杠指令：
指令功能
/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 → 认证。添加 -s user 使其在你所有项目中可用。此路径仍然暴露与 MCP 提示相同的工作流：/mcp__comfy-cloud__generate-image、/mcp__comfy-cloud__search-models 等（/mcp__<名称>__ 前缀使用你传递给 claude mcp add 的名称）。推荐使用上面的插件，因为它将这些包装为更友好的 /comfy-cloud:* 指令。

​
Claude Desktop

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

打开连接器

在 Claude Desktop 中，打开 自定义，然后选择 连接器。Claude Desktop 连接器
2

添加自定义连接器

点击 + 按钮，然后选择 添加自定义连接器。添加自定义连接器
3

输入服务器 URL

将其命名为任意名称（例如 Comfy Cloud），并将 远程 MCP 服务器 URL 设置为：
https://cloud.comfy.org/mcp
连接器详情
4

登录

点击 添加，然后按提示通过 Claude Desktop 登录。你即连接成功。通过 Claude Desktop 登录
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 工具的工作方式相同。

​
无头 / CI（API 密钥）

Claude Code 和 Claude Desktop 使用 OAuth，因此你不需要 API 密钥。对于无头或 CI 环境（无法使用浏览器）的情况，请改用 API 密钥进行身份验证：
1

创建密钥

前往 platform.comfy.org/profile/api-keys，点击 新建 API 密钥 并复制它（它以 comfyui- 开头）。
2

使用密钥标头添加服务器

claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp -H "X-API-Key: comfyui-…"

​
输出与下载

MCP 服务器在云端运行，绝不会将文件写入你的机器。当生成完成时，你的代理会调用 get_output，它会返回：
  1. 一个临时签名下载 URL（在短时间内有效）。
  2. 一条可直接运行的 shell 指令（macOS 和 Linux 上为 curl，Windows 上为 curl.exe）。
你的代理应在终端中运行该指令。指令中包含了目标路径和文件名。
请逐字运行返回的指令。请勿重新编码或编辑签名的 URL。签名位于查询字符串中，一旦修改 URL 就会失效。
如果你的 MCP 客户端无法运行 shell 指令（某些仅 GUI 的环境），请复制该指令并自行在终端中运行。

​
相关资源

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

​
反馈

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

​
已知限制

Comfy Cloud MCP 为早期版本。以下为已知的限制，团队正在努力解决： 工作流
  • 保存的工作流无法通过 ID 运行。 您的智能体可以列出和检查保存的工作流，但在执行之前必须重新构建或将其转换为 API 格式。
  • 生成的资源可能未嵌入工作流元数据。 通过 MCP 创建的图像在 ComfyUI 中打开时，可能无法恢复对应的工作流。
  • 工作流构建依赖于智能体的准确性。 复杂的多节点工作流可能需要重试或优化。
文件处理
  • 输出需要经过 Shell 下载步骤。 请参阅输出与下载。
  • 上传大小限制可能因 MCP 客户端而异。某些客户端对文件上传施加了自己的限制。
身份验证
  • OAuth 或 API 密钥。 Claude Code 和 Claude Desktop 使用一次性浏览器 OAuth 流程。无头客户端可以通过 X-API-Key 标头传递 Comfy Cloud API 密钥作为替代。计划为无法打开浏览器的客户端提供设备码 OAuth 流程。

​
常见问题

目前支持 Claude Code 和 Claude Desktop，两者均通过 OAuth 登录。未来将支持更多客户端。
Claude Code 和 Claude Desktop 不需要，它们使用 OAuth。仅在没有浏览器的无头或 CI 环境中才需要 API 密钥。
不能。斜杠指令是 Claude Code 插件的一部分。Claude Desktop 可以连接到同一个 MCP 服务器（如果你用自然语言提问或使用提示选择器，这些工具也能正常工作），但它不支持 Claude Code 插件或斜杠指令。
没有 /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 Cloud MCP 是我们的托管服务，但自 ComfyUI 开源以来，本地代理工作流就已存在。请参阅 Agent Tools 概述中的关于本地 ComfyUI？部分，了解 Cloud 首先发布的原因、当前可用的社区 MCP 服务器，以及另一个选择——Comfy CLI。