Comfy Cloud MCP

封闭测试版——仅限邀请。 Comfy Cloud MCP目前处于封闭测试阶段，按用户功能标志进行访问控制。功能、工具和行为可能会随着项目发展而变化。如果你还没有访问权限，请加入等待列表。

Comfy Cloud MCP通过模型上下文协议（MCP）将 AI 助手（包括 Claude Desktop、Claude Code、Cursor 和 Amp）连接到 Comfy Cloud。它使 AI 代理能够在云端 GPU 上生成图像、视频、音频和 3D 内容，搜索模型和节点，以及运行完整的 ComfyUI 工作流，无需本地 GPU。

快速开始

开始前请确认：

有效的 Comfy Cloud 订阅（提交工作流需要）
你的邮箱已加入 封闭测试 白名单（见上方说明）
一种登录方式：OAuth（在支持的客户端上推荐）或 Comfy API 密钥（以 comfyui- 开头）

OAuth 或 API 密钥登录

OAuth（无需粘贴 API 密钥） — 在 Claude Code 或 Claude Desktop 中添加远程服务器 https://cloud.comfy.org/mcp，使用客户端的 Authenticate 通过 Comfy 账号登录。连接成功后，合作节点生成与工作流工具用法相同。 API 密钥 — 仍完全支持。若客户端不支持 OAuth，或你更习惯使用密钥，请使用下方的一键安装或手动配置。

OAuth 逐步开放。 MCP 服务端已在生产环境支持 OAuth，但在下一次 Comfy Cloud 生产部署完成前（发现端点需同步更新），部分用户可能还无法完成端到端登录。若 OAuth 暂时不可用，请继续使用 API 密钥——现有 API 密钥配置不受影响。

若使用 API 密钥且尚未创建，请查看指引获取：

获取 API 密钥

了解如何创建和管理你的 Comfy Platform API 密钥，用于访问 Cloud API、合作伙伴节点等。

安装与连接（API 密钥）

一键安装脚本会自动检测你的 MCP 客户端（Claude Code、Cursor、Amp），询问 Comfy API 密钥并配置远程 MCP 服务器——无需 Node.js 或其他依赖。

macOS / Linux
Windows (PowerShell)

curl -fsSL https://raw.githubusercontent.com/Comfy-Org/comfy-cloud-mcp/main/install.sh | bash

irm https://raw.githubusercontent.com/Comfy-Org/comfy-cloud-mcp/main/install.ps1 | iex

使用 API 密钥手动配置

Comfy Cloud MCP 托管在 https://cloud.comfy.org/mcp。将 MCP 客户端指向该 URL 并提供 API 密钥：

Claude Code
Claude Desktop
Cursor

claude mcp add comfyui-cloud \
  --transport http \
  https://cloud.comfy.org/mcp \
  -H "X-API-Key: your-api-key-here"

将以下内容添加到你的 Claude Desktop 配置文件中：

操作系统	配置文件路径
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "comfyui-cloud": {
      "url": "https://cloud.comfy.org/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

将以下内容添加到你的 Cursor MCP 配置中（项目中的 .cursor/mcp.json 或全局配置）：

{
  "mcpServers": {
    "comfyui-cloud": {
      "url": "https://cloud.comfy.org/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

更多详情请参阅 Cursor 的 MCP 文档。

添加服务器后，请重启你的 MCP 客户端以加载新配置。

使用方法

直接提问即可。 智能代理会自动选择正确的工具 —— “生成一张太空中的猫宇航员图像”、“搜索 SDXL checkpoint”、“放大这张图片”。

生成路径如何路由

代理会在两条路径之间选择：

路径	工具	适用场景
合作 API	`partner_generate`	指定提供商（Flux、Grok、Nano Banana、Ideogram、GPT-image、Seedream 等）
自定义工作流	`submit_workflow`	开源模型、LoRA/ControlNet、多步流程，或 `partner_generate` 未覆盖的请求

对于合作提供商，partner_generate 会优先尝试真实的 Comfy Cloud 工作流运行。输出会保存到你的资源库，并嵌入工作流以便在编辑器中重新打开。工具返回 prompt_id —— 用 get_job_status 轮询，再用 get_output 下载（与其他工作流相同）。对于带图像输入的请求，或尚未纳入可持久化模型集的模型，服务器会自动回退到合作代理直连响应（即时下载 URL）。该回退是内部逻辑，无法手动开启或关闭。直连结果不会保存到资源库。

可用工具

工作流执行

工具	描述
`submit_workflow`	提交 ComfyUI API 格式的工作流以在 Comfy Cloud 上执行
`get_job_status`	轮询已提交工作流的执行状态
`get_output`	获取已完成工作流的输出图像、视频或音频
`cancel_job`	取消待处理或正在运行的任务
`get_queue`	检查正在运行和待处理的任务数量

合作 API 生成

工具	描述
`partner_generate`	使用合作 API 生成（Flux、Nano Banana、Grok、GPT-image、Ideogram、Seedream 等）。默认通过 Comfy Cloud 工作流运行；返回 `prompt_id` 并保存到资源库。与任意工作流一样，使用 `get_job_status` / `get_output` 轮询获取。不支持的情况会自动回退为即时代理 URL。

发现

工具	描述
`search_templates`	通过文本、标签、媒体类型或模型搜索 comfy.org 上的预构建工作流模板
`search_models`	通过文本、类型、基础模型或来源搜索模型目录
`search_nodes`	通过文本、类别或输入/输出类型搜索可用节点
`cql`	运行 Comfy 查询语言进行高级发现

输入与工作流链接

工具	描述
`upload_file`	上传用于工作流的输入图像或文件（例如 LoadImage）
`use_previous_output`	将一个工作流的输出作为另一个工作流的输入，实现工作流链接

已保存的工作流

工具	描述
`list_saved_workflows`	浏览你在 Comfy Cloud 上保存的工作流
`get_saved_workflow`	查看已保存工作流的节点、输入和配置
`save_workflow`	保存工作流到工作区（支持保存格式或 API 格式；API 格式会自动转换）
`run_saved_workflow`	获取已保存工作流、转换为 API 格式并提交执行

反馈（测试版）

工具	描述
`submit_feedback`	提交评分和评论反馈
`report_session_summary`	报告经过同意的会话摘要（不包含提示词、文件路径或个人信息）

服务器会在从头构建工作流之前先检查是否有匹配的预构建模板，从而获得更好的结果和更快的生成速度。

反馈

这是封闭测试版——请告诉我们哪些功能好用。

在代理中： 要求代理调用 submit_feedback（评分 + 评论）或 report_session_summary（经同意的会话摘要；不含提示词/文件路径/个人信息）。
问卷： links.comfy.org/cloudmcpbeta
问题反馈： 在本仓库提交 issue（页面底部有链接）

工具错误会包含一次性的反馈渠道提示，因此你无需额外记忆。

工作原理

┌──────────────┐    HTTPS/MCP    ┌─────────────────────────────────────────────┐
│  AI 代理     │◄───────────────►│            Comfy Cloud                      │
│  (Claude,    │  API 密钥或     │  cloud.comfy.org/mcp → 在云端 GPU 上       │
│   Cursor,    │  OAuth Bearer   │                        执行工作流           │
│   Amp)       │                 │                                             │
└──────────────┘                 └─────────────────────────────────────────────┘

你的 AI 代理直接连接到托管在 cloud.comfy.org/mcp 的 MCP 服务器。服务器将 MCP 工具调用转换为 Comfy Cloud GPU 上的工作流执行 —— 无需本地服务器或 GPU。对于合作模型，代理通常会先调用 partner_generate（工作流 + 资源库保存）。其他情况则使用发现工具（search_templates、search_nodes、cql），构建 ComfyUI API 格式的工作流 JSON，并通过 submit_workflow 提交 —— 只需用自然语言描述你想要的内容。

示例提示

安装完成后，在你的 AI 助手中尝试以下提示：

生成一张太空中漂浮的猫宇航员图像，卡通风格

帮我找一些文本转视频的工作流模板

搜索 SDXL checkpoint 模型，告诉我有哪些可用的

生成一幅奇幻风景画，有山脉和日落时分发光的河流

有哪些可用的图像放大节点？

代理会搜索匹配的模板，构建 ComfyUI 工作流，将其提交到 Comfy Cloud，并在对话中直接返回生成的图像。

输出处理

图像会在对话中内联显示（Claude Code）或在工件侧面板中显示（Claude Desktop）
视频和音频输出会以可下载链接的形式返回
动态图像（GIF、WebP）会被保存但不会内联预览，以保留动画效果
内联图像预览会调整为 1024px 以实现高效显示；全分辨率输出始终可通过 get_output 工具获取

已知限制

这是一个早期版本。以下是已知的限制，正在积极改进中。

工作流

run_saved_workflow 覆盖范围。 该工具会获取已保存工作流、将保存格式转换为 API 格式并提交。复杂的输入覆盖或不支持的节点可能仍需要手动修复或通过 submit_workflow 重建。
工作流元数据因路径而异。 partner_generate（工作流路径）的输出会保存到资源库，并嵌入可在编辑器中重新打开的图。submit_workflow 或 partner_generate 直连回退的输出可能在资源库中不包含完整工作流元数据。
工作流准确性取决于 AI。 代理从自然语言构建 ComfyUI 工作流。复杂的多节点工作流或不常见的节点配置可能需要多次迭代。
partner_generate 范围。 可持久化模型集上的文生图会作为已保存工作流运行。带图像输入的生成、未映射模型和非图像模态会使用直连代理回退（即时 URL，不写入资源库），直到工作流持久化支持扩展。

文件处理

上传大小限制可能因你的 MCP 客户端而异。
图像预览会被调整大小。 内联预览限制为 1024px（JPEG）。全分辨率文件会保存到磁盘。

认证

API 密钥或 OAuth。 手动配置使用 X-API-Key 头部的 Comfy Cloud API 密钥。通过 Comfy OAuth 登录的 MCP 客户端会发送 Authorization: Bearer 令牌；托管服务器均支持。

客户端特定

Claude Desktop —— 生成的图像通过 HTML 显示在工件侧面板中，而非原生图像工件。

故障排除

MCP 服务器未显示

重启你的 MCP 客户端（关闭并重新打开 Claude Code、Claude Desktop、Cursor 或 Amp）。MCP 服务器在启动时加载。请仔细检查配置中的服务器 URL 是否正确为 https://cloud.comfy.org/mcp。

API 密钥错误

在 platform.comfy.org/profile/api-keys 验证你的 API 密钥是否有效。手动配置时，通过 X-API-Key 头部传递密钥 —— 不要将 comfyui- 密钥作为 Bearer 令牌发送。OAuth 连接的客户端应使用 Comfy 登录流程获得的 Authorization: Bearer 令牌，而非 X-API-Key。如需要，生成新 API 密钥并更新客户端配置。

连接错误

如果 MCP 客户端无法访问服务器，请检查：

你是否有活跃的互联网连接
你的防火墙或代理是否阻止了 cloud.comfy.org
你是否有活跃的 Comfy Cloud 订阅

Documentation Index

​快速开始

​OAuth 或 API 密钥登录

获取 API 密钥

​安装与连接（API 密钥）

​使用 API 密钥手动配置

​使用方法

​生成路径如何路由

​可用工具

​工作流执行

​合作 API 生成

​发现

​输入与工作流链接

​已保存的工作流

​反馈（测试版）

​反馈

​工作原理

​示例提示

​输出处理

​已知限制

​故障排除

​MCP 服务器未显示

​API 密钥错误

​连接错误

快速开始

OAuth 或 API 密钥登录

安装与连接（API 密钥）

使用 API 密钥手动配置

使用方法

生成路径如何路由

可用工具

工作流执行

合作 API 生成

发现

输入与工作流链接

已保存的工作流

反馈（测试版）

反馈

工作原理

示例提示

输出处理

已知限制

故障排除

MCP 服务器未显示

API 密钥错误

连接错误