diff --git a/agent-tools/cli.mdx b/agent-tools/cli.mdx index c3251cc03..6359812b0 100644 --- a/agent-tools/cli.mdx +++ b/agent-tools/cli.mdx @@ -27,14 +27,14 @@ Use it for **terminal or script access**: batch jobs, CI pipelines, workflow aut ## How it fits with MCP -| | Comfy Cloud MCP | Comfy CLI | +| | Comfy MCP (cloud) | Comfy CLI | |---|---|---| | **Interface** | Chat with an MCP client (Claude Code, Claude Desktop, …) | Terminal commands and scripts | | **Best for** | Interactive agent workflows in chat | Automation, batch runs, CI, shell pipelines | | **Auth** | OAuth in MCP clients, or API key (headless) | `comfy cloud login` (OAuth) or API key (CI) | | **Output** | Returned in the chat session | Saved to disk (`--download`) or JSON (`--json`) | -For MCP setup, installation, tool lists, and auth methods, see [Comfy Cloud MCP](/agent-tools/mcp). +For MCP setup, installation, tool lists, and auth methods, see [Comfy MCP](/agent-tools/mcp). ## What the CLI does @@ -136,7 +136,7 @@ Everything above is the agent-focused summary. The full guide walks through each |---|---| | [Comfy CLI getting started](/comfy-cli/getting-started) | **Complete** install guide and command walkthrough | | [Comfy CLI reference](/comfy-cli/reference) | Commands, flags, and model aliases | -| [Comfy Cloud MCP](/agent-tools/mcp) | Connect agents via MCP for chat-driven generation | +| [Comfy MCP](/agent-tools/mcp) | Connect agents via MCP for chat-driven generation | | [comfy-cli on GitHub](https://github.com/Comfy-Org/comfy-cli) | Source repo, issues, and latest behavior | ## Feedback diff --git a/agent-tools/in-app-agent.mdx b/agent-tools/in-app-agent.mdx index e8500e91f..55eb65cfe 100644 --- a/agent-tools/in-app-agent.mdx +++ b/agent-tools/in-app-agent.mdx @@ -9,12 +9,12 @@ icon: "comments" **Private alpha.** Comfy In-App Agent is rolling out to a limited set of users. Public docs and website pages are not available yet. Join the waitlist to request access. -**Comfy In-App Agent** is the agent experience inside Comfy Cloud: prompt in chat, and the agent can build or edit workflows on your graph (with confirmation before generation). +**Comfy In-App Agent** is the agent experience inside Comfy Cloud: prompt in chat, and the agent can build or edit workflows on your graph. ## Join the waitlist - Request access to Comfy In-App Agent private alpha. + Request access to the Comfy In-App Agent private alpha. ## Feedback @@ -30,10 +30,10 @@ Already in the alpha? Share bugs and impressions: Looking for agent tools that work from Claude, Cursor, Codex, and other MCP clients (outside the ComfyUI canvas)? - - Connect external MCP clients to Comfy Cloud for generation, search, and workflows. + + Connect external MCP clients to ComfyUI for generation, search, and workflows. - - Compare Cloud MCP, Local MCP, and Comfy CLI. + + Compare the cloud connection, the local connection, and the In-App Agent. diff --git a/agent-tools/index.mdx b/agent-tools/index.mdx index d6581e8e6..c5b98d121 100644 --- a/agent-tools/index.mdx +++ b/agent-tools/index.mdx @@ -1,66 +1,36 @@ --- -title: "Agent Tools / MCP" -description: "Connect AI agents to ComfyUI via the Model Context Protocol (MCP) for image, video, audio, and 3D content generation." +title: "Agent Tools" +description: "Leverage AI agents to use ComfyUI smarter and faster. Comfy MCP, Comfy CLI, and the Comfy In-App Agent." sidebarTitle: "Overview" icon: "robot" --- -ComfyUI provides **MCP servers** and **Comfy CLI** so AI agents and developers can generate images, video, audio, and 3D content without always opening the ComfyUI canvas. - - - **Comfy Cloud MCP is in public beta.** Setup, feedback channels, and related tools (Comfy Skills, Comfy CLI) are on the [Comfy Cloud MCP](/agent-tools/mcp) page. - - - - **Comfy In-App Agent is in private alpha.** Full docs are not public yet. [Join the waitlist](/agent-tools/in-app-agent) to request access. - - - - Connect to the hosted MCP server at cloud.comfy.org/mcp. Generate images, video, audio, and 3D on Cloud GPUs, search templates/models/nodes, run workflows, and share saved workflows from chat. + + Connect any AI agent to ComfyUI, on Comfy Cloud or on your own machine. **Start here.** Agent experience inside Comfy Cloud (chat builds and edits your graph). *Private alpha; waitlist only for now.* - - First-party local MCP server that drives your **own** ComfyUI install via comfy-cli. *Private test; not publicly available yet.* - - Short agent-oriented overview of comfy generate. For the complete CLI guide, see [Getting started](/comfy-cli/getting-started). + ComfyUI in the terminal. Install and update ComfyUI, manage models and nodes, and generate from scripts, CI, or batch jobs. --- -## Which One Should I Use? +## Which one should I use? -| | Comfy Cloud MCP | Comfy Local MCP | Comfy CLI | +| | Comfy MCP
Cloud Connection | Comfy MCP
Local Connection | Comfy In-App Agent | |---|---|---|---| -| **Type** | Remote (hosted) | Local MCP server | Local CLI | -| **Requires** | Comfy Cloud subscription | Local ComfyUI + [comfy-cli](https://github.com/Comfy-Org/comfy-cli) | [Comfy API key](/development/api-development/getting-an-api-key) | -| **Models** | Comfy Cloud models (pre-installed) | Your local models and custom nodes | Partner nodes via `comfy generate` | -| **Workflows** | Full ComfyUI workflow execution | Full local ComfyUI workflow execution | One-shot partner API calls (no workflow JSON) | -| **GPU** | Cloud GPUs (no local GPU needed) | Your local GPU | No GPU needed (API-based) | -| **Best for** | Chat-driven agents, template search | Driving your own local ComfyUI from chat | Scripts, CI, batch jobs | - ---- - -## What about local ComfyUI? - -Want to drive a **local** ComfyUI install with an agent instead of (or alongside) Comfy Cloud MCP? See [**Comfy Local MCP**](/agent-tools/local) for our first-party local MCP server, setup, and client configuration. It is in **private test** and not publicly available yet. - -**Community MCP servers.** Several community projects also connect MCP clients to a local ComfyUI instance: - -| Project | Repository | -| --- | --- | -| comfyui-mcp | [artokun/comfyui-mcp](https://github.com/artokun/comfyui-mcp) | -| comfyui-mcp | [shawnrushefsky/comfyui-mcp](https://github.com/shawnrushefsky/comfyui-mcp) | -| comfyui-mcp-server | [joenorton/comfyui-mcp-server](https://github.com/joenorton/comfyui-mcp-server) | -| comfy-mcp-server | [lalanikarim/comfy-mcp-server](https://github.com/lalanikarim/comfy-mcp-server) | - -These are **community-maintained**. We link them for convenience; support, features, and compatibility vary by project. - -**Want a terminal workflow instead of chat?** See [Comfy CLI](/agent-tools/cli) (`comfy generate`, beta) for scripts and automation. To install and launch local ComfyUI from the terminal, start with [Comfy CLI getting started](/comfy-cli/getting-started). +| **What is it** | Run Comfy Cloud workflows with your own agent. | Drive your own local ComfyUI with your own agent. | Chat with AI inside the app and watch it build and run workflows for you. | +| **Best for** | Beginners who don't want to set up ComfyUI locally.
People who want to share workflows. | People who have ComfyUI locally.
People who have private custom nodes.
People who need to interact with the local file system. | Everyone from beginners to advanced workflow builders.
People who want to see the canvas and check workflows visually. | +| **Requires** | Your own agent.
An active Comfy Cloud subscription. | Your own agent.
A local ComfyUI setup. | No setup.
An active Comfy Cloud subscription. | +| **GPU** | Cloud GPUs (no hardware requirements) | Your local GPU | Cloud GPUs (no hardware requirements) | +| **Models** | Comfy Cloud models.
You can import your own models. | Local models downloaded to your machine. | Comfy Cloud models.
You can import your own models. | +| **Custom nodes** | The custom nodes supported on Comfy Cloud. | You can install any custom node. | The custom nodes supported on Comfy Cloud. | + +Both MCP columns are the **same product and the same page**. See [Comfy MCP](/agent-tools/mcp) to pick one. You can connect both at once. --- diff --git a/agent-tools/local.mdx b/agent-tools/local.mdx deleted file mode 100644 index 34e2be4b4..000000000 --- a/agent-tools/local.mdx +++ /dev/null @@ -1,155 +0,0 @@ ---- -title: "Comfy Local MCP" -sidebarTitle: "Local MCP" -description: "Drive your own local ComfyUI from AI agents (Claude Code, Claude Desktop, Cursor) with the first-party comfy-local-mcp server — run workflows, collect outputs, and inspect the nodes and models your install actually has." -icon: "server" ---- - - - **Private test.** `comfy-local-mcp` is in private testing and is not publicly available yet. If you do not have private-test access, you cannot install or use it today. The core loop (`server_info → run_workflow → fetch_outputs`) is validated end-to-end against a live local ComfyUI, but tools and behavior may still change. - - -[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) is Comfy's **first-party local MCP server** — the official way to drive a **local** ComfyUI install from AI agents (Claude Code, Claude Desktop, Cursor, and other MCP clients). It is a thin wrapper over [comfy-cli](https://github.com/Comfy-Org/comfy-cli): each tool shells out to the `comfy` command, so `comfy-cli` is the engine and there is no code shared with the [Comfy Cloud MCP](/agent-tools/mcp). - -Unlike the cloud and partner servers, it talks to the ComfyUI running on **your own machine** — so it can run your workflows and inspect the nodes, custom nodes, and models your install actually has. - ---- - -## Requirements - -- **Python 3.10+** -- **[comfy-cli](https://github.com/Comfy-Org/comfy-cli)** on your `PATH` (`pip install comfy-cli`) — the engine every tool wraps -- **A ComfyUI workspace** — create one with `comfy install` if you don't have one (an existing checkout works via `comfy set-default `) -- **A running ComfyUI** — start it with `comfy launch` before using the tools; nothing here launches ComfyUI implicitly - ---- - -## Installation - -From a checkout of the [repository](https://github.com/Comfy-Org/comfy-local-mcp): - -```bash -pip install . # or `pip install -e .` for a working copy -``` - -This puts a `comfy-local-mcp` console script on your `PATH` — that command is the MCP server (it speaks MCP over stdio). Point your AI client at it below. - - - **`COMFY_BIN` (optional).** MCP clients launch the server with their own environment, which often does **not** include your shell's `PATH`. If `comfy` lives in a virtualenv or a non-standard location, set `COMFY_BIN` to its absolute path (for example `/path/to/venv/bin/comfy`). Every client example below shows where it goes; drop it if `comfy` is already on the environment your client launches the server with. - - ---- - -## Configure your AI client - -All clients speak the same MCP stdio contract: run the `comfy-local-mcp` command as a server. Pick your client. - -### Claude Code - -One command registers the server: - -```bash -claude mcp add comfy-local -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-local-mcp -``` - -Or check it into a project with a `.mcp.json` at the repo root: - -```json -{ - "mcpServers": { - "comfy-local": { - "command": "comfy-local-mcp", - "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } - } - } -} -``` - -### Claude Desktop - -Edit `claude_desktop_config.json` (Settings → Developer → Edit Config; on macOS it lives at `~/Library/Application Support/Claude/claude_desktop_config.json`), add the server, then restart Claude Desktop: - -```json -{ - "mcpServers": { - "comfy-local": { - "command": "comfy-local-mcp", - "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } - } - } -} -``` - -### Cursor - -Add the server to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per project): - -```json -{ - "mcpServers": { - "comfy-local": { - "command": "comfy-local-mcp", - "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } - } - } -} -``` - ---- - -## Quickstart - -Zero to a generated image: - - - - ```bash - pip install comfy-cli # the engine - comfy install # create a ComfyUI workspace (skip if you have one) - pip install . # this MCP server → the `comfy-local-mcp` command - ``` - - - ```bash - comfy launch - ``` - - - Use the snippet for your client above, then restart / reload it so the tools appear. - - - For example: - - > "Confirm my local ComfyUI is running, then run the workflow at `~/workflows/txt2img.json` and show me the image." - - Under the hood the agent calls `server_info` to confirm ComfyUI is up, `run_workflow` to execute the workflow JSON, and `fetch_outputs` to collect the result. - - - ---- - -## Tools - -Each tool maps onto a `comfy-cli` command, run with `--where local`. Highlights: - -| Tool | Purpose | -|---|---| -| `server_info()` | Is a local ComfyUI running, where, and which workspace. **Call first.** | -| `run_workflow(workflow_path, wait=True)` | Run a workflow JSON; `wait=False` submits async and returns a `prompt_id`. | -| `job_status` / `wait_for_job` / `watch_job` | Poll, wait on, or stream a submitted job. | -| `fetch_outputs(prompt_id, out_dir)` | Copy a finished job's outputs into `out_dir`. | -| `launch_comfyui` / `stop_comfyui` | Start or stop the local ComfyUI. | -| `search_templates` / `fetch_template` | Find a built-in template and write its runnable workflow JSON. | -| `search_nodes` / `get_node` / `list_nodes` | Inspect the node classes in your **live local** install (custom nodes included). | -| `search_models` | List the model files on disk. | -| `validate_workflow` | Pre-flight a workflow against the live `object_info` before a slow run. | - -Node introspection and model search read your **live install** — custom nodes included — which is the local differentiator from the cloud MCP. See the [repository](https://github.com/Comfy-Org/comfy-local-mcp) for the full tool list and reference. - ---- - -## Related - -- [Comfy Cloud MCP](/agent-tools/mcp): hosted MCP server, no local install or GPU needed -- [Comfy CLI](/agent-tools/cli): drive local ComfyUI and partner generation from the terminal -- [comfy-local-mcp on GitHub](https://github.com/Comfy-Org/comfy-local-mcp): source, install, and tool reference diff --git a/agent-tools/mcp.mdx b/agent-tools/mcp.mdx index 6436f3b4f..68b91bb3a 100644 --- a/agent-tools/mcp.mdx +++ b/agent-tools/mcp.mdx @@ -1,30 +1,45 @@ --- -title: "Comfy Cloud MCP" -sidebarTitle: "Cloud MCP" -description: "Connect Comfy Cloud MCP from Claude Code, Claude Desktop, Cursor, Codex, OpenClaw, or any MCP-compatible agent — generate images, video, audio, and 3D, search models and nodes, and run workflows." -icon: "cloud" +title: "Comfy MCP" +sidebarTitle: "Comfy MCP" +description: "Connect any AI agent to ComfyUI on Comfy Cloud GPUs or on your own machine. Generate images, video, audio and 3D, search models, nodes and templates, and run real workflows." +icon: "bolt" --- -import CloudFeature from '/snippets/cloud-feature.mdx' + + **Public beta.** Comfy MCP is in public beta. APIs, tools, and behavior may change while we iterate. See [Feedback](#feedback) to report issues or share suggestions. + + +## Overview + +**Comfy MCP** connects AI agents to ComfyUI 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 real ComfyUI workflows from a chat with your agent. - +It comes with two connections: a **Comfy Cloud** connection and a **local ComfyUI** connection, with the local one fully open source. + + + **Stuck on anything below? The best way is to hand this page to your agent and ask for help.** + + +### Which connection do I want? + +**For new users, we recommend starting with the cloud connection** — it is the simplest setup. If you use claude.ai, ChatGPT, or the Claude Desktop chat app, the cloud connection is also the more compatible choice. + +**If you already run ComfyUI locally or in your own deployed environment, or you work mostly in a coding agent** like Claude Code, Cursor, or Codex, start with the **local** connection. - **Public beta.** Comfy Cloud MCP is in public beta. APIs, tools, and behavior may change while we iterate. See [Feedback](#feedback) to report issues or share suggestions. + **For Mac users, if you plan to run open-source models, we recommend the cloud connection.** Today's open-weight models — the local versions of MiniMax H3, LTX-2.3, and similar — are large, and will not run at a workable speed on the Apple GPU. -## Overview +Running both at once is normal, and most clients host two MCP servers happily. They sign in to the same Comfy account, but **separately** — one sign-in does not cover the other. -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 from a chat with your agent. -The server runs remotely at `cloud.comfy.org/mcp`. Workflows execute on Comfy Cloud GPUs, so you do not need a local GPU. Your agent talks to the server over HTTPS; the server translates tool calls into authenticated requests to Comfy Cloud on your behalf. +## Comfy Cloud MCP Connection -Any **MCP-compatible client** can connect to the same server URL. **Claude Code**, **Claude Desktop**, **Cursor**, **Codex**, and **OpenClaw** have first-class setup below. **Windsurf**, **Amp**, and other agents use the same URL with OAuth or an API key. +The hosted connection, linking your agent to your **Comfy Cloud** account. Nothing to install, and workflows run on Comfy Cloud GPUs. To learn more about Comfy Cloud, see [Comfy Cloud](/get_started/cloud). -## Install Comfy Cloud MCP +### Set up the cloud connection - You need a [Comfy Cloud](https://cloud.comfy.org) account before connecting. [Sign up](https://cloud.comfy.org) if you do not have one yet. OAuth sign-in during setup uses your Comfy account. + You need a [Comfy Cloud](https://cloud.comfy.org) account before connecting. [Sign up](https://cloud.comfy.org) if you do not have one yet; new users get **5 free runs** to try it out. OAuth sign-in during setup uses your Comfy account. Comfy Cloud MCP runs at: @@ -77,22 +92,6 @@ Pick your client: - Claude Desktop does not support Claude Code slash commands. Instead, open the **prompt picker** for the same workflows: - - | Prompt | Description | - | --- | --- | - | `generate-image` | Generate an image from a text description | - | `generate-video` | Generate a video from text or an image | - | `generate-audio` | Generate audio, music, or sound effects | - | `generate-3d` | Generate a 3D model from text or an image | - | `upscale-image` | Upscale an image to higher resolution | - | `remove-background` | Remove the background from an image | - | `search-templates` | Find pre-built workflow templates | - | `search-models` | Search for models (checkpoints, LoRAs, VAEs) | - | `search-nodes` | Search nodes and get wiring suggestions | - | `help` | See what you can do with ComfyUI Cloud | - - You can also skip prompts and ask in plain language. The MCP tools work the same way. @@ -175,7 +174,7 @@ Pick your client: } ``` - Set `COMFY_API_KEY` in your shell or system environment. Prefer `${env:COMFY_API_KEY}` over hardcoding the key in a file you might commit to git. + Set `COMFY_API_KEY` in your shell or system environment. Prefer `${env:COMFY_API_KEY}` over hardcoding the key in a file you might commit to Git. ![Cursor — mcp.json with API key](/images/agent_tools/cursor_mcp_setup_step3.png) @@ -344,11 +343,11 @@ Pick your client: claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp -H "X-API-Key: comfyui-…" ``` - Prefer `${env:COMFY_API_KEY}` or your client's secret interpolation instead of hard-coding keys in config files you commit to git. + Prefer `${env:COMFY_API_KEY}` or your client's secret interpolation instead of hardcoding keys in config files you commit to Git. -## What your agent can do +### What your agent can do You do not call MCP tools yourself. Your agent picks the right tool based on what you ask for. Slash commands and prompts (below) are shortcuts that steer the agent toward common tasks, but plain language works too ("generate an image of a cat astronaut", "upscale this photo", "find a Wan 2.2 video template"). @@ -360,11 +359,11 @@ Typical flow: The server prefers matching [pre-built templates](https://comfy.org/workflows) before building a workflow from scratch, which tends to produce better results faster. -## MCP tools +### Cloud MCP tools -These are the tools your agent has access to once connected. Names match what appears in MCP client logs and debugging. +These are the tools your agent has access to once connected. Names match what appears in MCP client logs and debugging output. -### Discovery +**Discovery** | Tool | Description | | --- | --- | @@ -377,7 +376,7 @@ These are the tools your agent has access to once connected. Names match what ap | `cql` | Run a [CQL](https://github.com/Comfy-Org/cql) graph query for structural questions (for example, which nodes produce images, or paths between node types). Use `search_nodes` when you need full input specs for a specific node | | `get_prompting_guide` | Prompt style and recommended settings (steps, cfg, sampler, resolution) per model family | -### Generation +**Generation** | Tool | Description | | --- | --- | @@ -387,7 +386,7 @@ These are the tools your agent has access to once connected. Names match what ap | `upload_file` | Upload an input image or file for use in workflows (for example, with LoadImage) | | `apply_slots` | Apply parameter overrides to a workflow's interior values and return the modified workflow | -### Jobs and batches +**Jobs and batches** | Tool | Description | | --- | --- | @@ -399,7 +398,7 @@ These are the tools your agent has access to once connected. Names match what ap | `get_queue` | Check how many jobs are running and pending | | `submit_batch`, `get_batch_status`, `get_batch_output`, `wait_for_batch` | Submit many generations in one call and collect them together later — the batch ID stays valid across sessions | -### Saved workflows +**Saved workflows** | Tool | Description | | --- | --- | @@ -409,7 +408,7 @@ These are the tools your agent has access to once connected. Names match what ap | `update_workflow` | Update an existing workflow in place as a new version (earlier versions stay recoverable) | | `run_saved_workflow` | Run a saved workflow by filename — the server converts it from editor format to executable format automatically | -### Sharing workflows +**Sharing workflows** | Tool | Description | | --- | --- | @@ -418,7 +417,7 @@ These are the tools your agent has access to once connected. Names match what ap **Hub URL share IDs:** the trailing hyphen-delimited hex token in a `comfy.org/workflows/-` hub URL is the share ID. For example, `comfy.org/workflows/topaz-starlight-upscale-1c77e82713b7` has share ID `1c77e82713b7`. Pass that token to `import_shared_workflow` as `share_id`. The `share_url` parameter only accepts `?share=` query URLs like `https://cloud.comfy.org/?share=...`, not hub page URLs. -### Apps and links +**Apps and links** | Tool | Description | | --- | --- | @@ -426,7 +425,7 @@ These are the tools your agent has access to once connected. Names match what ap | `get_app_mode_url` | Get the stable link that opens a workflow as a runnable app | | `get_workflow_canvas_url` | Get a link that opens a workflow directly on the Comfy Cloud canvas, ready to view, edit, or run | -### Account and session +**Account and session** | Tool | Description | | --- | --- | @@ -435,18 +434,32 @@ These are the tools your agent has access to once connected. Names match what ap | `submit_feedback` | Get the beta feedback survey link | | `report_session_summary` | Share an anonymized session summary with the Comfy team — **only with your explicit consent**; the agent must ask first, and no prompts, file paths, or personal information are included | -## Credits and spending +**Prompts (Claude Desktop)** -Discovery is free: `search_templates`, `search_models`, and `search_nodes` work with just a [Comfy account](https://cloud.comfy.org). Running generations requires an active Comfy Cloud subscription. A credit or top-up balance alone does not grant access: you need an active subscription to run generations, even if you have unused credits. +Claude Desktop does not support Claude Code slash commands. Instead, open the **prompt picker** for the same workflows: + +| Prompt | Description | +| --- | --- | +| `generate-image` | Generate an image from a text description | +| `generate-video` | Generate a video from text or an image | +| `generate-audio` | Generate audio, music, or sound effects | +| `generate-3d` | Generate a 3D model from text or an image | +| `upscale-image` | Upscale an image to higher resolution | +| `remove-background` | Remove the background from an image | +| `search-templates` | Find pre-built workflow templates | +| `search-models` | Search for models (checkpoints, LoRAs, VAEs) | +| `search-nodes` | Search nodes and get wiring suggestions | +| `help` | See what you can do with ComfyUI Cloud | -Tools that spend real money are **spend-gated**. When a generation uses a paid partner model (`partner_generate`) or a workflow/template containing paid API nodes (`run_template`, `run_saved_workflow`, `submit_batch`), the server blocks execution until your agent confirms you agreed to spend credits — so expect the agent to check with you before those runs. Free, local-only workflows never prompt. +You can also skip prompts and ask in plain language. The MCP tools work the same way. -You can ask your agent about your balance at any time ("how many credits do I have?") — it answers via `get_billing_status`. +### Credits and spending +Discovery is free: `search_templates`, `search_models`, and `search_nodes` work with just a [Comfy account](https://cloud.comfy.org). Running generations requires an active Comfy Cloud subscription. A credit or top-up balance alone does not grant access: you need an active subscription to run generations, even if you have unused credits. -## Outputs and downloads +### Uploads and downloads -The MCP server runs in the cloud and **never writes files to your machine**. When a generation completes, your agent calls `get_output`, which returns: +The MCP server runs in the cloud and the MCP itself doesn't write files to your machine. When a generation completes, your agent calls `get_output`, which returns: 1. A **temporary signed download URL** (valid for a short window). 2. A ready-to-run **shell command** (`curl` on macOS and Linux, `curl.exe` on Windows). @@ -459,6 +472,178 @@ Your agent should run that command in your shell. The command includes the desti If your MCP client cannot run shell commands (some GUI-only setups), copy the command and run it yourself in a terminal. +Asset upload and download depend on the client's file access. If Claude Desktop or another agent client has trouble handling asset uploads or downloads, it may be related to the agent's access to your local file directories. For Claude users we recommend **Claude Code** (desktop app or terminal), which has more capabilities. Similarly, for other agent families, the coding agent is usually better than the web chat version. + + +### Known limitations + +Comfy Cloud MCP is an early release. These limitations are known and being worked on: + +**Workflows** + +- **Assets generated via `submit_workflow` may not embed workflow metadata.** They might not reopen the originating workflow when opened in ComfyUI. +- **Workflow building depends on agent accuracy.** Complex multi-node workflows may need a retry or refinement. + +**File handling** + +- **Outputs require a shell download step.** See [Uploads and downloads](#uploads-and-downloads). +- **Upload size limits** may apply depending on your MCP client. Some clients impose their own limits on file uploads. + +**Authentication** + +- **OAuth or API key.** Claude Code and Claude Desktop use a one-time browser OAuth flow. **Cursor** requires a Comfy Cloud API key in your MCP config (no OAuth). Other headless clients can pass a Comfy Cloud API key via the `X-API-Key` header instead. A device-code OAuth flow for clients that cannot open a browser is planned. + + +## Local Comfy MCP Connection + +The open-source connection: your client launches the server on your machine and it drives the ComfyUI installed there. + +[**comfy-mcp**](https://github.com/Comfy-Org/comfy-mcp) is Comfy's **first-party local MCP server** — the official way to drive a **local** ComfyUI install from AI agents (Claude Code, Claude Desktop, Cursor, and other MCP clients). + +Unlike the cloud and partner servers, it talks to the ComfyUI running on **your own machine** — so it can run your workflows and inspect the nodes, custom nodes, and models your install actually has. + + + **The fastest setup: hand it to your agent.** Paste `https://docs.comfy.org/agent-tools/mcp#installation` into your AI client and ask it to set up the local connection for you. + + +### Requirements + +- **Python 3.10+** +- **[comfy-cli](https://github.com/Comfy-Org/comfy-cli)** on your `PATH` (`pip install comfy-cli`) — the engine every tool wraps +- **A ComfyUI workspace** — create one with `comfy install` if you don't have one (an existing checkout works via `comfy set-default `) +- **A running ComfyUI for execution tools.** Start it with `comfy launch`, or call `launch_comfyui`. The server does not launch ComfyUI implicitly. + +--- + +### Installation + +From a checkout of the [repository](https://github.com/Comfy-Org/comfy-mcp): + +```bash +pip install . # or `pip install -e .` for a working copy +``` + +This puts a `comfy-mcp` console script on your `PATH` — that command is the MCP server (it speaks MCP over stdio). Point your AI client at it below. + + + **`COMFY_BIN` (optional).** MCP clients launch the server with their own environment, which often does **not** include your shell's `PATH`. If `comfy` lives in a virtualenv or a non-standard location, set `COMFY_BIN` to its absolute path (for example `/path/to/venv/bin/comfy`). Every client example below shows where it goes; drop it if `comfy` is already on the environment your client launches the server with. + + +--- + +### Manual configuration + +All clients speak the same MCP stdio contract: run the `comfy-mcp` command as a server. Pick your client: + + + + Edit `claude_desktop_config.json` (Settings → Developer → Edit Config; on macOS it lives at `~/Library/Application Support/Claude/claude_desktop_config.json`), add the server, then restart Claude Desktop: + + ```json + { + "mcpServers": { + "comfy-mcp": { + "command": "comfy-mcp", + "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } + } + } + } + ``` + + + + One command registers the server: + + ```bash + claude mcp add comfy-mcp -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-mcp + ``` + + Or check it into a project with a `.mcp.json` at the repo root: + + ```json + { + "mcpServers": { + "comfy-mcp": { + "command": "comfy-mcp", + "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } + } + } + } + ``` + + + + Add the server to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per project): + + ```json + { + "mcpServers": { + "comfy-mcp": { + "command": "comfy-mcp", + "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } + } + } + } + ``` + + + +--- + +### Quickstart + +Zero to a generated image: + + + + ```bash + git clone https://github.com/Comfy-Org/comfy-mcp + cd comfy-mcp + pip install comfy-cli # the engine + comfy install # create a ComfyUI workspace (skip if you have one) + pip install . # this MCP server → the `comfy-mcp` command + ``` + + + ```bash + comfy launch + ``` + + + Use the snippet for your client above, then restart / reload it so the tools appear. + + + For example: + + > "Confirm my local ComfyUI is running, then run the workflow at `~/workflows/txt2img.json` and show me the image." + + Under the hood the agent calls `server_info` to confirm ComfyUI is up, `run_workflow` to execute the workflow JSON, and `fetch_outputs` to collect the result. + + + +--- + +### Tools + +Each tool maps onto a `comfy-cli` command, run with `--where local`. Highlights: + +| Tool | Purpose | +|---|---| +| `server_info()` | Is a local ComfyUI running, where, and which workspace. **Call first.** | +| `run_workflow(workflow_path, wait=True)` | Run a workflow JSON; `wait=False` submits async and returns a `prompt_id`. | +| `job_status` / `wait_for_job` / `watch_job` | Poll, wait on, or stream a submitted job. | +| `fetch_outputs(prompt_id, out_dir)` | Copy a finished job's outputs into `out_dir`. | +| `launch_comfyui` / `stop_comfyui` | Start or stop the local ComfyUI. | +| `search_templates` / `fetch_template` | Find a built-in template and write its runnable workflow JSON. | +| `search_nodes` / `get_node` / `list_nodes` | Inspect the node classes in your **live local** install (custom nodes included). | +| `search_models` | List the model files on disk. | +| `validate_workflow` | Pre-flight a workflow against the live `object_info` before a slow run. | + +Node introspection and model search read your **live install** — custom nodes included — which is the local differentiator from the cloud connection. See the [repository](https://github.com/Comfy-Org/comfy-mcp) for the full tool list and reference. + +--- + + ## Related resources | Resource | What it's for | @@ -478,44 +663,96 @@ Want the agent experience **inside** Comfy Cloud (chat that builds and edits you ## Feedback -Comfy Cloud MCP is in public beta. Please try it out and tell us what works and what doesn't: +Comfy MCP is in public beta. Please try it out and tell us what works and what doesn't: - **[Feedback survey](https://links.comfy.org/cloudmcpbeta)**: report bugs, request features, or share general impressions. - **Discord**: [#comfy-mcp-and-cli](https://discord.gg/xWJn6nhE3R) on the Comfy Discord for questions and discussion. -## Known limitations +## FAQ -Comfy Cloud MCP is an early release. These limitations are known and being worked on: +### Getting started -**Workflows** + + + Any MCP-compatible client. -- **Editor-to-executable conversion has rough edges.** Saved workflows run by filename via `run_saved_workflow` (the server converts them automatically), but some node configurations still convert imperfectly. -- **Assets generated via `submit_workflow` may not embed workflow metadata.** They might not reopen the originating workflow when opened in ComfyUI. -- **Workflow building depends on agent accuracy.** Complex multi-node workflows may need a retry or refinement. + The **cloud connection** needs remote HTTP support. **Claude Code**, **Claude Desktop**, **Cursor**, **Codex** and **OpenClaw** have first-class setup above; **Windsurf**, **Amp** and others use the same URL with OAuth or an API key. -**File handling** + The **local connection** needs a client that can launch a local stdio server as a subprocess. That rules out browser-based clients. [claude.ai](https://claude.ai) and ChatGPT accept remote connectors only. + + + The cloud connection runs at `https://cloud.comfy.org/mcp`. -- **Outputs require a shell download step.** See [Outputs and downloads](#outputs-and-downloads). -- **Upload size limits** may apply depending on your MCP client. Some clients impose their own limits on file uploads. + The local connection has no URL. Your client launches the `comfy-mcp` command directly and talks to it over stdio. + + + Yes. That is the [Local Comfy MCP Connection](#local-comfy-mcp-connection). It drives the ComfyUI installed on your own machine, so your agent sees the models, LoRAs and custom nodes you actually have, and runs on your GPU. + + + Yes, and we recommend it if you run ComfyUI locally. Most clients host two MCP servers happily, and your agent keeps them straight. Each connection runs its own workflows and returns its own results. -**Authentication** + The two sign-ins are **separate**, though. Signing in on one does not sign you in on the other, even though it is the same Comfy account. + + + Ask your agent. It reads your hardware before starting anything heavy. -- **OAuth or API key.** Claude Code and Claude Desktop use a one-time browser OAuth flow. **Cursor** requires a Comfy Cloud API key in your MCP config (no OAuth). Other headless clients can pass a Comfy Cloud API key via the `X-API-Key` header instead. A device-code OAuth flow for clients that cannot open a browser is planned. + On a **Mac**, use the cloud connection for generating: today's open-weight models are too large to run at a workable speed on the Apple GPU. On a **PC with a dedicated graphics card**, 24 GB or more of VRAM handles most things including video; 8–24 GB is fine for images but video will be slow or will not fit; under 8 GB, use cloud. + + + The cloud connection is in **public beta**. APIs, tools and behavior may change while we iterate. The local connection is available for local ComfyUI installations. See [Feedback](#feedback) to report issues. + + -## FAQ +### Cost and access - - Any MCP-compatible client that supports remote HTTP transport can connect to `https://cloud.comfy.org/mcp`. We document first-class setup for **Claude Code**, **Claude Desktop**, **Cursor**, **Codex**, and **OpenClaw**. **Windsurf**, **Amp**, and other agents follow the same URL with OAuth or an API key. See [Install Comfy Cloud MCP](#install-comfy-cloud-mcp). + + Discovery is free on both connections: searching templates, models and nodes needs only a Comfy account. + + On the **cloud connection**, running generations requires an active Comfy Cloud subscription; new users get 5 free runs. On the **local connection**, runs are free because they happen on your hardware, with one exception: partner models execute on partner infrastructure and spend credits. - Not for interactive clients that support OAuth (Claude Code, Claude Desktop, Codex, OpenClaw, and others). **Cursor** requires a Comfy Cloud API key in your MCP config. An API key is also needed for other headless or CI setups with no browser. See the **Cursor** tab, **OpenClaw** tab, or **Other clients** tab under [Install Comfy Cloud MCP](#install-comfy-cloud-mcp). + Not for interactive clients that support OAuth, including Claude Code, Claude Desktop, Codex and OpenClaw. + + **Cursor** requires a Comfy Cloud API key in your MCP config; there is no MCP OAuth there yet. Headless and CI setups with no browser need one too. See the **Cursor** and **Other clients** tabs under [Set up the cloud connection](#set-up-the-cloud-connection). + + + +### Using it + + + + You do not call MCP tools yourself — your agent picks them based on what you ask for. Typically it **discovers** what is available (`search_templates`, `search_models`, `search_nodes`), **runs** a generation, then **waits and retrieves** the output. See [What your agent can do](#what-your-agent-can-do). - - Paid generations are spend-gated: when a run would consume Comfy Cloud credits (a partner model, or a workflow/template with paid API nodes), the server requires your explicit agreement before executing. See [Credits and spending](#credits-and-spending). + + On the **cloud connection**, the server never writes to your machine: `get_output` returns a temporary signed URL and a ready-to-run download command for your agent to execute in your shell. See [Uploads and downloads](#uploads-and-downloads). + + On the **local connection**, ComfyUI writes into your workspace's `output/` directory, and `fetch_outputs(prompt_id, out_dir)` copies a finished job's files anywhere you name. - - No. Slash commands ship in the Claude Code plugin. Claude Desktop connects to the same MCP server (the tools work if you ask in plain language or use the prompt picker), but it does not support Claude Code plugins or slash commands. + + Nothing to undo — add the second connection alongside the first. + + Going **local → cloud** (you need Cloud GPUs or partner models): ask your agent to sign you in, then add `https://cloud.comfy.org/mcp` to your client. + + Going **cloud → local** (you want your own models and custom nodes): install ComfyUI and the local server, then point your client at it. Your agent can do most of this for you. + + + Just ask your agent. With both connections added, say where you want a job to run — "run this one on Comfy Cloud", "do this locally" — and it uses the right connection. There is no mode to toggle and nothing to reconfigure between runs. + + If a workflow turns out to be too heavy for your machine, your agent can tell you and offer to run it on Comfy Cloud instead. And if only one connection is set up, ask it to add the other — see [Set up the cloud connection](#set-up-the-cloud-connection) or the [Local Comfy MCP Connection](#local-comfy-mcp-connection). + + + On the **cloud connection**, nothing to do — it is hosted, so you are always on the current version. + + On the **local connection**, ask your agent to handle it. Afterwards, **restart your client** or start a new session: MCP servers load when a session starts, so a running one keeps serving the old version until you do. + + + +### Troubleshooting + + + + No. Slash commands ship in the Claude Code plugin. Claude Desktop connects to the same MCP server — the tools work if you ask in plain language or use the prompt picker — but it does not support Claude Code plugins or slash commands. There is no `/comfy` or `/cloud` command. Commands appear under one of two prefixes depending on how you connected: @@ -523,12 +760,9 @@ Comfy Cloud MCP is an early release. These limitations are known and being worke - **Plugin (recommended):** `/comfy-cloud:generate-image`, `/comfy-cloud:generate-video`, … — type `/comfy-cloud:` to see them all. - **Direct connection (no plugin):** `/mcp__comfy-cloud__generate-image`, … — type `/mcp__` to see them. - Either way you can also just ask in plain language ("generate an image of …"). The MCP tools are model-invoked and do not require a slash command. + Either way you can just ask in plain language ("generate an image of …"). The MCP tools are model-invoked and do not require a slash command. In Claude Code, run `/mcp`, select **comfy-cloud**, and choose **Authenticate**. In Claude Desktop, reopen the connector from **Customize → Connectors** and trigger sign-in. - - Comfy Cloud MCP is our hosted offering, but local agent workflows have existed since ComfyUI was open-sourced. See [What about local ComfyUI?](/agent-tools#what-about-local-comfyui) on the Agent Tools overview for why Cloud shipped first, community MCP servers you can use today, and [Comfy CLI](/agent-tools/cli) as another option. - diff --git a/agent-tools/skills.mdx b/agent-tools/skills.mdx new file mode 100644 index 000000000..8753eaef5 --- /dev/null +++ b/agent-tools/skills.mdx @@ -0,0 +1,23 @@ +--- +title: "Skills" +sidebarTitle: "Skills" +description: "Agent skills and plugins for Comfy, published through the Comfy Skills repository." +icon: "wand-magic-sparkles" +--- + +[**Comfy Skills**](https://github.com/Comfy-Org/comfy-skills) is the home of agent skills and plugins for Comfy. Skills are packaged knowledge an agent loads on demand: model guidance, workflow patterns, and ready-made commands. Any agent gets better at ComfyUI without you writing prompts from scratch. + +The repository hosts: + +- **Claude Code plugins**: for example **comfy-cloud**, which adds the Comfy Cloud MCP connection and the `/comfy-cloud:*` slash commands in one install. +- **Agent skills**: focused instructions for specific tasks, such as current model recommendations and workflow-building know-how, kept up to date as models change. +- **Community contributions**: skills and plugins from the Comfy community. + +To use it in Claude Code: + +``` +/plugin marketplace add Comfy-Org/comfy-skills +/plugin install comfy-cloud@comfy-skills +``` + +For the plugin's slash commands and setup details, see [Comfy MCP](/agent-tools/mcp). diff --git a/development/overview.mdx b/development/overview.mdx index 175683ee5..f17d7799f 100644 --- a/development/overview.mdx +++ b/development/overview.mdx @@ -33,7 +33,7 @@ Connect AI agents to ComfyUI via the Model Context Protocol (MCP). Start with th Compare Cloud MCP, Local MCP, and Comfy CLI, and find the right setup for your AI agent integration. -See also: [Comfy Cloud MCP](/agent-tools/mcp) · [Comfy Local MCP](/agent-tools/local) +See also: [Comfy MCP](/agent-tools/mcp) — cloud and local connections ## Comfy CLI diff --git a/docs.json b/docs.json index 4671894e2..ce851bc01 100644 --- a/docs.json +++ b/docs.json @@ -87,14 +87,14 @@ ] }, { - "group": "Agent Tools / MCP", + "group": "Agent Tools", "icon": "robot", "pages": [ "agent-tools/index", "agent-tools/mcp", + "agent-tools/cli", "agent-tools/in-app-agent", - "agent-tools/local", - "agent-tools/cli" + "agent-tools/skills" ] }, { @@ -2927,9 +2927,9 @@ "pages": [ "zh/agent-tools/index", "zh/agent-tools/mcp", + "zh/agent-tools/cli", "zh/agent-tools/in-app-agent", - "zh/agent-tools/local", - "zh/agent-tools/cli" + "zh/agent-tools/skills" ] }, { @@ -5777,9 +5777,9 @@ "pages": [ "ja/agent-tools/index", "ja/agent-tools/mcp", + "ja/agent-tools/cli", "ja/agent-tools/in-app-agent", - "ja/agent-tools/local", - "ja/agent-tools/cli" + "ja/agent-tools/skills" ] }, { @@ -8711,9 +8711,9 @@ "pages": [ "ko/agent-tools/index", "ko/agent-tools/mcp", + "ko/agent-tools/cli", "ko/agent-tools/in-app-agent", - "ko/agent-tools/local", - "ko/agent-tools/cli" + "ko/agent-tools/skills" ] }, { @@ -11537,6 +11537,10 @@ } }, "redirects": [ + { + "source": "/agent-tools/local", + "destination": "/agent-tools/mcp#local-comfy-mcp-connection" + }, { "source": "/agent-tools/cloud", "destination": "/agent-tools/mcp" @@ -11876,6 +11880,18 @@ { "source": "/ko/tutorials/partner-nodes/stability-ai/stable-audio", "destination": "/ko/tutorials/partner-nodes/overview" + }, + { + "source": "/zh/agent-tools/local", + "destination": "/zh/agent-tools/mcp#local-comfy-mcp-connection" + }, + { + "source": "/ja/agent-tools/local", + "destination": "/ja/agent-tools/mcp#local-comfy-mcp-connection" + }, + { + "source": "/ko/agent-tools/local", + "destination": "/ko/agent-tools/mcp#local-comfy-mcp-connection" } ] -} \ No newline at end of file +} diff --git a/ja/agent-tools/cli.mdx b/ja/agent-tools/cli.mdx index ea80dc7a1..f02ae8da5 100644 --- a/ja/agent-tools/cli.mdx +++ b/ja/agent-tools/cli.mdx @@ -3,11 +3,11 @@ title: "Comfy CLI" description: "ターミナルからComfyを操作：ローカルComfyUI、パートナー生成呼び出し、Comfy Cloud上の完全なワークフロー。スクリプト、CI、自動化でMCPを補完します。" sidebarTitle: "Comfy CLI" icon: "terminal" -translationSourceHash: 03991204 +translationSourceHash: bc3e7c14 translationFrom: agent-tools/cli.mdx translationBlockHashes: "_intro": cb162cdd - "How it fits with MCP": a426486a + "How it fits with MCP": a452f8fb "What the CLI does": 3c8cfc5f "Install and set up": 4c281b95 "Prerequisites for `comfy generate`": 66aa291a @@ -16,10 +16,12 @@ translationBlockHashes: "Usage examples": f6768bfe "Beyond `comfy generate`": 8e75f6a8 "Agent skills": 5cfcfe55 - "Related resources": e600c92d + "Related resources": d4e97516 "Feedback": fce347e2 --- + + import GenerateBetaInfo from "/snippets/ja/comfy-cli/generate-beta-info.mdx"; import AgentSkills from "/snippets/ja/comfy-cli/agent-skills.mdx"; import InstallCli from "/snippets/ja/install-comfycli.mdx"; @@ -42,14 +44,14 @@ import GenerateVideoAsync from "/snippets/ja/comfy-cli/generate-video-async.mdx" ## MCPとの連携 -| | Comfy Cloud MCP | Comfy CLI | +| | Comfy MCP（クラウド） | Comfy CLI | |---|---|---| | **インターフェース** | MCPクライアント（Claude Code、Claude Desktopなど）とのチャット | ターミナルコマンドとスクリプト | | **最適な用途** | チャットでの対話的なエージェントワークフロー | 自動化、バッチ実行、CI、シェルパイプライン | | **認証** | MCPクライアントのOAuth、またはAPIキー（ヘッドレス） | `comfy cloud login`（OAuth）またはAPIキー（CI） | | **出力** | チャットセッション内に返される | ディスクに保存（`--download`）またはJSON（`--json`） | -MCPのセットアップ、インストール、ツール一覧、認証方法については、[Comfy Cloud MCP](/ja/agent-tools/mcp) を参照してください。 +MCPのセットアップ、インストール、ツール一覧、認証方法については、[Comfy MCP](/ja/agent-tools/mcp) を参照してください。 ## CLIの機能 @@ -151,7 +153,7 @@ comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url' |---|---| | [Comfy CLI はじめに](/ja/comfy-cli/getting-started) | 完全なインストールガイドとコマンドの解説 | | [Comfy CLI リファレンス](/ja/comfy-cli/reference) | コマンド、フラグ、モデルエイリアス | -| [Comfy Cloud MCP](/ja/agent-tools/mcp) | MCP経由でエージェントを接続し、チャット駆動の生成 | +| [Comfy MCP](/ja/agent-tools/mcp) | MCP経由でエージェントを接続し、チャット駆動の生成を行う | | [GitHub の comfy-cli](https://github.com/Comfy-Org/comfy-cli) | ソースリポジトリ、Issue、最新の動作 | ## フィードバック diff --git a/ja/agent-tools/in-app-agent.mdx b/ja/agent-tools/in-app-agent.mdx index 880dc81e8..edf4e590d 100644 --- a/ja/agent-tools/in-app-agent.mdx +++ b/ja/agent-tools/in-app-agent.mdx @@ -3,7 +3,7 @@ title: "Comfy In-App Agent" sidebarTitle: "In-App Agent" description: "Comfy Cloud で Comfy In-App Agent のプライベートアルファウェイトリストに参加してください。" icon: "comments" -translationSourceHash: 6f0c61ab +translationSourceHash: 4eff238a translationFrom: agent-tools/in-app-agent.mdx --- @@ -11,11 +11,11 @@ translationFrom: agent-tools/in-app-agent.mdx **プライベートアルファ。** Comfy In-App Agent は限定ユーザーに展開されています。公開ドキュメントとウェブサイトページはまだ利用不可です。ウェイトリストに参加してアクセスをリクエストしてください。 -**Comfy In-App Agent** は Comfy Cloud 内のエージェント体験です：チャットでプロンプトを入力すると、エージェントがグラフ上でワークフローを構築または編集できます（生成前に確認あり）。 +**Comfy In-App Agent** は Comfy Cloud 内のエージェント体験です：チャットでプロンプトを入力すると、エージェントがグラフ上でワークフローを構築または編集できます。 -## ウェイトリストに参加 +## ウェイトリストに参加する - + Comfy In-App Agent プライベートアルファへのアクセスをリクエストします。 @@ -32,10 +32,10 @@ translationFrom: agent-tools/in-app-agent.mdx Claude、Cursor、Codex、その他のMCPクライアント（ComfyUIキャンバス外）で動作するエージェントツールをお探しですか？ - - 外部 MCP クライアントを Comfy Cloud に接続し、生成、検索、ワークフローに利用します。 + + 外部 MCP クライアントを ComfyUI に接続し、生成、検索、ワークフローに利用します。 - - Cloud MCP、Local MCP、Comfy CLI を比較します。 + + クラウド接続、ローカル接続、In-App Agent を比較します。 - + \ No newline at end of file diff --git a/ja/agent-tools/index.mdx b/ja/agent-tools/index.mdx index 6f2035b23..3d5e5625d 100644 --- a/ja/agent-tools/index.mdx +++ b/ja/agent-tools/index.mdx @@ -1,77 +1,44 @@ --- -title: "Agent Tools / MCP" -description: "Model Context Protocol (MCP) を使用して AI エージェントを ComfyUI に接続し、画像、動画、オーディオ、3D コンテンツを生成します。" +title: "エージェントツール" +description: "AI エージェントを活用して、ComfyUI をよりスマートかつ高速に使用します。Comfy MCP、Comfy CLI、Comfy In-App Agent を紹介します。" sidebarTitle: "概要" icon: "robot" -translationSourceHash: f467366b +translationSourceHash: 8c401b64 translationFrom: agent-tools/index.mdx -translationBlockHashes: - "_intro": 9db234db - "Which One Should I Use?": 7b3ab710 - "What about local ComfyUI?": 6e518082 - "What is MCP?": bb62fbe5 --- -ComfyUI は **MCP サーバー** と **Comfy CLI** を提供しているので、AI エージェントや開発者は、常に ComfyUI キャンバスを開かなくても、画像、動画、オーディオ、3D コンテンツを生成できます。 - - - **Comfy Cloud MCP はパブリックベータです。** セットアップ、フィードバックチャンネル、および関連ツール（Comfy Skills、Comfy CLI）については、[Comfy Cloud MCP](/ja/agent-tools/mcp) ページをご覧ください。 - - - - **Comfy In-App Agent はプライベートアルファです。** 完全なドキュメントはまだ公開されていません。[ウェイトリストに登録](/ja/agent-tools/in-app-agent)してアクセスをリクエストしてください。 - - - - ホスト型 MCP サーバー cloud.comfy.org/mcp に接続。Cloud GPU で画像、動画、オーディオ、3D を生成し、テンプレート/モデル/ノードを検索し、ワークフローを実行し、チャットから保存したワークフローを共有できます。 + + あらゆる AI エージェントを、Comfy Cloud または自分のマシン上の ComfyUI に接続できます。**ここから始めましょう。** Comfy Cloud 内のエージェント体験（チャットでグラフを構築・編集）。*プライベートアルファ。現在はウェイトリストのみ。* - - ファーストパーティのローカル MCP サーバーです。comfy-cli を使用して、お使いの ComfyUI インストールを操作します。非公開テスト。まだ一般公開されていません。 - - comfy generate の短いエージェント向け概要。完全な CLI ガイドは [はじめに](/ja/comfy-cli/getting-started) をご覧ください。 + ターミナルで使える ComfyUI。ComfyUI のインストールとアップデート、モデルとノードの管理、スクリプト、CI、バッチジョブからの生成が可能です。 -## どちらを使うべき？ - -| | Comfy Cloud MCP | Comfy Local MCP | Comfy CLI | -|---|---|---|---| -| **タイプ** | リモート（ホスト型） | ローカル MCP サーバー | ローカル CLI | -| **必要条件** | Comfy Cloud サブスクリプション | ローカル ComfyUI + [comfy-cli](https://github.com/Comfy-Org/comfy-cli) | [Comfy APIキー](/ja/development/api-development/getting-an-api-key) | -| **モデル** | Comfy Cloud モデル（プリインストール済み） | あなたのローカルモデルとカスタムノード | `comfy generate` によるパートナーノード | -| **ワークフロー** | 完全な ComfyUI ワークフロー実行 | 完全なローカル ComfyUI ワークフロー実行 | 単発のパートナーAPI呼び出し（ワークフローJSON不要） | -| **GPU** | クラウド GPU（ローカル GPU 不要） | あなたのローカル GPU | GPU不要（APIベース） | -| **最適な用途** | チャット駆動のエージェント、テンプレート検索 | チャットから自分のローカル ComfyUI を操作 | スクリプト、CI、バッチジョブ | - --- -## ローカルのComfyUIは？ - -エージェントを使って（Comfy Cloud MCP の代わりに、または併用して）**ローカル**の ComfyUI インストールを操作したいですか？ ファーストパーティのローカル MCP サーバー、セットアップ、クライアント設定については [**Comfy Local MCP**](/ja/agent-tools/local) をご覧ください。現在**非公開テスト**中で、まだ一般公開されていません。 - -**コミュニティ MCP サーバー。** いくつかのコミュニティプロジェクトも MCP クライアントをローカルの ComfyUI インスタンスに接続しています： +## どれを使うべき？ -| プロジェクト | リポジトリ | -| --- | --- | -| comfyui-mcp | [artokun/comfyui-mcp](https://github.com/artokun/comfyui-mcp) | -| comfyui-mcp | [shawnrushefsky/comfyui-mcp](https://github.com/shawnrushefsky/comfyui-mcp) | -| comfyui-mcp-server | [joenorton/comfyui-mcp-server](https://github.com/joenorton/comfyui-mcp-server) | -| comfy-mcp-server | [lalanikarim/comfy-mcp-server](https://github.com/lalanikarim/comfy-mcp-server) | - -これらは**コミュニティメンテナンス**です。便宜上リンクしています。サポート、機能、互換性はプロジェクトによって異なります。 +| | Comfy MCP
クラウド接続 | Comfy MCP
ローカル接続 | Comfy In-App Agent | +|---|---|---|---| +| **説明** | 自分のエージェントで Comfy Cloud ワークフローを実行します。 | 自分のエージェントでローカルの ComfyUI を操作します。 | アプリ内で AI とチャットし、AI がワークフローを構築・実行してくれる様子を確認できます。 | +| **最適な用途** | ローカルに ComfyUI をセットアップしたくない初心者。
ワークフローを共有したい人。 | ローカルに ComfyUI を導入している人。
プライベートなカスタムノードを持っている人。
ローカルファイルシステムを操作する必要がある人。 | 初心者から上級のワークフロー作成者まで、すべての人。
キャンバスを見てワークフローを視覚的に確認したい人。 | +| **必要条件** | 自分専用のエージェント。
有効な Comfy Cloud サブスクリプション。 | 自分専用のエージェント。
ローカルの ComfyUI セットアップ。 | セットアップ不要。
有効な Comfy Cloud サブスクリプション。 | +| **GPU** | クラウド GPU（ハードウェア要件なし） | ローカル GPU | クラウド GPU（ハードウェア要件なし） | +| **モデル** | Comfy Cloud モデル。
独自モデルのインポートが可能です。 | 自分のマシンにダウンロードしたローカルモデル。 | Comfy Cloud モデル。
独自モデルのインポートが可能です。 | +| **カスタムノード** | Comfy Cloud でサポートされているカスタムノード。 | 任意のカスタムノードをインストールできます。 | Comfy Cloud でサポートされているカスタムノード。 | -**チャットではなくターミナルワークフローをご希望ですか？** スクリプトと自動化には [Comfy CLI](/ja/agent-tools/cli)（`comfy generate`、ベータ）をご覧ください。ターミナルからローカル ComfyUI をインストールして起動するには、[Comfy CLI はじめに](/ja/comfy-cli/getting-started)から始めてください。 +MCP の 2 つの列は**同じ製品であり、同じページ**です。[Comfy MCP](/ja/agent-tools/mcp) を参照して選択してください。両方を同時に接続することもできます。 --- ## MCP とは？ -**Model Context Protocol (MCP)** は、AI アシスタントが標準化されたインターフェースを通じて外部ツールやサービスと連携するためのオープンスタンダードです。各サービスのカスタム API 形式を AI エージェントが学習する必要がなく、MCP はツールを統一された方法で公開します。 +**Model Context Protocol (MCP)** は、AI アシスタントが標準化されたインターフェースを通じて外部ツールやサービスと連携するためのオープンスタンダードです。各サービスのカスタム API 形式を AI エージェントが学習する必要はなく、MCP はツールを統一された方法で公開します。 MCP サーバーを Claude Desktop、Claude Code、Cursor、Amp に接続すると、AI アシスタントは以下のことが可能になります： diff --git a/ja/agent-tools/local.mdx b/ja/agent-tools/local.mdx deleted file mode 100644 index 29512a733..000000000 --- a/ja/agent-tools/local.mdx +++ /dev/null @@ -1,161 +0,0 @@ ---- -title: "Comfy Local MCP" -sidebarTitle: "Local MCP" -description: "AIエージェント（Claude Code、Claude Desktop、Cursor）から自分のローカルComfyUIを操作できる、ファーストパーティのcomfy-local-mcpサーバーを使用します。ワークフローを実行し、出力を収集し、インストールに実際に含まれるノードとモデルを検査します。" -icon: "server" -translationSourceHash: 996d6408 -translationFrom: agent-tools/local.mdx -translationBlockHashes: - "_intro": c57ebd12 - "Requirements": d93ce096 - "Installation": 09f9ec59 - "Configure your AI client": 69542371 - "Quickstart": 80f22916 - "Tools": f40c9da1 - "Related": 257416f6 ---- - - - **非公開テスト。** `comfy-local-mcp` は非公開テスト中であり、まだ一般公開されていません。非公開テストへのアクセス権がない場合、現在はインストールや使用はできません。コアループ (`server_info → run_workflow → fetch_outputs`) は実際のローカル ComfyUI に対してエンドツーエンドで検証されていますが、ツールや動作はまだ変更される可能性があります。 - - -[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) は Comfy の **ファーストパーティのローカル MCP サーバー** — AI エージェント (Claude Code、Claude Desktop、Cursor、およびその他の MCP クライアント) から **ローカル**の ComfyUI インストールを操作する公式の方法です。これは [comfy-cli](https://github.com/Comfy-Org/comfy-cli) の薄いラッパーであり、各ツールは `comfy` コマンドをシェルアウトし、comfy-cli がエンジンとして機能します。[Comfy Cloud MCP](/ja/agent-tools/mcp) とのコード共有はありません。 - -クラウドやパートナーサーバーとは異なり、これは **あなたのマシン** で実行されている ComfyUI と通信するため、自分のワークフローを実行したり、インストールに実際に含まれているノード、カスタムノード、モデルを検査したりできます。 - -## 要件 - -- **Python 3.10+** -- **[comfy-cli](https://github.com/Comfy-Org/comfy-cli)** が `PATH` に設定されていること（`pip install comfy-cli`）： すべてのツールがラップするエンジン -- **ComfyUI ワークスペース**： ワークスペースがない場合は `comfy install` で作成してください（既存のチェックアウトがある場合は `comfy set-default <パス>` で対応可能） -- **実行中の ComfyUI**： ツールを使用する前に `comfy launch` で起動してください。ここでの操作は ComfyUI を暗黙的に起動しません - -## インストール - -[リポジトリ](https://github.com/Comfy-Org/comfy-local-mcp) をチェックアウトしてから: - -```bash -pip install . # または作業用コピーの場合は `pip install -e .` -``` - -これにより、`comfy-local-mcp` コンソールスクリプトが `PATH` に配置されます。このコマンドはMCPサーバーであり（stdio経由でMCPを通信します）。以下の手順でAIクライアントを指定してください。 - - - **`COMFY_BIN`（オプション）。** MCPクライアントはサーバーを独自の環境で起動するため、シェルの `PATH` が含まれていないことがよくあります。`comfy` が仮想環境や非スタンダードな場所にある場合は、`COMFY_BIN` に絶対パス（例：`/path/to/venv/bin/comfy`）を設定してください。以下の各クライアントの例で設定場所を示します。クライアントがサーバーを起動する環境にすでに `comfy` が含まれている場合は、設定を省略してください。 - - ---- - -## AIクライアントの設定 - -すべてのクライアントは同じMCP stdioコントラクトを使用します。`comfy-local-mcp` コマンドをサーバーとして実行します。お好みのクライアントを選択してください。 - -### Claude Code - -1つのコマンドでサーバーを登録します。 - -```bash -claude mcp add comfy-local -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-local-mcp -``` - -または、プロジェクトのルートに `.mcp.json` ファイルを作成して登録することもできます。 - -```json -{ - "mcpServers": { - "comfy-local": { - "command": "comfy-local-mcp", - "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } - } - } -} -``` - -### Claude Desktop - -`claude_desktop_config.json` を編集します（設定 → デベロッパー → 設定を編集。macOSの場合は `~/Library/Application Support/Claude/claude_desktop_config.json` にあります）。サーバーを追加し、Claude Desktopを再起動します。 - -```json -{ - "mcpServers": { - "comfy-local": { - "command": "comfy-local-mcp", - "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } - } - } -} -``` - -### Cursor - -`~/.cursor/mcp.json`（グローバル）または `.cursor/mcp.json`（プロジェクトごと）にサーバーを追加します。 - -```json -{ - "mcpServers": { - "comfy-local": { - "command": "comfy-local-mcp", - "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } - } - } -} -``` - ---- - -## クイックスタート - -ゼロから画像生成まで： - - - - ```bash - pip install comfy-cli # エンジン - comfy install # ComfyUIのワークスペースを作成（既存の場合はスキップ） - pip install . # このMCPサーバー → `comfy-local-mcp`コマンド - ``` - - - ```bash - comfy launch - ``` - - - 上記のクライアント用のスニペットを使用し、クライアントを再起動またはリロードしてツールを表示させてください。 - - - 例： - - > "ローカルのComfyUIが動作していることを確認し、`~/workflows/txt2img.json`のワークフローを実行して、画像を表示してください。" - - 内部では、エージェントは`server_info`を呼び出してComfyUIの起動を確認し、`run_workflow`でワークフローJSONを実行し、`fetch_outputs`で結果を収集します。 - - - ---- - -## ツール - -各ツールは、`comfy-cli` コマンドにマッピングされ、`--where local` を指定して実行されます。ハイライト: - -| ツール | 目的 | -|---|---| -| `server_info()` | ローカルのComfyUIが実行中かどうか、場所、そしてどのワークスペースかを確認します。**最初に呼び出します。** | -| `run_workflow(workflow_path, wait=True)` | ワークフローJSONを実行します。`wait=False` で非同期に送信し、`prompt_id` を返します。 | -| `job_status` / `wait_for_job` / `watch_job` | 送信されたジョブをポーリング、待機、またはストリーミングします。 | -| `fetch_outputs(prompt_id, out_dir)` | 完了したジョブの出力を `out_dir` にコピーします。 | -| `launch_comfyui` / `stop_comfyui` | ローカルのComfyUIを起動または停止します。 | -| `search_templates` / `fetch_template` | 組み込みテンプレートを見つけ、実行可能なワークフローJSONを書き出します。 | -| `search_nodes` / `get_node` / `list_nodes` | **ライブローカル** インストール内のノードクラスを検査します（カスタムノードを含む）。 | -| `search_models` | ディスク上のモデルファイルを一覧表示します。 | -| `validate_workflow` | 遅い実行の前に、ライブの `object_info` に対してワークフローを事前チェックします。 | - -ノード内省とモデル検索は、**ライブインストール**（カスタムノードを含む）を読み取ります。これがクラウドMCPとのローカルの差別化要因です。完全なツール一覧とリファレンスについては、[リポジトリ](https://github.com/Comfy-Org/comfy-local-mcp) を参照してください。 - ---- - -## 関連リンク - -- [Comfy Cloud MCP](/ja/agent-tools/mcp): ホスト型MCPサーバー、ローカルインストールやGPUは不要 -- [Comfy CLI](/ja/agent-tools/cli): ターミナルからローカルのComfyUIとパートナー生成を操作 -- [comfy-local-mcp on GitHub](https://github.com/Comfy-Org/comfy-local-mcp): ソース、インストール、ツールリファレンス diff --git a/ja/agent-tools/mcp.mdx b/ja/agent-tools/mcp.mdx index 794b697d9..1ce70d076 100644 --- a/ja/agent-tools/mcp.mdx +++ b/ja/agent-tools/mcp.mdx @@ -1,48 +1,60 @@ --- -title: "Comfy Cloud MCP" -sidebarTitle: "Cloud MCP" -description: "Claude Code、Claude Desktop、Cursor、Codex、またはMCP互換エージェントからComfy Cloud MCPに接続: 画像・ビデオ・オーディオ・3Dの生成、モデルとノードの検索、ワークフローの実行。" -icon: "cloud" -translationSourceHash: f491b28c +title: "Comfy MCP" +sidebarTitle: "Comfy MCP" +description: "あらゆる AI エージェントを Comfy Cloud GPU 上、または自分のマシン上の ComfyUI に接続します。画像、動画、音声、3D を生成し、モデル、ノード、テンプレートを検索し、実際のワークフローを実行できます。" +icon: "bolt" +translationSourceHash: 15897127 translationFrom: agent-tools/mcp.mdx translationBlockHashes: - "_intro": b1c56a40 - "Overview": 2972aa17 - "Install Comfy Cloud MCP": b4e1e157 - "What your agent can do": 2c2a22e6 - "MCP tools": a9211dee - "Credits and spending": 686040e6 - "Outputs and downloads": a2c8c12f + "_intro": 340316c1 + "Overview": 64064e0e + "Comfy Cloud MCP Connection": f820ca16 + "Local Comfy MCP Connection": 5b13e8fd "Related resources": 2a86e2c5 "Related: Comfy In-App Agent": be5e2cdf - "Feedback": 6872768e - "Known limitations": 2f9e13ba - "FAQ": c943ff55 + "Feedback": 25a3d53f + "FAQ": 45b297ec --- -import CloudFeature from '/snippets/ja/cloud-feature.mdx' - - - **公開ベータ版.** Comfy Cloud MCP は公開ベータ版です。API、ツール、動作は開発中に変更される可能性があります。問題の報告や提案は[フィードバック](#feedback)をご覧ください。 + **パブリックベータ。** Comfy MCP はパブリックベータ版です。API、ツール、動作は開発中に変更される可能性があります。問題の報告や提案の共有については [フィードバック](#feedback) をご覧ください。 ## 概要 -**Comfy Cloud MCP サーバー**は、AI エージェントを [モデルコンテキストプロトコル（MCP）](https://modelcontextprotocol.io) を通じて [Comfy Cloud](https://cloud.comfy.org) に接続します。接続後、チャットから画像、動画、オーディオ、3D の生成、モデル、ノード、テンプレートの検索、ComfyUI ワークフローの実行ができます。 +**Comfy MCP** は、[Model Context Protocol](https://modelcontextprotocol.io) を介して AI エージェントを ComfyUI に接続します。接続すると、画像、動画、音声、3D の生成、モデル、ノード、テンプレートの検索、さらにエージェントとのチャットから実際の ComfyUI ワークフローを実行できます。 + +2 つの接続方法が用意されています。**Comfy Cloud** 接続と**ローカル ComfyUI** 接続で、ローカル接続は完全にオープンソースです。 + + + **以下の内容でお困りですか？ 一番良い方法は、このページをエージェントに渡して助けを求めることです。** + + +### どの接続を選ぶべきか + +**新規ユーザーには、クラウド接続から始めることをお勧めします。** 最も簡単なセットアップです。claude.ai、ChatGPT、または Claude Desktop チャットアプリを使用する場合も、クラウド接続の方が互換性が高い選択肢です。 + +**すでに ComfyUI をローカルまたは独自にデプロイした環境で実行している場合や、Claude Code、Cursor、Codex などのコーディングエージェントを主に使用する場合は、ローカル接続から始めてください。** + + + **Mac ユーザーの場合、オープンソースモデルを実行する予定なら、クラウド接続をお勧めします。** 現在のオープンウェイトモデル（MiniMax H3 や LTX-2.3 などのローカル版）は大きく、Apple GPU では実用的な速度で動作しません。 + + +両方を同時に実行するのは普通のことで、ほとんどのクライアントは 2 つの MCP サーバーを問題なくホストします。同じ Comfy アカウントにログインしますが、**別々に**行う必要があります。一方のログインで両方の接続が有効になるわけではありません。 + -サーバーは `cloud.comfy.org/mcp` でリモート実行されます。ワークフローは Comfy Cloud の GPU 上で実行されるため、ローカル GPU は不要です。エージェントは HTTPS 経由でサーバーと通信し、サーバーはツール呼び出しを認証済みのリクエストとして Comfy Cloud に代行送信します。 +## Comfy Cloud MCP 接続 -MCP 互換のクライアントはいずれも同じサーバー URL に接続できます。**Claude Code**、**Claude Desktop**、**Cursor**、**Codex**、**OpenClaw** については、以下にファーストクラスのセットアップ手順があります。**Windsurf**、**Amp**、およびその他のエージェントは、OAuth または APIキーを使用して同じ URL から利用できます。 +エージェントをあなたの **Comfy Cloud** アカウントにリンクするホスト型接続です。インストールは不要で、ワークフローは Comfy Cloud の GPU 上で実行されます。Comfy Cloud について詳しくは、[Comfy Cloud](/ja/get_started/cloud) をご覧ください。 -## Comfy Cloud MCP のインストール +### クラウド接続のセットアップ - 接続する前に[Comfy Cloud](https://cloud.comfy.org)アカウントが必要です。まだお持ちでない場合は[サインアップ](https://cloud.comfy.org)してください。セットアップ時のOAuthログインはComfyアカウントを使用します。 + 接続する前に、[Comfy Cloud](https://cloud.comfy.org) アカウントが必要です。まだお持ちでない場合は [サインアップ](https://cloud.comfy.org) してください。新規ユーザーは、お試しとして **5 回の無料実行** をご利用いただけます。セットアップ時の OAuth サインインでは、お使いの Comfy アカウントが使用されます。 -Comfy Cloud MCPは以下で実行されます： +Comfy Cloud MCP は以下で実行されます: ``` https://cloud.comfy.org/mcp @@ -52,7 +64,7 @@ https://cloud.comfy.org/mcp - Claude Desktopは、UIを通じてComfy Cloudを**カスタムコネクタ**として追加し、OAuthログインを実行します。 + Claude Desktop は UI から Comfy Cloud を**カスタムコネクタ**として追加し、OAuth ログインを実行します。 - - サイドバーで**カスタマイズ**（ラベル**1**）をクリックします。 + + サイドバーで、**Customize**（**1** と表示）をクリックします。 - ![Claude Desktop — カスタマイズを開く](/images/agent_tools/claude_desktop_mcp_setup_step1.png) + ![Claude Desktop — open Customize](/images/agent_tools/claude_desktop_mcp_setup_step1.png) - - **コネクタ**（ラベル**2**）をクリックします。 + + **Connectors**（**2** と表示）をクリックします。 - ![Claude Desktop — コネクタを開く](/images/agent_tools/claude_desktop_mcp_setup_step2.png) + ![Claude Desktop — open Connectors](/images/agent_tools/claude_desktop_mcp_setup_step2.png) - 1. コネクタヘッダーの**+**ボタン（ラベル**3**）をクリックします。 - 2. **カスタムコネクタを追加**（ラベル**4**）を選択します。 + 1. Connectors のヘッダーにある **+** ボタン（**3** と表示）をクリックします。 + 2. **Add custom connector**（**4** と表示）を選択します。 - ![Claude Desktop — カスタムコネクタを追加](/images/agent_tools/claude_desktop_mcp_setup_step3.png) + ![Claude Desktop — add custom connector](/images/agent_tools/claude_desktop_mcp_setup_step3.png) - 1. **名前**フィールド（ラベル**5**）に、**Comfy Cloud MCP**などの名前を入力します。 - 2. **Remote MCP server URL**を`https://cloud.comfy.org/mcp`に設定します（ラベル**6**）。 - 3. **追加**（ラベル**7**）をクリックします。 + 1. **Name** フィールド（**5** と表示）に、**Comfy Cloud MCP** などの名前を入力します。 + 2. **Remote MCP server URL** を `https://cloud.comfy.org/mcp` に設定します（**6** と表示）。 + 3. **Add**（**7** と表示）をクリックします。 - ![Claude Desktop — コネクタの詳細](/images/agent_tools/claude_desktop_mcp_setup_step4.png) + ![Claude Desktop — connector details](/images/agent_tools/claude_desktop_mcp_setup_step4.png) - - 1. ブラウザが開いたら、ワークスペースを選択します（例：**個人ワークスペース**）。 - 2. **続ける**をクリックしてコネクタを承認します。接続されます。 + + 1. ブラウザが開いたら、ワークスペースを選択します（例：**Personal Workspace**）。 + 2. **Continue** をクリックしてコネクタを認証します。接続されました。 - ![Comfy Cloud MCP認証](/images/agent_tools/auth.png) + ![Comfy Cloud MCP authorization](/images/agent_tools/auth.png) - Claude DesktopはClaude Codeのスラッシュコマンドをサポートしていません。代わりに、同じワークフローに対して**プロンプトピッカー**を開きます： - - | プロンプト | 説明 | - | --- | --- | - | `generate-image` | テキスト説明から画像を生成 | - | `generate-video` | テキストまたは画像から動画を生成 | - | `generate-audio` | オーディオ、音楽、効果音を生成 | - | `generate-3d` | テキストまたは画像から3Dモデルを生成 | - | `upscale-image` | 画像を高解像度にアップスケール | - | `remove-background` | 画像から背景を削除 | - | `search-templates` | 事前構築されたワークフローテンプレートを検索 | - | `search-models` | モデル（チェックポイント、LoRA、VAE）を検索 | - | `search-nodes` | ノードを検索し、配線の提案を取得 | - | `help` | ComfyUI Cloudでできることを確認 | - - プロンプトをスキップして、平易な言語で質問することもできます。MCPツールは同様に機能します。 - **comfy-cloud**プラグインをインストールします。これにより、MCP接続とスラッシュコマンドが一度に追加されます。このプラグインは、[Comfy Skills](https://github.com/Comfy-Org/comfy-skills/)リポジトリを通じて公開されています。このリポジトリにはClaude CodeプラグインとComfy向けのコミュニティエージェントスキルがホストされています。 + **comfy-cloud** プラグインをインストールします。MCP 接続とスラッシュコマンドを一度に追加します。プラグインは、Claude Code プラグインや Comfy のコミュニティエージェントスキルを提供する [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) リポジトリを通じて公開されています。 - Comfy Skillsマーケットプレイスを登録します（1回のみ）： + Comfy Skills マーケットプレイスを登録します（1 回のみ）: ``` /plugin marketplace add Comfy-Org/comfy-skills @@ -126,56 +122,56 @@ https://cloud.comfy.org/mcp /plugin install comfy-cloud@comfy-skills ``` - - `/mcp`を実行し、**comfy-cloud** → **認証**を選択します。ブラウザが開いてログインし、トークンは自動的に更新されます。 + + `/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でできることを確認 | - - - サーバーを直接追加： + | `/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 でできることを確認します | + + + サーバーを直接追加します: ```bash claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp ``` - その後、`/mcp`を実行し、**comfy-cloud** → **認証**を選択します。`-s user`を追加すると、すべてのプロジェクトで利用可能になります。 + 次に `/mcp` を実行し、**comfy-cloud** → **Authenticate** を選択します。すべてのプロジェクトで利用可能にするには `-s user` を追加してください。 - この方法でも、MCPプロンプトとして同じワークフローが公開されます：`/mcp__comfy-cloud__generate-image`、`/mcp__comfy-cloud__search-models`など（`/mcp__<名前>__`プレフィックスは、`claude mcp add`に渡した名前を使用します）。上記のプラグインは、これらをより親しみやすい`/comfy-cloud:*`コマンドとしてラップするため、推奨されます。 + この方法でも MCP プロンプトと同じワークフローが利用できます: `/mcp__comfy-cloud__generate-image`、`/mcp__comfy-cloud__search-models` など（`/mcp____` プレフィックスは `claude mcp add` に渡した名前を使用します）。上記のプラグインは、これらをより使いやすい `/comfy-cloud:*` コマンドとしてラップするため推奨されます。 - CursorはリモートMCPサーバーにHTTPで接続します。Cursorは現在MCP OAuthをサポートしていません。MCP設定にComfy Cloud APIキーを指定してComfy Cloudを追加します。 + Cursor は HTTP 経由でリモート MCP サーバーに接続します。現在、Cursor は MCP OAuth をサポートしていません。MCP 設定に Comfy Cloud API キーを使用して Comfy Cloud を追加します。 - - 右上隅の**設定**歯車アイコン（ラベル**1**）をクリックします。 + + 右上隅にある **Settings** ギア（**1** と表示）をクリックします。 - ![Cursor — 設定を開く](/images/agent_tools/cursor_mcp_setup_step1.png) + ![Cursor — open Settings](/images/agent_tools/cursor_mcp_setup_step1.png) - - 1. サイドバーで**Tools & MCPs**（ラベル**2**）をクリックします。 - 2. **+ New MCP Server**（ラベル**3**）→ **Add a Custom MCP Server**をクリックします。 + + 1. サイドバーで、**Tools & MCPs**（**2** と表示）をクリックします。 + 2. **+ New MCP Server**（**3** と表示）→ **Add a Custom MCP Server** をクリックします。 ![Cursor — Tools & MCPs](/images/agent_tools/cursor_mcp_setup_step2.png) - - `~/.cursor/mcp.json`（グローバル）または `.cursor/mcp.json`（プロジェクト）を編集します。サーバーURLを設定し、`X-API-Key`ヘッダーでComfy Cloud APIキーを渡します。[platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)でキーを作成します（`comfyui-`で始まります）： + + `~/.cursor/mcp.json`（グローバル）または `.cursor/mcp.json`（プロジェクト）を編集します。サーバー URL を設定し、`X-API-Key` ヘッダーで Comfy Cloud API キーを渡します。キーは [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) で作成します（`comfyui-` で始まります）: ```json { @@ -190,18 +186,18 @@ https://cloud.comfy.org/mcp } ``` - シェルまたはシステム環境に`COMFY_API_KEY`を設定します。キーをgitにコミットする可能性のあるファイルに直接記述するよりも、`${env:COMFY_API_KEY}`を推奨します。 + シェルまたはシステム環境に `COMFY_API_KEY` を設定します。Git にコミットする可能性のあるファイルにキーをハードコーディングするよりも、`${env:COMFY_API_KEY}` を使用することを推奨します。 - ![Cursor — APIキーを含むmcp.json](/images/agent_tools/cursor_mcp_setup_step3.png) + ![Cursor — mcp.json with API key](/images/agent_tools/cursor_mcp_setup_step3.png) - 平易な言葉で質問します（「猫の宇宙飛行士の画像を生成して」「Wan 2.2の動画テンプレートを探して」）。Cursorがあなたに代わってMCPツールを呼び出します。 + 自然言語で依頼します（「猫の宇宙飛行士の画像を生成して」「Wan 2.2 動画テンプレートを探して」など）。Cursor が MCP ツールを代わりに呼び出します。 - [Codex](https://developers.openai.com/codex/cli)は、Streamable HTTPを介してComfy Cloudに接続します。設定でサーバーを追加し、OAuthでログインします。 + [Codex](https://developers.openai.com/codex/cli) は Streamable HTTP 経由で Comfy Cloud に接続します。Settings でサーバーを追加し、OAuth でサインインします。 - [ClawHub](https://clawhub.ai/comfy-org/skills/comfy)から**Comfy Cloud**スキルをインストールします。これにより、OpenClawがホストされているMCPサーバー（`cloud.comfy.org/mcp`）に接続されます。クラウド専用：ローカルのComfyUIインストールを駆動しません。 + [ClawHub](https://clawhub.ai/comfy-org/skills/comfy) から **Comfy Cloud** スキルをインストールします。OpenClaw をホストされた MCP サーバー（`cloud.comfy.org/mcp`）に接続します。クラウド専用で、ローカルの ComfyUI インストールは操作しません。 @@ -276,10 +272,10 @@ https://cloud.comfy.org/mcp openclaw skills install @comfy-org/comfy ``` - スキルページ：[clawhub.ai/comfy-org/skills/comfy](https://clawhub.ai/comfy-org/skills/comfy) + スキルページ: [clawhub.ai/comfy-org/skills/comfy](https://clawhub.ai/comfy-org/skills/comfy)。 - - MCPサーバーを登録し、Comfyアカウントでログインします： + + MCP サーバーを登録し、Comfy アカウントでサインインします: ```bash openclaw mcp set comfy '{"url":"https://cloud.comfy.org/mcp","transport":"streamable-http","auth":"oauth"}' @@ -287,19 +283,19 @@ https://cloud.comfy.org/mcp openclaw gateway restart ``` - `openclaw mcp login`は認証URLを表示します。そのURLを開き、ログインして、CLIの指示に従ってフローを完了します（`--code`値を指定して再実行を求められる場合があります）。`openclaw mcp status --verbose`で確認します。 + `openclaw mcp login` は認証 URL を表示します。それを開いてサインインし、CLI の指示に従ってフローを完了します（`--code` 付きで再実行が必要になる場合があります）。`openclaw mcp status --verbose` で確認します。 - `auth: "oauth"`が設定されている場合、OpenClawはそのサーバーエントリの静的な`headers`を無視します。OAuthとハードコードされたAPIキーヘッダーを組み合わせないでください。 + `auth: "oauth"` が設定されている場合、OpenClaw はそのサーバーエントリの静的 `headers` を無視します。OAuth とハードコードされた API キーヘッダーを併用しないでください。 - 平易な言葉で質問します（「猫の宇宙飛行士の画像を生成して」「Wan 2.2の動画テンプレートを探して」）。OpenClawがあなたに代わってMCPツールを呼び出します。 + 自然言語で依頼します（「猫の宇宙飛行士の画像を生成して」「Wan 2.2 動画テンプレートを探して」など）。OpenClaw が MCP ツールを代わりに呼び出します。 - - [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)でキーを作成し（`comfyui-`で始まります）、エクスポートしてからサーバーを登録します： + + [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) でキーを作成し（`comfyui-` で始まります）、エクスポートしてからサーバーを登録します: ```bash export COMFY_API_KEY="comfyui-..." @@ -307,16 +303,16 @@ https://cloud.comfy.org/mcp openclaw gateway restart ``` - OpenClawではカスタムの`X-API-Key`ヘッダーよりも`Authorization: Bearer`を推奨します。一部のOpenClawビルドでは、streamable-httpトランスポートでカスタムヘッダーが削除される場合があります。Bearerはプロキシをより確実に通過します。`COMFY_API_KEY`をシェルプロファイルまたはOpenClawの環境に設定してください。キーをコミットしないでください。 + OpenClaw では、カスタム `X-API-Key` ヘッダーよりも `Authorization: Bearer` を優先してください。一部の OpenClaw ビルドでは streamable-http トランスポートでカスタムヘッダーが削除されることがあります。Bearer の方がプロキシをより確実に通過します。`COMFY_API_KEY` をシェルプロファイルまたは OpenClaw 環境に設定してください。キーをコミットしないでください。 - **リモートHTTP**トランスポートをサポートするMCPクライアントは、Comfy Cloudに接続できます。サーバーURLは常に`https://cloud.comfy.org/mcp`です。 + リモート HTTP トランスポートをサポートする MCP クライアントは、Comfy Cloud に接続できます。サーバー URL は常に `https://cloud.comfy.org/mcp` です。 - - `https://cloud.comfy.org/mcp`を指すリモートMCPエントリを追加します。ほとんどのクライアントは`url`フィールドを持つJSON設定を使用します： + + リモート MCP エントリを追加し、`https://cloud.comfy.org/mcp` を指すようにします。ほとんどのクライアントでは `url` フィールドを含む JSON 設定を使用します: ```json { @@ -328,17 +324,17 @@ https://cloud.comfy.org/mcp } ``` - **Windsurf**は`url`の代わりに`serverUrl`を使用します。**Amp**は**設定 → MCPサーバー**または`~/.config/amp/settings.json`で同じ`mcpServers`構造を使用します。 + **Windsurf** では `url` の代わりに `serverUrl` を使用します。**Amp** は **Settings → MCP Servers** または `~/.config/amp/settings.json` 内で同じ `mcpServers` 形式を使います。 - クライアントがMCP OAuthをサポートしている場合は、ブラウザからログインします。それ以外の場合は、APIキーヘッダーを追加します（下記参照）。 + クライアントが MCP OAuth をサポートしている場合は、プロンプトに従ってブラウザでサインインします。それ以外の場合は API キーヘッダーを追加します（下記参照）。 - クライアントを再起動します。**comfy-cloud**サーバーにComfy Cloudツール（`search_templates`、`submit_workflow`、`get_output`など）が登録されているはずです。 + クライアントを再起動します。**comfy-cloud** サーバーに Comfy Cloud ツール（`search_templates`、`submit_workflow`、`get_output` など）が登録されているはずです。 - **ヘッドレス/CI（APIキー）：** OAuthが利用できない場合は、[platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)でキーを作成し、`X-API-Key`ヘッダーとして渡します： + **ヘッドレス / CI（API キー）:** OAuth が利用できない場合は、[platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) でキーを作成し、`X-API-Key` ヘッダーとして渡します: ```json { @@ -353,198 +349,432 @@ https://cloud.comfy.org/mcp } ``` - ターミナルからClaude Codeを使用する場合： + ターミナルから Claude Code を使用する場合: ```bash claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp -H "X-API-Key: comfyui-…" ``` - 設定ファイルにキーを直接記述するのではなく、`${env:COMFY_API_KEY}`またはクライアントのシークレット補間を使用することをお勧めします（gitにコミットする設定ファイルで）。 + 設定ファイルを Git にコミットする可能性がある場合、キーを直接ハードコーディングする代わりに `${env:COMFY_API_KEY}` やクライアントのシークレット補間を使用することを推奨します。 -## エージェントができること +### エージェントができること -MCPツールを自分で呼び出す必要はありません。エージェントはリクエスト内容に基づいて適切なツールを選択します。スラッシュコマンドやプロンプト（下記）は、エージェントを一般的なタスクに誘導するショートカットですが、平易な言葉でも動作します（「猫の宇宙飛行士の画像を生成して」「この写真をアップスケールして」「Wan 2.2のビデオテンプレートを探して」など）。 +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`でダウンロードコマンドを取得します（エージェントがシェルで実行します）。 +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` がダウンロードコマンドを返すので、エージェントがシェルで実行します）。 -サーバーは、ワークフローをゼロから構築する前に、[事前構築済みテンプレート](https://comfy.org/workflows)を優先してマッチングします。これにより、より速く、より良い結果が得られる傾向があります。 +サーバーは、ゼロからワークフローを構築する前に[事前構築済みテンプレート](https://comfy.org/workflows) の一致を優先します。その方が、より良い結果をより早く得られる傾向があります。 -## MCP ツール +### クラウド MCP ツール -これらは、エージェントが接続後にアクセスできるツールです。名前は MCP クライアントのログやデバッグに表示されるものと一致します。 +接続後、エージェントが利用できるツールです。名前は MCP クライアントのログやデバッグ出力に表示されるものと一致します。 -### 検索 +**探索** | ツール | 説明 | | --- | --- | -| `search_templates` | [comfy.org](https://comfy.org/workflows) からテキスト、タグ、メディアタイプ、またはモデルで事前構築済みのワークフローテンプレートを検索します | -| `get_template` | テンプレートの完全なワークフロー JSON を取得し、検査や手動編集を行えます | -| `get_template_schema` | テンプレートのどのパラメータが実行時にオーバーライド可能かを確認します | -| `search_models` | テキスト、タイプ、ベースモデル、またはソースでモデルカタログを検索します | -| `search_nodes` | テキスト、カテゴリ、入力/出力タイプで利用可能なノードを検索します。また、**サブグラフブループリント**（テキストから画像へや背景を削除などの事前配線済みノードグループ）も表示します | -| `get_node` | 特定のノードの完全な入力仕様を取得します（全オプションリストを含む） | -| `cql` | 構造的な質問を行うために [CQL](https://github.com/Comfy-Org/cql) グラフクエリを実行します（例：どのノードが画像を生成するか、ノードタイプ間のパスなど）。特定のノードの完全な入力仕様が必要な場合は `search_nodes` を使用してください | -| `get_prompting_guide` | モデルファミリーごとのプロンプトスタイルと推奨設定（ステップ数、CFG、サンプラー、解像度） | +| `search_templates` | [comfy.org](https://comfy.org/workflows) の事前構築済みワークフローテンプレートを、テキスト、タグ、メディアタイプ、またはモデルで検索します | +| `get_template` | テンプレートの完全なワークフロー JSON を取得し、検査や手動編集に使用します | +| `get_template_schema` | テンプレートのパラメータのうち、実行時に上書き可能なものを確認します | +| `search_models` | モデルカタログをテキスト、タイプ、ベースモデル、ソースで検索します | +| `search_nodes` | 利用可能なノードをテキスト、カテゴリ、入出力タイプで検索します。**サブグラフブループリント**（Text to Image や Remove Background などの事前配線済みノードグループ）も表示します | +| `get_node` | 特定のノードの完全な入力仕様（すべてのオプションリストを含む）を取得します | +| `cql` | 構造的な質問（例：どのノードが画像を生成するか、ノードタイプ間のパス）に対して [CQL](https://github.com/Comfy-Org/cql) グラフクエリを実行します。特定のノードの完全な入力仕様が必要な場合は `search_nodes` を使用してください | +| `get_prompting_guide` | モデルファミリーごとのプロンプトスタイルと推奨設定（ステップ数、cfg、サンプラー、解像度）を取得します | -### 生成 +**生成** | ツール | 説明 | | --- | --- | -| `run_template` | 名前を指定して事前構築済みテンプレートを実行します。オプションでパラメータのオーバーライドが可能。テンプレートが一致する場合の推奨パスです | -| `submit_workflow` | ComfyUI API 形式のワークフローを Comfy Cloud での実行用に送信します | +| `run_template` | 名前で事前構築済みテンプレートを実行します。オプションでパラメータの上書きが可能です。テンプレートが一致する場合に推奨される方法です | +| `submit_workflow` | Comfy Cloud で実行するために ComfyUI API 形式のワークフローを送信します | | `partner_generate` | パートナー API モデル（Flux/BFL、Grok、Gemini、OpenAI、Ideogram、Seedream/Seedance など）で生成します | -| `upload_file` | ワークフローで使用する入力画像やファイルをアップロードします（例：LoadImage を使用する場合） | -| `apply_slots` | ワークフローの内部値にパラメータのオーバーライドを適用し、変更後のワークフローを返します | +| `upload_file` | ワークフローで使用する入力画像やファイルをアップロードします（例：`LoadImage` で使用） | +| `apply_slots` | ワークフローの内部値にパラメータの上書きを適用し、変更されたワークフローを返します | -### ジョブとバッチ +**ジョブとバッチ** | ツール | 説明 | | --- | --- | -| `get_job_status` | 送信したワークフローの実行ステータスをポーリングします | -| `wait_for_job` | 繰り返しポーリングする代わりに、ジョブが完了するまで待機します | -| `get_output` | 完了したワークフローから出力画像、動画、音声を取得します | -| `use_previous_output` | ある実行の出力を別の実行の入力として再利用し、ワークフローを連鎖させます | +| `get_job_status` | 送信されたワークフローの実行状態をポーリングします | +| `wait_for_job` | ポーリングを繰り返す代わりにジョブの完了を待ちます | +| `get_output` | 完了したワークフローから出力画像、動画、または音声を取得します | +| `use_previous_output` | ある実行の出力を別の実行の入力として再利用し、ワークフローを連結します | | `cancel_job` | 保留中または実行中のジョブをキャンセルします | -| `get_queue` | 実行中および保留中のジョブの数を確認します | -| `submit_batch`、`get_batch_status`、`get_batch_output`、`wait_for_batch` | 一度の呼び出しで多くの生成を送信し、後でまとめて収集します。バッチ ID はセッションをまたいで有効です | +| `get_queue` | 実行中および保留中のジョブ数を確認します | +| `submit_batch`、`get_batch_status`、`get_batch_output`、`wait_for_batch` | 1 回の呼び出しで多数の生成を送信し、後でまとめて収集します。バッチ ID はセッションをまたいで有効です | -### 保存済みワークフロー +**保存済みワークフロー** | ツール | 説明 | | --- | --- | -| `list_saved_workflows` | Comfy Cloud に保存されたワークフローをブラウズします | -| `get_saved_workflow` | 保存済みワークフローのノード、入力、カスタマイズ可能な設定を検査します | +| `list_saved_workflows` | Comfy Cloud から保存済みワークフローを参照します | +| `get_saved_workflow` | 保存済みワークフローのノード、入力、カスタマイズ可能な設定を調べます | | `save_workflow` | ワークフローを Comfy Cloud アカウントに保存します | -| `update_workflow` | 既存のワークフローを新しいバージョンとしてその場で更新します（以前のバージョンは復元可能なまま保持されます） | -| `run_saved_workflow` | ファイル名を指定して保存済みワークフローを実行します。サーバーがエディタ形式から実行可能形式に自動変換します | +| `update_workflow` | 既存のワークフローを新しいバージョンとしてその場で更新します（以前のバージョンは引き続き復元可能です） | +| `run_saved_workflow` | ファイル名で保存済みワークフローを実行します。サーバーがエディター形式から実行可能形式に自動変換します | -### ワークフローの共有 +**ワークフローの共有** | ツール | 説明 | | --- | --- | | `share_workflow` | 保存済みワークフローを公開し、誰でも開ける `?share=` URL を返します | -| `import_shared_workflow` | 共有 URL または共有 ID をワークフロー JSON に解決し、オプションでアカウントに保存します | +| `import_shared_workflow` | 共有 URL または共有 ID をワークフロー JSON に解決し、必要に応じてアカウントに保存します | -**Hub URL 共有 ID：** `comfy.org/workflows/-` ハブ URL 内の末尾のハイフン区切り16進トークンが共有 ID です。たとえば、`comfy.org/workflows/topaz-starlight-upscale-1c77e82713b7` の共有 ID は `1c77e82713b7` です。そのトークンを `share_id` として `import_shared_workflow` に渡します。`share_url` パラメータは `https://cloud.comfy.org/?share=...` のような `?share=` クエリ URL のみを受け付け、ハブページ URL は受け付けません。 +**Hub URL 共有 ID:** `comfy.org/workflows/-` ハブ URL 内の末尾のハイフン区切り 16 進数トークンが共有 ID です。例えば、`comfy.org/workflows/topaz-starlight-upscale-1c77e82713b7` の共有 ID は `1c77e82713b7` です。そのトークンを `import_shared_workflow` の `share_id` として渡します。`share_url` パラメータは `?share=` クエリ URL（例：`https://cloud.comfy.org/?share=...`）のみ受け付け、ハブページ URL は受け付けません。 -### アプリとリンク +**アプリとリンク** | ツール | 説明 | | --- | --- | -| `create_app` | 保存済みワークフローをアプリモードのアプリに変換します。選択した入力と出力を持つ簡略化された「このワークフローを実行」ビューです | +| `create_app` | 保存済みワークフローを App Mode アプリに変換します。選択した入出力を持つ「このワークフローを実行」ビューです | | `get_app_mode_url` | ワークフローを実行可能なアプリとして開く安定したリンクを取得します | -| `get_workflow_canvas_url` | ワークフローを直接 Comfy Cloud のキャンバスで開き、表示、編集、実行できるリンクを取得します | +| `get_workflow_canvas_url` | ワークフローを Comfy Cloud キャンバス上で直接開き、表示・編集・実行がすぐに行えるリンクを取得します | -### アカウントとセッション +**アカウントとセッション** | ツール | 説明 | | --- | --- | -| `get_billing_status` | あなたのクレジット残高、サブスクリプション階層、請求リンクを確認します | -| `get_server_info` | エージェントが到達したサーバーを確認します（環境、ホスト、バージョン、認証状態） | -| `submit_feedback` | ベータ版フィードバック調査のリンクを取得します | -| `report_session_summary` | 匿名化されたセッションサマリーを Comfy チームと共有します。**あなたの明示的な同意がある場合のみ**。エージェントは事前に許可を求める必要があり、プロンプト、ファイルパス、個人情報は含まれません | +| `get_billing_status` | クレジット残高、サブスクリプションのプラン、請求リンクを確認します | +| `get_server_info` | エージェントが到達したサーバーを確認します：環境、ホスト、バージョン、認証状態 | +| `submit_feedback` | ベータフィードバックアンケートのリンクを取得します | +| `report_session_summary` | 匿名化されたセッションサマリーを Comfy チームと共有します。**あなたの明示的な同意がある場合のみ**行われます。エージェントはまず確認を求め、プロンプト、ファイルパス、個人情報は一切含まれません | - +**プロンプト（Claude Desktop）** -## クレジットと支出 +Claude Desktop は Claude Code のスラッシュコマンドをサポートしていません。代わりに、同じワークフロー用の**プロンプトピッカー**を開いてください: -検索は無料です: `search_templates`、`search_models`、`search_nodes` は [Comfy アカウント](https://cloud.comfy.org) だけで動作します。生成の実行には、有効な Comfy Cloud サブスクリプションが必要です。クレジットやトップアップの残高だけではアクセスできません。未使用のクレジットがあっても、生成を実行するには有効なサブスクリプションが必要です。 +| プロンプト | 説明 | +| --- | --- | +| `generate-image` | テキスト説明から画像を生成します | +| `generate-video` | テキストまたは画像から動画を生成します | +| `generate-audio` | 音声、音楽、効果音を生成します | +| `generate-3d` | テキストまたは画像から 3D モデルを生成します | +| `upscale-image` | 画像を高解像度にアップスケールします | +| `remove-background` | 画像から背景を削除します | +| `search-templates` | 事前構築済みワークフローテンプレートを検索します | +| `search-models` | モデル（checkpoint、LoRA、VAE）を検索します | +| `search-nodes` | ノードを検索し、配線の提案を取得します | +| `help` | ComfyUI Cloud で何ができるかを確認します | + +プロンプトをスキップして自然言語で依頼することもできます。MCP ツールは同様に動作します。 -実際にお金を使うツールは **出費制限付き** です。生成で有料パートナーモデル (`partner_generate`) や有料 API ノードを含むワークフロー/テンプレート (`run_template`、`run_saved_workflow`、`submit_batch`) を使用する場合、サーバーはエージェントがクレジットを消費することに同意したことを確認するまで実行をブロックします。そのため、それらの実行前にエージェントが確認を求めます。無料のローカルのみのワークフローはプロンプトを表示しません。 +### クレジットと利用料金 -いつでもエージェントに残高を尋ねることができます（「クレジットはいくつありますか？」）。エージェントは `get_billing_status` を通じて回答します。 +探索は無料です: `search_templates`、`search_models`、`search_nodes` は [Comfy アカウント](https://cloud.comfy.org) だけで動作します。生成の実行には有効な Comfy Cloud サブスクリプションが必要です。クレジットやチャージ残高だけではアクセスできません。未使用のクレジットがあっても、生成を実行するには有効なサブスクリプションが必要です。 -## 出力とダウンロード +### アップロードとダウンロード -MCP サーバーはクラウド上で動作し、**ファイルをあなたのマシンに書き込むことはありません**。生成が完了すると、エージェントが `get_output` を呼び出し、以下のものを返します。 +MCP サーバーはクラウド上で動作し、MCP 自体はあなたのマシンにファイルを書き込みません。生成が完了すると、エージェントが `get_output` を呼び出し、次のものを返します: -1. **短期間有効な署名付きダウンロード URL**（短い期間のみ有効）。 -2. **すぐに実行できるシェルコマンド**（macOS と Linux では `curl`、Windows では `curl.exe`）。 +1. **一時的な署名付きダウンロード URL**（短い有効期間）。 +2. すぐに実行できる**シェルコマンド**（macOS と Linux では `curl`、Windows では `curl.exe`）。 -エージェントはそのコマンドをシェルで実行します。コマンドには保存先のパスとファイル名が含まれています。 +エージェントはそのコマンドをシェルで実行する必要があります。コマンドには出力先のパスとファイル名が含まれています。 - 返されたコマンドは**そのまま**実行してください。署名付き URL を再エンコードしたり編集したりしないでください。署名はクエリ文字列に含まれており、URL を変更すると壊れます。 + 返されたコマンドは**そのまま**実行してください。署名付き URL を再エンコードしたり編集したりしないでください。署名はクエリ文字列に含まれており、URL が変更されると無効になります。 -MCP クライアントがシェルコマンドを実行できない場合（一部の GUI のみのセットアップ）、コマンドをコピーして、ターミナルで自分で実行してください。 +MCP クライアントがシェルコマンドを実行できない場合（一部の GUI 専用設定など）は、コマンドをコピーしてターミナルで自分で実行してください。 + +アセットのアップロードとダウンロードはクライアントのファイルアクセスに依存します。Claude Desktop や他のエージェントクライアントがアセットのアップロードやダウンロードで問題が発生した場合、エージェントのローカルファイルディレクトリへのアクセスに関係している可能性があります。Claude ユーザーには、より多くの機能を備えた **Claude Code**（デスクトップアプリまたはターミナル）を推奨します。同様に、他のエージェントファミリーでも、コーディングエージェントの方がウェブチャット版よりも通常優れています。 + + +### 既知の制限 + +Comfy Cloud MCP はアーリーリリースです。以下の制限は既知のものであり、現在対応が進められています: + +**ワークフロー** + +- **`submit_workflow` で生成されたアセットには、ワークフローのメタデータが埋め込まれない可能性があります。** ComfyUI で開いたときに元のワークフローが再現されないことがあります。 +- **ワークフローの構築精度はエージェントの正確さに依存します。** 複雑なマルチノードワークフローでは、再試行や調整が必要になる場合があります。 + +**ファイルの取り扱い** + +- **出力の取得にはシェルでのダウンロード手順が必要です。** [アップロードとダウンロード](#uploads-and-downloads) を参照してください。 +- **アップロードサイズの制限**は、使用する MCP クライアントによって適用される場合があります。クライアントによっては、ファイルアップロードに独自の制限を課すものもあります。 + +**認証** + +- **OAuth または API キー。** Claude Code と Claude Desktop では、1 回限りのブラウザ OAuth フローを使用します。**Cursor** では MCP 設定に Comfy Cloud API キーが必要です（OAuth 非対応）。その他のヘッドレスクライアントでは、代わりに `X-API-Key` ヘッダーで Comfy Cloud API キーを渡せます。ブラウザを開けないクライアント向けのデバイスコード OAuth フローが計画されています。 + + +## ローカル Comfy MCP 接続 + +オープンソースの接続です。クライアントがあなたのマシン上でサーバーを起動し、そこにインストールされている ComfyUI を操作します。 + +[**comfy-mcp**](https://github.com/Comfy-Org/comfy-mcp) は Comfy の**ファーストパーティローカル MCP サーバー**です。AI エージェント（Claude Code、Claude Desktop、Cursor、その他の MCP クライアント）から**ローカル** ComfyUI インストールを操作する公式の方法です。 + +クラウドやパートナーサーバーとは異なり、**自分のマシン**上で動作する ComfyUI と通信するため、あなたのワークフローを実行したり、インストールに実際に含まれるノード、カスタムノード、モデルを検査したりできます。 + + + **最速のセットアップ: エージェントに任せましょう。** AI クライアントに `https://docs.comfy.org/agent-tools/mcp#installation` を貼り付けて、ローカル接続のセットアップを依頼してください。 + + +### 要件 + +- **Python 3.10+** +- **[comfy-cli](https://github.com/Comfy-Org/comfy-cli)** を `PATH` 上にインストール（`pip install comfy-cli`）。すべてのツールがラップするエンジンです +- **ComfyUI ワークスペース**。ない場合は `comfy install` で作成します（既存のチェックアウトは `comfy set-default ` で動作します） +- **稼働中の ComfyUI**。ツールを使用する前に `comfy launch` で起動してください。ここで暗黙的に ComfyUI が起動することはありません + +--- + +### インストール + +[リポジトリ](https://github.com/Comfy-Org/comfy-mcp) をチェックアウトした状態で: + +```bash +pip install . # or `pip install -e .` for a working copy +``` + +これにより `comfy-mcp` コンソールスクリプトが `PATH` 上に追加されます。そのコマンドが MCP サーバーです（stdio 経由で MCP を扱います）。下記で AI クライアントをそれに接続します。 + + + **`COMFY_BIN`（オプション）。** MCP クライアントはサーバーを独自の環境で起動しますが、その環境には通常、シェルの `PATH` が**含まれていません**。`comfy` が virtualenv や標準的でない場所にある場合は、`COMFY_BIN` にその絶対パスを設定してください（例：`/path/to/venv/bin/comfy`）。以下のすべてのクライアント例で設定場所を示しています。クライアントがサーバーを起動する環境で `comfy` が既に利用可能なら、この設定は不要です。 + + +--- + +### 手動設定 + +すべてのクライアントは同一の MCP stdio 契約を使用します: `comfy-mcp` コマンドをサーバーとして実行します。クライアントを選択してください: + + + + `claude_desktop_config.json` を編集します（Settings → Developer → Edit Config。macOS では `~/Library/Application Support/Claude/claude_desktop_config.json` にあります）。サーバーを追加してから Claude Desktop を再起動します: + + ```json + { + "mcpServers": { + "comfy-mcp": { + "command": "comfy-mcp", + "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } + } + } + } + ``` + + + + 1 つのコマンドでサーバーを登録します: + + ```bash + claude mcp add comfy-mcp -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-mcp + ``` + + または、リポジトリルートに `.mcp.json` を置いてプロジェクトにチェックインします: + + ```json + { + "mcpServers": { + "comfy-mcp": { + "command": "comfy-mcp", + "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } + } + } + } + ``` + + + + `~/.cursor/mcp.json`（グローバル）または `.cursor/mcp.json`（プロジェクトごと）にサーバーを追加します: + + ```json + { + "mcpServers": { + "comfy-mcp": { + "command": "comfy-mcp", + "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } + } + } + } + ``` + + + +--- + +### クイックスタート + +ゼロから生成済み画像まで: + + + + ```bash + git clone https://github.com/Comfy-Org/comfy-mcp + cd comfy-mcp + pip install comfy-cli # the engine + comfy install # create a ComfyUI workspace (skip if you have one) + pip install . # this MCP server → the `comfy-mcp` command + ``` + + + ```bash + comfy launch + ``` + + + 上記のクライアント用スニペットを使用し、ツールが表示されるようにクライアントを再起動 / リロードします。 + + + 例えば: + + > "Confirm my local ComfyUI is running, then run the workflow at `~/workflows/txt2img.json` and show me the image." + + 内部的に、エージェントは `server_info` を呼び出して ComfyUI の稼働を確認し、`run_workflow` でワークフロー JSON を実行し、`fetch_outputs` で結果を取得します。 + + + +--- + +### ツール + +各ツールは `comfy-cli` コマンドに対応しており、`--where local` を指定して実行します。主なツール: + +| ツール | 目的 | +|---|---| +| `server_info()` | ローカル ComfyUI が稼働中か、場所、使用しているワークスペースを返します。**最初に呼び出してください。** | +| `run_workflow(workflow_path, wait=True)` | ワークフロー JSON を実行します。`wait=False` にすると非同期で送信され、`prompt_id` を返します。 | +| `job_status` / `wait_for_job` / `watch_job` | 送信されたジョブをポーリング、待機、またはストリームします。 | +| `fetch_outputs(prompt_id, out_dir)` | 完了したジョブの出力を `out_dir` にコピーします。 | +| `launch_comfyui` / `stop_comfyui` | ローカル ComfyUI を起動または停止します。 | +| `search_templates` / `fetch_template` | 組み込みテンプレートを検索し、実行可能なワークフロー JSON を書き出します。 | +| `search_nodes` / `get_node` / `list_nodes` | **稼働中のローカル** インストール（カスタムノードを含む）のノードクラスを検査します。 | +| `search_models` | ディスク上のモデルファイルを一覧表示します。 | +| `validate_workflow` | 低速な実行の前に、稼働中の `object_info` に対してワークフローを事前検証します。 | + +ノードのイントロスペクションとモデル検索は、**稼働中のインストール**（カスタムノードを含む）を参照します。これがクラウド接続とのローカルの違いです。ツールの完全な一覧とリファレンスについては [リポジトリ](https://github.com/Comfy-Org/comfy-mcp) を参照してください。 + +--- + ## 関連リソース | リソース | 用途 | | --- | --- | -| [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) | Claude Code プラグインマーケットプレイスおよびコミュニティスキルライブラリ。上記で使用した **comfy-cloud** プラグインはこちらで配布されています。Comfy ワークフロー用の追加スキルをブラウズしたり、コントリビュートすることができます。 | -| [Comfy Cloud on ClawHub](https://clawhub.ai/comfy-org/skills/comfy) | ホスト型 Comfy Cloud MCP サーバー用の OpenClaw スキル（`openclaw skills install @comfy-org/comfy`）。 | -| [Comfy CLI](/ja/agent-tools/cli) | ローカル ComfyUI のインストール/起動、およびスクリプトや CI からホスト型パートナーノードを呼び出すためのコマンドラインツール（`comfy generate`、ベータ版）。ターミナルや自動化ワークフローが必要な場合に MCP を補完します。 | -| [Share a workflow on Comfy Cloud](/ja/cloud/share-workflow) | Comfy Cloud UI からワークフローを共有します（MCP の `share_workflow` ツールがエージェントセッションからこれを実行します）。 | +| [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) | Claude Code プラグインマーケットプレイスとコミュニティスキルライブラリ。上で使用している **comfy-cloud** プラグインはここで配布されています。Comfy ワークフロー用のスキルを参照したり、追加したりできます。 | +| [Comfy Cloud on ClawHub](https://clawhub.ai/comfy-org/skills/comfy) | ホストされた Comfy Cloud MCP サーバー向け OpenClaw スキル（`openclaw skills install @comfy-org/comfy`）。 | +| [Comfy CLI](/ja/agent-tools/cli) | ローカル ComfyUI のインストール / 起動や、スクリプトや CI からホストされたパートナーノードを呼び出すためのコマンドラインツール（`comfy generate`、ベータ版）。ターミナルや自動化のワークフローが必要な場合に MCP を補完します。 | +| [Share a workflow on Comfy Cloud](/ja/cloud/share-workflow) | Comfy Cloud UI からワークフローを共有します（MCP の `share_workflow` ツールはエージェントセッションから同様の操作を行います）。 | -## 関連: Comfy In-App Agent +## 関連: Comfy アプリ内エージェント -外部の MCP クライアントではなく、Comfy Cloud **内**のエージェント体験（チャットでグラフを構築・編集）をお探しですか？ +Comfy Cloud **内部**で、外部 MCP クライアントではなく、エージェント体験（チャットでグラフを構築・編集）が必要ですか？ - Comfy Cloud のプライベートアルファ。ウェイトリストに参加してアクセスをリクエストしてください。 + Comfy Cloud でのプライベートアルファ。ウェイトリストに参加してアクセスをリクエストしてください。 ## フィードバック -Comfy Cloud MCP は公開ベータ版です。ぜひ試してみて、うまくいく点とそうでない点をお知らせください： +Comfy MCP はパブリックベータです。ぜひ試してみて、うまくいっている点や改善すべき点をお知らせください: -- **[フィードバックアンケート](https://links.comfy.org/cloudmcpbeta)**: バグの報告、機能要望、一般の感想の共有など。 -- **Discord**: [#comfy-mcp-and-cli](https://discord.gg/xWJn6nhE3R)（Comfy Discord 内）質問やディスカッション用。 +- **[Feedback survey](https://links.comfy.org/cloudmcpbeta)**: バグの報告、機能のリクエスト、一般的なご感想の共有。 +- **Discord**: ご質問やディスカッションは Comfy Discord の [#comfy-mcp-and-cli](https://discord.gg/xWJn6nhE3R) チャンネルで。 -## 既知の制限事項 +## FAQ -Comfy Cloud MCP は初期リリースです。以下の制限事項は既知であり、現在対応中です： +### はじめに -**ワークフロー** + + + MCP 互換クライアントならどれでも利用できます。 -- **エディタ形式から実行可能形式への変換にはまだ粗い部分があります。** 保存済みワークフローは `run_saved_workflow` によりファイル名で実行できます（サーバーが自動的に変換します）が、一部のノード構成では変換が不完全な場合があります。 -- **`submit_workflow` 経由で生成されたアセットにはワークフローメタデータが埋め込まれない場合があります。** ComfyUI で開いたときに元のワークフローが復元されない可能性があります。 -- **ワークフローの構築はエージェントの精度に依存します。** 複雑なマルチノードワークフローでは、リトライや微調整が必要になる場合があります。 + **クラウド接続**にはリモート HTTP サポートが必要です。**Claude Code**、**Claude Desktop**、**Cursor**、**Codex**、**OpenClaw** には上記のファーストクラスセットアップ手順が用意されています。**Windsurf**、**Amp** などは OAuth または API キーを使用した同じ URL を利用します。 -**ファイル処理** + **ローカル接続**では、クライアントがサブプロセスとしてローカル stdio サーバーを起動できる必要があります。これによりブラウザベースのクライアントは除外されます。[claude.ai](https://claude.ai) と ChatGPT はリモートコネクタのみを受け付けます。 + + + クラウド接続は `https://cloud.comfy.org/mcp` で動作します。 -- **出力にはシェルダウンロード手順が必要です。** [出力とダウンロード](#outputs-and-downloads) を参照してください。 -- **アップロードサイズ制限** が MCP クライアントによって適用される場合があります。一部のクライアントはファイルアップロードに独自の制限を設けています。 + ローカル接続には URL がありません。クライアントが `comfy-mcp` コマンドを直接起動し、stdio で通信します。 + + + はい。それが [ローカル Comfy MCP 接続](#local-comfy-mcp-connection) です。あなたのマシンにインストールされている ComfyUI を操作するため、エージェントは実際に所有しているモデル、LoRA、カスタムノードを認識し、あなたの GPU 上で実行します。 + + + はい。ローカルで ComfyUI を実行している場合におすすめです。ほとんどのクライアントは 2 つの MCP サーバーを問題なくホストでき、エージェントはそれらを区別して扱います。各接続はそれぞれ独自のワークフローを実行し、独自の結果を返します。 -**認証** + ただし、2 つのサインインは**別々**です。どちらか一方でサインインしても、もう一方でもサインインされるわけではありません。同じ Comfy アカウントであっても同様です。 + + + エージェントに尋ねてください。エージェントは重い処理を開始する前に、あなたのハードウェアを読み取ります。 + + **Mac** では、生成にクラウド接続を使用してください: 現在のオープンウェイトモデルは Apple GPU 上で実用的な速度で動作するには大きすぎます。**専用グラフィックスカードを搭載した PC** では、VRAM 24 GB 以上あれば動画を含むほとんどの処理が可能です。8〜24 GB では画像は問題ありませんが、動画は遅くなるか処理しきれません。8 GB 未満の場合はクラウドをご利用ください。 + + + クラウド接続は**パブリックベータ版**です。API、ツール、動作は開発中に変更される可能性があります。問題を報告するには [フィードバック](#feedback) をご覧ください。 + + -- **OAuth または API キー。** Claude Code および Claude Desktop は、1回限りのブラウザ OAuth フローを使用します。**Cursor** は、MCP 設定で Comfy Cloud API キーを必要とします（OAuth なし）。その他のヘッドレスクライアントは、代わりに `X-API-Key` ヘッダー経由で Comfy Cloud API キーを渡すことができます。ブラウザを開けないクライアント向けのデバイスコード OAuth フローが計画されています。 +### コストとアクセス -## FAQ + + + 探索はどちらの接続でも無料です。テンプレート、モデル、ノードの検索には Comfy アカウントのみが必要です。 + + **クラウド接続**では、生成の実行には有効な Comfy Cloud サブスクリプションが必要です。新規ユーザーには 5 回の無料実行が提供されます。**ローカル接続**では、実行はあなたのハードウェア上で行われるため無料です。ただし 1 つ例外があります: パートナーモデルはパートナーのインフラストラクチャ上で実行され、クレジットを消費します。 + + + OAuth をサポートする対話型クライアント（Claude Code、Claude Desktop、Codex、OpenClaw など）では不要です。 + + **Cursor** では MCP 設定に Comfy Cloud API キーが必要です。そこではまだ MCP OAuth は利用できません。ブラウザのないヘッドレス環境や CI セットアップでも同様に必要です。[クラウド接続のセットアップ](#set-up-the-cloud-connection) の **Cursor** タブと**その他のクライアント**タブを参照してください。 + + + +### 使い方 - - MCP に対応し、リモート HTTP トランスポートをサポートしているクライアントはすべて `https://cloud.comfy.org/mcp` に接続できます。**Claude Code**、**Claude Desktop**、**Cursor**、**Codex**、**OpenClaw** のセットアップ方法を文書化しています。**Windsurf**、**Amp** などの他のエージェントも、同じ URL に OAuth または APIキーで接続します。詳細は [Comfy Cloud MCP のインストール](#install-comfy-cloud-mcp) を参照してください。 + + MCP ツールを自分で呼び出す必要はありません。エージェントが依頼内容に基づいて適切なものを選択します。通常は、利用可能なものを**探索**し（`search_templates`、`search_models`、`search_nodes`）、生成を**実行**し、出力を**待機して取得**します。[エージェントができること](#what-your-agent-can-do) を参照してください。 - - OAuth に対応した対話型クライアント（Claude Code、Claude Desktop、Codex、OpenClaw など）では不要です。**Cursor** では、MCP 設定に Comfy Cloud の APIキーが必要です。APIキーは、ブラウザのないヘッドレス環境や CI 環境でも必要です。詳細は [Comfy Cloud MCP のインストール](#install-comfy-cloud-mcp) の **Cursor** タブ、**OpenClaw** タブ、または **その他のクライアント** タブを参照してください。 + + **クラウド接続**では、サーバーはあなたのマシンに書き込みません。`get_output` は一時的な署名付き URL と、シェルで実行するためのダウンロードコマンドを返します。[アップロードとダウンロード](#uploads-and-downloads) を参照してください。 + + **ローカル接続**では、ComfyUI がワークスペースの `output/` ディレクトリに書き込み、`fetch_outputs(prompt_id, out_dir)` で完了したジョブのファイルを指定の場所にコピーします。 - - 有料の生成は支出ゲートの対象です：実行が Comfy Cloud のクレジットを消費する場合（パートナーモデル、または有料 API ノードを含むワークフロー/テンプレート）、サーバーは実行前に明示的な同意を必要とします。詳細は [クレジットと支出](#credits-and-spending) を参照してください。 + + 元に戻す必要はありません。最初の接続に加えて 2 つ目の接続を追加してください。 + + **ローカル → クラウド**（Cloud GPU やパートナーモデルが必要な場合）: エージェントにサインインを依頼し、クライアントに `https://cloud.comfy.org/mcp` を追加してください。 + + **クラウド → ローカル**（自分のモデルとカスタムノードを使いたい場合）: ComfyUI とローカルサーバーをインストールし、クライアントをそのサーバーに向けてください。エージェントがこれらの作業のほとんどを行ってくれます。 - - いいえ。スラッシュコマンドは Claude Code プラグインに含まれています。Claude Desktop は同じ MCP サーバーに接続します（ツールはプレーン言語で質問するか、プロンプトピッカーを使えば機能します）が、Claude Code プラグインやスラッシュコマンドはサポートしていません。 + + エージェントに尋ねるだけです。両方の接続を追加したら、ジョブをどこで実行するかを伝えます。「これは Comfy Cloud で実行して」「これはローカルでやって」と言えば、適切な接続を使います。切り替えるモードはなく、実行のたびに再設定する必要もありません。 + + ワークフローがマシンに対して重すぎることが判明した場合、エージェントがそれを伝え、代わりに Comfy Cloud で実行するよう提案してくれます。また、1 つの接続しか設定されていない場合は、もう一方を追加するよう依頼してください。[クラウド接続のセットアップ](#set-up-the-cloud-connection) または [ローカル Comfy MCP 接続](#local-comfy-mcp-connection) を参照してください。 - - `/comfy` や `/cloud` というコマンドはありません。コマンドは、接続方法に応じて2つのプレフィックスのいずれかに表示されます。 + + **クラウド接続**では、何もする必要はありません。ホストされているため、常に最新バージョンが利用可能です。 - - **プラグイン（推奨）：** `/comfy-cloud:generate-image`、`/comfy-cloud:generate-video` … — すべて表示するには `/comfy-cloud:` と入力してください。 - - **直接接続（プラグインなし）：** `/mcp__comfy-cloud__generate-image` … — 表示するには `/mcp__` と入力してください。 + **ローカル接続**では、エージェントに対処を依頼してください。その後、**クライアントを再起動**するか新しいセッションを開始します。MCP サーバーはセッション開始時に読み込まれるため、実行中のものは再起動するまで古いバージョンを提供し続けます。 + + + +### トラブルシューティング + + + + いいえ。スラッシュコマンドは Claude Code プラグインに含まれています。Claude Desktop は同じ MCP サーバーに接続します。自然言語で依頼したりプロンプトピッカーを使えばツールは動作しますが、Claude Code プラグインやスラッシュコマンドはサポートされていません。 + + + `/comfy` や `/cloud` というコマンドはありません。コマンドは接続方法に応じて、次の 2 種類の接頭辞のいずれかで表示されます: - どちらの場合でも、プレーン言語で質問するだけでも構いません（「...の画像を生成して」など）。MCP ツールはモデルによって呼び出されるため、スラッシュコマンドは必要ありません。 + - **プラグイン（推奨）:** `/comfy-cloud:generate-image`、`/comfy-cloud:generate-video`、…。`/comfy-cloud:` と入力するとすべて表示されます。 + - **直接接続（プラグインなし）:** `/mcp__comfy-cloud__generate-image`、…。`/mcp__` と入力すると表示されます。 + + いずれの場合も、自然言語で依頼するだけで使えます（「…の画像を生成」など）。MCP ツールはモデルが呼び出すもので、スラッシュコマンドは必要ありません。 - Claude Code では、`/mcp` を実行し、**comfy-cloud** を選択し、**認証** を選びます。Claude Desktop では、**カスタマイズ → コネクタ** からコネクタを再度開き、サインインをトリガーします。 - - - Comfy Cloud MCP は当社のホスティングサービスですが、ローカルエージェントワークフローは ComfyUI がオープンソース化されて以来存在しています。なぜクラウドが先にリリースされたか、現在使用できるコミュニティ MCP サーバー、および別のオプションとして [Comfy CLI](/ja/agent-tools/cli) については、Agent Tools の概要ページの [ローカル ComfyUI について](/ja/agent-tools#what-about-local-comfyui) を参照してください。 + Claude Code では `/mcp` を実行し、**comfy-cloud** を選択して **Authenticate** を選びます。Claude Desktop では、**Customize → Connectors** からコネクタを再び開いてサインインをトリガーします。 diff --git a/ja/agent-tools/skills.mdx b/ja/agent-tools/skills.mdx new file mode 100644 index 000000000..0257e8c24 --- /dev/null +++ b/ja/agent-tools/skills.mdx @@ -0,0 +1,25 @@ +--- +title: "スキル" +sidebarTitle: "スキル" +description: "Comfy Skills リポジトリを通じて公開される、Comfy のエージェントスキルとプラグイン。" +icon: "wand-magic-sparkles" +translationSourceHash: 6ebd0106 +translationFrom: agent-tools/skills.mdx +--- + +[**Comfy Skills**](https://github.com/Comfy-Org/comfy-skills) は、Comfy のエージェントスキルとプラグインの拠点です。スキルとは、エージェントが必要に応じて読み込むパッケージ化された知識で、モデルのガイダンス、ワークフローのパターン、既製のコマンドなどが含まれます。プロンプトをゼロから書かなくても、あらゆるエージェントが ComfyUI をより上手く扱えるようになります。 + +このリポジトリには以下が含まれています： + +- **Claude Code プラグイン**：例えば **comfy-cloud** があります。これは Comfy Cloud MCP 接続と `/comfy-cloud:*` スラッシュコマンドを一度のインストールで追加します。 +- **エージェントスキル**：特定のタスク向けの焦点を絞った指示。現在のモデルの推奨やワークフロー構築のノウハウなど、モデルの変更に合わせて最新の状態に保たれます。 +- **コミュニティからの貢献**：Comfy コミュニティによるスキルとプラグイン。 + +Claude Code で使用するには： + +``` +/plugin marketplace add Comfy-Org/comfy-skills +/plugin install comfy-cloud@comfy-skills +``` + +プラグインのスラッシュコマンドとセットアップの詳細については、[Comfy MCP](/ja/agent-tools/mcp) を参照してください。 \ No newline at end of file diff --git a/ja/development/overview.mdx b/ja/development/overview.mdx index 3b8e17328..11900a456 100644 --- a/ja/development/overview.mdx +++ b/ja/development/overview.mdx @@ -1,18 +1,21 @@ --- title: "概要" description: "開発者としての ComfyUI の利用" -translationSourceHash: 4d431c1f +translationSourceHash: 5514e159 translationFrom: development/overview.mdx translationBlockHashes: "_intro": 21d39346 "Deploy ComfyUI as a Server": 07693c4c "Cloud API": 80dab2ed - "Agent Tools / MCP": e325a91e + "Agent Tools / MCP": abe9d443 "Comfy CLI": 11578ce8 "Develop Custom Nodes": 51cd210e "Registry": cc46f1e1 --- + + + ComfyUI はモジュール式の GenAI 推論エンジンです。API サーバーとしてデプロイしたり、API 経由でアクセスしたり、カスタムノードで拡張したり、コマンドラインから管理したりできます。目的に合ったパスを選んでください。 ## ComfyUI をサーバーとしてデプロイ @@ -37,13 +40,13 @@ ComfyUI はモジュール式の GenAI 推論エンジンです。API サーバ ## Agent Tools / MCP -Model Context Protocol（MCP）を介して AI エージェントを ComfyUI に接続。ホスト型 Cloud MCP から始めるか、Local MCP と Comfy CLI で他の構成に対応できます。 +Model Context Protocol（MCP）を介して AI エージェントを ComfyUI に接続します。ホスト型 Cloud MCP から始めるか、Local MCP と Comfy CLI で他の構成に対応できます。 Cloud MCP、Local MCP、Comfy CLI を比較し、AI エージェント統合に最適な構成を見つけます。 -関連リンク：[Comfy Cloud MCP](/ja/agent-tools/mcp) · [Comfy Local MCP](/ja/agent-tools/local) +関連リンク：[Comfy MCP](/ja/agent-tools/mcp): クラウド接続とローカル接続 ## Comfy CLI diff --git a/ko/agent-tools/cli.mdx b/ko/agent-tools/cli.mdx index 764a7f185..5500d1da0 100644 --- a/ko/agent-tools/cli.mdx +++ b/ko/agent-tools/cli.mdx @@ -3,11 +3,11 @@ title: "Comfy CLI" description: "터미널에서 Comfy를 구동하세요: 로컬 ComfyUI, 파트너 생성 호출, Comfy Cloud의 전체 워크플로. 스크립트, CI, 자동화에서 MCP를 보완합니다." sidebarTitle: "Comfy CLI" icon: "terminal" -translationSourceHash: 03991204 +translationSourceHash: bc3e7c14 translationFrom: agent-tools/cli.mdx translationBlockHashes: "_intro": cb162cdd - "How it fits with MCP": a426486a + "How it fits with MCP": a452f8fb "What the CLI does": 3c8cfc5f "Install and set up": 4c281b95 "Prerequisites for `comfy generate`": 66aa291a @@ -16,10 +16,12 @@ translationBlockHashes: "Usage examples": f6768bfe "Beyond `comfy generate`": 8e75f6a8 "Agent skills": 5cfcfe55 - "Related resources": e600c92d + "Related resources": d4e97516 "Feedback": fce347e2 --- + + import GenerateBetaInfo from "/snippets/ko/comfy-cli/generate-beta-info.mdx"; import AgentSkills from "/snippets/ko/comfy-cli/agent-skills.mdx"; import InstallCli from "/snippets/ko/install-comfycli.mdx"; @@ -42,14 +44,14 @@ import GenerateVideoAsync from "/snippets/ko/comfy-cli/generate-video-async.mdx" ## MCP와의 연동 -| | Comfy Cloud MCP | Comfy CLI | +| | Comfy MCP(클라우드) | Comfy CLI | |---|---|---| | **인터페이스** | MCP 클라이언트(Claude Code, Claude Desktop 등)와 채팅 | 터미널 명령 및 스크립트 | | **최적 사용** | 채팅 내 대화형 에이전트 워크플로 | 자동화, 배치 실행, CI, 셸 파이프라인 | | **인증** | MCP 클라이언트의 OAuth 또는 API 키(헤드리스) | `comfy cloud login`(OAuth) 또는 API 키(CI) | | **출력** | 채팅 세션에 반환 | 디스크에 저장(`--download`) 또는 JSON(`--json`) | -MCP 설정, 설치, 도구 목록 및 인증 방법은 [Comfy Cloud MCP](/ko/agent-tools/mcp)를 참조하세요. +MCP 설정, 설치, 도구 목록 및 인증 방법은 [Comfy MCP](/ko/agent-tools/mcp)를 참조하세요. ## CLI 기능 @@ -151,7 +153,7 @@ comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url' |---|---| | [Comfy CLI 시작하기](/ko/comfy-cli/getting-started) | **전체** 설치 가이드 및 명령 안내 | | [Comfy CLI 참조](/ko/comfy-cli/reference) | 명령, 플래그, 모델 별칭 | -| [Comfy Cloud MCP](/ko/agent-tools/mcp) | MCP를 통해 에이전트를 연결하여 채팅 기반 생성 | +| [Comfy MCP](/ko/agent-tools/mcp) | MCP를 통해 에이전트를 연결하여 채팅 기반 생성 | | [GitHub의 comfy-cli](https://github.com/Comfy-Org/comfy-cli) | 소스 저장소, 이슈, 최신 동작 | ## 피드백 diff --git a/ko/agent-tools/in-app-agent.mdx b/ko/agent-tools/in-app-agent.mdx index 4c7103c90..46c8e03da 100644 --- a/ko/agent-tools/in-app-agent.mdx +++ b/ko/agent-tools/in-app-agent.mdx @@ -3,7 +3,7 @@ title: "Comfy 인앱 에이전트" sidebarTitle: "인앱 에이전트" description: "Comfy Cloud에서 Comfy 인앱 에이전트 비공개 알파 대기자 명단에 참여하세요." icon: "comments" -translationSourceHash: 6f0c61ab +translationSourceHash: 4eff238a translationFrom: agent-tools/in-app-agent.mdx --- @@ -11,7 +11,7 @@ translationFrom: agent-tools/in-app-agent.mdx **비공개 알파.** Comfy 인앱 에이전트는 제한된 사용자 그룹에 순차적으로 배포되고 있습니다. 공개 문서 및 웹사이트 페이지는 아직 사용할 수 없습니다. 액세스를 요청하려면 대기자 명단에 참여하세요. -**Comfy 인앱 에이전트**는 Comfy Cloud 내의 에이전트 경험입니다: 채팅으로 프롬프트를 입력하면 에이전트가 그래프에서 워크플로를 빌드하거나 편집할 수 있습니다(생성 전 확인 필요). +**Comfy 인앱 에이전트**는 Comfy Cloud 내의 에이전트 경험입니다: 채팅으로 프롬프트를 입력하면 에이전트가 그래프에서 워크플로를 빌드하거나 편집할 수 있습니다. ## 대기자 명단 참여 @@ -32,10 +32,10 @@ translationFrom: agent-tools/in-app-agent.mdx Claude, Cursor, Codex 및 기타 MCP 클라이언트(ComfyUI 캔버스 외부)에서 작동하는 에이전트 도구를 찾고 계신가요? - - 외부 MCP 클라이언트를 Comfy Cloud에 연결하여 생성, 검색, 워크플로에 사용하세요. + + 외부 MCP 클라이언트를 ComfyUI에 연결하여 생성, 검색, 워크플로에 사용하세요. - - Cloud MCP, Local MCP, Comfy CLI를 비교합니다. + + 클라우드 연결, 로컬 연결, 인앱 에이전트를 비교합니다. - + \ No newline at end of file diff --git a/ko/agent-tools/index.mdx b/ko/agent-tools/index.mdx index 9fe4f3599..3fdbbacac 100644 --- a/ko/agent-tools/index.mdx +++ b/ko/agent-tools/index.mdx @@ -1,84 +1,51 @@ --- -title: "Agent Tools / MCP" -description: "AI 에이전트를 모델 컨텍스트 프로토콜(MCP)을 통해 ComfyUI에 연결하여 이미지, 비디오, 오디오 및 3D 콘텐츠를 생성합니다." +title: "에이전트 도구" +description: "AI 에이전트를 활용해 ComfyUI를 더 스마트하고 빠르게 사용하세요. Comfy MCP, Comfy CLI, Comfy In-App Agent." sidebarTitle: "개요" icon: "robot" -translationSourceHash: f467366b +translationSourceHash: 8c401b64 translationFrom: agent-tools/index.mdx -translationBlockHashes: - "_intro": 9db234db - "Which One Should I Use?": 7b3ab710 - "What about local ComfyUI?": 6e518082 - "What is MCP?": bb62fbe5 --- -ComfyUI는 **MCP 서버**와 **Comfy CLI**를 제공하여 AI 에이전트와 개발자가 항상 ComfyUI 캔버스를 열지 않고도 이미지, 비디오, 오디오 및 3D 콘텐츠를 생성할 수 있도록 합니다. - - - **Comfy Cloud MCP는 퍼블릭 베타입니다.** 설정, 피드백 채널 및 관련 도구(Comfy Skills, Comfy CLI)에 대한 내용은 [Comfy Cloud MCP](/ko/agent-tools/mcp) 페이지에서 확인하세요. - - - - **Comfy In-App Agent는 프라이빗 알파입니다.** 전체 문서는 아직 공개되지 않았습니다. [대기자 명단에 등록](/ko/agent-tools/in-app-agent)하여 액세스를 요청하세요. - - - - cloud.comfy.org/mcp에서 호스팅된 MCP 서버에 연결하세요. 클라우드 GPU에서 이미지, 비디오, 오디오 및 3D를 생성하고, 템플릿/모델/노드를 검색하며, 워크플로를 실행하고, 채팅에서 저장된 워크플로를 공유할 수 있습니다. + + Comfy Cloud 또는 자신의 머신에서 모든 AI 에이전트를 ComfyUI에 연결하세요. **여기서 시작하세요.** - Comfy Cloud 내에서의 에이전트 경험(채팅으로 그래프를 빌드하고 편집). 프라이빗 알파; 현재는 대기자 명단만 가능. - - - comfy-cli를 통해 사용자 **자신의** ComfyUI 설치를 구동하는 자사 로컬 MCP 서버입니다. 비공개 테스트; 아직 공개적으로 사용할 수 없습니다. + Comfy Cloud 내부의 에이전트 경험(채팅이 그래프를 빌드하고 편집합니다). *비공개 알파; 현재는 대기자 명단만 가능합니다.* - comfy generate에 대한 에이전트 중심의 간략한 개요입니다. 전체 CLI 가이드는 [시작하기](/ko/comfy-cli/getting-started)를 참조하세요. + 터미널에서 ComfyUI를 사용하세요. ComfyUI 설치 및 업데이트, 모델 및 노드 관리, 스크립트·CI·배치 작업에서 생성할 수 있습니다. -## 어떤 것을 사용해야 할까요? - -| | Comfy Cloud MCP | Comfy Local MCP | Comfy CLI | -|---|---|---|---| -| **유형** | 원격(호스팅) | 로컬 MCP 서버 | 로컬 CLI | -| **필요사항** | Comfy Cloud 구독 | 로컬 ComfyUI + [comfy-cli](https://github.com/Comfy-Org/comfy-cli) | [Comfy API 키](/ko/development/api-development/getting-an-api-key) | -| **모델** | Comfy Cloud 모델(사전 설치됨) | 로컬 모델 및 커스텀 노드 | `comfy generate`를 통한 파트너 노드 | -| **워크플로** | 전체 ComfyUI 워크플로 실행 | 전체 로컬 ComfyUI 워크플로 실행 | 일회성 파트너 API 호출 (워크플로 JSON 불필요) | -| **GPU** | 클라우드 GPU (로컬 GPU 필요 없음) | 로컬 GPU | GPU 불필요 (API 기반) | -| **최적 사용처** | 채팅 기반 에이전트, 템플릿 검색 | 채팅으로 로컬 ComfyUI 구동 | 스크립트, CI, 배치 작업 | - --- -## 로컬 ComfyUI는 어떻게 하나요? - -Comfy Cloud MCP 대신(또는 함께) **로컬** ComfyUI 설치를 에이전트로 구동하고 싶으신가요? 자체(first-party) 로컬 MCP 서버, 설정 및 클라이언트 구성은 [**Comfy Local MCP**](/ko/agent-tools/local)를 참조하세요. 현재 **비공개 테스트** 중이며 아직 공개적으로 사용할 수 없습니다. - -**커뮤니티 MCP 서버.** 여러 커뮤니티 프로젝트도 MCP 클라이언트를 로컬 ComfyUI 인스턴스에 연결합니다: - -| 프로젝트 | 저장소 | -| --- | --- | -| comfyui-mcp | [artokun/comfyui-mcp](https://github.com/artokun/comfyui-mcp) | -| comfyui-mcp | [shawnrushefsky/comfyui-mcp](https://github.com/shawnrushefsky/comfyui-mcp) | -| comfyui-mcp-server | [joenorton/comfyui-mcp-server](https://github.com/joenorton/comfyui-mcp-server) | -| comfy-mcp-server | [lalanikarim/comfy-mcp-server](https://github.com/lalanikarim/comfy-mcp-server) | +## 어떤 것을 사용해야 할까요? -이들은 **커뮤니티 유지보수** 프로젝트입니다. 편의를 위해 링크를 제공합니다; 지원, 기능, 호환성은 프로젝트마다 다릅니다. +| | Comfy MCP
클라우드 연결 | Comfy MCP
로컬 연결 | Comfy In-App Agent | +|---|---|---|---| +| **설명** | 자신의 에이전트로 Comfy Cloud 워크플로를 실행합니다. | 자신의 에이전트로 자신의 로컬 ComfyUI를 구동합니다. | 앱 안에서 AI와 채팅하고 AI가 워크플로를 빌드하고 실행하는 것을 지켜보세요. | +| **최적 사용 대상** | ComfyUI를 로컬에 설정하고 싶지 않은 초보자.
워크플로를 공유하려는 사람. | ComfyUI를 로컬에 보유한 사람.
비공개 커스텀 노드를 가진 사람.
로컬 파일 시스템과 상호작용해야 하는 사람. | 초보자부터 고급 워크플로 빌더까지 모든 사람.
캔버스를 보고 워크플로를 시각적으로 확인하려는 사람. | +| **요구 사항** | 자신의 에이전트.
활성 Comfy Cloud 구독. | 자신의 에이전트.
로컬 ComfyUI 설정. | 설정 불필요.
활성 Comfy Cloud 구독. | +| **GPU** | 클라우드 GPU(하드웨어 요구 사항 없음) | 로컬 GPU | 클라우드 GPU(하드웨어 요구 사항 없음) | +| **모델** | Comfy Cloud 모델.
나만의 모델을 가져올 수 있습니다. | 사용자 머신에 다운로드된 로컬 모델. | Comfy Cloud 모델.
나만의 모델을 가져올 수 있습니다. | +| **커스텀 노드** | Comfy Cloud에서 지원되는 커스텀 노드. | 모든 커스텀 노드를 설치할 수 있습니다. | Comfy Cloud에서 지원되는 커스텀 노드. | -**채팅 대신 터미널 워크플로를 원하시나요?** 스크립트 및 자동화를 위해 [Comfy CLI](/ko/agent-tools/cli)(`comfy generate`, 베타)를 참조하세요. 터미널에서 로컬 ComfyUI를 설치하고 시작하려면 [Comfy CLI 시작하기](/ko/comfy-cli/getting-started)부터 시작하세요. +두 MCP 열은 **동일한 제품이자 동일한 페이지**입니다. 하나를 선택하려면 [Comfy MCP](/ko/agent-tools/mcp)를 참조하세요. 두 가지를 동시에 연결할 수 있습니다. --- ## MCP란 무엇인가요? -**모델 컨텍스트 프로토콜(MCP)**은 AI 비서가 표준화된 인터페이스를 통해 외부 도구 및 서비스와 상호작용할 수 있도록 하는 오픈 표준입니다. AI 에이전트가 모든 서비스의 맞춤형 API 형식을 알아야 하는 대신, MCP는 도구를 공통적으로 노출하는 일관된 방법을 제공합니다. +**모델 컨텍스트 프로토콜(MCP)**은 AI 비서가 표준화된 인터페이스를 통해 외부 도구 및 서비스와 상호작용할 수 있도록 하는 오픈 표준입니다. AI 에이전트가 모든 서비스의 맞춤형 API 형식을 알아야 하는 대신, MCP는 도구를 노출하는 일관된 방법을 제공합니다. -MCP 서버를 Claude Desktop, Claude Code, Cursor 또는 Amp와 연결하면 AI 비서는 다음과 같은 작업을 수행할 수 있습니다: +MCP 서버를 Claude Desktop, Claude Code, Cursor 또는 Amp에 연결하면 AI 비서는 다음을 수행할 수 있습니다: - 텍스트 설명으로 **이미지 생성** -- 텍스트 또는 이미지로 **비디오 제작** +- 텍스트 또는 이미지로 **비디오 생성** - 텍스트 또는 이미지로 **3D 모델 생성** - AI 모델을 사용해 **오디오 및 음악 생성** - 작업에 적합한 도구를 찾기 위해 **모델 및 템플릿 검색** -...이 모든 것을 자연어 대화를 통해 수행하며, API 호출을 직접 작성할 필요가 없습니다. +...이 모든 것을 자연어 대화를 통해 수행하며, API 호출을 수동으로 작성할 필요가 없습니다. diff --git a/ko/agent-tools/local.mdx b/ko/agent-tools/local.mdx deleted file mode 100644 index 30ec7d1f2..000000000 --- a/ko/agent-tools/local.mdx +++ /dev/null @@ -1,163 +0,0 @@ ---- -title: "Comfy Local MCP" -sidebarTitle: "Local MCP" -description: "자신의 로컬 ComfyUI를 AI 에이전트(Claude Code, Claude Desktop, Cursor)에서 구동하세요. 공식 comfy-local-mcp 서버를 사용하여 워크플로를 실행하고, 출력을 수집하며, 실제 설치된 노드와 모델을 검사할 수 있습니다." -icon: "server" -translationSourceHash: 996d6408 -translationFrom: agent-tools/local.mdx -translationBlockHashes: - "_intro": c57ebd12 - "Requirements": d93ce096 - "Installation": 09f9ec59 - "Configure your AI client": 69542371 - "Quickstart": 80f22916 - "Tools": f40c9da1 - "Related": 257416f6 ---- - - - **비공개 테스트.** `comfy-local-mcp`는 비공개 테스트 중이며 아직 공개적으로 사용할 수 없습니다. 비공개 테스트 접근 권한이 없다면 오늘 설치하거나 사용할 수 없습니다. 핵심 루프(`server_info → run_workflow → fetch_outputs`)는 실제 로컬 ComfyUI에 대해 종단 간 검증되었지만, 도구와 동작은 변경될 수 있습니다. - - -[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp)는 Comfy의 **공식 로컬 MCP 서버**로, AI 에이전트(Claude Code, Claude Desktop, Cursor 및 기타 MCP 클라이언트)에서 **로컬** ComfyUI 설치를 구동하는 공식적인 방법입니다. 이는 [comfy-cli](https://github.com/Comfy-Org/comfy-cli)의 가벼운 래퍼로, 각 도구는 `comfy` 명령을 호출하므로 `comfy-cli`가 엔진 역할을 하며 [Comfy Cloud MCP](/ko/agent-tools/mcp)와 코드를 공유하지 않습니다. - -클라우드 및 파트너 서버와 달리, **사용자 자신의 머신**에서 실행 중인 ComfyUI와 통신하므로 설치에 실제로 있는 워크플로를 실행하고 노드, 커스텀 노드, 모델을 검사할 수 있습니다. - -## 요구 사항 - -- **Python 3.10+** -- `PATH`에 **[comfy-cli](https://github.com/Comfy-Org/comfy-cli)**가 있어야 합니다 (`pip install comfy-cli`). 모든 도구가 기반으로 하는 엔진입니다. -- **ComfyUI 워크스페이스**: 없으면 `comfy install`로 생성합니다 (기존 체크아웃은 `comfy set-default `로 설정 가능). -- **실행 중인 ComfyUI**: 도구 사용 이전에 `comfy launch`로 시작합니다. 여기서는 ComfyUI를 암시적으로 실행하지 않습니다. - ---- - -## 설치 - -[저장소](https://github.com/Comfy-Org/comfy-local-mcp)를 체크아웃한 후: - -```bash -pip install . # 또는 작업 복사본의 경우 `pip install -e .` -``` - -그러면 `PATH`에 `comfy-local-mcp` 콘솔 스크립트가 생깁니다. 이 명령은 MCP 서버입니다 (stdio를 통해 MCP와 통신함). 아래에서 AI 클라이언트를 이 서버에 연결하세요. - - - **`COMFY_BIN` (선택 사항).** MCP 클라이언트는 자체 환경으로 서버를 실행하며, 이 환경에는 일반적으로 셸의 `PATH`가 **포함되지 않습니다**. `comfy`가 가상 환경이나 비표준 위치에 있는 경우 `COMFY_BIN`을 해당 절대 경로(예: `/path/to/venv/bin/comfy`)로 설정하세요. 아래의 모든 클라이언트 예제에서 해당 위치를 보여줍니다. 클라이언트가 서버를 실행하는 환경에 이미 `comfy`가 있다면 생략하세요. - - ---- - -## AI 클라이언트 설정하기 - -모든 클라이언트는 동일한 MCP stdio 계약을 따릅니다: `comfy-local-mcp` 명령을 서버로 실행하세요. 클라이언트를 선택하세요. - -### Claude Code - -한 번의 명령으로 서버를 등록합니다: - -```bash -claude mcp add comfy-local -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-local-mcp -``` - -또는 프로젝트 루트에 `.mcp.json` 파일로 체크인합니다: - -```json -{ - "mcpServers": { - "comfy-local": { - "command": "comfy-local-mcp", - "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } - } - } -} -``` - -### Claude Desktop - -`claude_desktop_config.json`을 편집하세요 (설정 → 개발자 → 구성 편집; macOS에서는 `~/Library/Application Support/Claude/claude_desktop_config.json`에 위치합니다), 서버를 추가한 후 Claude Desktop을 재시작하세요: - -```json -{ - "mcpServers": { - "comfy-local": { - "command": "comfy-local-mcp", - "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } - } - } -} -``` - -### Cursor - -서버를 `~/.cursor/mcp.json` (전역) 또는 `.cursor/mcp.json` (프로젝트별)에 추가하세요: - -```json -{ - "mcpServers": { - "comfy-local": { - "command": "comfy-local-mcp", - "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } - } - } -} -``` - ---- - -## 빠른 시작 - -생성된 이미지까지 제로부터: - - - - ```bash - pip install comfy-cli # 엔진 - comfy install # ComfyUI 워크스페이스 생성 (이미 있으면 건너뛰기) - pip install . # 이 MCP 서버 → `comfy-local-mcp` 명령 - ``` - - - ```bash - comfy launch - ``` - - - 위에서 클라이언트에 맞는 스니펫을 사용한 후, 클라이언트를 재시작하거나 다시 로드하면 도구가 나타납니다. - - - 예를 들어: - - > "내 로컬 ComfyUI가 실행 중인지 확인한 다음 `~/workflows/txt2img.json`의 워크플로를 실행하고 이미지를 보여줘." - - 내부적으로 에이전트는 `server_info`를 호출하여 ComfyUI가 작동 중인지 확인하고, `run_workflow`를 호출하여 워크플로 JSON을 실행하며, `fetch_outputs`를 호출하여 결과를 수집합니다. - - - ---- - -## 도구 - -각 도구는 `comfy-cli` 명령에 매핑되며, `--where local`로 실행됩니다. 주요 기능: - -| 도구 | 용도 | -|---|---| -| `server_info()` | 로컬 ComfyUI가 실행 중인지, 위치, 워크스페이스를 확인합니다. **먼저 호출하세요.** | -| `run_workflow(workflow_path, wait=True)` | 워크플로 JSON을 실행합니다. `wait=False`는 비동기로 제출하고 `prompt_id`를 반환합니다. | -| `job_status` / `wait_for_job` / `watch_job` | 제출된 작업을 폴링, 대기 또는 스트리밍합니다. | -| `fetch_outputs(prompt_id, out_dir)` | 완료된 작업의 출력을 `out_dir`로 복사합니다. | -| `launch_comfyui` / `stop_comfyui` | 로컬 ComfyUI를 시작하거나 중지합니다. | -| `search_templates` / `fetch_template` | 내장 템플릿을 찾아 실행 가능한 워크플로 JSON으로 작성합니다. | -| `search_nodes` / `get_node` / `list_nodes` | **실행 중인 로컬** 설치의 노드 클래스를 검사합니다 (커스텀 노드 포함). | -| `search_models` | 디스크의 모델 파일을 나열합니다. | -| `validate_workflow` | 느린 실행 이전에 실행 중인 `object_info`를 기준으로 워크플로를 사전 점검합니다. | - -노드 인트로스펙션과 모델 검색은 **실행 중인 설치**(커스텀 노드 포함)를 읽습니다. 이것이 로컬이 클라우드 MCP와 차별화되는 점입니다. 전체 도구 목록과 참조는 [저장소](https://github.com/Comfy-Org/comfy-local-mcp)를 참조하세요. - ---- - -## 관련 - -- [Comfy Cloud MCP](/ko/agent-tools/mcp): 호스팅된 MCP 서버, 로컬 설치나 GPU 불필요 -- [Comfy CLI](/ko/agent-tools/cli): 터미널에서 로컬 ComfyUI 및 파트너 생성 구동 -- [comfy-local-mcp on GitHub](https://github.com/Comfy-Org/comfy-local-mcp): 소스, 설치, 도구 참조 diff --git a/ko/agent-tools/mcp.mdx b/ko/agent-tools/mcp.mdx index 97ee695b0..0f4098863 100644 --- a/ko/agent-tools/mcp.mdx +++ b/ko/agent-tools/mcp.mdx @@ -1,47 +1,57 @@ --- -title: "Comfy Cloud MCP" -sidebarTitle: "Cloud MCP" -description: "Claude Code, Claude Desktop, Cursor, Codex, OpenClaw 또는 MCP 호환 에이전트에서 Comfy Cloud MCP에 연결하여 이미지, 비디오, 오디오 및 3D를 생성하고, 모델과 노드를 검색하며, 워크플로를 실행하세요." -icon: "cloud" -translationSourceHash: f491b28c +title: "Comfy MCP" +sidebarTitle: "Comfy MCP" +description: "Comfy Cloud GPU 또는 자신의 컴퓨터에서 ComfyUI에 AI 에이전트를 연결하세요. 이미지, 비디오, 오디오, 3D를 생성하고, 모델, 노드, 템플릿을 검색하며, 실제 워크플로를 실행할 수 있습니다." +icon: "bolt" +translationSourceHash: 15897127 translationFrom: agent-tools/mcp.mdx translationBlockHashes: - "_intro": b1c56a40 - "Overview": 2972aa17 - "Install Comfy Cloud MCP": b4e1e157 - "What your agent can do": 2c2a22e6 - "MCP tools": a9211dee - "Credits and spending": 686040e6 - "Outputs and downloads": a2c8c12f + "_intro": 340316c1 + "Overview": 64064e0e + "Comfy Cloud MCP Connection": f820ca16 + "Local Comfy MCP Connection": 5b13e8fd "Related resources": 2a86e2c5 "Related: Comfy In-App Agent": be5e2cdf - "Feedback": 6872768e - "Known limitations": 2f9e13ba - "FAQ": c943ff55 + "Feedback": 25a3d53f + "FAQ": 45b297ec --- -import CloudFeature from '/snippets/ko/cloud-feature.mdx' - - - **공개 베타.** Comfy Cloud MCP는 공개 베타 중입니다. API, 도구 및 동작이 변경될 수 있습니다. 문제를 신고하거나 제안을 공유하려면 [피드백](#feedback)을 참조하세요. + **공개 베타.** Comfy MCP는 현재 공개 베타 상태입니다. API, 도구, 동작은 개선 과정에서 변경될 수 있습니다. 문제를 신고하거나 제안을 공유하려면 [피드백](#feedback)을 참조하세요. ## 개요 -**Comfy Cloud MCP 서버**는 [Model Context Protocol](https://modelcontextprotocol.io)을 통해 AI 에이전트를 [Comfy Cloud](https://cloud.comfy.org)에 연결합니다. 연결 후에는 에이전트와의 채팅에서 이미지, 비디오, 오디오 및 3D를 생성하고, 모델, 노드 및 템플릿을 검색하며, ComfyUI 워크플로를 실행할 수 있습니다. +**Comfy MCP**는 [Model Context Protocol](https://modelcontextprotocol.io)을 통해 AI 에이전트를 ComfyUI에 연결합니다. 연결이 완료되면 이미지, 비디오, 오디오, 3D를 생성하고 모델, 노드, 템플릿을 검색하며, 에이전트와의 채팅에서 실제 ComfyUI 워크플로를 실행할 수 있습니다. + +두 가지 연결을 제공합니다. **Comfy Cloud** 연결과 **로컬 ComfyUI** 연결이며, 로컬 연결은 완전한 오픈소스입니다. -서버는 `cloud.comfy.org/mcp`에서 원격으로 실행됩니다. 워크플로는 Comfy Cloud GPU에서 실행되므로 로컬 GPU가 필요하지 않습니다. 에이전트는 HTTPS를 통해 서버와 통신하며, 서버는 도구 호출을 대신 인증된 요청으로 변환하여 Comfy Cloud에 전송합니다. + + **아래 내용에서 막히는 부분이 있다면? 가장 좋은 방법은 이 페이지를 에이전트에게 건네고 도움을 요청하는 것입니다.** + -모든 **MCP 호환 클라이언트**가 동일한 서버 URL에 연결할 수 있습니다. **Claude Code**, **Claude Desktop**, **Cursor**, **Codex**, **OpenClaw**는 아래에 전용 설정 안내가 있습니다. **Windsurf**, **Amp** 및 기타 에이전트는 OAuth 또는 API 키를 사용하여 동일한 URL을 사용합니다. +### 어떤 연결을 선택해야 하나요? - +**새로운 사용자라면 클라우드 연결로 시작하는 것을 권장합니다.** 가장 간단한 설정입니다. claude.ai, ChatGPT 또는 Claude Desktop 채팅 앱을 사용 중이라면 클라우드 연결이 더 호환되는 선택입니다. -## Comfy Cloud MCP 설치 +**이미 ComfyUI를 로컬에서 실행하거나 자체 배포 환경에서 운영 중이거나, Claude Code, Cursor, Codex 같은 코딩 에이전트에서 주로 작업한다면** **로컬** 연결로 시작하세요. - 연결하기 전에 [Comfy Cloud](https://cloud.comfy.org) 계정이 필요합니다. 아직 계정이 없다면 [가입하기](https://cloud.comfy.org)를 클릭하세요. 설정 중 OAuth 로그인은 Comfy 계정을 사용합니다. + **Mac 사용자의 경우, 오픈소스 모델을 실행할 계획이라면 클라우드 연결을 권장합니다.** 현재의 오픈웨이트 모델(예: MiniMax H3, LTX-2.3의 로컬 버전)은 크기가 커서 Apple GPU에서 실용적인 속도로 실행되지 않습니다. + + +두 연결을 동시에 실행하는 것은 일반적이며, 대부분의 클라이언트는 두 개의 MCP 서버를 문제없이 호스팅합니다. 동일한 Comfy 계정에 로그인하지만 **별도로** 로그인해야 합니다. 하나의 로그인으로 다른 연결을 포함하지 않습니다. + + +## Comfy Cloud MCP 연결 + +에이전트를 **Comfy Cloud** 계정에 연결하는 호스팅 연결입니다. 설치할 필요가 없으며, 워크플로는 Comfy Cloud GPU에서 실행됩니다. Comfy Cloud에 대해 더 알아보려면 [Comfy Cloud](/ko/get_started/cloud)를 참조하세요. + +### 클라우드 연결 설정 + + + 연결 전에 [Comfy Cloud](https://cloud.comfy.org) 계정이 필요합니다. 아직 계정이 없다면 [가입하기](https://cloud.comfy.org)를 클릭하세요. 신규 사용자는 **5회 무료 실행**을 사용해 볼 수 있습니다. 설정 중 OAuth 로그인은 Comfy 계정을 사용합니다. Comfy Cloud MCP는 다음 주소에서 실행됩니다: @@ -54,7 +64,7 @@ https://cloud.comfy.org/mcp - Claude Desktop은 Comfy Cloud를 UI를 통해 **사용자 지정 커넥터**로 추가한 다음 OAuth 로그인을 실행합니다. + Claude Desktop은 UI를 통해 Comfy Cloud를 **사용자 정의 커넥터**로 추가한 다음 OAuth 로그인을 실행합니다. - - 사이드바에서 **Customize**(**1**로 표시)를 클릭하세요. + + 사이드바에서 **Customize**(라벨 **1**)를 클릭하세요. - ![Claude Desktop — 사용자 정의 열기](/images/agent_tools/claude_desktop_mcp_setup_step1.png) + ![Claude Desktop — open Customize](/images/agent_tools/claude_desktop_mcp_setup_step1.png) - - **Connectors**(**2**로 표시)를 클릭하세요. + + **Connectors**(라벨 **2**)를 클릭하세요. - ![Claude Desktop — 커넥터 열기](/images/agent_tools/claude_desktop_mcp_setup_step2.png) + ![Claude Desktop — open Connectors](/images/agent_tools/claude_desktop_mcp_setup_step2.png) - - 1. 커넥터 헤더에서 **+** 버튼(**3**으로 표시)을 클릭하세요. - 2. **Add custom connector**(**4**로 표시)를 선택하세요. + + 1. Connectors 헤더에서 **+** 버튼(라벨 **3**)을 클릭하세요. + 2. **Add custom connector**(라벨 **4**)를 선택하세요. - ![Claude Desktop — 사용자 지정 커넥터 추가](/images/agent_tools/claude_desktop_mcp_setup_step3.png) + ![Claude Desktop — add custom connector](/images/agent_tools/claude_desktop_mcp_setup_step3.png) - 1. **Name** 필드(**5**로 표시)에 **Comfy Cloud MCP**와 같은 이름을 입력하세요. - 2. **Remote MCP server URL**을 `https://cloud.comfy.org/mcp`로 설정하세요(**6**으로 표시). - 3. **Add**(**7**로 표시)를 클릭하세요. + 1. **Name** 필드(라벨 **5**)에 **Comfy Cloud MCP**와 같은 이름을 입력하세요. + 2. **Remote MCP server URL**을 `https://cloud.comfy.org/mcp`(라벨 **6**)로 설정하세요. + 3. **Add**(라벨 **7**)를 클릭하세요. - ![Claude Desktop — 커넥터 세부 정보](/images/agent_tools/claude_desktop_mcp_setup_step4.png) + ![Claude Desktop — connector details](/images/agent_tools/claude_desktop_mcp_setup_step4.png) - 1. 브라우저가 열리면 워크스페이스(예: **Personal Workspace**)를 선택하세요. - 2. **Continue**를 클릭하여 커넥터를 승인합니다. 연결됩니다. + 1. 브라우저가 열리면 워크스페이스를 선택하세요(예: **Personal Workspace**). + 2. **Continue**를 클릭하여 커넥터를 승인하세요. 연결되었습니다. - ![Comfy Cloud MCP 권한 부여](/images/agent_tools/auth.png) + ![Comfy Cloud MCP authorization](/images/agent_tools/auth.png) - Claude Desktop은 Claude Code 슬래시 명령어를 지원하지 않습니다. 대신 **프롬프트 선택기**를 열어 동일한 워크플로를 사용하세요: - - | 프롬프트 | 설명 | - | --- | --- | - | `generate-image` | 텍스트 설명에서 이미지 생성 | - | `generate-video` | 텍스트 또는 이미지에서 비디오 생성 | - | `generate-audio` | 오디오, 음악 또는 사운드 효과 생성 | - | `generate-3d` | 텍스트 또는 이미지에서 3D 모델 생성 | - | `upscale-image` | 이미지를 더 높은 해상도로 업스케일 | - | `remove-background` | 이미지에서 배경 제거 | - | `search-templates` | 사전 구축된 워크플로 템플릿 검색 | - | `search-models` | 모델(체크포인트, LoRA, VAE) 검색 | - | `search-nodes` | 노드 검색 및 연결 제안 받기 | - | `help` | ComfyUI Cloud로 할 수 있는 작업 확인 | - - 프롬프트를 건너뛰고 일반 언어로 요청할 수도 있습니다. MCP 도구는 동일하게 작동합니다. - **comfy-cloud** 플러그인을 설치하세요. 이 플러그인은 MCP 연결과 슬래시 명령어를 한 번에 추가합니다. 이 플러그인은 Comfy의 Claude Code 플러그인과 커뮤니티 에이전트 스킬을 호스팅하는 [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) 저장소를 통해 게시됩니다. + **comfy-cloud** 플러그인을 설치하세요. MCP 연결과 슬래시 명령을 한 번에 추가합니다. 이 플러그인은 [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) 저장소를 통해 배포되며, Comfy용 Claude Code 플러그인과 커뮤니티 에이전트 스킬을 호스팅합니다. - Comfy Skills 마켓플레이스를 등록합니다(한 번만 수행): + Comfy Skills 마켓플레이스를 등록합니다(최초 1회): ``` /plugin marketplace add Comfy-Org/comfy-skills @@ -129,21 +123,21 @@ https://cloud.comfy.org/mcp ``` - `/mcp`를 실행하고 **comfy-cloud** → **Authenticate**를 선택하세요. 브라우저가 열려 로그인하고 토큰은 자동으로 새로 고쳐집니다. + `/mcp`를 실행하고 **comfy-cloud** → **Authenticate**를 선택하세요. 브라우저가 열려 로그인되고 토큰이 자동으로 갱신됩니다. - 플러그인은 다음 슬래시 명령어를 추가합니다: + 플러그인은 다음 슬래시 명령을 추가합니다: - | 명령어 | 설명 | + | 명령 | 설명 | | --- | --- | | `/comfy-cloud:generate-image` | 이미지 생성, 편집 또는 수정 | | `/comfy-cloud:generate-video` | 비디오 생성, 편집 또는 확장 | | `/comfy-cloud:generate-audio` | 오디오, 음악 또는 사운드 효과 생성 | - | `/comfy-cloud:generate-3d` | 텍스트 또는 이미지에서 3D 모델 생성 | + | `/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-templates` | [comfy.org](https://comfy.org)에서 사전 제작된 워크플로 템플릿 찾기 | | `/comfy-cloud:search-models` | 사용 가능한 모델 검색 | | `/comfy-cloud:search-nodes` | 노드 검색 및 연결 제안 받기 | | `/comfy-cloud:help` | ComfyUI Cloud로 할 수 있는 작업 확인 | @@ -155,29 +149,29 @@ https://cloud.comfy.org/mcp claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp ``` - 그런 다음 `/mcp`를 실행하고 **comfy-cloud** → **Authenticate**를 선택하세요. `-s user`를 추가하면 모든 프로젝트에서 사용할 수 있습니다. + 그런 다음 `/mcp`를 실행하고 **comfy-cloud** → **Authenticate**를 선택하세요. 모든 프로젝트에서 사용할 수 있도록 `-s user`를 추가하세요. - 이 방법도 MCP 프롬프트로 동일한 워크플로를 제공합니다: `/mcp__comfy-cloud__generate-image`, `/mcp__comfy-cloud__search-models` 등(`/mcp__<이름>__` 접두사는 `claude mcp add`에 전달한 이름을 사용합니다). 위 플러그인은 이를 더 친숙한 `/comfy-cloud:*` 명령어로 래핑하므로 권장됩니다. + 이 경로는 여전히 MCP 프롬프트와 동일한 워크플로를 노출합니다: `/mcp__comfy-cloud__generate-image`, `/mcp__comfy-cloud__search-models` 등(`/mcp____` 접두사는 `claude mcp add`에 전달한 이름을 사용합니다). 위 플러그인이 권장되는 이유는 이러한 명령을 더 친근한 `/comfy-cloud:*` 명령으로 감싸기 때문입니다. - Cursor는 원격 MCP 서버에 HTTP로 연결됩니다. Cursor는 현재 MCP OAuth를 지원하지 않습니다. MCP 구성에 Comfy Cloud API 키를 사용하여 Comfy Cloud를 추가하세요. + Cursor는 HTTP를 통해 원격 MCP 서버에 연결합니다. Cursor는 현재 MCP OAuth를 지원하지 **않습니다**. MCP 구성에 Comfy Cloud API 키와 함께 Comfy Cloud를 추가하세요. - - 오른쪽 상단의 **Settings** 기어(**1**로 표시)를 클릭하세요. + + 오른쪽 위 모서리의 **Settings** 톱니바퀴를 클릭하세요(라벨 **1**). - ![Cursor — 설정 열기](/images/agent_tools/cursor_mcp_setup_step1.png) + ![Cursor — open Settings](/images/agent_tools/cursor_mcp_setup_step1.png) - 1. 사이드바에서 **Tools & MCPs**(**2**로 표시)를 클릭하세요. - 2. **+ New MCP Server**(**3**으로 표시) → **Add a Custom MCP Server**를 클릭하세요. + 1. 사이드바에서 **Tools & MCPs**(라벨 **2**)를 클릭하세요. + 2. **+ New MCP Server**(라벨 **3**) → **Add a Custom MCP Server**를 클릭하세요. ![Cursor — Tools & MCPs](/images/agent_tools/cursor_mcp_setup_step2.png) - `~/.cursor/mcp.json`(전역) 또는 `.cursor/mcp.json`(프로젝트)을 편집하세요. 서버 URL을 설정하고 `X-API-Key` 헤더에 Comfy Cloud API 키를 전달하세요. 키는 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)에서 생성하세요(`comfyui-`로 시작): + `~/.cursor/mcp.json`(글로벌) 또는 `.cursor/mcp.json`(프로젝트)을 편집하세요. 서버 URL을 설정하고 `X-API-Key` 헤더에 Comfy Cloud API 키를 전달하세요. [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)에서 키를 생성하세요(`comfyui-`로 시작): ```json { @@ -192,18 +186,18 @@ https://cloud.comfy.org/mcp } ``` - `COMFY_API_KEY`를 셸 또는 시스템 환경에 설정하세요. Git에 커밋할 수 있는 파일에 키를 하드코딩하는 대신 `${env:COMFY_API_KEY}`를 사용하는 것이 좋습니다. + 셸 또는 시스템 환경에 `COMFY_API_KEY`를 설정하세요. Git에 커밋할 수 있는 파일에 키를 하드코딩하는 대신 `${env:COMFY_API_KEY}`를 사용하는 것이 좋습니다. - ![Cursor — API 키가 있는 mcp.json](/images/agent_tools/cursor_mcp_setup_step3.png) + ![Cursor — mcp.json with API key](/images/agent_tools/cursor_mcp_setup_step3.png) - 일반 언어로 요청하세요("고양이 우주비행사 이미지 생성", "Wan 2.2 비디오 템플릿 찾기"). Cursor가 대신 MCP 도구를 호출합니다. + 평범한 언어로 요청하세요("고양이 우주 비행사 이미지 생성", "Wan 2.2 비디오 템플릿 찾기"). Cursor가 대신 MCP 도구를 호출합니다. - [Codex](https://developers.openai.com/codex/cli)는 Streamable HTTP를 통해 Comfy Cloud에 연결합니다. 설정에서 서버를 추가한 다음 OAuth로 로그인하세요. + [Codex](https://developers.openai.com/codex/cli)는 Streamable HTTP를 통해 Comfy Cloud에 연결됩니다. Settings에서 서버를 추가한 후 OAuth로 로그인합니다. - [ClawHub](https://clawhub.ai/comfy-org/skills/comfy)에서 **Comfy Cloud** 스킬을 설치하세요. OpenClaw를 호스팅된 MCP 서버(`cloud.comfy.org/mcp`)에 연결합니다. Cloud 전용이며, 로컬 ComfyUI 설치를 구동하지 않습니다. + [ClawHub](https://clawhub.ai/comfy-org/skills/comfy)에서 **Comfy Cloud** 스킬을 설치하세요. OpenClaw를 호스팅된 MCP 서버(`cloud.comfy.org/mcp`)에 연결합니다. 클라우드 전용이며, 로컬 ComfyUI 설치를 구동하지 않습니다. @@ -280,8 +274,8 @@ https://cloud.comfy.org/mcp 스킬 페이지: [clawhub.ai/comfy-org/skills/comfy](https://clawhub.ai/comfy-org/skills/comfy). - - MCP 서버를 등록하고 Comfy 계정으로 로그인합니다: + + MCP 서버를 등록하고 Comfy 계정으로 로그인하세요: ```bash openclaw mcp set comfy '{"url":"https://cloud.comfy.org/mcp","transport":"streamable-http","auth":"oauth"}' @@ -289,19 +283,19 @@ https://cloud.comfy.org/mcp openclaw gateway restart ``` - `openclaw mcp login`이 인증 URL을 출력합니다. URL을 열고 로그인한 뒤 CLI 안내에 따라 흐름을 완료하세요(`--code` 값으로 다시 실행하라고 할 수 있음). `openclaw mcp status --verbose`로 확인합니다. + `openclaw mcp login`은 인증 URL을 출력합니다. URL을 열어 로그인하고 CLI의 안내에 따라 흐름을 완료하세요(`--code` 값과 함께 다시 실행하라는 요청이 있을 수 있습니다). `openclaw mcp status --verbose`로 확인하세요. - `auth: "oauth"`가 설정되면 OpenClaw는 해당 서버 항목의 정적 `headers`를 무시합니다. OAuth와 하드코딩된 API 키 헤더를 함께 쓰지 마세요. + `auth: "oauth"`가 설정되면 OpenClaw는 해당 서버 항목의 정적 `headers`를 무시합니다. OAuth와 하드코딩된 API 키 헤더를 결합하지 마세요. - 일반 언어로 요청하세요("고양이 우주비행사 이미지 생성", "Wan 2.2 비디오 템플릿 찾기"). OpenClaw가 대신 MCP 도구를 호출합니다. + 평범한 언어로 요청하세요("고양이 우주 비행사 이미지 생성", "Wan 2.2 비디오 템플릿 찾기"). OpenClaw가 대신 MCP 도구를 호출합니다. - - [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)에서 키를 생성하세요(`comfyui-`로 시작). 내보낸 뒤 서버를 등록합니다: + + [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)에서 키를 생성하세요(`comfyui-`로 시작), 내보낸 다음 서버를 등록하세요: ```bash export COMFY_API_KEY="comfyui-..." @@ -309,16 +303,16 @@ https://cloud.comfy.org/mcp openclaw gateway restart ``` - OpenClaw에서는 커스텀 `X-API-Key` 헤더보다 `Authorization: Bearer`를 권장합니다. 일부 OpenClaw 빌드는 streamable-http 전송에서 커스텀 헤더를 드롭할 수 있으며, Bearer가 프록시를 더 안정적으로 통과합니다. `COMFY_API_KEY`는 셸 프로필 또는 OpenClaw 환경에 두세요. 키를 커밋하지 마세요. + OpenClaw에서는 사용자 정의 `X-API-Key` 헤더보다 `Authorization: Bearer`를 선호하세요. 일부 OpenClaw 빌드는 streamable-http 전송에서 사용자 정의 헤더를 삭제합니다. Bearer는 프록시를 더 안정적으로 통과합니다. `COMFY_API_KEY`를 셸 프로필이나 OpenClaw 환경에 넣으세요. 키를 커밋하지 마세요. - + **원격 HTTP** 전송을 지원하는 모든 MCP 클라이언트는 Comfy Cloud에 연결할 수 있습니다. 서버 URL은 항상 `https://cloud.comfy.org/mcp`입니다. - `https://cloud.comfy.org/mcp`를 가리키는 원격 MCP 항목을 추가하세요. 대부분의 클라이언트는 `url` 필드가 있는 JSON 구성을 사용합니다: + `https://cloud.comfy.org/mcp`를 가리키는 원격 MCP 항목을 추가하세요. 대부분의 클라이언트는 `url` 필드가 있는 JSON 설정을 사용합니다: ```json { @@ -330,17 +324,17 @@ https://cloud.comfy.org/mcp } ``` - **Windsurf**는 `url` 대신 `serverUrl`을 사용합니다. **Amp**는 **Settings → MCP Servers** 또는 `~/.config/amp/settings.json`에서 동일한 `mcpServers` 형식을 사용합니다. + **Windsurf**는 `url` 대신 `serverUrl`을 사용합니다. **Amp**는 **Settings → MCP Servers** 또는 `~/.config/amp/settings.json`에서 동일한 `mcpServers` 형태를 사용합니다. - - 클라이언트가 MCP OAuth를 지원하는 경우 브라우저에서 로그인하라는 메시지가 표시됩니다. 그렇지 않으면 API 키 헤더를 추가하세요(아래 참조). + + 클라이언트가 MCP OAuth를 지원하면 메시지가 표시될 때 브라우저를 통해 로그인하세요. 그렇지 않으면 API 키 헤더를 추가하세요(아래 참조). - 클라이언트를 재시작하세요. **comfy-cloud** 서버 아래에 Comfy Cloud 도구(`search_templates`, `submit_workflow`, `get_output` 등)가 등록된 것을 확인할 수 있습니다. + 클라이언트를 재시작하세요. **comfy-cloud** 서버 아래에 Comfy Cloud 도구(`search_templates`, `submit_workflow`, `get_output` 등)가 등록되어 있어야 합니다. - **헤드리스 / CI (API 키):** OAuth를 사용할 수 없는 경우 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)에서 키를 생성하고 `X-API-Key` 헤더로 전달하세요: + **헤드리스 / CI(API 키):** OAuth를 사용할 수 없는 경우, [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)에서 키를 생성하고 `X-API-Key` 헤더로 전달하세요: ```json { @@ -361,192 +355,426 @@ https://cloud.comfy.org/mcp claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp -H "X-API-Key: comfyui-…" ``` - Git에 커밋하는 구성 파일에 키를 하드코딩하는 대신 `${env:COMFY_API_KEY}` 또는 클라이언트의 비밀 변수 보간을 사용하는 것이 좋습니다. + Git에 커밋하는 설정 파일에 키를 하드코딩하는 대신 `${env:COMFY_API_KEY}` 또는 클라이언트의 비밀 보간(interpolation)을 사용하는 것이 좋습니다. -## 에이전트가 할 수 있는 작업 +### 에이전트로 할 수 있는 일 -직접 MCP 도구를 호출하지 않습니다. 에이전트가 사용자의 요청에 따라 적절한 도구를 선택합니다. 슬래시 명령과 프롬프트(아래 참조)는 에이전트를 일반적인 작업으로 안내하는 단축키이지만, 일반 언어로도 작동합니다("고양이 우주비행사 이미지 생성", "이 사진 업스케일", "Wan 2.2 비디오 템플릿 찾기"). +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`이 에이전트가 셸에서 실행할 다운로드 명령을 반환. +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`이 에이전트가 셸에서 실행하는 다운로드 명령을 반환합니다). -서버는 처음부터 워크플로를 빌드하기 전에 일치하는 [사전 제작된 템플릿](https://comfy.org/workflows)을 선호하며, 이는 더 빠르고 더 나은 결과를 내는 경향이 있습니다. +서버는 처음부터 워크플로를 구축하기보다 [사전 제작 템플릿](https://comfy.org/workflows)을 일치시키는 것을 선호하며, 이는 일반적으로 더 빠르고 더 나은 결과를 생성합니다. -## MCP 도구 +### 클라우드 MCP 도구 -연결된 후 에이전트가 액세스할 수 있는 도구입니다. 이름은 MCP 클라이언트 로그 및 디버깅에 표시되는 것과 일치합니다. +연결되면 에이전트가 액세스할 수 있는 도구입니다. 이름은 MCP 클라이언트 로그 및 디버깅 출력에 표시되는 것과 일치합니다. -### 탐색 +**탐색** | 도구 | 설명 | | --- | --- | -| `search_templates` | [comfy.org](https://comfy.org/workflows)에서 사전 구축된 워크플로 템플릿을 텍스트, 태그, 미디어 유형 또는 모델별로 검색합니다. | -| `get_template` | 템플릿의 전체 워크플로 JSON을 가져와서 검사하거나 수동으로 편집합니다. | -| `get_template_schema` | 템플릿의 파라미터 중 런타임에 재정의할 수 있는 항목을 확인합니다. | -| `search_models` | 모델 카탈로그를 텍스트, 유형, 베이스 모델 또는 소스별로 검색합니다. | -| `search_nodes` | 사용 가능한 노드를 텍스트, 카테고리, 입력/출력 유형별로 검색합니다. 또한 **서브그래프 블루프린트**(텍스트 기반 이미지 생성 또는 배경 제거와 같은 사전 연결된 노드 그룹)를 표시합니다. | -| `get_node` | 특정 노드에 대한 전체 입력 사양을 가져옵니다(전체 옵션 목록 포함). | -| `cql` | 구조적 질문(예: 이미지를 생성하는 노드 또는 노드 유형 간 경로)을 위해 [CQL](https://github.com/Comfy-Org/cql) 그래프 쿼리를 실행합니다. 특정 노드의 전체 입력 사양이 필요한 경우 `search_nodes`를 사용하세요. | -| `get_prompting_guide` | 모델 제품군별 프롬프트 스타일 및 권장 설정(스텝, CFG, 샘플러, 해상도)을 제공합니다. | +| `search_templates` | [comfy.org](https://comfy.org/workflows)에서 텍스트, 태그, 미디어 유형 또는 모델별로 사전 제작된 워크플로 템플릿 검색 | +| `get_template` | 검사하거나 직접 편집할 수 있도록 템플릿의 전체 워크플로 JSON 가져오기 | +| `get_template_schema` | 런타임에 오버라이드할 수 있는 템플릿의 파라미터 확인 | +| `search_models` | 텍스트, 유형, 베이스 모델 또는 소스별로 모델 카탈로그 검색 | +| `search_nodes` | 텍스트, 카테고리 또는 입력/출력 유형별로 사용 가능한 노드 검색. **서브그래프 블루프린트**(Text to Image 또는 Remove Background와 같은 사전 배선된 노드 그룹)도 표시 | +| `get_node` | 특정 노드의 전체 입력 사양 가져오기(전체 옵션 목록 포함) | +| `cql` | 구조적 질문(예: 어떤 노드가 이미지를 생성하는지, 또는 노드 유형 간 경로)을 위해 [CQL](https://github.com/Comfy-Org/cql) 그래프 쿼리 실행. 특정 노드의 전체 입력 사양이 필요하면 `search_nodes` 사용 | +| `get_prompting_guide` | 모델 제품군별 프롬프트 스타일과 권장 설정(스텝, cfg, sampler, 해상도) | -### 생성 +**생성** | 도구 | 설명 | | --- | --- | -| `run_template` | 이름으로 사전 구축된 템플릿을 실행하며, 선택적으로 파라미터를 재정의할 수 있습니다. 템플릿이 일치할 때 선호되는 방법입니다. | -| `submit_workflow` | Comfy Cloud에서 실행할 ComfyUI API 형식 워크플로를 제출합니다. | -| `partner_generate` | 파트너 API 모델(Flux/BFL, Grok, Gemini, OpenAI, Ideogram, Seedream/Seedance 등)로 생성합니다. | -| `upload_file` | 워크플로에서 사용할 입력 이미지 또는 파일을 업로드합니다(예: LoadImage 사용). | -| `apply_slots` | 워크플로의 내부 값에 파라미터 재정의를 적용하고 수정된 워크플로를 반환합니다. | +| `run_template` | 이름으로 사전 제작된 템플릿 실행(선택적으로 파라미터 오버라이드). 템플릿이 적합한 경우 선호되는 경로 | +| `submit_workflow` | ComfyUI API 형식의 워크플로를 Comfy Cloud에서 실행하도록 제출 | +| `partner_generate` | 파트너 API 모델(Flux/BFL, Grok, Gemini, OpenAI, Ideogram, Seedream/Seedance 등)로 생성 | +| `upload_file` | 워크플로에서 사용할 입력 이미지 또는 파일 업로드(예: LoadImage 사용) | +| `apply_slots` | 워크플로의 내부 값에 파라미터 오버라이드 적용 후 수정된 워크플로 반환 | -### 작업 및 배치 +**작업 및 배치** | 도구 | 설명 | | --- | --- | -| `get_job_status` | 제출된 워크플로의 실행 상태를 폴링합니다. | -| `wait_for_job` | 반복적인 폴링 대신 작업이 완료될 때까지 기다립니다. | -| `get_output` | 완료된 워크플로에서 출력 이미지, 비디오 또는 오디오를 검색합니다. | -| `use_previous_output` | 한 실행의 출력을 다른 실행의 입력으로 재사용하여 워크플로를 연결합니다. | -| `cancel_job` | 대기 중 또는 실행 중인 작업을 취소합니다. | -| `get_queue` | 실행 중 및 대기 중인 작업 수를 확인합니다. | -| `submit_batch`, `get_batch_status`, `get_batch_output`, `wait_for_batch` | 한 번의 호출로 여러 생성을 제출하고 나중에 함께 수집합니다. 배치 ID는 세션 간에 유효합니다. | +| `get_job_status` | 제출된 워크플로의 실행 상태 폴링 | +| `wait_for_job` | 반복적으로 폴링하지 않고 작업이 완료될 때까지 대기 | +| `get_output` | 완료된 워크플로에서 출력 이미지, 비디오 또는 오디오 가져오기 | +| `use_previous_output` | 한 실행의 출력을 다른 실행의 입력으로 재사용하여 워크플로 연결 | +| `cancel_job` | 대기 중이거나 실행 중인 작업 취소 | +| `get_queue` | 실행 중이거나 대기 중인 작업 수 확인 | +| `submit_batch`, `get_batch_status`, `get_batch_output`, `wait_for_batch` | 한 번의 호출로 여러 생성을 제출하고 나중에 함께 수집. 배치 ID는 세션 간에 유효 | -### 저장된 워크플로 +**저장된 워크플로** | 도구 | 설명 | | --- | --- | -| `list_saved_workflows` | Comfy Cloud에서 저장된 워크플로를 찾아봅니다. | -| `get_saved_workflow` | 저장된 워크플로의 노드, 입력 및 사용자 정의 가능한 설정을 검사합니다. | -| `save_workflow` | 워크플로를 Comfy Cloud 계정에 저장합니다. | -| `update_workflow` | 기존 워크플로를 새 버전으로 제자리에서 업데이트합니다(이전 버전은 복구 가능하게 유지됨). | -| `run_saved_workflow` | 파일 이름으로 저장된 워크플로를 실행합니다. 서버가 편집기 형식에서 실행 가능한 형식으로 자동 변환합니다. | +| `list_saved_workflows` | Comfy Cloud에서 저장된 워크플로 찾아보기 | +| `get_saved_workflow` | 저장된 워크플로의 노드, 입력 및 사용자 정의 가능한 설정 검사 | +| `save_workflow` | Comfy Cloud 계정에 워크플로 저장 | +| `update_workflow` | 기존 워크플로를 새 버전으로 바로 업데이트(이전 버전은 복구 가능하게 유지) | +| `run_saved_workflow` | 파일 이름으로 저장된 워크플로 실행. 서버가 편집기 형식에서 실행 가능 형식으로 자동 변환 | -### 워크플로 공유 +**워크플로 공유** | 도구 | 설명 | | --- | --- | -| `share_workflow` | 저장된 워크플로를 게시하고 누구나 열 수 있는 `?share=` URL을 반환합니다. | -| `import_shared_workflow` | 공유 URL 또는 bare 공유 ID를 워크플로 JSON으로 변환하고, 선택적으로 계정에 저장합니다. | +| `share_workflow` | 저장된 워크플로를 게시하고 누구나 열 수 있는 `?share=` URL 반환 | +| `import_shared_workflow` | 공유 URL 또는 단순 공유 ID를 워크플로 JSON으로 변환(선택적으로 계정에 저장) | -**허브 URL 공유 ID:** `comfy.org/workflows/-` 허브 URL의 끝에 있는 하이픈으로 구분된 16진수 토큰이 공유 ID입니다. 예를 들어, `comfy.org/workflows/topaz-starlight-upscale-1c77e82713b7`의 공유 ID는 `1c77e82713b7`입니다. 해당 토큰을 `import_shared_workflow`에 `share_id`로 전달하세요. `share_url` 매개변수는 `https://cloud.comfy.org/?share=...`와 같은 `?share=` 쿼리 URL만 허용하며, 허브 페이지 URL은 허용하지 않습니다. +**Hub URL 공유 ID:** `comfy.org/workflows/-` hub URL에서 뒤에 붙은 하이픈으로 구분된 16진수 토큰이 공유 ID입니다. 예를 들어, `comfy.org/workflows/topaz-starlight-upscale-1c77e82713b7`의 공유 ID는 `1c77e82713b7`입니다. 이 토큰을 `import_shared_workflow`에 `share_id`로 전달하세요. `share_url` 매개변수는 `https://cloud.comfy.org/?share=...`와 같은 `?share=` 쿼리 URL만 허용하며, hub 페이지 URL은 허용하지 않습니다. -### 앱 및 링크 +**앱 및 링크** | 도구 | 설명 | | --- | --- | -| `create_app` | 저장된 워크플로를 앱 모드 앱으로 변환합니다. 선택한 입력 및 출력이 있는 단순화된 "이 워크플로 실행" 보기입니다. | -| `get_app_mode_url` | 워크플로를 실행 가능한 앱으로 여는 안정적인 링크를 가져옵니다. | -| `get_workflow_canvas_url` | 워크플로를 Comfy Cloud 캔버스에서 직접 열어서 보고, 편집하거나 실행할 수 있는 링크를 가져옵니다. | +| `create_app` | 저장된 워크플로를 App Mode 앱으로 변환. 선택한 입력과 출력을 가진 간소화된 "이 워크플로 실행" 보기 | +| `get_app_mode_url` | 워크플로를 실행 가능한 앱으로 열 수 있는 안정적인 링크 가져오기 | +| `get_workflow_canvas_url` | 워크플로를 Comfy Cloud 캔버스에서 직접 열 수 있는 링크 가져오기(보기, 편집 또는 실행 준비 완료) | -### 계정 및 세션 +**계정 및 세션** | 도구 | 설명 | | --- | --- | -| `get_billing_status` | 보유 크레딧 잔액, 구독 등급 및 청구 링크를 확인합니다. | -| `get_server_info` | 에이전트가 도달한 서버를 확인합니다: 환경, 호스트, 버전 및 인증 상태. | -| `submit_feedback` | 베타 피드백 설문조사 링크를 가져옵니다. | -| `report_session_summary` | 익명화된 세션 요약을 Comfy 팀과 공유합니다. **명시적인 동의가 있어야만 가능**하며, 에이전트가 먼저 물어봐야 합니다. 프롬프트, 파일 경로 또는 개인 정보는 포함되지 않습니다. | +| `get_billing_status` | 크레딧 잔액, 구독 등급, 결제 링크 확인 | +| `get_server_info` | 에이전트가 연결한 서버 확인: 환경, 호스트, 버전, 인증 상태 | +| `submit_feedback` | 베타 피드백 설문조사 링크 가져오기 | +| `report_session_summary` | 익명화된 세션 요약을 Comfy 팀과 공유. **명시적 동의가 있는 경우에만** 진행하며, 에이전트가 먼저 요청해야 함. 프롬프트, 파일 경로, 개인 정보는 포함되지 않음 | + +**프롬프트(Claude Desktop)** - +Claude Desktop은 Claude Code 슬래시 명령을 지원하지 않습니다. 대신 **prompt picker**를 열어 동일한 워크플로를 사용하세요: -## 크레딧 및 사용 +| 프롬프트 | 설명 | +| --- | --- | +| `generate-image` | 텍스트 설명에서 이미지 생성 | +| `generate-video` | 텍스트 또는 이미지에서 비디오 생성 | +| `generate-audio` | 오디오, 음악, 사운드 효과 생성 | +| `generate-3d` | 텍스트 또는 이미지에서 3D 모델 생성 | +| `upscale-image` | 이미지를 더 높은 해상도로 업스케일 | +| `remove-background` | 이미지에서 배경 제거 | +| `search-templates` | 사전 제작된 워크플로 템플릿 찾기 | +| `search-models` | 모델 검색(checkpoint, LoRA, VAE) | +| `search-nodes` | 노드 검색 및 연결 제안 받기 | +| `help` | ComfyUI Cloud로 할 수 있는 작업 확인 | -탐색은 무료입니다: `search_templates`, `search_models`, `search_nodes`는 [Comfy 계정](https://cloud.comfy.org)만 있으면 작동합니다. 생성을 실행하려면 활성 Comfy Cloud 구독이 필요합니다. 크레딧 또는 충전 잔액만으로는 접근할 수 없습니다. 미사용 크레딧이 있어도 생성을 실행하려면 활성 구독이 필요합니다. +프롬프트를 건너뛰고 평범한 언어로 요청할 수도 있습니다. MCP 도구는 동일한 방식으로 작동합니다. -실제 비용이 발생하는 도구는 **spend-gated**입니다. 생성이 유료 파트너 모델(`partner_generate`) 또는 유료 API 노드가 포함된 워크플로/템플릿(`run_template`, `run_saved_workflow`, `submit_batch`)을 사용하는 경우, 서버는 에이전트가 크레딧 사용에 동의했음을 확인할 때까지 실행을 차단합니다. 따라서 해당 실행 이전에 에이전트가 사용자에게 확인을 요청할 것입니다. 무료 로컬 전용 워크플로는 절대 확인을 요청하지 않습니다. +### 크레딧과 비용 -언제든지 에이전트에게 잔액 정보를 물어볼 수 있습니다("크레딧이 얼마나 있나요?") — `get_billing_status`를 통해 답변합니다. +탐색은 무료입니다: `search_templates`, `search_models`, `search_nodes`는 [Comfy 계정](https://cloud.comfy.org)만 있으면 작동합니다. 생성을 실행하려면 활성 Comfy Cloud 구독이 필요합니다. 크레딧이나 충전 잔액만으로는 접근 권한이 주어지지 않습니다. 사용하지 않은 크레딧이 있어도 생성을 실행하려면 활성 구독이 필요합니다. -## 출력 및 다운로드 +### 업로드 및 다운로드 -MCP 서버는 클라우드에서 실행되며 **사용자 기기에 파일을 절대 쓰지 않습니다**. 생성이 완료되면 에이전트가 `get_output`을 호출하며, 다음을 반환합니다: +MCP 서버는 클라우드에서 실행되며 MCP 자체는 사용자 머신에 파일을 쓰지 않습니다. 생성이 완료되면 에이전트가 `get_output`을 호출하고, 다음을 반환합니다: -1. **임시 서명된 다운로드 URL**(짧은 기간 동안 유효). -2. 바로 실행 가능한 **셸 명령**(macOS 및 Linux에서는 `curl`, Windows에서는 `curl.exe`). +1. **임시 서명된 다운로드 URL**(짧은 시간 동안 유효). +2. 바로 실행 가능한 **셸 명령**(macOS와 Linux에서는 `curl`, Windows에서는 `curl.exe`). -에이전트는 해당 명령을 셸에서 실행해야 합니다. 명령에는 대상 경로와 파일 이름이 포함됩니다. +에이전트는 이 명령을 셸에서 실행해야 합니다. 명령에는 대상 경로와 파일 이름이 포함되어 있습니다. - 반환된 명령을 **그대로** 실행하세요. 서명된 URL을 다시 인코딩하거나 편집하지 마세요. 서명은 쿼리 문자열에 있으며 URL이 수정되면 깨집니다. + 반환된 명령을 **그대로** 실행하세요. 서명된 URL을 다시 인코딩하거나 편집하지 마세요. 서명은 쿼리 문자열에 있으며 URL을 수정하면 깨집니다. MCP 클라이언트가 셸 명령을 실행할 수 없는 경우(일부 GUI 전용 설정), 명령을 복사하여 터미널에서 직접 실행하세요. +에셋 업로드와 다운로드는 클라이언트의 파일 접근에 의존합니다. Claude Desktop이나 다른 에이전트 클라이언트가 에셋 업로드 또는 다운로드를 처리하는 데 문제가 있다면, 에이전트의 로컬 파일 디렉터리 접근과 관련이 있을 수 있습니다. Claude 사용자에게는 더 많은 기능을 갖춘 **Claude Code**(데스크톱 앱 또는 터미널)를 권장합니다. 마찬가지로, 다른 에이전트 계열에서는 일반적으로 코딩 에이전트가 웹 채팅 버전보다 낫습니다. + + +### 알려진 제한 사항 + +Comfy Cloud MCP는 초기 릴리스입니다. 다음과 같은 알려진 제한 사항이 있으며, 해결을 위해 작업 중입니다: + +**워크플로** + +- **`submit_workflow`를 통해 생성된 에셋에는 워크플로 메타데이터가 포함되지 않을 수 있습니다.** ComfyUI에서 열 때 원래 워크플로가 다시 열리지 않을 수 있습니다. +- **워크플로 빌드는 에이전트의 정확도에 따라 달라집니다.** 복잡한 다중 노드 워크플로는 재시도나 수정이 필요할 수 있습니다. + +**파일 처리** + +- **출력물은 셸 다운로드 단계가 필요합니다.** [업로드 및 다운로드](#uploads-and-downloads)를 참조하세요. +- **업로드 크기 제한**은 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**](https://github.com/Comfy-Org/comfy-mcp)는 Comfy의 **퍼스트파티 로컬 MCP 서버**입니다. AI 에이전트(Claude Code, Claude Desktop, Cursor 및 기타 MCP 클라이언트)에서 **로컬** ComfyUI 설치를 구동하는 공식 방법입니다. + +클라우드 및 파트너 서버와 달리, 이 서버는 **자신의 머신**에서 실행 중인 ComfyUI와 통신하므로, 워크플로를 실행하고 설치된 노드, 커스텀 노드, 모델을 검사할 수 있습니다. + + + **가장 빠른 설정 방법: 에이전트에게 맡기세요.** AI 클라이언트에 `https://docs.comfy.org/agent-tools/mcp#installation`을 붙여넣고 로컬 연결 설정을 요청하세요. + + +### 요구 사항 + +- **Python 3.10+** +- **`PATH`에 있는 [comfy-cli](https://github.com/Comfy-Org/comfy-cli)**(`pip install comfy-cli`). 모든 도구가 래핑하는 엔진입니다. +- **ComfyUI 워크스페이스**. 없으면 `comfy install`로 생성하세요(기존 체크아웃은 `comfy set-default `로 사용 가능). +- **실행 중인 ComfyUI**. 도구를 사용하기 전에 `comfy launch`로 시작하세요. 여기서는 ComfyUI를 암시적으로 시작하지 않습니다. + +--- + +### 설치 + +[저장소](https://github.com/Comfy-Org/comfy-mcp)를 체크아웃한 후: + +```bash +pip install . # or `pip install -e .` for a working copy +``` + +이렇게 하면 `comfy-mcp` 콘솔 스크립트가 `PATH`에 추가됩니다. 이 명령이 MCP 서버이며(stdio를 통해 MCP 통신), AI 클라이언트가 아래에서 이 서버를 가리키도록 설정하세요. + + + **`COMFY_BIN`(선택 사항).** MCP 클라이언트는 자체 환경에서 서버를 실행하며, 이 환경에는 일반적으로 셸의 `PATH`가 포함되지 **않습니다**. `comfy`가 가상 환경이나 표준이 아닌 위치에 있는 경우 `COMFY_BIN`을 절대 경로로 설정하세요(예: `/path/to/venv/bin/comfy`). 아래의 모든 클라이언트 예제에서 설정 위치를 확인할 수 있으며, 클라이언트가 서버를 시작하는 환경에 이미 `comfy`가 있다면 이 변수를 생략해도 됩니다. + + +--- + +### 수동 구성 + +모든 클라이언트는 동일한 MCP stdio 규약을 따릅니다: `comfy-mcp` 명령을 서버로 실행하면 됩니다. 사용 중인 클라이언트를 선택하세요: + + + + `claude_desktop_config.json`을 편집하고(Settings → Developer → Edit Config. macOS의 경우 `~/Library/Application Support/Claude/claude_desktop_config.json`에 위치), 서버를 추가한 다음 Claude Desktop을 재시작합니다: + + ```json + { + "mcpServers": { + "comfy-mcp": { + "command": "comfy-mcp", + "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } + } + } + } + ``` + + + + 한 줄의 명령으로 서버를 등록합니다: + + ```bash + claude mcp add comfy-mcp -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-mcp + ``` + + 또는 저장소 루트에 `.mcp.json` 파일을 만들어 프로젝트에 등록할 수도 있습니다: + + ```json + { + "mcpServers": { + "comfy-mcp": { + "command": "comfy-mcp", + "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } + } + } + } + ``` + + + + 서버를 `~/.cursor/mcp.json`(전역) 또는 `.cursor/mcp.json`(프로젝트별)에 추가합니다: + + ```json + { + "mcpServers": { + "comfy-mcp": { + "command": "comfy-mcp", + "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } + } + } + } + ``` + + + +--- + +### 빠른 시작 + +처음부터 생성 이미지까지: + + + + ```bash + git clone https://github.com/Comfy-Org/comfy-mcp + cd comfy-mcp + pip install comfy-cli # the engine + comfy install # create a ComfyUI workspace (skip if you have one) + pip install . # this MCP server → the `comfy-mcp` command + ``` + + + ```bash + comfy launch + ``` + + + 위의 클라이언트용 스니펫을 사용한 다음, 재시작/새로고침하여 도구가 표시되도록 하세요. + + + 예를 들어: + + > "내 로컬 ComfyUI가 실행 중인지 확인한 다음, `~/workflows/txt2img.json`에 있는 워크플로를 실행하고 이미지를 보여줘." + + 내부적으로 에이전트는 `server_info`를 호출하여 ComfyUI가 실행 중인지 확인하고, `run_workflow`로 워크플로 JSON을 실행하며, `fetch_outputs`로 결과를 수집합니다. + + + +--- + +### 도구 + +각 도구는 `comfy-cli` 명령에 매핑되며, `--where local`과 함께 실행됩니다. 주요 도구: + +| 도구 | 목적 | +|---|---| +| `server_info()` | 로컬 ComfyUI가 실행 중인지, 위치와 워크스페이스 확인. **먼저 호출하세요.** | +| `run_workflow(workflow_path, wait=True)` | 워크플로 JSON 실행. `wait=False`는 비동기 제출 후 `prompt_id` 반환 | +| `job_status` / `wait_for_job` / `watch_job` | 제출된 작업을 폴링, 대기 또는 스트리밍 | +| `fetch_outputs(prompt_id, out_dir)` | 완료된 작업의 출력을 `out_dir`로 복사 | +| `launch_comfyui` / `stop_comfyui` | 로컬 ComfyUI 시작 또는 중지 | +| `search_templates` / `fetch_template` | 내장 템플릿 찾기 및 실행 가능한 워크플로 JSON 작성 | +| `search_nodes` / `get_node` / `list_nodes` | **실행 중인 로컬** 설치의 노드 클래스 검사(커스텀 노드 포함) | +| `search_models` | 디스크의 모델 파일 목록 표시 | +| `validate_workflow` | 느린 실행 이전에 실행 중인 `object_info`를 통해 워크플로 사전 검증 | + +노드 인트로스펙션과 모델 검색은 **실행 중인 설치**를 읽습니다. 커스텀 노드가 포함되며, 이것이 클라우드 연결과 구별되는 로컬의 특징입니다. 전체 도구 목록과 참조는 [저장소](https://github.com/Comfy-Org/comfy-mcp)를 확인하세요. + +--- + + ## 관련 리소스 -| 리소스 | 용도 | +| 리소스 | 설명 | | --- | --- | -| [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) | Claude Code 플러그인 마켓플레이스 및 커뮤니티 스킬 라이브러리입니다. 위에서 사용된 **comfy-cloud** 플러그인이 여기에 배포되어 있습니다. Comfy 워크플로를 위한 추가 스킬을 찾아보거나 기여하세요. | -| [Comfy Cloud on ClawHub](https://clawhub.ai/comfy-org/skills/comfy) | 호스팅된 Comfy Cloud MCP 서버용 OpenClaw 스킬(`openclaw skills install @comfy-org/comfy`)입니다. | -| [Comfy CLI](/ko/agent-tools/cli) | 로컬 ComfyUI 설치/실행 및 스크립트나 CI에서 호스팅된 파트너 노드를 호출하기 위한 명령줄 도구입니다 (`comfy generate`, 베타). 터미널 또는 자동화 워크플로가 필요할 때 MCP를 보완합니다. | -| [Share a workflow on Comfy Cloud](/ko/cloud/share-workflow) | Comfy Cloud UI에서 워크플로를 공유합니다 (MCP `share_workflow` 도구가 에이전트 세션에서 이 작업을 수행합니다). | +| [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) | Claude Code 플러그인 마켓플레이스이자 커뮤니티 스킬 라이브러리. 위에서 사용된 **comfy-cloud** 플러그인이 여기에 배포되어 있으며, Comfy 워크플로를 위한 추가 스킬을 찾아보거나 기여할 수 있습니다. | +| [ClawHub의 Comfy Cloud](https://clawhub.ai/comfy-org/skills/comfy) | 호스팅된 Comfy Cloud MCP 서버용 OpenClaw 스킬(`openclaw skills install @comfy-org/comfy`). | +| [Comfy CLI](/ko/agent-tools/cli) | 로컬 ComfyUI 설치/실행 및 스크립트나 CI에서 호스팅된 파트너 노드를 호출하기 위한 명령줄 도구(`comfy generate`, 베타). 터미널이나 자동화 워크플로가 필요할 때 MCP를 보완합니다. | +| [Comfy Cloud에서 워크플로 공유하기](/ko/cloud/share-workflow) | Comfy Cloud UI에서 워크플로를 공유합니다(MCP `share_workflow` 도구가 에이전트 세션에서 이 작업을 수행합니다). | -## 관련: Comfy In-App Agent +## 관련 항목: Comfy 인앱 에이전트 -외부 MCP 클라이언트가 아니라 Comfy Cloud **내부** 에이전트 경험(채팅으로 그래프를 빌드·편집)을 원하시나요? +외부 MCP 클라이언트가 아닌, **Comfy Cloud 내부**에서 에이전트 경험(그래프를 빌드하고 편집하는 채팅)을 원하시나요? - - Comfy Cloud 비공개 알파. 대기자 명단에 참여하여 액세스를 요청하세요. + + Comfy Cloud의 비공개 알파입니다. 액세스를 요청하려면 웨이팅 리스트에 참여하세요. ## 피드백 -Comfy Cloud MCP는 공개 베타 버전입니다. 사용해 보시고 어떤 점이 잘 작동하고 어떤 점이 그렇지 않은지 알려주세요: +Comfy MCP는 공개 베타 단계입니다. 사용해 보시고 작동하는 점과 그렇지 않은 점을 알려주세요: -- **[피드백 설문](https://links.comfy.org/cloudmcpbeta)**: 버그를 신고하거나, 기능을 요청하거나, 일반적인 의견을 공유해 주세요. -- **Discord**: 질문과 토론을 위해 Comfy Discord의 [#comfy-mcp-and-cli](https://discord.gg/xWJn6nhE3R) 채널을 이용해 주세요. +- **[피드백 설문조사](https://links.comfy.org/cloudmcpbeta)**: 버그 신고, 기능 요청 또는 일반적인 소감을 공유하세요. +- **Discord**: Comfy Discord의 [#comfy-mcp-and-cli](https://discord.gg/xWJn6nhE3R)에서 문의 및 토론하세요. -## 알려진 제한 사항 +## FAQ -Comfy Cloud MCP는 초기 릴리스입니다. 다음 제한 사항이 알려져 있으며 현재 작업 중입니다: +### 시작하기 -**워크플로** + + + MCP와 호환되는 모든 클라이언트가 지원됩니다. -- **에디터 형식에서 실행 가능한 형식으로의 변환에는 아직 미흡한 부분이 있습니다.** 저장된 워크플로는 `run_saved_workflow`를 통해 파일 이름으로 실행되지만(서버가 자동으로 변환), 일부 노드 구성은 여전히 불완전하게 변환됩니다. -- **`submit_workflow`로 생성된 에셋에는 워크플로 메타데이터가 포함되지 않을 수 있습니다.** ComfyUI에서 열 때 원본 워크플로를 다시 열지 못할 수 있습니다. -- **워크플로 구축은 에이전트의 정확성에 달려 있습니다.** 복잡한 다중 노드 워크플로는 재시도 또는 개선이 필요할 수 있습니다. + **클라우드 연결**은 원격 HTTP 지원이 필요합니다. **Claude Code**, **Claude Desktop**, **Cursor**, **Codex**, **OpenClaw**는 위에서 가장 간편하게 설정할 수 있습니다. **Windsurf**, **Amp** 등도 OAuth나 API 키와 함께 같은 URL을 사용합니다. -**파일 처리** + **로컬 연결**은 로컬 stdio 서버를 하위 프로세스로 실행할 수 있는 클라이언트가 필요합니다. 따라서 브라우저 기반 클라이언트는 사용할 수 없습니다. [claude.ai](https://claude.ai)와 ChatGPT는 원격 커넥터만 허용합니다. + + + 클라우드 연결은 `https://cloud.comfy.org/mcp`에서 실행됩니다. -- **출력은 쉘 다운로드 단계가 필요합니다.** [출력 및 다운로드](#outputs-and-downloads)를 참조하세요. -- **업로드 크기 제한**은 MCP 클라이언트에 따라 적용될 수 있습니다. 일부 클라이언트는 파일 업로드에 자체 제한을 부과합니다. + 로컬 연결에는 URL이 없습니다. 클라이언트가 `comfy-mcp` 명령을 직접 실행하고 stdio를 통해 통신합니다. + + + 사용할 수 있습니다. 바로 [로컬 Comfy MCP 연결](#local-comfy-mcp-connection)입니다. 직접 설치한 ComfyUI를 구동하므로, 에이전트가 실제로 보유한 모델, LoRA, 커스텀 노드를 인식하고 여러분의 GPU에서 실행됩니다. + + + 네, 로컬에서 ComfyUI를 실행한다면 이 방법을 권장합니다. 대부분의 클라이언트는 두 개의 MCP 서버를 문제없이 호스팅하며, 에이전트는 각 연결을 분리하여 처리합니다. 각 연결은 자체 워크플로를 실행하고 자체 결과를 반환합니다. -**인증** + 단, 두 연결의 로그인은 **별도**로 진행해야 합니다. 동일한 Comfy 계정이라도 한쪽에서 로그인했다고 다른 쪽이 자동으로 로그인되지는 않습니다. + + + 에이전트에게 물어보세요. 무거운 작업을 시작하기 전에 에이전트가 하드웨어를 확인합니다. -- **OAuth 또는 API 키.** Claude Code와 Claude Desktop은 일회성 브라우저 OAuth 흐름을 사용합니다. **Cursor**는 MCP 구성에 Comfy Cloud API 키가 필요합니다(OAuth 없음). 다른 헤드리스 클라이언트는 대신 `X-API-Key` 헤더를 통해 Comfy Cloud API 키를 전달할 수 있습니다. 브라우저를 열 수 없는 클라이언트를 위한 장치 코드 OAuth 흐름이 계획되어 있습니다. + **Mac**에서는 생성 작업에 클라우드 연결을 사용하세요. 현재의 오픈웨이트 모델은 Apple GPU에서 실용적인 속도로 실행하기에는 너무 큽니다. **전용 그래픽 카드가 있는 PC**의 경우, VRAM이 24GB 이상이면 비디오를 포함한 대부분의 작업을 처리할 수 있습니다. 8~24GB는 이미지에 적합하지만 비디오는 느리거나 맞지 않을 수 있습니다. 8GB 미만이라면 클라우드를 사용하세요. + + + 클라우드 연결은 **공개 베타** 상태입니다. API, 도구, 동작은 개발 과정에서 변경될 수 있습니다. 문제를 신고하려면 [피드백](#feedback)을 참고하세요. + + -## 자주 묻는 질문 +### 비용과 접근 - - 원격 HTTP 전송을 지원하는 모든 MCP 호환 클라이언트는 `https://cloud.comfy.org/mcp`에 연결할 수 있습니다. **Claude Code**, **Claude Desktop**, **Cursor**, **Codex** 및 **OpenClaw**에 대한 일급 설정을 문서화합니다. **Windsurf**, **Amp** 및 기타 에이전트는 OAuth 또는 API 키를 사용하여 동일한 URL을 따릅니다. [Comfy Cloud MCP 설치](#install-comfy-cloud-mcp)를 참조하세요. + + 탐색은 두 연결 모두에서 무료입니다. 템플릿, 모델, 노드를 검색하는 데는 Comfy 계정만 있으면 됩니다. + + **클라우드 연결**에서는 생성을 실행하려면 활성 Comfy Cloud 구독이 필요합니다. 신규 사용자에게는 5회의 무료 실행이 제공됩니다. **로컬 연결**에서는 사용자 하드웨어에서 실행되므로 무료입니다. 단, 한 가지 예외가 있습니다: 파트너 모델은 파트너 인프라에서 실행되며 크레딧이 소모됩니다. - OAuth를 지원하는 대화형 클라이언트(Claude Code, Claude Desktop, Codex, OpenClaw 등)에는 필요하지 않습니다. **Cursor**의 경우 MCP 구성에 Comfy Cloud API 키가 필요합니다. API 키는 브라우저 없이 헤드리스 또는 CI 설정에서도 필요합니다. [Comfy Cloud MCP 설치](#install-comfy-cloud-mcp)의 **Cursor** 탭, **OpenClaw** 탭 또는 **기타 클라이언트** 탭을 참조하세요. + OAuth를 지원하는 인터랙티브 클라이언트에서는 필요하지 않습니다. Claude Code, Claude Desktop, Codex, OpenClaw 등이 여기에 해당합니다. + + **Cursor**는 MCP 구성에 Comfy Cloud API 키가 필요합니다. 아직 MCP OAuth를 지원하지 않기 때문입니다. 브라우저가 없는 헤드리스 및 CI 환경에서도 API 키가 필요합니다. [클라우드 연결 설정](#set-up-the-cloud-connection)의 **Cursor** 및 **Other clients** 탭을 참조하세요. - - 유료 생성에는 지출 게이트가 적용됩니다: 실행이 Comfy Cloud 크레딧을 소모하는 경우(파트너 모델 또는 유료 API 노드가 포함된 워크플로/템플릿), 서버는 실행 전에 사용자의 명시적 동의를 요구합니다. 자세한 내용은 [크레딧 및 지출](#credits-and-spending)을 참조하세요. + + +### 사용하기 + + + + MCP 도구를 직접 호출하지 않습니다. 사용자의 요청에 따라 에이전트가 선택합니다. 일반적으로 사용 가능한 항목을 **탐색**하고(`search_templates`, `search_models`, `search_nodes`), 생성을 **실행**한 후 출력을 **기다렸다가 가져옵니다**. 자세한 내용은 [에이전트로 할 수 있는 일](#what-your-agent-can-do)을 참고하세요. + + + **클라우드 연결**에서는 서버가 사용자의 머신에 기록하지 않습니다. `get_output`은 임시 서명된 URL과 셸에서 실행할 수 있는 다운로드 명령을 반환합니다. 자세한 내용은 [업로드 및 다운로드](#uploads-and-downloads)를 참고하세요. + + **로컬 연결**에서는 ComfyUI가 워크스페이스의 `output/` 디렉터리에 파일을 기록하며, `fetch_outputs(prompt_id, out_dir)`는 완료된 작업의 파일을 지정한 경로로 복사합니다. + + + 실행 취소할 것은 없습니다. 기존 연결에 두 번째 연결을 추가하기만 하면 됩니다. + + **로컬 → 클라우드**로 전환할 때(클라우드 GPU 또는 파트너 모델이 필요할 때): 에이전트에게 로그인하라고 요청한 다음 클라이언트에 `https://cloud.comfy.org/mcp`를 추가하세요. + + **클라우드 → 로컬**로 전환할 때(자신의 모델과 커스텀 노드를 사용하고 싶을 때): ComfyUI와 로컬 서버를 설치한 다음 클라이언트가 이를 가리키도록 설정하세요. 에이전트가 대부분의 작업을 대신해 줍니다. + + + 에이전트에게 요청하기만 하면 됩니다. 두 연결이 모두 추가된 상태에서 작업을 실행할 위치를 말하세요: "이 작업을 Comfy Cloud에서 실행해 줘", "로컬에서 이 작업을 해 줘"라고 하면 에이전트가 적절한 연결을 사용합니다. 실행 간에 전환할 모드도 없고 재설정할 것도 없습니다. + + 워크플로가 기기에 너무 무겁다고 판단되면, 에이전트가 알려주며 Comfy Cloud에서 대신 실행하도록 제안할 수 있습니다. 하나의 연결만 설정되어 있다면, 다른 연결을 추가하도록 요청하세요. 자세한 내용은 [클라우드 연결 설정](#set-up-the-cloud-connection) 또는 [로컬 Comfy MCP 연결](#local-comfy-mcp-connection)을 참고하세요. - - 아니요. 슬래시 명령은 Claude Code 플러그인에 포함되어 있습니다. Claude Desktop은 동일한 MCP 서버에 연결됩니다(일반 언어로 요청하거나 프롬프트 선택기를 사용하면 도구가 작동합니다). 하지만 Claude Code 플러그인이나 슬래시 명령은 지원하지 않습니다. + + **클라우드 연결**에서는 할 일이 없습니다. 호스팅되기 때문에 항상 최신 버전을 사용 중입니다. + + **로컬 연결**에서는 에이전트에게 처리하도록 요청하세요. 그 후, **클라이언트를 재시작**하거나 새 세션을 시작하세요. MCP 서버는 세션이 시작될 때 로드되므로, 실행 중인 서버는 재시작하거나 새 세션을 시작하기 전까지 이전 버전을 계속 제공합니다. - - `/comfy` 또는 `/cloud` 명령은 없습니다. 명령은 연결 방식에 따라 두 가지 접두사 중 하나로 나타납니다: + - - **플러그인 (권장):** `/comfy-cloud:generate-image`, `/comfy-cloud:generate-video`, … — 전체를 보려면 `/comfy-cloud:`를 입력하세요. - - **직접 연결 (플러그인 없음):** `/mcp__comfy-cloud__generate-image`, … — 보려면 `/mcp__`를 입력하세요. +### 트러블슈팅 - 어느 쪽이든 일반 언어로 요청할 수도 있습니다 ("...의 이미지 생성"). MCP 도구는 모델에 의해 호출되며 슬래시 명령이 필요하지 않습니다. + + + 아니요. 슬래시 명령은 Claude Code 플러그인에서 제공됩니다. Claude Desktop은 동일한 MCP 서버에 연결되며, 평범한 언어로 요청하거나 prompt picker를 사용하면 도구가 작동합니다. 하지만 Claude Code 플러그인이나 슬래시 명령은 지원되지 않습니다. - - Claude Code에서 `/mcp`를 실행하고 **comfy-cloud**를 **선택**한 다음 **인증**을 선택하세요. Claude Desktop에서는 **사용자 정의 → 커넥터**에서 커넥터를 다시 열고 로그인을 트리거하세요. + + `/comfy` 또는 `/cloud` 명령은 없습니다. 연결 방법에 따라 명령이 다음 두 접두사 중 하나로 나타납니다: + + - **플러그인(권장):** `/comfy-cloud:generate-image`, `/comfy-cloud:generate-video`, … — 모두 보려면 `/comfy-cloud:`를 입력하세요. + - **직접 연결(플러그인 없음):** `/mcp__comfy-cloud__generate-image`, … — 보려면 `/mcp__`를 입력하세요. + + 어느 쪽이든 평범한 언어로 요청할 수 있습니다("...의 이미지를 생성해 줘"). MCP 도구는 모델이 호출하므로 슬래시 명령이 필요하지 않습니다. - - Comfy Cloud MCP는 당사의 호스팅 서비스이지만, 로컬 에이전트 워크플로는 ComfyUI가 오픈소스화된 이후로 존재해 왔습니다. Agent Tools 개요에서 [로컬 ComfyUI는 어떻습니까?](/ko/agent-tools#what-about-local-comfyui)를 참조하여 클라우드가 먼저 출시된 이유, 현재 사용할 수 있는 커뮤니티 MCP 서버, 그리고 또 다른 옵션인 [Comfy CLI](/ko/agent-tools/cli)를 확인하세요. + + Claude Code에서는 `/mcp`를 실행하고 **comfy-cloud**를 선택한 다음 **Authenticate**를 선택합니다. Claude Desktop에서는 **Customize → Connectors**에서 커넥터를 다시 열고 로그인을 트리거합니다. diff --git a/ko/agent-tools/skills.mdx b/ko/agent-tools/skills.mdx new file mode 100644 index 000000000..8634d9ac8 --- /dev/null +++ b/ko/agent-tools/skills.mdx @@ -0,0 +1,25 @@ +--- +title: "스킬" +sidebarTitle: "스킬" +description: "Comfy Skills 저장소를 통해 게시되는 Comfy용 에이전트 스킬과 플러그인." +icon: "wand-magic-sparkles" +translationSourceHash: 6ebd0106 +translationFrom: agent-tools/skills.mdx +--- + +[**Comfy Skills**](https://github.com/Comfy-Org/comfy-skills)는 Comfy용 에이전트 스킬과 플러그인의 본거지입니다. 스킬은 에이전트가 필요 시 로드하는 패키지화된 지식입니다: 모델 가이드, 워크플로 패턴, 즉시 사용 가능한 명령어. 프롬프트를 처음부터 작성하지 않아도 모든 에이전트가 ComfyUI를 더 잘 활용할 수 있습니다. + +이 저장소는 다음을 호스팅합니다: + +- **Claude Code 플러그인**: 예를 들어 **comfy-cloud**는 Comfy Cloud MCP 연결과 `/comfy-cloud:*` 슬래시 명령어를 한 번의 설치로 추가합니다. +- **에이전트 스킬**: 특정 작업에 초점을 맞춘 지침입니다. 최신 모델 추천과 워크플로 구축 노하우가 포함되며, 모델이 변경됨에 따라 최신 상태로 유지됩니다. +- **커뮤니티 기여**: Comfy 커뮤니티의 스킬과 플러그인. + +Claude Code에서 사용하려면: + +``` +/plugin marketplace add Comfy-Org/comfy-skills +/plugin install comfy-cloud@comfy-skills +``` + +플러그인의 슬래시 명령어와 설정 세부 정보는 [Comfy MCP](/ko/agent-tools/mcp)를 참조하세요. \ No newline at end of file diff --git a/ko/development/overview.mdx b/ko/development/overview.mdx index 3c6223f66..71a2cc791 100644 --- a/ko/development/overview.mdx +++ b/ko/development/overview.mdx @@ -1,18 +1,21 @@ --- title: "개요" description: "개발자로서 ComfyUI 사용하기" -translationSourceHash: 4d431c1f +translationSourceHash: 5514e159 translationFrom: development/overview.mdx translationBlockHashes: "_intro": 21d39346 "Deploy ComfyUI as a Server": 07693c4c "Cloud API": 80dab2ed - "Agent Tools / MCP": e325a91e + "Agent Tools / MCP": abe9d443 "Comfy CLI": 11578ce8 "Develop Custom Nodes": 51cd210e "Registry": cc46f1e1 --- + + + ComfyUI는 서버로 실행되고 API를 통해 접근 가능하며, 커스텀 노드로 확장할 수 있고 명령줄에서 관리 가능한 모듈식 GenAI 추론 엔진입니다. 아래에서 원하는 방식을 선택하세요. ## ComfyUI를 서버로 배포하기 @@ -43,7 +46,7 @@ ComfyUI는 서버로 실행되고 API를 통해 접근 가능하며, 커스텀 클라우드 MCP, Local MCP, Comfy CLI를 비교하고, AI 에이전트 통합에 적합한 설정을 찾아보세요. -참고: [Comfy Cloud MCP](/ko/agent-tools/mcp) · [Comfy Local MCP](/ko/agent-tools/local) +참고: [Comfy MCP](/ko/agent-tools/mcp): 클라우드 및 로컬 연결 ## Comfy CLI diff --git a/zh/agent-tools/cli.mdx b/zh/agent-tools/cli.mdx index a6a65b93c..ca0e537a4 100644 --- a/zh/agent-tools/cli.mdx +++ b/zh/agent-tools/cli.mdx @@ -3,11 +3,11 @@ title: "Comfy CLI" description: "从终端驱动 Comfy：本地 ComfyUI、合作伙伴生成调用以及 Comfy Cloud 上的完整工作流。与 MCP 互补，适用于脚本、CI 和自动化。" sidebarTitle: "Comfy CLI" icon: "terminal" -translationSourceHash: 03991204 +translationSourceHash: bc3e7c14 translationFrom: agent-tools/cli.mdx translationBlockHashes: "_intro": cb162cdd - "How it fits with MCP": a426486a + "How it fits with MCP": a452f8fb "What the CLI does": 3c8cfc5f "Install and set up": 4c281b95 "Prerequisites for `comfy generate`": 66aa291a @@ -16,10 +16,12 @@ translationBlockHashes: "Usage examples": f6768bfe "Beyond `comfy generate`": 8e75f6a8 "Agent skills": 5cfcfe55 - "Related resources": e600c92d + "Related resources": d4e97516 "Feedback": fce347e2 --- + + import GenerateBetaInfo from "/snippets/zh/comfy-cli/generate-beta-info.mdx"; import AgentSkills from "/snippets/zh/comfy-cli/agent-skills.mdx"; import InstallCli from "/snippets/zh/install-comfycli.mdx"; @@ -42,14 +44,14 @@ import GenerateVideoAsync from "/snippets/zh/comfy-cli/generate-video-async.mdx" ## 如何与 MCP 配合使用 -| | Comfy Cloud MCP | Comfy CLI | +| | Comfy MCP（云端） | Comfy CLI | |---|---|---| | **接口** | 与 MCP 客户端（Claude Code、Claude Desktop 等）对话 | 终端命令和脚本 | -| **适用场景** | 聊天中的交互式代理工作流 | 自动化、批量运行、CI、Shell 管道 | +| **适用场景** | 聊天中的交互式代理工作流 | 自动化、批处理运行、CI、Shell 管道 | | **认证** | MCP 客户端中的 OAuth，或 API 密钥（无头模式） | `comfy cloud login`（OAuth）或 API 密钥（CI） | -| **输出** | 返回至聊天会话 | 保存到磁盘（`--download`）或 JSON（`--json`） | +| **输出** | 在聊天会话中返回 | 保存到磁盘（`--download`）或 JSON（`--json`） | -有关 MCP 设置、安装、工具列表和认证方法，请参阅 [Comfy Cloud MCP](/zh/agent-tools/mcp)。 +有关 MCP 设置、安装、工具列表和认证方法，请参阅 [Comfy MCP](/zh/agent-tools/mcp)。 ## CLI 能做什么 @@ -151,7 +153,7 @@ comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url' |---|---| | [Comfy CLI 入门](/zh/comfy-cli/getting-started) | **完整**安装指南和命令演练 | | [Comfy CLI 参考](/zh/comfy-cli/reference) | 命令、标志和模型别名 | -| [Comfy Cloud MCP](/zh/agent-tools/mcp) | 通过 MCP 连接代理，实现聊天驱动的生成 | +| [Comfy MCP](/zh/agent-tools/mcp) | 通过 MCP 连接代理，实现聊天驱动的生成 | | [GitHub 上的 comfy-cli](https://github.com/Comfy-Org/comfy-cli) | 源码仓库、问题反馈及最新行为 | ## 反馈 diff --git a/zh/agent-tools/in-app-agent.mdx b/zh/agent-tools/in-app-agent.mdx index 5418435be..26bba768a 100644 --- a/zh/agent-tools/in-app-agent.mdx +++ b/zh/agent-tools/in-app-agent.mdx @@ -1,22 +1,22 @@ --- title: "Comfy 应用内智能体" sidebarTitle: "应用内智能体" -description: "加入 Comfy Cloud 上 Comfy 应用内智能体的内测等候列表。" +description: "加入 Comfy Cloud 上 Comfy 应用内智能体的内测候补名单。" icon: "comments" -translationSourceHash: 6f0c61ab +translationSourceHash: 4eff238a translationFrom: agent-tools/in-app-agent.mdx --- - **内测阶段。** Comfy 应用内智能体目前仅向部分用户开放。公开文档和网站页面尚不可用。加入等候列表以申请访问权限。 + **私有内测。** Comfy 应用内智能体目前仅向部分用户开放。公开文档和网站页面尚不可用。加入候补名单以申请访问权限。 -**Comfy 应用内智能体**是在 Comfy Cloud 中的智能体体验：在聊天中提示，智能体可以在你的图上构建或编辑工作流（生成前需确认）。 +**Comfy 应用内智能体**是 Comfy Cloud 中的智能体体验：在聊天中输入提示，智能体即可在你的图上构建或编辑工作流。 -## 加入等候列表 +## 加入候补名单 - - 申请访问 Comfy 应用内智能体内测。 + + 申请访问 Comfy 应用内智能体的内测。 ## 反馈 @@ -32,10 +32,10 @@ translationFrom: agent-tools/in-app-agent.mdx 寻找可从 Claude、Cursor、Codex 及其他 MCP 客户端（在 ComfyUI 画布之外）使用的智能体工具？ - - 将外部 MCP 客户端连接到 Comfy Cloud，用于生成、搜索和工作流。 + + 将外部 MCP 客户端连接到 ComfyUI，用于生成、搜索和工作流。 - - 比较 Cloud MCP、Local MCP 和 Comfy CLI。 + + 比较云端连接、本地连接和应用内智能体。 - + \ No newline at end of file diff --git a/zh/agent-tools/index.mdx b/zh/agent-tools/index.mdx index 4f3ee35de..ffa89ee36 100644 --- a/zh/agent-tools/index.mdx +++ b/zh/agent-tools/index.mdx @@ -1,39 +1,21 @@ --- -title: "Agent Tools / MCP" -description: "通过 Model Context Protocol (MCP) 将 AI 代理连接到 ComfyUI，用于生成图像、视频、音频和 3D 内容。" +title: "Agent 工具" +description: "利用 AI 代理更智能、更快速地使用 ComfyUI。Comfy MCP、Comfy CLI 和 Comfy In-App Agent。" sidebarTitle: "概览" icon: "robot" -translationSourceHash: f467366b +translationSourceHash: 8c401b64 translationFrom: agent-tools/index.mdx -translationBlockHashes: - "_intro": 9db234db - "Which One Should I Use?": 7b3ab710 - "What about local ComfyUI?": 6e518082 - "What is MCP?": bb62fbe5 --- -ComfyUI 提供了 **MCP 服务器** 和 **Comfy CLI**，让 AI 代理和开发者无需总是打开 ComfyUI 画布即可生成图像、视频、音频和 3D 内容。 - - - **Comfy Cloud MCP 处于公开测试阶段。** 设置、反馈渠道及相关工具（Comfy Skills、Comfy CLI）详见 [Comfy Cloud MCP](/zh/agent-tools/mcp) 页面。 - - - - **Comfy In-App Agent 处于私有内测阶段。** 完整文档尚未公开。加入 [候补名单](/zh/agent-tools/in-app-agent) 申请访问权限。 - - - - 连接至托管在 cloud.comfy.org/mcp 的 MCP 服务器。在 Cloud GPU 上生成图像、视频、音频和 3D 内容，搜索模板/模型/节点，运行工作流，并通过聊天分享已保存的工作流。 + + 将任何 AI 代理连接到 ComfyUI，无论是在 Comfy Cloud 上还是在您自己的机器上。**从这里开始。** Comfy Cloud 内部的代理体验（通过聊天构建和编辑您的画面）。*私有内测；目前仅限候补名单。* - - 第一方本地 MCP 服务器，通过 comfy-cli 驱动您**自己的** ComfyUI 安装。*私有测试；尚未公开提供。* - - 关于 comfy generate 的简短代理导向概述。完整 CLI 指南请参见 [入门](/zh/comfy-cli/getting-started)。 + 终端中的 ComfyUI。安装和更新 ComfyUI，管理模型和节点，并通过脚本、CI 或批处理作业生成。 @@ -41,41 +23,24 @@ ComfyUI 提供了 **MCP 服务器** 和 **Comfy CLI**，让 AI 代理和开发 ## 我该用哪个？ -| | Comfy Cloud MCP | Comfy Local MCP | Comfy CLI | +| | Comfy MCP
云端连接 | Comfy MCP
本地连接 | Comfy In-App Agent | |---|---|---|---| -| **类型** | 远程（托管） | 本地 MCP 服务器 | 本地 CLI | -| **需要** | Comfy Cloud 订阅 | 本地 ComfyUI + [comfy-cli](https://github.com/Comfy-Org/comfy-cli) | [Comfy API 密钥](/zh/development/api-development/getting-an-api-key) | -| **模型** | Comfy Cloud 模型（预装） | 您的本地模型和自定义节点 | 通过 `comfy generate` 调用的合作伙伴节点 | -| **工作流** | 完整的 ComfyUI 工作流执行 | 完整的本地 ComfyUI 工作流执行 | 一次性合作伙伴 API 调用（无需工作流 JSON） | -| **GPU** | Cloud GPU（无需本地 GPU） | 您的本地 GPU | 无需 GPU（基于 API） | -| **最佳用途** | 聊天驱动代理、模板搜索 | 从聊天驱动您的本地 ComfyUI | 脚本、CI、批处理作业 | - ---- - -## 那本地 ComfyUI 呢？ - -想用 AI 代理驱动**本地** ComfyUI 安装，而不是（或同时使用）Comfy Cloud MCP 吗？请参阅 [**Comfy Local MCP**](/zh/agent-tools/local) 了解我们的第一方本地 MCP 服务器、设置和客户端配置。目前处于**私有测试**阶段，尚未公开发布。 - -**社区 MCP 服务器。** 多个社区项目也将 MCP 客户端连接到本地 ComfyUI 实例： - -| 项目 | 仓库 | -| --- | --- | -| comfyui-mcp | [artokun/comfyui-mcp](https://github.com/artokun/comfyui-mcp) | -| comfyui-mcp | [shawnrushefsky/comfyui-mcp](https://github.com/shawnrushefsky/comfyui-mcp) | -| comfyui-mcp-server | [joenorton/comfyui-mcp-server](https://github.com/joenorton/comfyui-mcp-server) | -| comfy-mcp-server | [lalanikarim/comfy-mcp-server](https://github.com/lalanikarim/comfy-mcp-server) | - -这些是**社区维护的**。我们提供链接以方便使用；支持、功能和兼容性因项目而异。 +| **是什么** | 使用您自己的代理运行 Comfy Cloud 工作流。 | 使用您自己的代理驱动您自己的本地 ComfyUI。 | 在应用内与 AI 聊天，观看它为您构建并运行工作流。 | +| **最适合** | 不想在本地设置 ComfyUI 的初学者。
想要分享工作流的人。 | 在本地拥有 ComfyUI 的人。
拥有私有自定义节点的人。
需要与本地文件系统交互的人。 | 从初学者到高级工作流构建者的所有人。
想要查看画布并直观检查工作流的人。 | +| **需要** | 您自己的代理。
有效的 Comfy Cloud 订阅。 | 您自己的代理。
本地 ComfyUI 环境。 | 无需设置。
有效的 Comfy Cloud 订阅。 | +| **GPU** | 云端 GPU（无硬件要求） | 您的本地 GPU | 云端 GPU（无硬件要求） | +| **模型** | Comfy Cloud 模型。
您可以导入您自己的模型。 | 下载到您机器上的本地模型。 | Comfy Cloud 模型。
您可以导入您自己的模型。 | +| **自定义节点** | Comfy Cloud 支持的自定义节点。 | 您可以安装任何自定义节点。 | Comfy Cloud 支持的自定义节点。 | -**想要终端工作流而不是聊天？** 请参阅 [Comfy CLI](/zh/agent-tools/cli)（`comfy generate`，测试版）用于脚本和自动化。要从终端安装并启动本地 ComfyUI，请从 [Comfy CLI 入门](/zh/comfy-cli/getting-started)开始。 +MCP 两列是**同一个产品和同一个页面**。请参阅 [Comfy MCP](/zh/agent-tools/mcp) 选择其一。您可以同时连接两者。 --- ## 什么是 MCP？ -**Model Context Protocol (MCP)** 是一个开放标准，允许 AI 助手通过标准化接口与外部工具和服务交互。MCP 为工具提供统一的暴露方式，AI 代理无需为每个服务学习不同的 API 格式。 +**Model Context Protocol (MCP)** 是一个开放标准，允许 AI 助手通过标准化接口与外部工具和服务交互。AI 代理无需为每个服务学习自定义 API 格式，MCP 提供了一种统一的工具暴露方式。 -连接 MCP 服务器到 Claude Desktop、Claude Code、Cursor 或 Amp 后，AI 助手可以： +将 MCP 服务器连接到 Claude Desktop、Claude Code、Cursor 或 Amp 后，AI 助手可以： - **生成图像**：根据文字描述 - **创建视频**：从文字或图像生成 @@ -83,4 +48,4 @@ ComfyUI 提供了 **MCP 服务器** 和 **Comfy CLI**，让 AI 代理和开发 - **生成音频和音乐**：使用 AI 模型 - **搜索模型和模板**：为任务找到合适的工具 -……全部通过自然语言对话完成，无需手动写 API 调用。 +……全部通过自然语言对话完成，无需手动编写 API 调用。 diff --git a/zh/agent-tools/local.mdx b/zh/agent-tools/local.mdx deleted file mode 100644 index 8166947eb..000000000 --- a/zh/agent-tools/local.mdx +++ /dev/null @@ -1,163 +0,0 @@ ---- -title: "Comfy Local MCP" -sidebarTitle: "本地MCP" -description: "使用官方的 comfy-local-mcp 服务器，通过 AI 代理（Claude Code、Claude Desktop、Cursor）驱动你自己的本地 ComfyUI：运行工作流、收集输出，并检查你的安装实际拥有的节点和模型。" -icon: "server" -translationSourceHash: 996d6408 -translationFrom: agent-tools/local.mdx -translationBlockHashes: - "_intro": c57ebd12 - "Requirements": d93ce096 - "Installation": 09f9ec59 - "Configure your AI client": 69542371 - "Quickstart": 80f22916 - "Tools": f40c9da1 - "Related": 257416f6 ---- - - - **私有测试。** `comfy-local-mcp` 目前处于私有测试阶段，尚未公开发布。如果您没有私有测试访问权限，则今天无法安装或使用它。核心循环（`server_info → run_workflow → fetch_outputs`）已针对运行的本地 ComfyUI 进行了端到端验证，但工具和行为可能仍会发生变化。 - - -[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) 是 Comfy 的**第一方本地 MCP 服务器**——从 AI 代理（Claude Code、Claude Desktop、Cursor 及其他 MCP 客户端）驱动**本地** ComfyUI 安装的官方方式。它是在 [comfy-cli](https://github.com/Comfy-Org/comfy-cli) 之上的薄封装：每个工具都会调用外部的 `comfy` 指令，因此 `comfy-cli` 是引擎，并且与 [Comfy Cloud MCP](/zh/agent-tools/mcp) 没有共享任何代码。 - -与云端和合作伙伴服务器不同，它与运行在**您自己的机器**上的 ComfyUI 通信，因此它可以运行您的工作流，并检查您的安装实际拥有的节点、自定义节点和模型。 - ---- - -## 要求 - -- **Python 3.10+** -- **在您的 `PATH` 中的 [comfy-cli](https://github.com/Comfy-Org/comfy-cli)**（`pip install comfy-cli`）：每个工具所依赖的引擎 -- **一个 ComfyUI 工作区**：如果您还没有，请使用 `comfy install` 创建一个（已有的检出可通过 `comfy set-default ` 来使用） -- **正在运行的 ComfyUI**：在使用工具之前，请用 `comfy launch` 启动它；此处的任何操作都不会隐式启动 ComfyUI - -## 安装 - -从[仓库](https://github.com/Comfy-Org/comfy-local-mcp)的检出副本开始： - -```bash -pip install . # 或 `pip install -e .` 以获得可编辑的副本 -``` - -这会将一个名为 `comfy-local-mcp` 的控制台脚本添加到您的 `PATH` 中。该命令就是 MCP 服务器（它通过 stdio 使用 MCP 协议通信）。请按下方说明将其配置到您的 AI 客户端。 - - - **`COMFY_BIN`（可选）。** MCP 客户端会在自己的环境中启动服务器，该环境通常**不**包含您 shell 环境中的 `PATH`。如果 `comfy` 位于虚拟环境或非标准位置，请将 `COMFY_BIN` 设置为其绝对路径（例如 `/path/to/venv/bin/comfy`）。下方的每个客户端示例都会说明其放置位置；如果 `comfy` 已存在于客户端用来启动服务器的环境中，则可以省略该设置。 - - ---- - -## 配置 AI 客户端 - -所有客户端均使用相同的 MCP stdio 协议：将 `comfy-local-mcp` 指令作为服务器运行。选择您的客户端。 - -### Claude Code - -一条指令即可注册服务器： - -```bash -claude mcp add comfy-local -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-local-mcp -``` - -或者通过项目根目录下的 `.mcp.json` 文件将其纳入版本控制： - -```json -{ - "mcpServers": { - "comfy-local": { - "command": "comfy-local-mcp", - "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } - } - } -} -``` - -### Claude Desktop - -编辑 `claude_desktop_config.json`（设置 → 开发者 → 编辑配置；macOS 上位于 `~/Library/Application Support/Claude/claude_desktop_config.json`），添加服务器，然后重新启动 Claude Desktop： - -```json -{ - "mcpServers": { - "comfy-local": { - "command": "comfy-local-mcp", - "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } - } - } -} -``` - -### Cursor - -将服务器添加到 `~/.cursor/mcp.json`（全局）或 `.cursor/mcp.json`（按项目）： - -```json -{ - "mcpServers": { - "comfy-local": { - "command": "comfy-local-mcp", - "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } - } - } -} -``` - ---- - -## 快速入门 - -从零开始到已生成图像： - - - - ```bash - pip install comfy-cli # 引擎 - comfy install # 创建ComfyUI工作区（如果已有则跳过） - pip install . # 此MCP服务器 → `comfy-local-mcp`指令 - ``` - - - ```bash - comfy launch - ``` - - - 使用上面适用于您客户端的代码片段，然后重新启动/重新加载它，以便工具出现。 - - - 例如： - - > "确认我的本地ComfyUI正在运行，然后运行 `~/workflows/txt2img.json` 中的工作流并向我展示图像。" - - 在底层，代理调用 `server_info` 确认ComfyUI已启动，调用 `run_workflow` 执行工作流JSON，并调用 `fetch_outputs` 收集结果。 - - - ---- - -## 工具 - -每个工具对应一个 `comfy-cli` 指令，使用 `--where local` 运行。主要工具如下： - -| 工具 | 用途 | -|---|---| -| `server_info()` | 检查本地 ComfyUI 是否正在运行、运行位置以及所属工作区。**请优先调用。** | -| `run_workflow(workflow_path, wait=True)` | 运行工作流 JSON；`wait=False` 时异步提交并返回一个 `prompt_id`。 | -| `job_status` / `wait_for_job` / `watch_job` | 轮询、等待或流式查看已提交的任务。 | -| `fetch_outputs(prompt_id, out_dir)` | 将已完成任务的输出复制到 `out_dir`。 | -| `launch_comfyui` / `stop_comfyui` | 启动或停止本地的 ComfyUI。 | -| `search_templates` / `fetch_template` | 查找内置模板并写入其可运行的工作流 JSON。 | -| `search_nodes` / `get_node` / `list_nodes` | 检查**本地实时安装**中的节点类（包括自定义节点）。 | -| `search_models` | 列出磁盘上的模型文件。 | -| `validate_workflow` | 在慢速运行之前，针对实时的 `object_info` 预检工作流。 | - -节点内省和模型搜索会读取您的**实时安装**（包括自定义节点），这是本地与云端 MCP 的差异所在。请参阅[仓库](https://github.com/Comfy-Org/comfy-local-mcp)获取完整工具列表和参考。 - ---- - -## 相关 - -- [Comfy Cloud MCP](/zh/agent-tools/mcp)：托管MCP服务器，无需本地安装或GPU -- [Comfy CLI](/zh/agent-tools/cli)：从终端驱动本地ComfyUI和合作伙伴生成 -- [comfy-local-mcp on GitHub](https://github.com/Comfy-Org/comfy-local-mcp)：来源、安装和工具参考 diff --git a/zh/agent-tools/mcp.mdx b/zh/agent-tools/mcp.mdx index 58e8a3be8..89fa2d999 100644 --- a/zh/agent-tools/mcp.mdx +++ b/zh/agent-tools/mcp.mdx @@ -1,48 +1,60 @@ --- -title: "Comfy Cloud MCP" -sidebarTitle: "Cloud MCP" -description: "从 Claude Code、Claude Desktop、Cursor、Codex、OpenClaw 或任何兼容 MCP 的代理连接 Comfy Cloud MCP：生成图像、视频、音频和 3D，搜索模型与节点，并运行工作流。" -icon: "cloud" -translationSourceHash: f491b28c +title: "Comfy MCP" +sidebarTitle: "Comfy MCP" +description: "将任意 AI 智能体连接到 Comfy Cloud GPU 或本机上的 ComfyUI。生成图像、视频、音频和 3D，搜索模型、节点与模板，并运行真实工作流。" +icon: "bolt" +translationSourceHash: 15897127 translationFrom: agent-tools/mcp.mdx translationBlockHashes: - "_intro": b1c56a40 - "Overview": 2972aa17 - "Install Comfy Cloud MCP": b4e1e157 - "What your agent can do": 2c2a22e6 - "MCP tools": a9211dee - "Credits and spending": 686040e6 - "Outputs and downloads": a2c8c12f + "_intro": 340316c1 + "Overview": 64064e0e + "Comfy Cloud MCP Connection": f820ca16 + "Local Comfy MCP Connection": 5b13e8fd "Related resources": 2a86e2c5 "Related: Comfy In-App Agent": be5e2cdf - "Feedback": 6872768e - "Known limitations": 2f9e13ba - "FAQ": c943ff55 + "Feedback": 25a3d53f + "FAQ": 45b297ec --- -import CloudFeature from '/snippets/zh/cloud-feature.mdx' - + + **公共测试版。** Comfy MCP 目前处于公共测试版阶段。API、工具和行为可能会在迭代过程中发生变化。请参阅[反馈](#feedback)来报告问题或分享建议。 + + +## 概览 + +**Comfy MCP** 通过[模型上下文协议](https://modelcontextprotocol.io)将 AI 智能体连接到 ComfyUI。连接后，您可以生成图像、视频、音频和 3D，搜索模型、节点和模板，并与智能体聊天运行真实的 ComfyUI 工作流。 + +它提供两种连接：**Comfy Cloud** 连接和**本地 ComfyUI** 连接，其中本地连接完全开源。 + + + **对以下任何内容感到困惑？最佳方式是将此页面交给您的智能体并寻求帮助。** + + +### 我该选哪种连接？ + +**对于新用户，我们建议从云端连接开始。** 这是最简单的设置。如果您使用 claude.ai、ChatGPT 或 Claude Desktop 聊天应用，云端连接也是更兼容的选择。 + +**如果您已在本地或自己部署的环境中运行 ComfyUI，或者您主要在编码智能体中工作**，比如 Claude Code、Cursor 或 Codex，请从**本地**连接开始。 - **公开测试版。** Comfy Cloud MCP 目前处于公开测试阶段。API、工具和行为在迭代过程中可能会发生变化。请参阅[反馈](#反馈)来报告问题或分享建议。 + **对于 Mac 用户，如果您计划运行开源模型，我们推荐云端连接。** 当前的开放权重模型（如 MiniMax H3、LTX-2.3 等的本地版本）都很大，在 Apple GPU 上无法以可行的速度运行。 -## 概述 +同时运行两者是正常的，大多数客户端都可以愉快地托管两个 MCP 服务器。它们登录到同一个 Comfy 账户，但**分开**进行：一次登录并不涵盖另一个。 -**Comfy Cloud MCP 服务器**通过[模型上下文协议（MCP）](https://modelcontextprotocol.io)将 AI 代理连接到 [Comfy Cloud](https://cloud.comfy.org)。连接后，你可以通过代理对话生成图像、视频、音频和3D，搜索模型、节点和模板，并运行 ComfyUI 工作流。 -服务器远程运行在 `cloud.comfy.org/mcp`。工作流在 Comfy Cloud GPU 上执行，因此你无需本地 GPU。你的代理通过 HTTPS 与服务器通信；服务器将工具调用转换为经过身份验证的请求，代表你发送给 Comfy Cloud。 +## Comfy Cloud MCP 连接 -任何 **MCP 兼容客户端**都可以连接到相同的服务器 URL。**Claude Code**、**Claude Desktop**、**Cursor**、**Codex** 和 **OpenClaw** 在下方有优先设置指导。**Windsurf**、**Amp** 和其他代理使用相同的 URL，搭配 OAuth 或 API 密钥。 +托管连接，将你的智能体关联到你的 **Comfy Cloud** 账户。无需安装，工作流在 Comfy Cloud GPU 上运行。要了解更多关于 Comfy Cloud 的信息，请参阅 [Comfy Cloud](/zh/get_started/cloud)。 -## 安装 Comfy Cloud MCP +### 设置云端连接 - 你需要有一个 [Comfy Cloud](https://cloud.comfy.org) 账户才能连接。如果你还没有，请[注册](https://cloud.comfy.org)。设置期间的 OAuth 登录会使用你的 Comfy 账户。 + 连接之前，你需要一个 [Comfy Cloud](https://cloud.comfy.org) 账户。如果你还没有账户，请[注册](https://cloud.comfy.org)；新用户可获得 **5 次免费运行**，试试看。设置期间的 OAuth 登录会使用你的 Comfy 账户。 -Comfy Cloud MCP 运行于： +Comfy Cloud MCP 运行地址： ``` https://cloud.comfy.org/mcp @@ -52,7 +64,7 @@ https://cloud.comfy.org/mcp - Claude Desktop 通过其 UI 将 Comfy Cloud 添加为**自定义连接器**，然后运行 OAuth 登录。 + Claude Desktop 通过其界面将 Comfy Cloud 添加为 **custom connector**，然后运行 OAuth 登录。 - + 在侧边栏中，点击 **Customize**（标记为 **1**）。 - ![Claude Desktop — 打开自定义](/images/agent_tools/claude_desktop_mcp_setup_step1.png) + ![Claude Desktop — open Customize](/images/agent_tools/claude_desktop_mcp_setup_step1.png) - + 点击 **Connectors**（标记为 **2**）。 - ![Claude Desktop — 打开连接器](/images/agent_tools/claude_desktop_mcp_setup_step2.png) + ![Claude Desktop — open Connectors](/images/agent_tools/claude_desktop_mcp_setup_step2.png) - - 1. 点击连接器标题中的 **+** 按钮（标记为 **3**）。 + + 1. 点击 Connectors 标题中的 **+** 按钮（标记为 **3**）。 2. 选择 **Add custom connector**（标记为 **4**）。 - ![Claude Desktop — 添加自定义连接器](/images/agent_tools/claude_desktop_mcp_setup_step3.png) + ![Claude Desktop — add custom connector](/images/agent_tools/claude_desktop_mcp_setup_step3.png) - 1. 在 **Name** 字段中输入一个名称，例如 **Comfy Cloud MCP**（标记为 **5**）。 + 1. 在 **Name** 字段（标记为 **5**）中输入一个名称，例如 **Comfy Cloud MCP**。 2. 将 **Remote MCP server URL** 设置为 `https://cloud.comfy.org/mcp`（标记为 **6**）。 3. 点击 **Add**（标记为 **7**）。 - ![Claude Desktop — 连接器详情](/images/agent_tools/claude_desktop_mcp_setup_step4.png) + ![Claude Desktop — connector details](/images/agent_tools/claude_desktop_mcp_setup_step4.png) - 1. 当浏览器打开时，选择你的工作区（例如**个人工作区**）。 - 2. 点击**继续**以授权连接器。你已连接。 + 1. 当浏览器打开时，选择您的工作区（例如 **Personal Workspace**）。 + 2. 点击 **Continue** 以授权连接器。您已连接。 - ![Comfy Cloud MCP 授权](/images/agent_tools/auth.png) + ![Comfy Cloud MCP authorization](/images/agent_tools/auth.png) - Claude Desktop 不支持 Claude Code 斜杠指令。相反，打开**提示词选择器**以使用相同的工作流： - - | 提示词 | 描述 | - | --- | --- | - | `generate-image` | 根据文本描述生成图像 | - | `generate-video` | 从文本或图像生成视频 | - | `generate-audio` | 生成音频、音乐或音效 | - | `generate-3d` | 从文本或图像生成 3D 模型 | - | `upscale-image` | 将图像放大到更高分辨率 | - | `remove-background` | 从图像中移除背景 | - | `search-templates` | 查找预构建的工作流模板 | - | `search-models` | 搜索模型（checkpoint、LoRA、VAE） | - | `search-nodes` | 搜索节点并获取连接建议 | - | `help` | 查看你可以用 ComfyUI Cloud 做什么 | - - 你也可以跳过提示词，直接用自然语言提问。MCP 工具的工作方式相同。 - 安装 **comfy-cloud** 插件。它将 MCP 连接和斜杠指令集成为一步操作。该插件通过 [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) 仓库发布，该仓库托管了 Claude Code 插件以及适用于 Comfy 的社区代理技能。 + 安装 **comfy-cloud** 插件。它一步完成 MCP 连接和斜杠命令的添加。该插件通过 [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) 仓库发布，这里面托管了用于 Comfy 的 Claude Code 插件和社区智能体技能。 - - 添加 Comfy Skills 插件市场（只需一次）： + + 注册 Comfy Skills marketplace（仅需一次）： ``` /plugin marketplace add Comfy-Org/comfy-skills @@ -127,35 +123,35 @@ https://cloud.comfy.org/mcp ``` - 运行 `/mcp`，选择 **comfy-cloud** → **Authenticate**。你的浏览器会打开并登录，令牌会自动刷新。 + 运行 `/mcp`，选择 **comfy-cloud** → **Authenticate**。浏览器会打开以进行登录，令牌会自动刷新。 - 该插件添加了以下斜杠指令： + 该插件添加了以下斜杠命令： - | 指令 | 作用 | + | 命令 | 作用 | | --- | --- | | `/comfy-cloud:generate-image` | 生成、编辑或修改图像 | - | `/comfy-cloud:generate-video` | 生成、编辑或扩展视频 | + | `/comfy-cloud:generate-video` | 生成、编辑或延长视频 | | `/comfy-cloud:generate-audio` | 生成音频、音乐或音效 | | `/comfy-cloud:generate-3d` | 从文本或图像生成 3D 模型 | - | `/comfy-cloud:remove-background` | 从图像中移除背景 | + | `/comfy-cloud:remove-background` | 移除图像背景 | | `/comfy-cloud:upscale-image` | 将图像放大到更高分辨率 | - | `/comfy-cloud:search-templates` | 在 [comfy.org](https://comfy.org) 上查找预构建的工作流模板 | + | `/comfy-cloud:search-templates` | 在 [comfy.org](https://comfy.org) 上查找预置的工作流模板 | | `/comfy-cloud:search-models` | 搜索可用模型 | - | `/comfy-cloud:search-nodes` | 搜索节点并获取连接建议 | + | `/comfy-cloud:search-nodes` | 搜索节点并获取连线建议 | | `/comfy-cloud:help` | 查看你可以用 ComfyUI Cloud 做什么 | - + 直接添加服务器： ```bash claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp ``` - 然后运行 `/mcp`，选择 **comfy-cloud** → **Authenticate**。添加 `-s user` 使其在你所有项目中可用。 + 然后运行 `/mcp`，选择 **comfy-cloud** → **Authenticate**。添加 `-s user` 使其在所有项目中可用。 - 此路径仍然会暴露与 MCP 提示词相同的工作流：`/mcp__comfy-cloud__generate-image`、`/mcp__comfy-cloud__search-models` 等（`/mcp____` 前缀使用你传递给 `claude mcp add` 的名称）。推荐使用上面的插件，因为它将这些封装为更友好的 `/comfy-cloud:*` 指令。 + 此路径仍然将相同的工作流公开为 MCP 提示：`/mcp__comfy-cloud__generate-image`、`/mcp__comfy-cloud__search-models` 等（`/mcp____` 前缀使用您在 `claude mcp add` 中传递的名称）。推荐使用上述插件，因为它将这些包装为更友好的 `/comfy-cloud:*` 命令。 @@ -163,19 +159,19 @@ https://cloud.comfy.org/mcp Cursor 通过 HTTP 连接到远程 MCP 服务器。Cursor 目前**不**支持 MCP OAuth。在 MCP 配置中使用 Comfy Cloud API 密钥添加 Comfy Cloud。 - - 点击右上角的设置齿轮（标记为 **1**）。 + + 点击右上角的 **Settings** 齿轮（标注为 **1**）。 - ![Cursor — 打开设置](/images/agent_tools/cursor_mcp_setup_step1.png) + ![Cursor — open Settings](/images/agent_tools/cursor_mcp_setup_step1.png) - 1. 在侧边栏中，点击 **Tools & MCPs**（标记为 **2**）。 - 2. 点击 **+ New MCP Server**（标记为 **3**）→ **Add a Custom MCP Server**。 + 1. 在侧边栏中，点击 **Tools & MCPs**（标注为 **2**）。 + 2. 点击 **+ New MCP Server**（标注为 **3**）→ **Add a Custom MCP Server**。 ![Cursor — Tools & MCPs](/images/agent_tools/cursor_mcp_setup_step2.png) - - 编辑 `~/.cursor/mcp.json`（全局）或 `.cursor/mcp.json`（项目）。设置服务器 URL 并在 `X-API-Key` 标头中传递你的 Comfy Cloud API 密钥。在 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) 创建密钥（以 `comfyui-` 开头）： + + 编辑 `~/.cursor/mcp.json`（全局）或 `.cursor/mcp.json`（项目）。设置服务器 URL，并在 `X-API-Key` 请求头中传递你的 Comfy Cloud API 密钥。在 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) 创建密钥（以 `comfyui-` 开头）： ```json { @@ -190,18 +186,18 @@ https://cloud.comfy.org/mcp } ``` - 在你的 shell 或系统环境中设置 `COMFY_API_KEY`。推荐使用 `${env:COMFY_API_KEY}` 而不是在可能提交到 git 的文件中硬编码密钥。 + 在你的 shell 或系统环境中设置 `COMFY_API_KEY`。推荐使用 `${env:COMFY_API_KEY}` 而不是将密钥硬编码在可能提交到 Git 的文件中。 - ![Cursor — 带有 API 密钥的 mcp.json](/images/agent_tools/cursor_mcp_setup_step3.png) + ![Cursor — mcp.json with API key](/images/agent_tools/cursor_mcp_setup_step3.png) - 用自然语言提问（"生成一张猫宇航员的图像"、"找一个 Wan 2.2 视频模板"）。Cursor 会代表你调用 MCP 工具。 + 用自然语言提问（例如「生成一张猫宇航员的图像」、「找一个 Wan 2.2 视频模板」）。Cursor 会代表你调用 MCP 工具。 - [Codex](https://developers.openai.com/codex/cli) 通过 Streamable HTTP 连接到 Comfy Cloud。在设置中添加服务器，然后使用 OAuth 登录。 + [Codex](https://developers.openai.com/codex/cli) 通过 Streamable HTTP 连接到 Comfy Cloud。在 Settings 中添加服务器，然后使用 OAuth 登录。 - 从 [ClawHub](https://clawhub.ai/comfy-org/skills/comfy) 安装 **Comfy Cloud** 技能。它将 OpenClaw 连接到托管的 MCP 服务器（`cloud.comfy.org/mcp`）。仅限云服务：它不会驱动本地 ComfyUI 安装。 + 从 [ClawHub](https://clawhub.ai/comfy-org/skills/comfy) 安装 **Comfy Cloud** 技能。它将 OpenClaw 连接到托管的 MCP 服务器（`cloud.comfy.org/mcp`）。仅适用于云端：无法驱动本地 ComfyUI 安装。 @@ -279,7 +275,7 @@ https://cloud.comfy.org/mcp 技能页面：[clawhub.ai/comfy-org/skills/comfy](https://clawhub.ai/comfy-org/skills/comfy)。 - 注册 MCP 服务器并使用你的 Comfy 账户登录： + 注册 MCP 服务器并使用您的 Comfy 账户登录： ```bash openclaw mcp set comfy '{"url":"https://cloud.comfy.org/mcp","transport":"streamable-http","auth":"oauth"}' @@ -287,19 +283,19 @@ https://cloud.comfy.org/mcp openclaw gateway restart ``` - `openclaw mcp login` 会打印一个授权 URL。打开它，登录，然后按照 CLI 的指示完成流程（它可能会要求你使用 `--code` 值重新运行）。使用 `openclaw mcp status --verbose` 验证。 + `openclaw mcp login` 会输出一个授权 URL。打开该链接，登录，然后按照 CLI 提示完成流程（可能会要求您使用 `--code` 参数重新运行）。使用 `openclaw mcp status --verbose` 进行验证。 - 当 `auth: "oauth"` 被设置时，OpenClaw 会忽略该服务器条目上的静态 `headers`。不要将 OAuth 与硬编码的 API 密钥标头组合使用。 + 当设置 `auth: "oauth"` 时，OpenClaw 会忽略该服务器条目中的静态 `headers`。切勿将 OAuth 与硬编码的 API 密钥头组合使用。 - 用自然语言提问（"生成一张猫宇航员的图像"、"找一个 Wan 2.2 视频模板"）。OpenClaw 会代表你调用 MCP 工具。 + 用自然语言提问（例如「生成一张猫宇航员的图像」、「找一个 Wan 2.2 视频模板」）。OpenClaw 会代您调用 MCP 工具。 - - 在 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) 创建一个密钥（以 `comfyui-` 开头），导出它，然后注册服务器： + + 在 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) 创建一个密钥（以 `comfyui-` 开头），然后将其导出，并注册服务器： ```bash export COMFY_API_KEY="comfyui-..." @@ -307,16 +303,16 @@ https://cloud.comfy.org/mcp openclaw gateway restart ``` - 对于 OpenClaw，推荐使用 `Authorization: Bearer` 而非自定义的 `X-API-Key` 标头。某些 OpenClaw 构建会在 streamable-http 传输上丢弃自定义标头；Bearer 更可靠地通过代理。将 `COMFY_API_KEY` 放入你的 shell 配置或 OpenClaw 环境变量中。不要提交密钥。 + 对于 OpenClaw，优先使用 `Authorization: Bearer` 而非自定义的 `X-API-Key` 请求头。某些 OpenClaw 构建版本会在 streamable-http 传输中丢弃自定义请求头；Bearer 能更可靠地通过代理。将 `COMFY_API_KEY` 放入你的 shell 配置文件或 OpenClaw 环境变量中。不要提交该密钥。 - - 任何支持 **远程 HTTP** 传输的 MCP 客户端都可以连接到 Comfy Cloud。服务器 URL 始终为 `https://cloud.comfy.org/mcp`。 + + 任何支持**远程 HTTP**传输的 MCP 客户端都可以连接到 Comfy Cloud。服务器 URL 始终为 `https://cloud.comfy.org/mcp`。 - 添加一个指向 `https://cloud.comfy.org/mcp` 的远程 MCP 条目。大多数客户端使用带有 `url` 字段的 JSON 配置： + 添加指向 `https://cloud.comfy.org/mcp` 的远程 MCP 条目。大多数客户端使用带有 `url` 字段的 JSON 配置： ```json { @@ -328,17 +324,17 @@ https://cloud.comfy.org/mcp } ``` - **Windsurf** 使用 `serverUrl` 而不是 `url`。**Amp** 在 **设置 → MCP Servers** 或 `~/.config/amp/settings.json` 中使用相同的 `mcpServers` 结构。 + **Windsurf** 使用 `serverUrl` 而不是 `url`。**Amp** 在 **Settings → MCP Servers** 或 `~/.config/amp/settings.json` 中使用相同的 `mcpServers` 格式。 - - 如果你的客户端支持 MCP OAuth，在提示时通过浏览器登录。否则，添加一个 API 密钥标头（见下文）。 + + 如果您的客户端支持 MCP OAuth，请在浏览器中提示时登录。否则，添加 API 密钥请求头（见下文）。 - 重新启动你的客户端。你应该会看到 Comfy Cloud 工具（`search_templates`、`submit_workflow`、`get_output` 等）注册在 **comfy-cloud** 服务器下。 + 重新启动您的客户端。您应该会看到 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` 标头传递： + **无头 / CI（API 密钥）：** 当 OAuth 不可用时，请在 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) 创建密钥，并将其作为 `X-API-Key` 请求头传递： ```json { @@ -353,196 +349,432 @@ https://cloud.comfy.org/mcp } ``` - 在终端中为 Claude Code 使用： + 从终端使用 Claude Code： ```bash claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp -H "X-API-Key: comfyui-…" ``` - 优先使用 `${env:COMFY_API_KEY}` 或你客户端的机密插值，而不是在提交到 git 的配置文件中硬编码密钥。 + 推荐使用 `${env:COMFY_API_KEY}` 或客户端的密钥插值，而不是将密钥硬编码到您提交到 Git 的配置文件中。 -## 您的代理能做什么 +### 智能体可以做什么 -您无需自行调用 MCP 工具。您的代理会根据您的请求自动选择合适的工具。斜杠命令和提示（如下所示）是引导代理完成常见使用例的快捷键，但自然语言也同样有效（例如“生成一张猫宇航员的图像”、“放大这张照片”、“找一份 Wan 2.2 视频模板”）。 +您不需要亲自调用 MCP 工具。您的智能体会根据您的请求选取恰当的工具。斜杠命令和提示词（如下所示）是引导智能体执行常见任务的快捷方式，但用普通语言同样可行（例如「生成一张猫宇航员的图像」、「放大这张照片」、「找一个 Wan 2.2 视频模板」）。 典型流程： -1. **发现**可用资源（使用 `search_templates`、`search_models`、`search_nodes`，或对画面风格的问题使用 `cql`）。 -2. **运行**生成任务：如果找到匹配的预构建模板则使用 `run_template`，自定义工作流则使用 `submit_workflow`（需要输入图像时配合 `upload_file`），或使用 `partner_generate` 调用 Flux、Grok、Gemini、OpenAI、Ideogram、Seedance 等合作伙伴模型。 -3. **等待并获取输出**（`wait_for_job`，然后 `get_output` 返回一条下载指令，由您的代理在 shell 中运行）。 +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` 获得一个下载命令，由您的智能体在终端中运行。 -服务器倾向于优先匹配 [预构建模板](https://comfy.org/workflows)，而不是从头构建工作流，这样往往能更快地获得更好的结果。 +服务器通常优先尝试匹配[预构建模板](https://comfy.org/workflows)，而非从头构建工作流，这往往能更快地获得更佳的结果。 -## MCP 工具 +### 云端 MCP 工具 -这些是您的代理连接后可访问的工具。名称与 MCP 客户端日志和调试中显示的名称保持一致。 +连接后，您的智能体可以访问这些工具。工具名称与 MCP 客户端日志和调试输出中显示的名称一致。 -### 发现 +**发现** | 工具 | 描述 | | --- | --- | -| `search_templates` | 按文本、标签、媒体类型或模型从 [comfy.org](https://comfy.org/workflows) 搜索预构建的工作流模板 | -| `get_template` | 获取模板的完整工作流 JSON，用于检查或手动编辑 | -| `get_template_schema` | 查看模板的哪些参数可以在运行时覆盖 | +| `search_templates` | 按文本、标签、媒体类型或模型，从 [comfy.org](https://comfy.org/workflows) 搜索预构建的工作流模板 | +| `get_template` | 获取模板的完整工作流 JSON，以便检查或手动编辑 | +| `get_template_schema` | 查看模板的哪些参数可在运行时被覆盖 | | `search_models` | 按文本、类型、基础模型或来源搜索模型目录 | -| `search_nodes` | 按文本、类别或输入/输出类型搜索可用节点。还能列出**子图蓝图**（预连线的节点组，如文本转图像或移除背景） | -| `get_node` | 获取特定节点的完整输入说明，包括完整的选项列表 | -| `cql` | 运行 [CQL](https://github.com/Comfy-Org/cql) 图查询以回答结构性问题（例如，哪些节点生成图像，或节点类型之间的路径）。当需要特定节点的完整输入说明时，请使用 `search_nodes` | -| `get_prompting_guide` | 各模型系列的提示词风格与推荐设置（步数、cfg、采样器、分辨率） | +| `search_nodes` | 按文本、类别或输入/输出类型搜索可用节点。还会显示**子图蓝图**（预连线节点组，如 Text to Image 或 Remove Background） | +| `get_node` | 获取特定节点的完整输入规范，包括完整的选项列表 | +| `cql` | 运行 [CQL](https://github.com/Comfy-Org/cql) 图查询，回答结构性问题（例如，哪些节点生成图像，或节点类型之间的路径）。当需要特定节点的完整输入规范时，请使用 `search_nodes` | +| `get_prompting_guide` | 按模型系列提供提示风格和推荐设置（步数、cfg、采样器、分辨率） | -### 生成 +**生成** | 工具 | 描述 | | --- | --- | -| `run_template` | 按名称运行预构建模板，可选择覆盖参数——有匹配模板时的首选路径 | -| `submit_workflow` | 提交 ComfyUI API 格式的工作流在 Comfy Cloud 上执行 | +| `run_template` | 按名称运行预构建模板，可选择性地覆盖参数。当有匹配的模板时，这是首选方式 | +| `submit_workflow` | 提交 ComfyUI API 格式的工作流，以便在 Comfy Cloud 上执行 | | `partner_generate` | 使用合作伙伴 API 模型生成（Flux/BFL、Grok、Gemini、OpenAI、Ideogram、Seedream/Seedance 等） | -| `upload_file` | 上传输入图像或文件用于工作流中（例如，与 LoadImage 配合使用） | -| `apply_slots` | 将参数覆盖应用到工作流的内部值，并返回修改后的工作流 | +| `upload_file` | 上传输入图像或文件，以便在工作流中使用（例如，与 LoadImage 一起使用） | +| `apply_slots` | 对工作流的内部值应用参数覆盖，并返回修改后的工作流 | -### 作业与批处理 +**作业与批处理** | 工具 | 描述 | | --- | --- | | `get_job_status` | 轮询已提交工作流的执行状态 | -| `wait_for_job` | 等待作业完成，而无需反复轮询 | -| `get_output` | 从已完成的工作流中检索输出的图像、视频或音频 | -| `use_previous_output` | 通过将一个运行的输出重用作另一个运行的输入来串联工作流 | -| `cancel_job` | 取消待定或正在运行的作业 | -| `get_queue` | 检查正在运行和待定的作业数量 | -| `submit_batch`、`get_batch_status`、`get_batch_output`、`wait_for_batch` | 在一次调用中提交多个生成任务，稍后统一收集结果——批处理 ID 在多个会话间保持有效 | +| `wait_for_job` | 等待任务完成，而不是反复轮询 | +| `get_output` | 从已完成的工作流中获取输出图像、视频或音频 | +| `use_previous_output` | 将一个运行中的输出作为另一个运行中的输入，串联工作流 | +| `cancel_job` | 取消一个待定或正在运行的任务 | +| `get_queue` | 检查有多少个任务正在运行和待定 | +| `submit_batch`、`get_batch_status`、`get_batch_output`、`wait_for_batch` | 在一次调用中提交多个生成任务，稍后一起收集。批处理 ID 在各个会话之间保持有效 | -### 已保存的工作流 +**已保存的工作流** | 工具 | 描述 | | --- | --- | -| `list_saved_workflows` | 浏览您保存在 Comfy Cloud 中的工作流 | +| `list_saved_workflows` | 从 Comfy Cloud 浏览您已保存的工作流 | | `get_saved_workflow` | 检查已保存工作流的节点、输入和可自定义的设置 | | `save_workflow` | 将工作流保存到您的 Comfy Cloud 账户 | -| `update_workflow` | 就地更新现有工作流并生成新版本（早期版本仍可恢复） | -| `run_saved_workflow` | 按文件名运行已保存的工作流——服务器会自动将其从编辑器格式转换为可执行格式 | +| `update_workflow` | 在原位更新现有工作流，作为一个新版本（旧版本仍可恢复） | +| `run_saved_workflow` | 按文件名运行已保存的工作流。服务器会自动将其从编辑器格式转换为可执行格式 | -### 共享工作流 +**分享工作流** | 工具 | 描述 | | --- | --- | -| `share_workflow` | 发布一个已保存的工作流，并返回一个任何人都可以打开的 `?share=` 链接 | -| `import_shared_workflow` | 将分享链接或纯分享 ID 解析为工作流 JSON，可选择保存到您的账户 | +| `share_workflow` | 发布一个已保存的工作流，并返回一个任何人都可以打开的 `?share=` URL | +| `import_shared_workflow` | 将一个分享链接或裸分享 ID 解析为工作流 JSON，并可选择将其保存到您的账户 | -**Hub 链接分享 ID：** `comfy.org/workflows/-` Hub 链接中尾部的连字符分隔的十六进制令牌就是分享 ID。例如，`comfy.org/workflows/topaz-starlight-upscale-1c77e82713b7` 的分享 ID 是 `1c77e82713b7`。将该令牌作为 `share_id` 传给 `import_shared_workflow`。`share_url` 参数只接受类似 `https://cloud.comfy.org/?share=...` 的 `?share=` 查询参数链接，不接受 Hub 页面链接。 +**Hub URL 分享 ID：** `comfy.org/workflows/-` 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=` 查询 URL，不接受 hub 页面 URL。 -### 应用与链接 +**应用和链接** | 工具 | 描述 | | --- | --- | -| `create_app` | 将已保存的工作流转换为应用模式（App Mode）应用——带有选定输入和输出、简化的“运行此工作流”视图 | -| `get_app_mode_url` | 获取一个稳定链接，可将工作流作为可运行的应用打开 | -| `get_workflow_canvas_url` | 获取一个直接在 Comfy Cloud 画布上打开工作流的链接，随时可查看、编辑或运行 | +| `create_app` | 将已保存的工作流转化为 App Mode 应用：一个简化版的「运行此工作流」视图，包含选定的输入和输出 | +| `get_app_mode_url` | 获取以可运行应用形式打开工作流的稳定链接 | +| `get_workflow_canvas_url` | 获取直接打开到 Comfy Cloud 画布上的工作流链接，可随时查看、编辑或运行 | -### 账户与会话 +**账户和会话** | 工具 | 描述 | | --- | --- | -| `get_billing_status` | 查看你的积分余额、订阅等级和账单链接 | -| `get_server_info` | 确认代理连接到的是哪台服务器：环境、主机、版本和认证状态 | -| `submit_feedback` | 获取测试版反馈调查问卷链接 | -| `report_session_summary` | 与 Comfy 团队分享匿名化的会话摘要——**仅在你明确同意的情况下**；代理必须先征求你的同意，且摘要中不包含任何提示词、文件路径或个人信息 | +| `get_billing_status` | 检查您的积分余额、订阅层级和账单链接 | +| `get_server_info` | 确认智能体连接到的服务器：环境、主机、版本和认证状态 | +| `submit_feedback` | 获取测试版反馈问卷链接 | +| `report_session_summary` | 与 Comfy 团队分享匿名的会话摘要（**仅在您明确同意后**；智能体必须先询问，且不包含提示、文件路径或个人信息） | + +**提示（Claude Desktop）** -## 积分与消费 +Claude Desktop 不支持 Claude Code 的斜杠命令。相反，打开 **prompt picker** 以使用相同的工作流： + +| 提示 | 描述 | +| --- | --- | +| `generate-image` | 根据文本描述生成图像 | +| `generate-video` | 从文本或图像生成视频 | +| `generate-audio` | 生成音频、音乐或音效 | +| `generate-3d` | 从文本或图像生成 3D 模型 | +| `upscale-image` | 将图像升级至更高分辨率 | +| `remove-background` | 移除图像背景 | +| `search-templates` | 查找预构建的工作流模板 | +| `search-models` | 搜索模型（checkpoints、LoRAs、VAEs） | +| `search-nodes` | 搜索节点并获取连线建议 | +| `help` | 查看您可以使用 ComfyUI Cloud 做些什么 | -探索功能免费：`search_templates`、`search_models` 和 `search_nodes` 只需一个 [Comfy 账户](https://cloud.comfy.org) 即可使用。运行生成需要有效的 Comfy Cloud 订阅。仅有积分或充值余额并不足以获得访问权限：即使你还有未使用的积分，也需要有效订阅才能运行生成。 +您也可以跳过提示，用自然语言提问。MCP 工具的工作方式相同。 -实际花费金钱的工具是**消费门槛限定**的。当生成使用付费合作伙伴模型（`partner_generate`）或包含付费 API 节点的工作流/模板（`run_template`、`run_saved_workflow`、`submit_batch`）时，服务器会阻止执行，直到你的智能体确认你同意花费积分。因此，在这些运行之前，智能体会先与你确认。免费的本地工作流永远不会提示。 +### 积分与消费 -你可以随时向智能体询问你的余额（“我还有多少积分？”）。它会通过 `get_billing_status` 回答。 +发现功能免费：`search_templates`、`search_models` 和 `search_nodes` 仅需一个 [Comfy 账户](https://cloud.comfy.org)。运行生成任务需要有效的 Comfy Cloud 订阅。仅有积分或充值余额并不能授予访问权限：您需要有效的订阅才能运行生成，即使您还有未使用的积分。 -## 输出与下载 +### 上传与下载 -MCP 服务器在云端运行，**绝不会将文件写入你的机器**。当生成完成时，你的代理会调用 `get_output`，它会返回： +MCP 服务器在云端运行，MCP 本身不会将文件写入您的机器。当生成完成时，您的智能体调用 `get_output`，返回： 1. 一个**临时签名下载 URL**（在短时间内有效）。 -2. 一条可直接运行的 **shell 指令**（macOS 和 Linux 上为 `curl`，Windows 上为 `curl.exe`）。 +2. 一个直接可执行的 **shell 命令**（在 macOS 和 Linux 上为 `curl`，在 Windows 上为 `curl.exe`）。 -你的代理应在终端中运行该指令。指令中包含了目标路径和文件名。 +您的智能体应在您的 shell 中运行该命令。该命令包含目标路径和文件名。 - 请**逐字运行**返回的指令。请勿重新编码或编辑签名的 URL。签名位于查询字符串中，一旦修改 URL 就会失效。 + **原样**运行返回的命令。不要对签名 URL 进行重新编码或编辑。签名存在于查询字符串中，如果修改 URL 则会失效。 -如果你的 MCP 客户端无法运行 shell 指令（某些仅 GUI 的环境），请复制该指令并自行在终端中运行。 +如果您的 MCP 客户端无法运行 shell 命令（某些纯 GUI 的设置），请复制该命令并在终端中自行运行。 + +资源的上传和下载取决于客户端的文件访问权限。如果 Claude Desktop 或其他智能体客户端在处理资源上传或下载时遇到问题，这可能与智能体访问本地文件目录的权限有关。对于 Claude 用户，我们推荐 **Claude Code**（桌面应用或终端），它具有更多功能。类似地，对于其他智能体系列，编码智能体通常比网页聊天版本更好。 + + +### 已知限制 + +Comfy Cloud MCP 是早期版本。以下是已知限制，正在改进中： + +**工作流** + +- **通过 `submit_workflow` 生成的资产可能不会嵌入工作流元数据。** 在 ComfyUI 中打开时，可能无法重新打开原始工作流。 +- **工作流构建依赖于智能体的准确性。** 复杂的多节点工作流可能需要重试或手动调整。 + +**文件处理** + +- **输出需要额外的 shell 下载步骤。** 请参阅[上传与下载](#uploads-and-downloads)。 +- **上传大小限制**可能因 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**](https://github.com/Comfy-Org/comfy-mcp) 是 Comfy 的**第一方本地 MCP 服务器**：即从 AI 智能体（Claude Code、Claude Desktop、Cursor 和其他 MCP 客户端）驱动**本地** ComfyUI 安装的官方方式。 + +与云端和合作伙伴服务器不同，它直接与**您自己机器上**运行的 ComfyUI 通信，因此可以运行您的工作流，并检查您实际安装中拥有的节点、自定义节点和模型。 + + + **最快设置方式：交给您的智能体。** 将 `https://docs.comfy.org/agent-tools/mcp#installation` 粘贴到您的 AI 客户端中，并让它为您设置本地连接。 + + +### 要求 + +- **Python 3.10+** +- 位于您 `PATH` 中的 **[comfy-cli](https://github.com/Comfy-Org/comfy-cli)**（`pip install comfy-cli`）：它是每个工具所包装的引擎 +- **一个 ComfyUI 工作区**：如果还没有，请使用 `comfy install` 创建一个（已有检出可通过 `comfy set-default ` 使用） +- **一个正在运行的 ComfyUI**：使用这些工具之前，请通过 `comfy launch` 启动它；本文不会隐式启动 ComfyUI + +--- + +### 安装 + +从 [仓库](https://github.com/Comfy-Org/comfy-mcp) 的本地检出中： + +```bash +pip install . # or `pip install -e .` for a working copy +``` + +这将 `comfy-mcp` 控制台脚本添加到您的 `PATH` 中。该命令就是 MCP 服务器（它通过 stdio 使用 MCP 协议）。接下来将您的 AI 客户端指向它。 + + + **`COMFY_BIN`（可选）。** MCP 客户端会以其自身环境启动服务器，这通常**不**包含您 shell 的 `PATH`。如果 `comfy` 位于虚拟环境或非标准位置，请将 `COMFY_BIN` 设置为其绝对路径（例如 `/path/to/venv/bin/comfy`）。以下每个客户端示例都展示了它应放在哪里；如果 `comfy` 已经在客户端启动服务器时所在的环境中，则可以省略。 + + +--- + +### 手动配置 + +所有客户端遵循相同的 MCP stdio 协议：将 `comfy-mcp` 命令作为服务器运行。选择你的客户端： + + + + 编辑 `claude_desktop_config.json`（Settings → Developer → Edit Config；在 macOS 上位于 `~/Library/Application Support/Claude/claude_desktop_config.json`），添加该服务器，然后重新启动 Claude Desktop： + + ```json + { + "mcpServers": { + "comfy-mcp": { + "command": "comfy-mcp", + "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } + } + } + } + ``` + + + + 一条命令即可注册服务器： + + ```bash + claude mcp add comfy-mcp -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-mcp + ``` + + 或者将其登记到项目中，在仓库根目录创建 `.mcp.json` 文件： + + ```json + { + "mcpServers": { + "comfy-mcp": { + "command": "comfy-mcp", + "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } + } + } + } + ``` + + + + 将服务器添加到 `~/.cursor/mcp.json`（全局）或 `.cursor/mcp.json`（按项目）： + + ```json + { + "mcpServers": { + "comfy-mcp": { + "command": "comfy-mcp", + "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" } + } + } + } + ``` + + + +--- + +### 快速开始 + +从零到生成图像： + + + + ```bash + git clone https://github.com/Comfy-Org/comfy-mcp + cd comfy-mcp + pip install comfy-cli # the engine + comfy install # create a ComfyUI workspace (skip if you have one) + pip install . # this MCP server → the `comfy-mcp` command + ``` + + + ```bash + comfy launch + ``` + + + 使用上面对应您客户端的代码片段，然后重新启动 / 重新加载客户端，以便工具显示。 + + + 例如： + + > 「确认我的本地 ComfyUI 正在运行，然后运行位于 `~/workflows/txt2img.json` 的工作流，并向我显示图像。」 + + 在底层，智能体会调用 `server_info` 来确认 ComfyUI 已启动，调用 `run_workflow` 来执行工作流 JSON，并调用 `fetch_outputs` 来收集结果。 + + + +--- + +### 工具 + +每个工具都映射到一个 `comfy-cli` 命令，并以 `--where local` 运行。亮点如下： + +| 工具 | 用途 | +|---|---| +| `server_info()` | 检查本地 ComfyUI 是否正在运行、位置以及工作区。**首先调用。** | +| `run_workflow(workflow_path, wait=True)` | 运行工作流 JSON 文件；`wait=False` 会异步提交并返回 `prompt_id`。 | +| `job_status` / `wait_for_job` / `watch_job` | 轮询、等待或流式传输已提交的任务。 | +| `fetch_outputs(prompt_id, out_dir)` | 将已完成任务的输出复制到 `out_dir` 目录中。 | +| `launch_comfyui` / `stop_comfyui` | 启动或停止本地 ComfyUI。 | +| `search_templates` / `fetch_template` | 查找内置模板并写入其可运行的工作流 JSON 文件。 | +| `search_nodes` / `get_node` / `list_nodes` | 检查**本地实时**安装中的节点类（包含自定义节点）。 | +| `search_models` | 列出磁盘上的模型文件。 | +| `validate_workflow` | 在缓慢运行之前，针对实时的 `object_info` 对工作流进行预检。 | + +节点自省和模型搜索会读取你的**实时安装**（包含自定义节点），这是与云端连接相比的本地差异化特点。查看[仓库](https://github.com/Comfy-Org/comfy-mcp)以获取完整工具列表和参考。 + +--- + ## 相关资源 -| 资源 | 用途 | +| 资源 | 作用 | | --- | --- | -| [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) | Claude Code 插件市场与社区技能库。上述使用的 **comfy-cloud** 插件即在此分发；可浏览或贡献适用于 Comfy 工作流的其他技能。 | -| [Comfy Cloud on ClawHub](https://clawhub.ai/comfy-org/skills/comfy) | 用于托管 Comfy Cloud MCP 服务器的 OpenClaw 技能（`openclaw skills install @comfy-org/comfy`）。 | -| [Comfy CLI](/zh/agent-tools/cli) | 用于在本地安装/启动 ComfyUI，以及从脚本或 CI 中调用托管合作节点的命令行工具（`comfy generate`，测试版）。当需要终端或自动化工作流时，可补充 MCP 使用。 | -| [在 Comfy Cloud 上分享工作流](/zh/cloud/share-workflow) | 从 Comfy Cloud UI 界面分享工作流（MCP 的 `share_workflow` 工具可在代理会话中完成此操作）。 | +| [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) | Claude Code 插件市场和社区技能库。上面使用的 **comfy-cloud** 插件就托管在此；可浏览或贡献更多用于 Comfy 工作流的技能。 | +| [Comfy Cloud on ClawHub](https://clawhub.ai/comfy-org/skills/comfy) | OpenClaw 技能（`openclaw skills install @comfy-org/comfy`），用于托管的 Comfy Cloud MCP 服务器。 | +| [Comfy CLI](/zh/agent-tools/cli) | 命令行工具，用于本地 ComfyUI 的安装/启动，以及从脚本或 CI 调用托管的合作节点（`comfy generate`，测试版）。作为 MCP 的补充，适用于需要终端或自动化工作流的场景。 | +| [在 Comfy Cloud 上分享工作流](/zh/cloud/share-workflow) | 通过 Comfy Cloud UI 分享工作流（MCP 的 `share_workflow` 工具在智能体会话中也可实现分享）。 | -## 相关：Comfy In-App Agent +## 相关：Comfy 应用内智能体 -希望在 Comfy Cloud **内部**使用代理（通过聊天构建和编辑画面），而不是外部 MCP 客户端？ +想要**在** Comfy Cloud 内部获得智能体体验（聊天，可以构建和编辑你的画面），而不是通过外部 MCP 客户端吗？ - - Comfy Cloud 私有内测。加入候补名单申请访问权限。 + + Comfy Cloud 上的私有 Alpha 测试。加入候补名单以请求访问。 ## 反馈 -Comfy Cloud MCP 目前处于公开测试阶段。请试试看，并告诉我们哪些功能好用、哪些不好用： +Comfy MCP 目前是公开测试版。请试试看，并告诉我们哪些地方好用，哪些地方需要改进： -- **[反馈调查问卷](https://links.comfy.org/cloudmcpbeta)**：反馈错误、请求功能或分享常规印象。 -- **Discord**：在 Comfy Discord 上的 [#comfy-mcp-and-cli](https://discord.gg/xWJn6nhE3R) 频道进行提问和讨论。 +- **[反馈调查](https://links.comfy.org/cloudmcpbeta)**：反馈 bug、请求功能，或分享常规印象。 +- **Discord**：[#comfy-mcp-and-cli](https://discord.gg/xWJn6nhE3R)（位于 Comfy Discord 上），用于问题咨询和讨论。 -## 已知限制 +## 常见问题 -Comfy Cloud MCP 为早期版本。以下为已知的限制，团队正在努力解决： +### 入门 -**工作流** + + + 任何与 MCP 兼容的客户端。 -- **编辑器格式到可执行格式的转换尚不完善。** 已保存的工作流可以通过 `run_saved_workflow` 按文件名运行（服务器会自动转换），但某些节点配置的转换仍不够完美。 -- **通过 `submit_workflow` 生成的资产可能未嵌入工作流元数据。** 在 ComfyUI 中打开时，可能无法重新打开其原始工作流。 -- **工作流构建依赖于智能体的准确性。** 复杂的多节点工作流可能需要重试或优化。 + **云端连接**需要支持远程 HTTP。**Claude Code**、**Claude Desktop**、**Cursor**、**Codex** 和 **OpenClaw** 有上文中提到的一流设置；**Windsurf**、**Amp** 等客户端使用相同 URL，通过 OAuth 或 API 密钥连接。 -**文件处理** + **本地连接**需要客户端能够以子进程方式启动本地 stdio 服务器。这排除了基于浏览器的客户端：[claude.ai](https://claude.ai) 和 ChatGPT 仅接受远程连接器。 + + + 云端连接运行于 `https://cloud.comfy.org/mcp`。 -- **输出需要经过 Shell 下载步骤。** 请参阅[输出与下载](#outputs-and-downloads)。 -- **上传大小限制**可能因 MCP 客户端而异。某些客户端对文件上传施加了自己的限制。 + 本地连接没有 URL：您的客户端直接运行 `comfy-mcp` 命令，并通过 stdio 与之通信。 + + + 可以：那就是[本地 Comfy MCP 连接](#local-comfy-mcp-connection)。它驱动您自己机器上已安装的 ComfyUI，因此您的智能体能看到您实际拥有的模型、LoRA 和自定义节点，并运行在您的 GPU 上。 + + + 可以，而且如果您本地运行 ComfyUI，我们推荐这样做。大多数客户端都可以同时承载两个 MCP 服务器，您的智能体能区分它们：每个连接运行自己的工作流并返回各自的结果。 -**身份验证** + 不过，两次登录是**分开**的。在一个连接上登录不会在另一个上登录，即使使用的是同一个 Comfy 账户。 + + + 询问您的智能体：它在启动任何繁重任务之前会读取您的硬件信息。 -- **OAuth 或 API 密钥。** Claude Code 和 Claude Desktop 使用一次性浏览器 OAuth 流程。**Cursor** 需要你在 MCP 配置中提供 Comfy Cloud API 密钥（不支持 OAuth）。其他无头客户端可以通过 `X-API-Key` 标头传递 Comfy Cloud API 密钥作为替代。计划为无法打开浏览器的客户端提供设备码 OAuth 流程。 + 在 **Mac** 上，请使用云端连接进行生成：目前的开源模型过大，无法在 Apple GPU 上以可用的速度运行。在 **配备独立显卡的 PC** 上，24 GB 或更大显存处理包括视频在内的大部分任务；8–24 GB 用于图像没问题，但视频会很慢或无法适应；低于 8 GB，请使用云端。 + + + 云端连接处于 **公开测试版**：API、工具和行为可能会在我们迭代期间发生变化。请参阅[反馈](#feedback)来提交问题。 + + -## 常见问题 +### 费用与访问 - - 任何支持远程 HTTP 传输的 MCP 兼容客户端都可以连接到 `https://cloud.comfy.org/mcp`。我们为 **Claude Code**、**Claude Desktop**、**Cursor**、**Codex** 和 **OpenClaw** 提供了最优先的配置说明。**Windsurf**、**Amp** 和其他代理使用相同的 URL，通过 OAuth 或 API 密钥连接。参见[安装 Comfy Cloud MCP](#install-comfy-cloud-mcp)。 + + 发现功能在两种连接上都免费：搜索模板、模型和节点只需要一个 Comfy 账户。 + + 在**云端连接**上，运行生成需要有效的 Comfy Cloud 订阅；新用户可获得 5 次免费运行。在**本地连接**上，运行是免费的，因为它们在你的硬件上进行，但有一个例外：合作伙伴模型在合作伙伴的基础设施上执行，并且会消耗积分。 - - 对于支持 OAuth 的交互式客户端（Claude Code、Claude Desktop、Codex、OpenClaw 等）不需要。**Cursor** 需要在你的 MCP 配置中提供 Comfy Cloud API 密钥。在没有浏览器的无头或 CI 环境中也需要 API 密钥。请参见[安装 Comfy Cloud MCP](#install-comfy-cloud-mcp) 下的 **Cursor** 标签、**OpenClaw** 标签或 **其他客户端** 标签。 + + 对于支持 OAuth 的交互式客户端，不需要，例如 Claude Code、Claude Desktop、Codex 和 OpenClaw 等。 + + **Cursor** 需要在你的 MCP 配置中提供 Comfy Cloud API 密钥；那里尚不支持 MCP OAuth。无浏览器的无头环境和 CI 设置也需要一个。请参阅[设置云端连接](#set-up-the-cloud-connection)下的 **Cursor** 和 **Other clients** 选项卡。 - - 付费生成受消费确认保护：当一次运行会消耗 Comfy Cloud 积分时（使用合作伙伴模型，或包含付费 API 节点的工作流/模板），服务器会要求你明确同意后才执行。请参阅[积分与消费](#credits-and-spending)。 + + +### 使用 + + + + 您不用自己调用 MCP 工具，智能体会根据您的请求选用。通常它会**发现**可用的内容（`search_templates`、`search_models`、`search_nodes`），**运行**生成任务，然后**等待并获取**输出。请参阅[智能体可以做什么](#what-your-agent-can-do)。 - - 不能。斜杠指令是 Claude Code 插件的一部分。Claude Desktop 可以连接到同一个 MCP 服务器（如果你用自然语言提问或使用提示选择器，这些工具也能正常工作），但它不支持 Claude Code 插件或斜杠指令。 + + 在**云端连接**下，服务器不会写入您的计算机：`get_output` 会返回一个临时签名 URL 和一个可直接运行的下载命令，供智能体在您的 shell 中执行。请参阅[上传与下载](#uploads-and-downloads)。 + + 在**本地连接**下，ComfyUI 会写入工作区的 `output/` 目录，`fetch_outputs(prompt_id, out_dir)` 会将已完成任务的文件复制到您指定的任何位置。 - - 没有 `/comfy` 或 `/cloud` 指令。指令根据连接方式显示在以下两个前缀之一下： + + 无需撤消，在原连接基础上添加第二种连接即可。 + + 从**本地转向云端**（需要 Cloud GPU 或合作伙伴模型）：让智能体帮您登录，然后将 `https://cloud.comfy.org/mcp` 添加到客户端。 - - **插件（推荐）：** `/comfy-cloud:generate-image`、`/comfy-cloud:generate-video`……输入 `/comfy-cloud:` 即可看到所有指令。 - - **直接连接（无插件）：** `/mcp__comfy-cloud__generate-image`……输入 `/mcp__` 即可查看。 + 从**云端转向本地**（想使用自己的模型和自定义节点）：安装 ComfyUI 和本地服务器，然后将客户端指向它。大部分操作智能体可以帮您完成。 + + + 只需告诉智能体。两种连接都已添加后，指定需要运行任务的位置，例如「在 Comfy Cloud 上运行此任务」、「本地运行」，智能体会使用对应的连接。无需切换模式，也无需在两次运行间重新配置。 - 无论哪种方式，你也可以直接用自然语言提问（例如“生成一张……的图像”）。MCP 工具由模型调用，无需斜杠指令。 + 如果一个工作流对你的机器负担过重，智能体可以告诉你并提议改为在 Comfy Cloud 上运行。如果只设置了一种连接，请让它添加另一种：参见[设置云端连接](#set-up-the-cloud-connection)或[本地 Comfy MCP 连接](#local-comfy-mcp-connection)。 - - 在 Claude Code 中，运行 `/mcp`，选择 **comfy-cloud**，然后选择 **Authenticate**。在 Claude Desktop 中，重新打开“自定义 → 连接器”中的连接器，并触发登录。 + + 在**云端连接**上，无需操作：它由托管，因此你始终使用最新版本。 + + 在**本地连接**上，请让智能体处理。之后，**重新启动客户端**或开始一个新会话：MCP 服务器在会话启动时加载，因此在你重新启动客户端或开始新会话之前，正在运行的服务器会继续提供旧版本。 + + + +### 疑难解答 + + + + 否。斜杠命令随 Claude Code 插件提供。Claude Desktop 连接到同一个 MCP 服务器：如果您用自然语言询问或使用 prompt picker，这些工具可以工作，但它不支持 Claude Code 插件或斜杠命令。 + + + 没有 `/comfy` 或 `/cloud` 命令。根据您的连接方式，命令显示在以下两种前缀之一： + + - **插件（推荐）：** `/comfy-cloud:generate-image`、`/comfy-cloud:generate-video`，……输入 `/comfy-cloud:` 查看全部。 + - **直接连接（无插件）：** `/mcp__comfy-cloud__generate-image`，……输入 `/mcp__` 查看。 + + 无论哪种方式，您都可以直接使用自然语言询问（「生成一张……的图像」）。MCP 工具由模型调用，无需斜杠命令。 - - Comfy Cloud MCP 是我们的托管服务，但自 ComfyUI 开源以来，本地代理工作流就已存在。请参阅 Agent Tools 概述中的[关于本地 ComfyUI？](/zh/agent-tools#what-about-local-comfyui)部分，了解 Cloud 首先发布的原因、当前可用的社区 MCP 服务器，以及另一个选择——[Comfy CLI](/zh/agent-tools/cli)。 + + 在 Claude Code 中，运行 `/mcp`，选择 **comfy-cloud**，然后选择 **Authenticate**。在 Claude Desktop 中，从 **Customize → Connectors** 重新打开连接器并触发登录。 diff --git a/zh/agent-tools/skills.mdx b/zh/agent-tools/skills.mdx new file mode 100644 index 000000000..2001de5c4 --- /dev/null +++ b/zh/agent-tools/skills.mdx @@ -0,0 +1,25 @@ +--- +title: "技能" +sidebarTitle: "技能" +description: "面向 Comfy 的智能体技能与插件，通过 Comfy Skills 仓库发布。" +icon: "wand-magic-sparkles" +translationSourceHash: 6ebd0106 +translationFrom: agent-tools/skills.mdx +--- + +[**Comfy Skills**](https://github.com/Comfy-Org/comfy-skills) 是 Comfy 智能体技能与插件的家园。技能是智能体按需加载的打包知识：模型引导、工作流模式和现成的命令。无需你从零编写提示词，任何智能体都能更好地使用 ComfyUI。 + +该仓库托管以下内容： + +- **Claude Code 插件**：例如 **comfy-cloud**，一次安装即可添加 Comfy Cloud MCP 连接和 `/comfy-cloud:*` 斜杠命令。 +- **智能体技能**：针对特定任务的聚焦指令，例如当前模型推荐和工作流构建技巧，并随模型变化保持最新。 +- **社区贡献**：来自 Comfy 社区的技能与插件。 + +在 Claude Code 中使用： + +``` +/plugin marketplace add Comfy-Org/comfy-skills +/plugin install comfy-cloud@comfy-skills +``` + +有关该插件的斜杠命令和设置详情，请参阅 [Comfy MCP](/zh/agent-tools/mcp)。 \ No newline at end of file diff --git a/zh/development/overview.mdx b/zh/development/overview.mdx index 16c494be3..8f5e33fa1 100644 --- a/zh/development/overview.mdx +++ b/zh/development/overview.mdx @@ -1,18 +1,21 @@ --- title: "概述" description: "作为开发者使用 ComfyUI" -translationSourceHash: 4d431c1f +translationSourceHash: 5514e159 translationFrom: development/overview.mdx translationBlockHashes: "_intro": 21d39346 "Deploy ComfyUI as a Server": 07693c4c "Cloud API": 80dab2ed - "Agent Tools / MCP": e325a91e + "Agent Tools / MCP": abe9d443 "Comfy CLI": 11578ce8 "Develop Custom Nodes": 51cd210e "Registry": cc46f1e1 --- + + + ComfyUI 是一个模块化的 GenAI 推理引擎，可以部署为 API 服务器、通过接口调用、用自定义节点扩展，也能用命令行管理。根据你的需求选择下面的路径。 ## 部署 ComfyUI 作为 API 服务 @@ -43,7 +46,7 @@ ComfyUI 是一个模块化的 GenAI 推理引擎，可以部署为 API 服务器 比较 Cloud MCP、Local MCP 和 Comfy CLI，找到适合你 AI 代理集成的方式。 -另见：[Comfy Cloud MCP](/zh/agent-tools/mcp) · [Comfy Local MCP](/zh/agent-tools/local) +另见：[Comfy MCP](/zh/agent-tools/mcp)：云端与本地连接 ## Comfy CLI