Comfy MCP

​

概览

​

我该选哪种连接？

​

Comfy Cloud MCP 连接

​

设置云端连接

https://cloud.comfy.org/mcp

• Claude Desktop
• Claude Code
• Cursor
• Codex
• OpenClaw
• Other clients

Claude Desktop 通过其界面将 Comfy Cloud 添加为 custom connector，然后运行 OAuth 登录。

1

打开 Customize

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

2

打开 Connectors

点击 Connectors（标记为 2）。

3

添加 custom connector

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

4

输入服务器详情

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

5

登录

1. 当浏览器打开时，选择您的工作区（例如 Personal Workspace）。
2. 点击 Continue 以授权连接器。您已连接。

安装 comfy-cloud 插件。它一步完成 MCP 连接和斜杠命令的添加。该插件通过 Comfy Skills 仓库发布，这里面托管了用于 Comfy 的 Claude Code 插件和社区智能体技能。

1

添加 marketplace

注册 Comfy Skills marketplace（仅需一次）：

/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 Settings

点击右上角的 Settings 齿轮（标注为 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。在 Settings 中添加服务器，然后使用 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 字段（标记 5）中输入名称，例如 Comfy Cloud MCP。
3. 在 URL 字段（标记 6）中输入 URL https://cloud.comfy.org/mcp。
4. 点击 Save（标记 7）。

4

Authenticate

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

用自然语言提问（例如「生成一张猫宇航员的图像」、「找一个 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 在 Settings → MCP Servers 或 ~/.config/amp/settings.json 中使用相同的 mcpServers 格式。

2

Authenticate

如果您的客户端支持 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）；对于 Flux、Grok、Gemini、OpenAI、Ideogram 和 Seedance 等合作伙伴模型，则使用 partner_generate。
3. 等待并获取输出：先执行 wait_for_job，再通过 get_output 获得一个下载命令，由您的智能体在终端中运行。

​

云端 MCP 工具

​

积分与消费

​

上传与下载

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

​

已知限制

• 通过 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 流程正在规划中。

​

本地 Comfy MCP 连接

​

要求

• Python 3.10+
• 位于您 PATH 中的 comfy-cli（pip install comfy-cli）：它是每个工具所包装的引擎
• 一个 ComfyUI 工作区：如果还没有，请使用 comfy install 创建一个（已有检出可通过 comfy set-default <path> 使用）
• 用于执行工具的正在运行的 ComfyUI。 使用 comfy launch 启动它，或调用 launch_comfyui。服务器不会隐式启动 ComfyUI。

​

安装

pip install comfy-mcp

​

手动配置

{
  "mcpServers": {
    "comfy-mcp": {
      "command": "comfy-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}

claude mcp add comfy-mcp -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-mcp

{
  "mcpServers": {
    "comfy-mcp": {
      "command": "comfy-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}

{
  "mcpServers": {
    "comfy-mcp": {
      "command": "comfy-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}

​

快速开始

git clone https://github.com/Comfy-Org/comfy-mcp
cd comfy-mcp
pip install "comfy-cli>=1.14.0"  # the engine
comfy install             # create a ComfyUI workspace (skip if you have one)
pip install comfy-mcp            # this MCP server → the `comfy-mcp` command

comfy launch

​

工具

​

相关资源

​

相关：Comfy 应用内智能体

​

反馈

• 反馈调查：反馈 bug、请求功能，或分享常规印象。
• Discord：#comfy-mcp-and-cli（位于 Comfy Discord 上），用于问题咨询和讨论。

​

常见问题

​

入门

​

费用与访问

​

使用

​

故障排查