Agent tools & MCP (Comfy Cloud MCP)

Last updated: September 29, 2026

What Comfy MCP is, how to connect your AI assistant to Comfy Cloud or your own ComfyUI, what it costs, and how to fix common issues.

Q. What is Comfy MCP?

Comfy MCP connects your own AI assistant or coding agent to ComfyUI through the Model Context Protocol (MCP). Once connected, you can ask your agent in plain language to generate images, video, audio, and 3D, search models, nodes, and templates, and run real ComfyUI workflows.

It has two connections:

  • Comfy Cloud connection: hosted by us, with nothing to install. Workflows run on Comfy Cloud GPUs.

  • Local connection: open source. It runs on your machine and drives your own ComfyUI, with your models and custom nodes.

Both connections are generally available, and you can use both at once.

Q. Which connection should I use?

  • Comfy Cloud connection: best for new users, Mac users, and anyone using claude.ai, ChatGPT, or the Claude Desktop app.

  • Local connection: best if you already run ComfyUI on your machine, use private custom nodes, or work mostly in a coding agent like Claude Code, Cursor, or Codex.

💡 On a Mac, use the Comfy Cloud connection for generating. Today's open-weight models are too large to run at a workable speed on the Apple GPU.

💡 You can add both connections. They sign in separately, even though it's the same Comfy account.

Q. Which AI clients are supported?

Any MCP-compatible client.

  • Comfy Cloud connection: needs a client that supports remote MCP servers. The docs have step-by-step setup for Claude Code, Claude Desktop, Cursor, Codex, and OpenClaw. Windsurf, Amp, and others work with the same server URL.

  • Local connection: needs a client that can launch a local server. Browser-based apps like claude.ai and ChatGPT only work with the Comfy Cloud connection.

Q. How do I connect to Comfy Cloud?

  1. Make sure you have a Comfy Cloud account.

  2. Add this server URL to your AI client: https://cloud.comfy.org/mcp

  3. When your client opens the browser, sign in with your Comfy account.

  4. Restart your client. You should see the Comfy Cloud tools listed under comfy-cloud.

Cursor doesn't support sign-in yet, so add your Comfy API key instead. Headless and CI setups can also use an API key, passed in the X-API-Key header.

👉 See Comfy Docs – Comfy MCP setup for each client

👉 See How to generate a Comfy API key

Q. How do I connect my local ComfyUI?

You need Python 3.10 or newer, comfy-cli 1.14.0 or newer, and a ComfyUI install.

  1. Install the server: pip install comfy-mcp

  2. Start ComfyUI with comfy launch and leave it running.

  3. Add the comfy-mcp command to your AI client's MCP settings.

💡 The fastest way is to paste https://docs.comfy.org/agent-tools/mcp#installation into your AI client and ask it to set up the local connection for you.

👉 See Comfy Docs – Local Comfy MCP connection

Q. How much does it cost?

  • Searching templates, models, and nodes is free on both connections and only needs a Comfy account.

  • Comfy Cloud connection: running generations needs an active Comfy Cloud subscription. New users get 5 free runs to try it. Credits alone, without a subscription, don't unlock runs.

  • Local connection: runs are free because they happen on your own hardware. Partner models are the exception: they run on partner infrastructure and use credits.

Q. Do I need an API key?

Not for clients that let you sign in with your Comfy account, including Claude Code, Claude Desktop, Codex, and OpenClaw.

You need a Comfy API key for Cursor and for headless or CI setups without a browser.

Q. What can my agent do once it's connected?

Just ask in plain language, like "generate an image of a cat astronaut" or "find a Wan 2.2 video template." Your agent picks the right tools on its own: it finds templates, models, and nodes, runs the generation, and gets the output. It uses a matching pre-built template when there is one, which usually gives better results faster.

In Claude Code with the comfy-cloud plugin, you can also use shortcuts like /comfy-cloud:generate-image.

Q. Where do my outputs go?

  • Comfy Cloud connection: the server doesn't save files to your computer. Your agent gets a temporary download link and a ready-to-run download command for your terminal. If your client can't run commands, copy the command and run it yourself. Don't edit the link, or it will stop working.

  • Local connection: outputs are saved in your ComfyUI output/ folder.

Q. How is Comfy MCP different from Comfy Agent?

  • Comfy MCP connects your own AI assistant or coding agent to Comfy, on Comfy Cloud or your own machine.

  • Comfy Agent is built into ComfyUI. You chat with it next to your canvas, and it edits and runs your workflow while you watch.

👉 See Comfy Docs – Comfy Agent

Q. Something isn't working. What do I do?

  • The Comfy Cloud tools don't show up: check that the URL is exactly https://cloud.comfy.org/mcp, then restart your client. If you use an API key, check that it's in the X-API-Key header.

  • Sign-in didn't open a browser: in Claude Code, run /mcp, select comfy-cloud, and choose Authenticate. In Claude Desktop, reopen the connector from Customize → Connectors and sign in.

  • Slash commands don't work: Claude Desktop doesn't support them, and there's no /comfy or /cloud command. In Claude Code, type /comfy-cloud: (plugin) or /mcp__ (direct connection) to see them. You can always just ask in plain language.

  • Uploads or downloads fail: this usually comes from your client's access to your files. Coding agents like Claude Code handle files better than web chat apps.

  • Local runs don't start: make sure ComfyUI is running (comfy launch), since the server doesn't start it for you. If your client can't find comfy, set COMFY_BIN to its full path.

  • The local server seems out of date after an update: restart your client or start a new session.

  • A complex workflow didn't come out right: workflow building depends on your agent, so ask it to retry or refine the workflow.

Q. Where can I get help or give feedback?