> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy Cloud MCP

> Use Comfy Cloud from Claude Code and Claude Desktop through the Comfy Cloud MCP server — generate images, video, audio, and 3D, search models and nodes, and run workflows.

<Note>
  This is a **Comfy Cloud** feature and is only available in the cloud version. To learn more about Comfy Cloud, see [Comfy Cloud](/get_started/cloud).
</Note>

## Overview

The **Comfy Cloud MCP server** connects AI agents to [Comfy Cloud](https://cloud.comfy.org) over the [Model Context Protocol](https://modelcontextprotocol.io). Once connected, you can generate images, video, audio, and 3D, search models, nodes, and templates, and run ComfyUI workflows — all from a chat with your agent.

Support is currently scoped to **Claude Code** and **Claude Desktop**, which sign in with **OAuth** — a one-time browser sign-in. Support for more clients is coming.

## Install

Pick your client:

<CardGroup cols={2}>
  <Card title="Claude Code" icon="terminal" href="#claude-code">
    Install the plugin — connection and commands in one step.
  </Card>

  <Card title="Claude Desktop" icon="desktop" href="#claude-desktop">
    Add a custom connector in the app, then sign in.
  </Card>
</CardGroup>

### <span style={{ marginRight: "0.6rem" }}><Icon icon="terminal" size={22} /></span> Claude Code

Install the **comfy-cloud** plugin — it adds the MCP connection and the slash commands in one step.

<Steps>
  <Step title="Add the marketplace">
    ```
    /plugin marketplace add Comfy-Org/comfy-skills
    ```
  </Step>

  <Step title="Install the plugin">
    ```
    /plugin install comfy-cloud@comfy-skills
    ```
  </Step>

  <Step title="Sign in">
    Run `/mcp`, select **comfy-cloud** → **Authenticate**. Your browser opens to sign in, and tokens refresh automatically.
  </Step>
</Steps>

The plugin adds these slash commands:

| Command                          | What it does                        |
| -------------------------------- | ----------------------------------- |
| `/comfy-cloud:generate-image`    | Generate, edit, or modify an image  |
| `/comfy-cloud:generate-video`    | Generate, edit, or extend a video   |
| `/comfy-cloud:generate-audio`    | Generate audio                      |
| `/comfy-cloud:generate-3d`       | Generate a 3D model                 |
| `/comfy-cloud:remove-background` | Remove the background from an image |
| `/comfy-cloud:upscale-image`     | Upscale an image                    |
| `/comfy-cloud:search-models`     | Search available models             |
| `/comfy-cloud:search-nodes`      | Search for nodes                    |
| `/comfy-cloud:search-templates`  | Find pre-built workflows            |
| `/comfy-cloud:help`              | See what you can do                 |

<Accordion title="Prefer just the connection, without the plugin?">
  Add the server directly (no slash commands):

  ```bash theme={null}
  claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp
  ```

  Then run `/mcp`, select **comfy-cloud** → **Authenticate**. Add `-s user` to make it available in all your projects.
</Accordion>

### <span style={{ marginRight: "0.6rem" }}><Icon icon="desktop" size={22} /></span> Claude Desktop

Claude Desktop adds Comfy Cloud as a **custom connector** through its UI, then runs the OAuth sign-in.

<Steps>
  <Step title="Open Connectors">
    In Claude Desktop, open **Customize**, then choose **Connectors**.

    <img src="https://mintcdn.com/dripart/hggE7jk4IUe9Dgn5/images/cloud/mcp/desktop-connectors.png?fit=max&auto=format&n=hggE7jk4IUe9Dgn5&q=85&s=64d90eeac78724a81cee358e4a509a9b" alt="Claude Desktop Connectors" width="566" height="232" data-path="images/cloud/mcp/desktop-connectors.png" />
  </Step>

  <Step title="Add a custom connector">
    Click the **+** button, then choose **Add custom connector**.

    <img src="https://mintcdn.com/dripart/VcJUoOhemC23a4kR/images/cloud/mcp/desktop-add-custom-connector.png?fit=max&auto=format&n=VcJUoOhemC23a4kR&q=85&s=ace4d0901bcbfcccf6e688c9f88ac369" alt="Add custom connector" width="794" height="292" data-path="images/cloud/mcp/desktop-add-custom-connector.png" />
  </Step>

  <Step title="Enter the server URL">
    Name it anything (for example, *Comfy Cloud*) and set the **Remote MCP server URL** to:

    ```
    https://cloud.comfy.org/mcp
    ```

    <img src="https://mintcdn.com/dripart/hggE7jk4IUe9Dgn5/images/cloud/mcp/desktop-connector-url.png?fit=max&auto=format&n=hggE7jk4IUe9Dgn5&q=85&s=89ff669fd6d2ec94917a1ccfecdd2608" alt="Connector details" width="1138" height="898" data-path="images/cloud/mcp/desktop-connector-url.png" />
  </Step>

  <Step title="Sign in">
    Click **Add**, then sign in through Claude Desktop when prompted. You are connected.

    <img src="https://mintcdn.com/dripart/hggE7jk4IUe9Dgn5/images/cloud/mcp/desktop-signin.png?fit=max&auto=format&n=hggE7jk4IUe9Dgn5&q=85&s=2a9dbc39cdac3aa4626b3dc911e74568" alt="Sign in through Claude Desktop" width="430" height="561" data-path="images/cloud/mcp/desktop-signin.png" />
  </Step>
</Steps>

### Headless / CI (API key)

Claude Code and Claude Desktop use OAuth, so you do not need an API key. For **headless or CI** setups where no browser is available, authenticate with an API key instead:

<Steps>
  <Step title="Create a key">
    Go to [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys), click **New API Key**, and copy it (it starts with `comfyui-`).
  </Step>

  <Step title="Add the server with the key header">
    ```bash theme={null}
    claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp -H "X-API-Key: comfyui-…"
    ```
  </Step>
</Steps>

## FAQ

<AccordionGroup>
  <Accordion title="Which clients are supported?">
    Claude Code and Claude Desktop today, both signing in with OAuth. Support for more clients is coming.
  </Accordion>

  <Accordion title="Do I need an API key?">
    Not for Claude Code or Claude Desktop — they use OAuth. An API key is only needed for headless or CI setups with no browser.
  </Accordion>

  <Accordion title="Do the slash commands work in Claude Desktop?">
    No. The slash commands ship in the Claude Code plugin. Claude Desktop connects to the same MCP server (so the tools work — just ask in plain language), but it doesn't support Claude Code plugins or slash commands.
  </Accordion>

  <Accordion title="The sign-in did not open a browser.">
    In Claude Code, run `/mcp`, select **comfy-cloud**, and choose **Authenticate**. In Claude Desktop, reopen the connector from **Customize → Connectors** and trigger sign-in.
  </Accordion>
</AccordionGroup>