Comfy MCP：将 AI 智能体连接到 ComfyUI

通过模型上下文协议（MCP）将 AI 智能体连接到 ComfyUI。可生成图像、视频、音频和 3D，并在 Comfy Cloud 或本机运行真实工作流。

概览

Comfy MCP 通过模型上下文协议将 AI 智能体连接到 ComfyUI。连接后，您可以生成图像、视频、音频和 3D，搜索模型、节点和模板，并与智能体聊天运行真实的 ComfyUI 工作流。

它提供两种连接：Comfy Cloud 连接和本地 ComfyUI 连接，其中本地连接完全开源。

[!TIP] 对以下任何内容感到困惑？最佳方式是将此页面交给您的智能体并寻求帮助。

我该选哪种连接？

对于新用户，我们建议从云端连接开始。 这是最简单的设置。如果您使用 claude.ai、ChatGPT 或 Claude Desktop 聊天应用，云端连接也是更兼容的选择。

如果您已在本地或自己部署的环境中运行 ComfyUI，或者您主要在编码智能体中工作，比如 Claude Code、Cursor 或 Codex，请从本地连接开始。

[!NOTE] 对于 Mac 用户，如果您计划运行开源模型，我们推荐云端连接。 当前的开放权重模型（如 MiniMax H3、LTX-2.3 等的本地版本）都很大，在 Apple GPU 上无法以可行的速度运行。

同时运行两者是正常的，大多数客户端都可以愉快地托管两个 MCP 服务器。它们登录到同一个 Comfy 账户，但分开进行：一次登录并不涵盖另一个。

Comfy Cloud MCP 连接

托管连接，将你的智能体关联到你的 Comfy Cloud 账户。无需安装，工作流在 Comfy Cloud GPU 上运行。要了解更多关于 Comfy Cloud 的信息，请参阅 Comfy Cloud。

设置云端连接

[!NOTE] 连接之前，你需要一个 Comfy Cloud 账户。如果你还没有账户，请注册；新用户可获得 5 次免费运行，试试看。设置期间的 OAuth 登录会使用你的 Comfy 账户。

Comfy Cloud MCP 运行地址：

https://cloud.comfy.org/mcp

选择你的客户端：

[tab] Claude Desktop Claude Desktop 通过其界面将 Comfy Cloud 添加为 custom connector，然后运行 OAuth 登录。 <video controls src="https://mintcdn.com/dripart/UM6LYOmx4pqCW3H7/images/agent_tools/Claude_desktop.mp4?fit=max&auto=format&n=UM6LYOmx4pqCW3H7&q=85&s=6bb8cfd8fcf2c004809bf23f7a42ee41" /> 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 以授权连接器。您已连接。

[tab] Claude Code 安装 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](https://comfy.org) 上查找预置的工作流模板 | | /comfy-cloud:search-models | 搜索可用模型 | | /comfy-cloud:search-nodes | 搜索节点并获取连线建议 | | /comfy-cloud:help | 查看你可以用 ComfyUI Cloud 做什么 | > [accordion] 只需要连接，不想安装插件？ > > 直接添加服务器： > > `bash theme={null} > 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:*` 命令。

[tab] Cursor 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- 开头）： ``json theme={null} { "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 工具。

[tab] Codex Codex 通过 Streamable HTTP 连接到 Comfy Cloud。在 Settings 中添加服务器，然后使用 OAuth 登录。 <video controls src="https://mintcdn.com/dripart/oeEoB3PP1mIk3aIP/images/agent_tools/CodeX_Oauth_mcp.mp4?fit=max&auto=format&n=oeEoB3PP1mIk3aIP&q=85&s=c09f1520aadfb3f325d7a166a56ba5a7" /> 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 工具。 > [accordion] 更倾向于使用 CLI？ > > 从终端注册并登录： > > ``bash theme={null} > codex mcp add comfy-cloud --url https://cloud.comfy.org/mcp > codex mcp login comfy-cloud > ` > > 这会将一个条目写入 ~/.codex/config.toml（或在受信任项目中写入 .codex/config.toml）。 > [accordion] 使用 API 密钥代替 OAuth（无头或 CI） > > 当没有可用的浏览器时，通过从环境变量中提取的请求头添加服务器。在 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) 上创建密钥（以 comfyui- 开头），然后添加到 ~/.codex/config.toml： > > `toml theme={null} > [mcp_servers.comfy-cloud] > url = "https://cloud.comfy.org/mcp" > env_http_headers = { "X-API-Key" = "COMFY_API_KEY" } > ` > > 在 shell 或系统环境中设置 COMFY_API_KEY。不要将密钥提交到版本控制。 > [accordion] Codex 反复要求重新登录（invalid\_grant 或刷新令牌重用） > > **症状：** Codex 反复将你从 Comfy Cloud 登出并要求重新认证，有时每隔几分钟就会发生一次。Codex 的警告或日志中可能出现 invalid_grant、刷新令牌已被使用或已被吊销，或 OAuth 令牌刷新失败等信息。 > > **原因：** 这是 Codex 存储和刷新 MCP OAuth 凭据的方式导致的，而不是 Comfy Cloud 的问题。当多个 Codex 进程（TUI 会话、应用服务器、codex mcp 命令）共用同一个 OAuth 服务器时，某个进程可能会使用已被另一个进程轮换掉的令牌进行刷新。授权服务器会将其视为令牌重用并结束会话。其他 OAuth MCP 服务器的用户也报告了相同的现象。以下问题在 Codex 仓库中仍处于开启状态，你可以自行查看其最新进展： > > * [openai/codex#46028](https://github.com/openai/codex/issues/46028)：长时间运行的客户端重用已轮换的刷新令牌 > * [openai/codex#48507](https://github.com/openai/codex/issues/48507)：并发进程在刷新令牌轮换时发生竞争，下次启动时出现 invalid_grant > * [openai/codex#41133](https://github.com/openai/codex/issues/41133)：关闭时可能丢失已轮换的刷新令牌 > * [openai/codex#17265](https://github.com/openai/codex/issues/17265)：Codex 不会刷新已存储的 MCP OAuth 令牌 > > **变通方法 1：开启 Codex 的刷新协调标志。** Codex 提供一个功能标志 mcp_oauth_refresh_coordination，用于在多个 Codex 进程之间协调 OAuth 令牌刷新。这是 Codex 的设置，而不是 Comfy 的设置。Codex 将其标记为开发中且默认关闭，Codex 和 Comfy 都不将其作为官方支持的修复方案。在 openai/codex#46028 中，开启该标志后，报告者的测试中不再出现过期令牌重用。如果你的 Codex 版本仍默认关闭该标志，请将其添加到 ~/.codex/config.toml： > > `toml theme={null} > [features] > mcp_oauth_refresh_coordination = true > ` > > 关闭并重新启动所有正在运行的 Codex 会话，使它们都加载该标志。如果 Codex 已显示 **comfy-cloud** 处于登出状态，请再登录一次（运行 codex mcp login comfy-cloud，或在设置中点击 **Authenticate**）。如果后续的 Codex 版本默认开启了该功能或移除了该标志，可以跳过此步骤。 > > **变通方法 2：让每个服务器只由一个 Codex 进程负责刷新。** 如果该标志不可用或没有效果，请将 [mcp_servers.comfy-cloud] 条目从全局 ~/.codex/config.toml 移到受信任项目中的 .codex/config.toml`，这样只有该项目中的会话会加载并刷新它。避免同时运行多个连接 Comfy Cloud 的 Codex 会话，并在重启电脑前关闭 Codex 会话。这是 openai/codex#48507 中报告的变通方法。 > > 移动条目并不会停止已经加载全局配置的 Codex 进程，这些进程会继续刷新旧的服务器定义。移动后，请关闭所有正在运行的 Codex 会话并停止 Codex 应用服务器，然后只在包含该条目的项目中启动 Codex。 > > 如果你不需要 OAuth，上面的 API 密钥设置不会使用刷新令牌。 > > 这些步骤可以减少被登出的次数，但不一定能完全避免。我们也在 Comfy Cloud 端进行改进，以减少此类情况的发生。

[tab] OpenClaw 从 ClawHub 安装 Comfy Cloud 技能。它将 OpenClaw 连接到托管的 MCP 服务器（cloud.comfy.org/mcp）。仅适用于云端：无法驱动本地 ComfyUI 安装。 1. 安装技能 ``bash theme={null} openclaw skills install @comfy-org/comfy ` 技能页面：[clawhub.ai/comfy-org/skills/comfy](https://clawhub.ai/comfy-org/skills/comfy)。 **2. 使用 OAuth 连接（推荐）** 注册 MCP 服务器并使用您的 Comfy 账户登录： `bash theme={null} 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 进行验证。 > [!NOTE] > > 当设置 auth: "oauth" 时，OpenClaw 会忽略该服务器条目中的静态 headers。切勿将 OAuth 与硬编码的 API 密钥头组合使用。 **3. 开始生成** 用自然语言提问（例如「生成一张猫宇航员的图像」、「找一个 Wan 2.2 视频模板」）。OpenClaw 会代您调用 MCP 工具。 > [accordion] 使用 API 密钥代替 OAuth（无头或 CI） > > 在 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) 创建一个密钥（以 comfyui- 开头），然后将其导出，并注册服务器： > > `bash theme={null} > 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 环境变量中。不要提交该密钥。

[tab] Other clients 任何支持远程 HTTP传输的 MCP 客户端都可以连接到 Comfy Cloud。服务器 URL 始终为 https://cloud.comfy.org/mcp。 1. 添加服务器 URL 添加指向 https://cloud.comfy.org/mcp 的远程 MCP 条目。大多数客户端使用带有 url 字段的 JSON 配置： ``json theme={null} { "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](https://platform.comfy.org/profile/api-keys) 创建密钥，并将其作为 X-API-Key 请求头传递： `json theme={null} { "mcpServers": { "comfy-cloud": { "url": "https://cloud.comfy.org/mcp", "headers": { "X-API-Key": "comfyui-…" } } } } ` 从终端使用 Claude Code： `bash theme={null} 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 视频模板」）。

典型流程：

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 工具

连接后，您的智能体可以访问这些工具。工具名称与 MCP 客户端日志和调试输出中显示的名称一致。

发现

生成

作业与批处理

已保存的工作流

分享工作流

Hub URL 分享 ID： comfy.org/workflows/<slug>-<hex> hub URL 中末尾连字符分隔的十六进制令牌便是分享 ID。例如，comfy.org/workflows/topaz-starlight-upscale-1c77e82713b7 的分享 ID 为 1c77e82713b7。请将该令牌作为 share_id 传递给 import_shared_workflow。share_url 参数只接受像 https://cloud.comfy.org/?share=... 这样的 ?share=<id> 查询 URL，不接受 hub 页面 URL。

应用和链接

账户和会话

提示（Claude Desktop）

Claude Desktop 不支持 Claude Code 的斜杠命令。相反，打开 prompt picker 以使用相同的工作流：

您也可以跳过提示，用自然语言提问。MCP 工具的工作方式相同。

积分与消费

发现功能免费：search_templates、search_models 和 search_nodes 仅需一个 Comfy 账户。运行生成任务需要有效的 Comfy Cloud 订阅。仅有积分或充值余额并不能授予访问权限：您需要有效的订阅才能运行生成，即使您还有未使用的积分。

上传与下载

MCP 服务器在云端运行，MCP 本身不会将文件写入您的机器。当生成完成时，您的智能体调用 get_output，返回：

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

您的智能体应在您的 shell 中运行该命令。该命令包含目标路径和文件名。

[!WARNING] 原样运行返回的命令。不要对签名 URL 进行重新编码或编辑。签名存在于查询字符串中，如果修改 URL 则会失效。

如果您的 MCP 客户端无法运行 shell 命令（某些纯 GUI 的设置），请复制该命令并在终端中自行运行。

资源的上传和下载取决于客户端的文件访问权限。如果 Claude Desktop 或其他智能体客户端在处理资源上传或下载时遇到问题，这可能与智能体访问本地文件目录的权限有关。对于 Claude 用户，我们推荐 Claude Code（桌面应用或终端），它具有更多功能。类似地，对于其他智能体系列，编码智能体通常比网页聊天版本更好。

已知限制

Comfy Cloud MCP 是早期版本。以下是已知限制，正在改进中：

工作流

• 通过 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 连接

开源连接：客户端在您的机器上启动服务器，并驱动该处安装的 ComfyUI。

comfy-mcp 是 Comfy 的第一方本地 MCP 服务器：即从 AI 智能体（Claude Code、Claude Desktop、Cursor 和其他 MCP 客户端）驱动本地 ComfyUI 安装的官方方式。

与云端和合作伙伴服务器不同，它直接与您自己机器上运行的 ComfyUI 通信，因此可以运行您的工作流，并检查您实际安装中拥有的节点、自定义节点和模型。

[!TIP] 最快设置方式：交给您的智能体。 将 https://docs.comfy.org/agent-tools/mcp#installation 粘贴到您的 AI 客户端中，并让它为您设置本地连接。

要求

• 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

这将 comfy-mcp 控制台脚本添加到您的 PATH 中。该命令就是 MCP 服务器（它通过 stdio 使用 MCP 协议）。接下来将您的 AI 客户端指向它。

[!NOTE] COMFY_BIN（可选）。 MCP 客户端会以其自身环境启动服务器，这通常不包含您 shell 的 PATH。如果 comfy 位于虚拟环境或非标准位置，请将 COMFY_BIN 设置为其绝对路径（例如 /path/to/venv/bin/comfy）。以下每个客户端示例都展示了它应放在哪里；如果 comfy 已经在客户端启动服务器时所在的环境中，则可以省略。

---

手动配置

所有客户端遵循相同的 MCP stdio 协议：将 comfy-mcp 命令作为服务器运行。选择你的客户端：

[tab] Claude Desktop 编辑 claude_desktop_config.json（Settings → Developer → Edit Config；在 macOS 上位于 ~/Library/Application Support/Claude/claude_desktop_config.json），添加该服务器，然后重新启动 Claude Desktop： ``json theme={null} { "mcpServers": { "comfy-mcp": { "command": "comfy-mcp", "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } } } } ``

[tab] Claude Code 一条命令即可注册服务器： ``bash theme={null} claude mcp add comfy-mcp -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-mcp ` 或者将其登记到项目中，在仓库根目录创建 .mcp.json 文件： `json theme={null} { "mcpServers": { "comfy-mcp": { "command": "comfy-mcp", "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } } } } ``

[tab] Cursor 将服务器添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（按项目）： ``json theme={null} { "mcpServers": { "comfy-mcp": { "command": "comfy-mcp", "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } } } } ``

---

快速开始

从零到生成图像：

1. 安装组件

git clone https://github.com/Comfy-Org/comfy-mcp
cd comfy-mcp
pip install "comfy-cli>=1.14.0"  # 引擎
comfy install             # 创建 ComfyUI 工作区（已有可跳过）
pip install comfy-mcp            # 本 MCP 服务器 → `comfy-mcp` 命令

2. 启动 ComfyUI 并保持运行

comfy launch

3. 将服务器添加到您的客户端

使用上面对应您客户端的代码片段，然后重新启动 / 重新加载客户端，以便工具显示。

4. 让智能体运行工作流

例如：

「确认我的本地 ComfyUI 正在运行，然后运行位于 ~/workflows/txt2img.json 的工作流，并向我显示图像。」

在底层，智能体会调用 server_info 来确认 ComfyUI 已启动，调用 run_workflow 来执行工作流 JSON，并调用 fetch_outputs 来收集结果。

---

工具

每个工具都映射到一个 comfy-cli 命令，并以 --where local 运行。亮点如下：

节点自省和模型搜索会读取你的实时安装（包含自定义节点），这是与云端连接相比的本地差异化特点。查看仓库以获取完整工具列表和参考。

---

相关资源

相关：Comfy Agent

想要在 ComfyUI 内部获得智能体体验，而不是使用外部 MCP 客户端吗？

[card] Comfy Agent 内置的 ComfyUI 助手，用于构建、编辑和运行工作流。云端已正式发布。 本地版（Comfy Desktop）即将推出。

反馈

欢迎试用 Comfy MCP，并告诉我们哪些地方好用，哪些地方需要改进：

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

常见问题

入门

[accordion] 支持哪些客户端？ 任何兼容 MCP 的客户端。 云端连接需要远程 HTTP 支持。Claude Code、Claude Desktop、Cursor、Codex 和 OpenClaw 在上文有一流的配置说明；Windsurf、Amp 及其他客户端则使用相同的 URL，配合 OAuth 或 API 密钥。 本地连接需要一个能够将本地 stdio 服务器作为子进程启动的客户端。这排除了基于浏览器的客户端。claude.ai 和 ChatGPT 仅接受远程连接器。

[accordion] 服务器 URL 是什么？ 云端连接运行于 https://cloud.comfy.org/mcp。 本地连接没有 URL。你的客户端会直接启动 comfy-mcp 指令，并通过 stdio 与其通信。

[accordion] 可以将它与本地 ComfyUI 一起使用吗？ 可以。这就是本地 Comfy MCP 连接。它会驱动你自己机器上安装的 ComfyUI，因此你的智能体可以看到你实际拥有的模型、LoRA 和自定义节点，并在你的 GPU 上运行。

[accordion] 可以同时连接云端和本地连接吗？ 可以，如果你在本地运行 ComfyUI，我们也推荐这样做。大多数客户端都能轻松托管两个 MCP 服务器，你的智能体也能将它们区分清楚。每个连接都会运行自己的工作流，并返回自己的结果。 不过，这两个登录是相互独立的。在其中一个登录并不会让你自动登录另一个，即使使用的是同一个 Comfy 账户。

[accordion] 如何判断我的机器能否运行本地连接？ 问问你的智能体。它会在开始任何繁重任务之前读取你的硬件信息。 在 Mac 上，请使用云端连接进行生成：如今的开放权重模型体积过大，无法在 Apple GPU 上以可用速度运行。在配备独立显卡的 PC 上，24 GB 或以上的 VRAM 可以处理大多数任务，包括视频；8–24 GB 适合图像生成，但视频生成会较慢，或无法装入显存；低于 8 GB 时，请使用云端。

[accordion] 它是否已正式发布？ 是的。云端连接已正式发布，本地连接适用于本地 ComfyUI 安装。如需反馈问题或分享建议，请参阅反馈。

费用与访问

[accordion] 需要付费吗？ 在两种连接方式下，发现功能均免费：搜索模板、模型和节点只需一个 Comfy 账户。 在云端连接上，运行生成任务需要有效的 Comfy Cloud 订阅；新用户可获得 5 次免费运行。在本地连接上，运行完全免费，因为生成在您自己的硬件上执行，但有一个例外：合作伙伴模型会在合作伙伴的基础设施上执行并消耗积分。

[accordion] 我需要 API 密钥吗？ 对于支持 OAuth 的交互式客户端则不需要，包括 Claude Code、Claude Desktop、Codex 和 OpenClaw。 Cursor 需要在您的 MCP 配置中提供 Comfy Cloud API 密钥；该客户端目前尚不支持 MCP OAuth。无浏览器的无头设置和 CI 设置也需要一个。请参阅 设置云端连接 下的 Cursor 和 其他客户端 选项卡。

使用

[accordion] 我的智能体连接后能做什么？ 你无需自己调用 MCP 工具：你的智能体会根据你的请求来选择它们。通常，它会发现可用的工具（search_templates、search_models、search_nodes），运行生成任务，然后等待并获取输出。参见你的智能体可以做什么。

[accordion] 我的输出会保存到哪里？ 在云端连接下，服务器绝不会在你的机器上写入任何内容：get_output 会返回一个临时签名 URL 和一条立即可运行的下载指令，供你的智能体在你的 shell 中执行。参见上传与下载。 在本地连接下，ComfyUI 会写入你工作区的 output/ 目录，fetch_outputs(prompt_id, out_dir) 会将已完成任务的文件复制到你指定的任何位置。

[accordion] 我从一种连接开始，现在需要另一种连接。我该怎么办？ 无需撤回任何操作：将第二种连接添加到第一种连接旁边即可。 从本地转向云端（你需要云端 GPU 或合作伙伴模型）：请你的智能体帮你登录，然后将 https://cloud.comfy.org/mcp 添加到你的客户端。 从云端转向本地（你想要自己的模型和自定义节点）：安装 ComfyUI 和本地服务器，然后将你的客户端指向它。你的智能体可以帮你完成其中大部分操作。

[accordion] 我如何在本地连接和云端连接之间切换？ 直接告诉你的智能体即可。两种连接都已添加后，说出你希望任务在哪里运行，例如"这个在 Comfy Cloud 上运行"或"这个在本地运行"，它就会使用正确的连接。没有需要切换的模式，两次运行之间也无需重新配置任何内容。 如果某个工作流对你的机器来说负担过重，你的智能体会告诉你，并建议改为在 Comfy Cloud 上运行。如果只设置了一种连接，请让它添加另一种连接：参见设置云端连接或本地 Comfy MCP 连接。

[accordion] 我如何更新 Comfy MCP？ 在云端连接下，无需进行任何操作：它是托管服务，因此你始终使用的是当前版本。 在本地连接下，请你的智能体来处理。之后，重新启动你的客户端或开启新会话：MCP 服务器在会话启动时加载，因此正在运行的服务器会继续提供旧版本，直到你重新启动（或开启新会话）为止。

故障排查

[accordion] 斜杠指令在 Claude Desktop 中可用吗？ 不。斜杠指令随 Claude Code 插件提供。Claude Desktop 连接到同一个 MCP 服务器：如果你用日常语言提问或使用提示选择器，这些工具可以正常工作，但它不支持 Claude Code 插件或斜杠指令。

[accordion] 我输入了 /comfy 或 /cloud，但什么都没出现。 没有 /comfy 或 /cloud 指令。根据你的连接方式，指令会出现在以下两个前缀之一： 插件（推荐）： /comfy-cloud:generate-image、/comfy-cloud:generate-video 等。输入 /comfy-cloud: 即可看到所有指令。 直接连接（无插件）： /mcp__comfy-cloud__generate-image 等。输入 /mcp__ 即可看到这些指令。 无论哪种方式，你都可以直接用日常语言提问（“生成一张……的图像”）。MCP 工具由模型调用，不需要斜杠指令。

[accordion] 登录时未打开浏览器。 在 Claude Code 中，运行 /mcp，选择 comfy-cloud，然后选择 认证。在 Claude Desktop 中，从 自定义 → 连接器 重新打开连接器并触发登录。