Comfy-Org · comfyui-wiki · Aug 3, 2026 · Aug 3, 2026 · Aug 3, 2026
diff --git a/agent-tools/mcp.mdx b/agent-tools/mcp.mdx
@@ -17,7 +17,7 @@

 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.

 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.

@@ -186,7 +186,7 @@
  </Tab>

  <Tab title="Codex">
    [Codex](https://developers.openai.com/codex/cli) connects to Comfy Cloud over Streamable HTTP. Add the server in Settings, then sign in with OAuth.

    <video
      controls
@@ -355,7 +355,7 @@
 Typical flow:

 1. **Discover** what is available (`search_templates`, `search_models`, `search_nodes`, or `cql` for graph-style questions).
 2. **Run** a generation: `run_template` for a matching pre-built template, `submit_workflow` for a custom workflow (with `upload_file` when an input image is needed), or `partner_generate` for partner models like Flux, Grok, Gemini, OpenAI, Ideogram, and Seedance.
 3. **Wait and retrieve** outputs (`wait_for_job`, then `get_output` returns a download command your agent runs in your shell).

 The server prefers matching [pre-built templates](https://comfy.org/workflows) before building a workflow from scratch, which tends to produce better results faster.
@@ -372,10 +372,10 @@
 | `get_template` | Fetch a template's full workflow JSON for inspection or hand-editing |
 | `get_template_schema` | See which of a template's parameters can be overridden at run time |
 | `search_models` | Search the model catalog by text, type, base model, or source |
 | `search_nodes` | Search available nodes by text, category, or input/output types. Also surfaces **subgraph blueprints** (pre-wired node groups like Text to Image or Remove Background) |
 | `get_node` | Get the complete input spec for specific nodes, including full option lists |
 | `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

@@ -433,11 +433,11 @@
 | `get_billing_status` | Check your credit balance, subscription tier, and billing link |
 | `get_server_info` | Confirm which server the agent reached: environment, host, version, and auth state |
 | `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
 
-Discovery is free: `search_templates`, `search_models`, and `search_nodes` work with just a [Comfy account](https://cloud.comfy.org). Running generations consumes Comfy Cloud credits and requires a subscription or credit balance.
+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.
 
 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.
 
@@ -473,7 +473,7 @@
 Want the agent experience **inside** Comfy Cloud (chat that builds and edits your graph), not an external MCP client?

 <Card title="Comfy In-App Agent" icon="comments" href="/agent-tools/in-app-agent">
  Private alpha on Comfy Cloud. Join the waitlist to request access.
 </Card>

 ## Feedback

diff --git a/ja/agent-tools/mcp.mdx b/ja/agent-tools/mcp.mdx
@@ -3,15 +3,15 @@ title: "Comfy Cloud MCP"
 sidebarTitle: "Cloud MCP"
 description: "Claude Code、Claude Desktop、Cursor、Codex、またはMCP互換エージェントからComfy Cloud MCPに接続: 画像・ビデオ・オーディオ・3Dの生成、モデルとノードの検索、ワークフローの実行。"
 icon: "cloud"
-translationSourceHash: b269a2a2
+translationSourceHash: f491b28c
 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": 20e94ef0
+  "Credits and spending": 686040e6
   "Outputs and downloads": a2c8c12f
   "Related resources": 2a86e2c5
   "Related: Comfy In-App Agent": be5e2cdf
@@ -24,6 +24,9 @@ translationBlockHashes:
 
 
 
+
+
+
 import CloudFeature from '/snippets/ja/cloud-feature.mdx'
 
 <CloudFeature/>
@@ -458,7 +461,7 @@ MCPツールを自分で呼び出す必要はありません。エージェン
 
 ## クレジットと支出
 
-検索は無料です: `search_templates`、`search_models`、`search_nodes` は [Comfy アカウント](https://cloud.comfy.org) だけで動作します。生成の実行は Comfy Cloud のクレジットを消費し、サブスクリプションまたはクレジット残高が必要です。
+検索は無料です: `search_templates`、`search_models`、`search_nodes` は [Comfy アカウント](https://cloud.comfy.org) だけで動作します。生成の実行には、有効な Comfy Cloud サブスクリプションが必要です。クレジットやトップアップの残高だけではアクセスできません。未使用のクレジットがあっても、生成を実行するには有効なサブスクリプションが必要です。
 
 実際にお金を使うツールは **出費制限付き** です。生成で有料パートナーモデル (`partner_generate`) や有料 API ノードを含むワークフロー/テンプレート (`run_template`、`run_saved_workflow`、`submit_batch`) を使用する場合、サーバーはエージェントがクレジットを消費することに同意したことを確認するまで実行をブロックします。そのため、それらの実行前にエージェントが確認を求めます。無料のローカルのみのワークフローはプロンプトを表示しません。
 

diff --git a/ko/agent-tools/mcp.mdx b/ko/agent-tools/mcp.mdx
@@ -3,15 +3,15 @@
 sidebarTitle: "Cloud MCP"
 description: "Claude Code, Claude Desktop, Cursor, Codex, OpenClaw 또는 MCP 호환 에이전트에서 Comfy Cloud MCP에 연결하여 이미지, 비디오, 오디오 및 3D를 생성하고, 모델과 노드를 검색하며, 워크플로를 실행하세요."
 icon: "cloud"
-translationSourceHash: b269a2a2
+translationSourceHash: f491b28c
 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": 20e94ef0
+  "Credits and spending": 686040e6
   "Outputs and downloads": a2c8c12f
   "Related resources": 2a86e2c5
   "Related: Comfy In-App Agent": be5e2cdf
@@ -23,6 +23,9 @@
 
 
 
+
+
+
 import CloudFeature from '/snippets/ko/cloud-feature.mdx'
 
 <CloudFeature/>
@@ -206,7 +209,7 @@
  </Tab>

  <Tab title="Codex">
    [Codex](https://developers.openai.com/codex/cli)는 Streamable HTTP를 통해 Comfy Cloud에 연결합니다. 설정에서 서버를 추가한 다음 OAuth로 로그인하세요.

    <video
      controls
@@ -375,7 +378,7 @@
 일반적인 흐름:

 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)을 선호하며, 이는 더 빠르고 더 나은 결과를 내는 경향이 있습니다.
@@ -459,7 +462,7 @@
 
 ## 크레딧 및 사용
 
-탐색은 무료입니다: `search_templates`, `search_models`, `search_nodes`는 [Comfy 계정](https://cloud.comfy.org)만 있으면 작동합니다. 생성 실행은 Comfy Cloud 크레딧을 소비하며 구독 또는 크레딧 잔액이 필요합니다.
+탐색은 무료입니다: `search_templates`, `search_models`, `search_nodes`는 [Comfy 계정](https://cloud.comfy.org)만 있으면 작동합니다. 생성을 실행하려면 활성 Comfy Cloud 구독이 필요합니다. 크레딧 또는 충전 잔액만으로는 접근할 수 없습니다. 미사용 크레딧이 있어도 생성을 실행하려면 활성 구독이 필요합니다.
 
 실제 비용이 발생하는 도구는 **spend-gated**입니다. 생성이 유료 파트너 모델(`partner_generate`) 또는 유료 API 노드가 포함된 워크플로/템플릿(`run_template`, `run_saved_workflow`, `submit_batch`)을 사용하는 경우, 서버는 에이전트가 크레딧 사용에 동의했음을 확인할 때까지 실행을 차단합니다. 따라서 해당 실행 이전에 에이전트가 사용자에게 확인을 요청할 것입니다. 무료 로컬 전용 워크플로는 절대 확인을 요청하지 않습니다.
 

diff --git a/zh/agent-tools/mcp.mdx b/zh/agent-tools/mcp.mdx
@@ -3,15 +3,15 @@
 sidebarTitle: "Cloud MCP"
 description: "从 Claude Code、Claude Desktop、Cursor、Codex、OpenClaw 或任何兼容 MCP 的代理连接 Comfy Cloud MCP：生成图像、视频、音频和 3D，搜索模型与节点，并运行工作流。"
 icon: "cloud"
-translationSourceHash: b269a2a2
+translationSourceHash: f491b28c
 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": 20e94ef0
+  "Credits and spending": 686040e6
   "Outputs and downloads": a2c8c12f
   "Related resources": 2a86e2c5
   "Related: Comfy In-App Agent": be5e2cdf
@@ -22,6 +22,9 @@
 
 
 
+
+
+
 import CloudFeature from '/snippets/zh/cloud-feature.mdx'
 
 <CloudFeature/>
@@ -203,7 +206,7 @@
  </Tab>

  <Tab title="Codex">
    [Codex](https://developers.openai.com/codex/cli) 通过 Streamable HTTP 连接到 Comfy Cloud。在设置中添加服务器，然后使用 OAuth 登录。

    <video
      controls
@@ -454,7 +457,7 @@
 
 ## 积分与消费
 
-探索功能免费：`search_templates`、`search_models` 和 `search_nodes` 只需一个 [Comfy 账户](https://cloud.comfy.org) 即可使用。运行生成会消耗 Comfy Cloud 积分，且需要订阅或积分余额。
+探索功能免费：`search_templates`、`search_models` 和 `search_nodes` 只需一个 [Comfy 账户](https://cloud.comfy.org) 即可使用。运行生成需要有效的 Comfy Cloud 订阅。仅有积分或充值余额并不足以获得访问权限：即使你还有未使用的积分，也需要有效订阅才能运行生成。
 
 实际花费金钱的工具是**消费门槛限定**的。当生成使用付费合作伙伴模型（`partner_generate`）或包含付费 API 节点的工作流/模板（`run_template`、`run_saved_workflow`、`submit_batch`）时，服务器会阻止执行，直到你的智能体确认你同意花费积分。因此，在这些运行之前，智能体会先与你确认。免费的本地工作流永远不会提示。