1. 为什么我要把 ComfyUI 接到 Claude/Cursor 上ComfyUI 是目前最灵活的模块化 AI 图像生成引擎节点式可视化编程支持 SDXL、SD3.5、Flux 图像Wan2.2、HunyuanVideo 视频甚至 Hunyuan3D 和 Stable Audio 全模态生成。它的生产力毋庸置疑但用过的人都有一个共同感受节点系统是一把双刃剑。100 多个节点类型、几十条连线一个参数调错整条工作流就崩想复现别人的工作流先花半小时读懂他的节点图。手动拖拽节点的方式严重限制了 ComfyUI 的生产力释放。而 MCPModel Context Protocol协议的出现让 Claude、Cursor 这类 AI 智能体可以直接用自然语言操作 ComfyUI 工作流。你只需要说一句“生成一张赛博朋克城市夜景16:9”AI 自动完成从模型加载、提示词处理到图像输出的完整链路。这篇内容面向想在本地用自然语言驱动出图的开发者交付可复制的 MCP server 配置骨架、TaoToken 统一 Key 接入步骤以及 settings.json / config.toml 示例。目标是一次跑通“自然语言 → ComfyUI 出图”的链路不绕弯子。2. TaoToken 前置统一 Key 管理为什么必要在配置 MCP 之前有一个容易被忽略但很关键的问题Key 管理。当你同时用 Claude Desktop、Cursor、Continue 等多个客户端接入 MCP 时每个客户端都要配置模型 API Key。如果每个工具单独申请、单独配置Key 散落在五六个配置文件里轮换一次要改半天。TaoToken 在这里的角色是统一入口。它提供兼容主流协议的统一 API 地址你只需要在 TaoToken 控制台创建一个 Key然后把这个 Key 填到各个客户端的 MCP 配置里。模型对话、Coding Plan、API Keys 管理都在同一个控制台完成不用在多个平台之间来回切换。具体操作路径访问官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录进入控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 创建 API Key如果你主要做长期编码和 Agent 任务可以看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基础地址统一用 https://taotoken.net/api不加 UTM注意Key 只在创建时完整显示一次建议创建后立即复制到密码管理器。后续在 Claude Desktop、Cursor 的 MCP 配置里都会用到同一个 Key。3. 可复制配置ComfyUI MCP Server 骨架这一章是核心直接给可复制的配置。整体分三步装 ComfyUI MCP 扩展、配 MCP server、填 TaoToken Key。3.1 安装 ComfyUI MCP 扩展进入 ComfyUI 的 custom_nodes 目录克隆并安装cd ComfyUI/custom_nodes git clone https://github.com/comfy-org/comfy-mcp.git cd comfy-mcp pip install -e .安装完成后重启 ComfyUI确认扩展加载成功。你可以在 ComfyUI 启动日志里看到 comfy-mcp 相关的注册信息。3.2 MCP server 配置骨架MCP server 的配置本质是一个 JSON 或 TOML 文件告诉 Claude Desktop / Cursor 去哪里启动 MCP 进程、传什么环境变量。下面是一个通用骨架把TAOTOKEN_API_KEY换成你在控制台创建的 Key 即可。{ mcpServers: { comfy: { command: npx, args: [-y, comfy-org/comfy-mcp], env: { COMFYUI_HOST: http://127.0.0.1:8188, TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: sk-你的TaoTokenKey } } } }几个参数说明参数作用建议值COMFYUI_HOSTComfyUI 本地服务地址http://127.0.0.1:8188TAOTOKEN_BASE_URL统一 API 入口https://taotoken.net/apiTAOTOKEN_API_KEY统一鉴权 Key控制台创建3.3 Claude Desktop 配置位置macOS 路径~/Library/Application Support/Claude/claude_desktop_config.jsonWindows 路径%APPDATA%/Claude/claude_desktop_config.json把上面的 JSON 骨架粘贴进去保存后完全退出 Claude Desktop 再重启。重启后在开发者设置里能看到 Local MCP servers 列表comfy 应该处于 connected 状态。3.4 Cursor 配置config.toml 示例Cursor 的 MCP 配置在 Settings → MCP 里也支持直接编辑配置文件。如果你用 TOML 格式管理可以这样写[mcp_servers.comfy] command npx args [-y, comfy-org/comfy-mcp] [mcp_servers.comfy.env] COMFYUI_HOST http://127.0.0.1:8188 TAOTOKEN_BASE_URL https://taotoken.net/api TAOTOKEN_API_KEY sk-你的TaoTokenKey保存后 Cursor 会自动重连 MCP server。如果没生效在 MCP 面板手动点一下刷新。4. 验证请求确认链路真的通了配置写完不代表链路通了必须做连通性验证。我一般分两步先验证 MCP server 能启动再验证自然语言能驱动出图。4.1 验证 MCP server 启动在终端手动跑一次 MCP server看有没有报错COMFYUI_HOSThttp://127.0.0.1:8188 \ TAOTOKEN_BASE_URLhttps://taotoken.net/api \ TAOTOKEN_API_KEYsk-你的TaoTokenKey \ npx -y comfy-org/comfy-mcp如果输出里出现 MCP server 监听信息说明进程能正常启动。如果报ECONNREFUSED检查 ComfyUI 是否在 8188 端口运行。4.2 验证自然语言出图在 Claude Desktop 或 Cursor 的对话窗口里输入帮我生成一张赛博朋克风格的城市夜景16:9 比例霓虹灯反射在湿漉漉的街道上正常情况下AI 会调用 comfy MCP 工具自动搭建节点链路并触发出图。你可以在 ComfyUI 界面看到节点被自动创建和连线最终输出图像。4.3 验证实时反馈出图后继续对话这张图整体偏暗把亮度和对比度都调高一点再生成一版AI 会读取上一轮的生成结果修改对应节点参数并重新出图。这一步验证的是 MCP 的实时图像反馈能力也是自然语言驱动相比手动拖拽最大的优势。5. 本篇常见错排查配置过程中最容易踩的坑集中在这几个地方按出现频率排序。5.1 MCP server 显示 disconnected最常见原因是 Claude Desktop 没有完全退出。它不是关窗口就退出要在菜单栏彻底 Quit 再重启。另外检查 JSON 是否有尾逗号JSON 不允许尾逗号这是新手最容易犯的格式错误。5.2 npx 找不到包如果报404 Not Found或npm ERR先确认 Node.js 版本在 18 以上node -v npm -v版本过低会导致 npx 无法拉取最新的 MCP 包。升级 Node 后重试。5.3 ComfyUI 连接被拒报ECONNREFUSED 127.0.0.1:8188说明 MCP server 找不到 ComfyUI。确认 ComfyUI 已启动并且监听在 8188 端口。如果你改了 ComfyUI 端口同步修改COMFYUI_HOST。5.4 Key 鉴权失败报401 Unauthorized或invalid api key检查三件事Key 是否复制完整不要带空格、TAOTOKEN_BASE_URL是否写成https://taotoken.net/api、Key 是否在控制台被禁用。如果 Key 泄露过直接在控制台轮换一个新 Key 替换。5.5 出图卡住不返回MCP 调用出图是异步的如果模型较大比如 Flux首次加载需要时间。检查 ComfyUI 控制台是否有进度输出。如果长时间无响应可能是显存不足换小一点的模型或降低分辨率测试。6. 把 Key 和接入文档放在手边整条链路跑通后日常使用其实很简单Claude Desktop 或 Cursor 里说一句话ComfyUI 自动出图。真正需要维护的只有两样东西——TaoToken 的 Key 和 MCP 配置。Key 管理在控制台完成创建、轮换、禁用都在一个页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档里有各客户端的配置示例和参数说明遇到新客户端接入时直接对照https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你主要用 Claude 做模型对话验证可以直接在模型对话页测试 Key 是否可用https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content长期做编码和 Agent 任务的话Coding Plan 更适合额度和并发都按开发场景设计https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后分享一个实用技巧把 MCP 配置里的 Key 用环境变量引用而不是硬编码在 JSON 里。这样轮换 Key 时只需要改一处环境变量所有客户端自动生效。Claude Desktop 和 Cursor 都支持在 env 字段里读取系统环境变量具体写法参考接入文档里的环境变量章节。