WorkBuddy 接入 Comfy Cloud MCP 完整实录:从 DNS 污染到 31 个工具全部启用

📅 2026/7/2 4:07:19
WorkBuddy 接入 Comfy Cloud MCP 完整实录:从 DNS 污染到 31 个工具全部启用
WorkBuddy 接入 Comfy Cloud MCP 完整实录从 DNS 污染到 31 个工具全部启用记录一次在 Windows WorkBuddy 环境下配置 Comfy Cloud MCP 的真实过程包括 JSON 配置、API Key 认证、DNS 污染踩坑、hosts 绕过方案以及如何把 Claude Code 的comfy-skills插件迁移成 WorkBuddy 技能。Comfy MCP 公测把 Claude、Cursor、CodeX、Hermes 和 WorkBuddy 变成你的创意技术专家一、背景与目标1.1 为什么选 WorkBuddyWorkBuddy 是国内一款 AI 工作助手支持 MCPModel Context Protocol扩展。相比 Claude Code 的/plugin插件体系WorkBuddy 的 MCP 配置更贴近标准协议适合习惯中文界面的开发者需要同时接入多个 MCP Server代码、搜索、文档、绘图的团队不想手动配置 Claude Desktop 的 Windows 用户1.2 目标让 WorkBuddy 成功连接 Comfy Cloud MCP实现用自然语言生成图像、视频、音频、3D搜索模型、节点、工作流模板保存、分享、复现工作流二、准备工作2.1 注册 Comfy Cloud 并获取 API Key打开 cloud.comfy.org注册/登录 Comfy 账号。进入 platform.comfy.org/profile/api-keys。点击New API Key复制以comfyui-开头的密钥。示例comfyui-506c5547...注意Claude Code / Claude Desktop 走 OAuth 浏览器登录不需要 API Key但 WorkBuddy 等非 Claude 客户端建议用 API Key免去浏览器回调配置。三、配置 WorkBuddy 的 MCP Server3.1 找到 WorkBuddy 的 MCP 配置文件WorkBuddy 的 MCP 配置通常在C:\Users\你的用户名\.workbuddy\mcp.json初始内容可能是空的{ mcpServers: {} }3.2 添加 Comfy Cloud 服务器编辑mcp.json加入以下内容{ mcpServers: { comfy: { url: https://cloud.comfy.org/mcp, headers: { X-API-Key: comfyui-你的APIKey } } } }关键字段说明字段说明url必须填https://cloud.comfy.org/mcp不是mcp.comfy.orgX-API-Key从 Comfy 平台 API Keys 页面获取官方文档参考https://docs.comfy.org/agent-tools/cloud其实以上步骤都可以用 WorkBuddy Agent 代为完成只有少数步骤需要手动操作。3.3 在 WorkBuddy 中信任并启用保存mcp.json后打开 WorkBuddy 的MCP 服务管理页面找到comfy服务器点击「信任/启用」。四、踩坑DNS 污染导致连接失败4.1 报错信息启用后如果遇到类似错误streamableHttp connect failed: fetch failed sse connect failed: SSE error: TypeError: fetch failed: Client network socket disconnected before secure TLS connection was established这说明网络连接层面出了问题。4.2 诊断curl 测试在终端执行curl -sS -o /dev/null -w HTTP %{http_code} --max-time 15 https://cloud.comfy.org/mcp结果可能是正常情况返回HTTP 401未带 API Key认证失败但连接成功异常情況连接超时或 TLS 握手失败4.3 根因DNS 解析被污染在受影响的网络环境下cloud.comfy.org可能被解析到虚假地址198.18.0.92这是一个 RFC 3330 保留的测试网络地址并非真实服务器。DNS 污染导致 TLS 握手无法完成。你可以用 Google DoH 查询真实 IPcurl -sS https://dns.google/resolve?namecloud.comfy.orgtypeA返回{ Answer: [ {data: 104.20.32.113}, {data: 172.66.174.4} ] }真实服务器部署在 Cloudflare 上。五、解决方案hosts 文件绕过5.1 手动修改 hosts因为 Windows 的 hosts 文件受 UAC 保护需要以管理员身份修改按Win键搜索「记事本」右键选择「以管理员身份运行」。文件 → 打开 → 输入路径C:\Windows\System32\drivers\etc\hosts右下角文件类型选择「所有文件」。在文件末尾添加# Comfy Cloud MCP 104.20.32.113 cloud.comfy.org保存并关闭。注意不要把这行添加到 Tailscale 等自动管理区段内避免被覆盖。5.2 验证再次执行 curl 测试curl -sS -o /dev/null -w HTTP %{http_code} | time: %{time_total}s\n --max-time 10 https://cloud.comfy.org/mcp预期输出HTTP 401 | time: 0.53sHTTP 401 是正常结果curl 未带 API Key关键是连接耗时从 15 秒超时变成了 0.5 秒左右。六、成功启用31 个工具全部上线回到 WorkBuddy 的 MCP 服务管理页面点击comfy的「重新连接」或「信任」即可看到31/31 个工具已启用10 个 Prompt开关变绿截图如下可用的工具包括类别工具工作流执行comfy_submit_workflow、comfy_run_template、comfy_run_saved_workflow状态/队列comfy_get_job_status、comfy_wait_for_job、comfy_get_queue、comfy_cancel_job输出/文件comfy_get_output、comfy_upload_file、comfy_use_previous_output搜索comfy_search_templates、comfy_search_models、comfy_search_nodes生成generate-image、generate-video、generate-audio、generate-3d等七、把 Claude Code 的 comfy-skills 迁移到 WorkBuddy7.1 为什么需要迁移Comfy Org 官方维护了一个comfy-skills仓库本质上是Claude Code 插件提供/comfy-cloud:generate-image等 slash 命令。WorkBuddy 不支持 Claude Code 插件但可以把这些命令转换为 WorkBuddy 技能Skill。仓库地址https://github.com/Comfy-Org/comfy-skills/https://github.com/Comfy-Org/comfy-skills/7.2 创建 WorkBuddy 技能在 WorkBuddy 用户级技能目录创建C:\Users\你的用户名\.workbuddy\skills\comfy-cloud\SKILL.md内容包含生成图像/视频/音频/3D 的完整工作流去背、放大、搜索模型/节点/模板人物合影合成输出约定使用present_files展示图片保存其他文件到本地7.3 迁移后的使用方式不再需要 slash 命令直接说生成一张猫宇航员在太空的图或上传这张照片把背景去掉Agent 会根据技能描述自动调用对应工具。八、常见问题 FAQQ1为什么返回 HTTP 401401 表示认证失败但连接成功。通常是因为 curl 测试没有带X-API-KeyWorkBuddy 的 MCP 客户端会自动带无需担心。Q2API Key 会不会过期从 Comfy 平台创建时默认长期有效。如果泄露建议删除并重新创建。Q3hosts 里的 IP 变了怎么办如果cloud.comfy.org的真实 IP 变更可以再次用 Google DoH 查询并更新 hosts。或者改用 DoH 客户端自动解析。Q4WorkBuddy 为什么比 Claude Code 多这一步 DNS 绕过Claude Code 的桌面环境可能通过不同网络通道访问。WorkBuddy 的 MCP 连接受本机 DNS 影响在 DNS 被污染的环境下需要手动指定 IP。九、总结通过以下步骤我们完成了 WorkBuddy 对 Comfy Cloud MCP 的接入从 Comfy 平台获取comfyui-开头的 API Key。在~/.workbuddy/mcp.json中配置服务器URL 为https://cloud.comfy.org/mcp。在 WorkBuddy 中信任并启用comfy服务器。遇到 DNS 污染导致的 TLS 失败时通过 hosts 文件指定真实 IP104.20.32.113。将comfy-skills仓库转换为 WorkBuddy 技能覆盖所有核心生成任务。现在你可以直接对 WorkBuddy 说“生成一张赛博朋克风格的街景图”它会自动在云端跑 ComfyUI 工作流并把结果展示出来。参考链接Comfy Cloud MCP 官方文档https://docs.comfy.org/agent-tools/cloudComfy Skills 仓库https://github.com/Comfy-Org/comfy-skills/Comfy API Key 管理https://platform.comfy.org/profile/api-keysModel Context Protocol 介绍https://modelcontextprotocol.io