3行でいうと
- 公式が用意しているAI連携は、「Comfy MCP」(クラウドとローカルの2種類)、「Comfy CLI」(
comfy generateはベータ)、「Comfy Skills」(Claude Code用のプラグインなど)、画面の中の「Comfy Agent」、そして「API」です。 - クラウドのMCPは、
https://cloud.comfy.org/mcpに接続します。Claude DesktopやClaude Codeは、ブラウザのサインイン(OAuth)で使えます。動かすには、有効なComfy Cloudのサブスクリプションが要る、と書かれています。 - ローカルのMCPは、自分のPCのComfyUIを操作します。公式の説明では、ComfyUIの出力は手元のフォルダに書かれます。
- パートナーノードは、外部の提供元(Kling、Luma、OpenAIなど)にプロンプトや画像を送ります。公式のデータ保持のページは、パートナーノードの入出力は保存から24時間後に消える、と書いています。
- カスタムノードは、公式のドキュメントが「コミュニティが開発したもの」と呼ぶものです。公式のレジストリは悪意のある動作をスキャンしますが、公式は「信頼できる作者のものだけを入れる」よう警告しています。
この記事は、公式の資料を2026年10月23日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。コマンドや設定名は、公式の表記を写しています。公式のページは要約の形で取得したため、長い引用はせず、言い換えています。読んだ範囲で見つからなかったことは、「公式の資料では確認できていない」と書きます。
先に結論
- 「ClaudeからComfyUIを動かす」公式の道は、MCP。 クラウド用とローカル用があり、どちらも公式(Comfy Org)が出しています。Claude Desktop、Claude Code、Cursor、Codexなどの設定例が、ドキュメントにあります。
- データの行き先は、つなぎ方で変わる。 クラウドなら、プロンプトとワークフローはComfy Cloudに送られます。ローカルなら、手元で生成します。ただし、パートナーのモデルを使うと、どちらの接続でも、パートナーの設備で処理され、クレジットが使われます。
- 公式が運営するものと、そうでないものは、名前だけでは見分けにくい。 「comfyui-mcp」のように、名前が似た個人の開発者のプロジェクトも検索に出ます。公式の
comfy-mcpとは別物で、そのプロジェクトのREADMEは、公式との提携を書いていませんでした。 - ComfyUI-Managerは、Comfy-Org組織のリポジトリにあるが、そこで入れるカスタムノードの大半は、コミュニティ製。 公式は、悪意のあるノードがありうる、と警告しています。
前提:用語をそろえる
- MCP(Model Context Protocol):AIアプリが、外のツールやデータにつながるための決まりです。ここでは、ClaudeなどのAIがComfyUIを操作するための入口として使います。
- OAuth(オーオース):パスワードを渡さず、ブラウザのサインインでアプリに権限を与える仕組みです。
- APIキー:プログラムが、サービスを呼び出すときの「通行証」の文字列です。公開しない、と公式も書いています。
- CLI(コマンドライン):黒い画面に文字で命令を打つ操作です。ここでは
comfyコマンドです。 - パートナーノード:外部の会社のモデルを、APIで呼ぶノードです。
- カスタムノード:コミュニティの人たちが作る、追加のノードです。
- レジストリ(Comfy Registry):カスタムノードの公開の集まりです。ComfyUI-Managerの裏側で使われます。
- ComfyUI-Manager:カスタムノードやモデルを入れたり、消したり、まとめて管理したりする拡張です。
たとえ話:自分の工房の「受付窓口」と「外注先」と「持ち込みのツール」
自分のComfyUIが工房だとすると、MCPやCLIは「外から注文を受ける受付窓口」です。AIはその窓口に注文を出します。パートナーノードは、工房の外にある「外注先」で、材料(プロンプトや画像)を渡して、結果だけ受け取ります。カスタムノードは、よその職人が作った「持ち込みのツール」で、便利ですが、工房の中で動くので、安全かどうかは持ち込む側の確認に頼ります。これは僕らのたとえで、公式の表現ではありません。
先に整理:公式が運営するものと、そうでないもの
| 種類 | 名前 | 運営の区分(読んだ資料のとおり) |
|---|---|---|
| 公式 | Comfy MCP(クラウド接続) | 公式。cloud.comfy.org で動く |
| 公式 | Comfy MCP(ローカル接続)、comfy-mcp |
公式。GitHubの Comfy-Org/comfy-mcp |
| 公式 | Comfy CLI(comfy) |
公式。comfy generate はベータ |
| 公式 | Comfy Skills(Comfy-Org/comfy-skills) | 公式。コミュニティの寄稿も受け付ける、と書かれている |
| 公式 | Comfy Agent(画面の中の助手) | 公式。クラウドで提供中、ローカルは「coming soon」 |
| 公式 | Comfy Router | 公式。パートナーのモデルを1つのAPIで呼ぶ |
| 公式 | Comfy API | 公式。料金ページの説明は、ワークフローを本番用のAPIとして動かすもの。GPUの時間単価は秒単位で課金 |
| 公式 | ComfyUIのサーバーAPI(REST+WebSocket) | 公式。互換性の保証はない、と書かれている |
| 公式 | パートナーノード | ノードは公式。処理はパートナー(第三者)の設備 |
| 公式(組織のリポジトリ) | ComfyUI-Manager、Comfy Registry | Comfy-Org組織のリポジトリ(READMEに「公式」の明記はない)。入れるものの大半はコミュニティ製 |
| コミュニティ・第三者 | カスタムノード | コミュニティが開発したもの(ドキュメントの表現) |
| コミュニティ・第三者 | 個人の開発者のMCPやAgentのパネル(例:comfyui-mcp) | 公式との提携は、そのREADMEには書かれていない。MITライセンス |
| コミュニティ・第三者 | Hugging Face、Civitai のモデル | それぞれの提供元の条件 |
公式が運営するもの
Comfy MCP(クラウド接続)
公式のMCPのページによると、次のとおりです(確認日2026-10-23)。
| 項目 | 公式に書かれていること |
|---|---|
| 接続先 | https://cloud.comfy.org/mcp |
| 必要なもの | Comfy Cloudのアカウント。新規の人には「5回の無料の実行」があるが、動かすには有効なサブスクリプションが要り、クレジットの残高だけでは足りない。テンプレート・モデル・ノードの検索は、アカウントがあれば無料と書かれている |
| 認証 | Claude Desktop、Claude Code、Codex、OpenClaw は、ブラウザのサインイン(OAuth)。Cursorは、MCPのOAuthに対応していないため、APIキー(comfyui- で始まり、X-API-Key のヘッダーで渡す) |
| Claude Desktop | カスタムコネクタとして、URLを追加する |
| Claude Code | Comfy Skillsのマーケットプレイスから comfy-cloud のプラグインを入れる、または claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp |
| Cursor | mcp.json に、APIキーを環境変数から渡す設定を書く |
| できること(ツール) | テンプレートやモデルやノードの検索、テンプレートやワークフローの実行、ファイルのアップロード、ジョブの待機と出力の取得、保存したワークフロー、共有、課金状況の確認 |
- 公式は、新しい人にはクラウド接続から始めることを勧めています。
- MCPのドキュメントには、Codexで繰り返しサインアウトされる問題(
invalid_grant)と、その対処が書かれています。公式は、Codex側のトークンの扱いが原因としています。 - 成熟度の表記が、ページの中で揃っていません。 FAQは「generally available」、既知の制限の節は「早期のリリース」と書き、意見募集のURLには「cloudmcpbeta」が入っている、という要約でした。
- 既知の制限として、
submit_workflowで作った資産には、ワークフローのメタデータが入らないことがある、複雑なワークフローは再試行が要ることがある、出力はシェルでのダウンロードが要る、が挙げられています。
Comfy MCP(ローカル接続)
| 項目 | 公式に書かれていること |
|---|---|
| 入れ方 | pip install comfy-mcp。comfy-mcp コマンドが、標準入出力でMCPを話す。URLも認証も要らない |
| 必要なもの | Python 3.10以上、comfy-cli(1.14.0以上)、ComfyUIの作業場、実行用に動いているComfyUI(comfy launch) |
| 設定 | Claude Desktopは、mcpServers に comfy-mcp を書き、環境変数 COMFY_BIN に comfy の場所を渡す。Claude Codeは claude mcp add comfy-mcp ...。Cursorは同じJSON |
| ツール | 実行、ジョブの状態、出力の取得、ComfyUIの起動と停止、テンプレート・ノード・モデルの検索、ワークフローの検証など。自分の環境のカスタムノードも読む |
| 目安の機材 | PCではVRAM 24GB以上でほとんどの作業(動画を含む)、8〜24GBで画像、8GB未満ならクラウド |
- ローカル版もクラウド版も、同時に使えます。ただし、サインインはそれぞれ別です。
- ローカル版の出力は、作業場の
output/に書かれ、fetch_outputsで指定した場所にコピーできます。 - パートナーのモデルは、ローカル接続でも、パートナーの設備で動き、クレジットを使う、と書かれています。
Comfy CLI
| 項目 | 公式に書かれていること |
|---|---|
| 入れ方 | pip install comfy-cli、またはHomebrew。comfy setup、comfy cloud login、comfy cloud whoami |
| 主なコマンド | comfy generate(パートナーの画像・動画・音声・3Dを1回で呼ぶ)、comfy run、comfy jobs、comfy validate(クラウドのワークフロー)、comfy templates、comfy nodes、comfy models、comfy skills install |
| ベータの表記 | 「comfy generate はベータ。フラグ名、モデルの別名、出力の形式は変わりうる」。このラベルが付いているのは comfy generate だけ、と書かれている |
| 認証 | ブラウザのサインイン、またはAPIキー(--api-key か環境変数 COMFY_API_KEY) |
| 使うもの | クレジットが要る。ローカルのComfyUIのサーバーは、任意 |
| 接続先の切り替え | サインイン済みならクラウド、そうでなければローカル。--where local か --where cloud などで変えられる |
- 生成のときは、手元のファイルをアップロードし、ジョブを出し、終わるまで確認して、結果を保存します。
- アップロードした参照用のファイルは、Comfyが管理するGoogle Cloud Storageに、署名つきのURLで置かれ、24時間で自動的に削除される、と書かれています。
Comfy Skills
- Comfy-Org/comfy-skills は、コーディング用のAIエージェント向けのスキルとプラグインの置き場所です。Claude Code用の
comfy-cloudプラグインが、MCPの接続と、/comfy-cloud:*のコマンドを一度に入れます。 - 入れ方(Claude Code):
/plugin marketplace add Comfy-Org/comfy-skillsと/plugin install comfy-cloud@comfy-skills。 - Skillsのページは、対応するエージェントとしてClaude Codeだけを書いています。一方、CLIのページは、
comfy skills installでClaude Code、Cursor、AGENTS.mdに対応するツール向けのスキルを入れられる、と書いています。リポジトリには、Comfyの利用者からの寄稿も入る、と書かれています。 - 必要なもの、ベータの表記、データの行き先は、そのページには書かれていませんでした。
Comfy Agent(画面の中の助手)
- 公式の説明:ワークフローを、理解する、作る、編集する、実行前に検証する、画像・動画・音声を確認する、といったことを、会話で手伝います。実行の許可は、「Ask」(毎回の確認)か「Auto」(確認なし)を選べます。
- 提供の範囲:クラウドで提供中(「generally available」)。ローカルのデスクトップ版は「coming soon」で、順番待ち(ウェイトリスト)が開いています。
- 費用:最初の数回のチャットは無料で、あとはComfyのクレジットが使われます。サブスクリプションは必ずしも要らないが、クレジットの残高がプラスであることが必要、とAgentのページは書いています。トークンあたりのクレジットの表も載っていて、例として Opus 4.8 は1,000トークンあたり、入力1.055、出力5.275、キャッシュヒット0.106クレジットです(このほかキャッシュ書き込みの単価もあります。2026-10-24に確認)。料金ページは、プランごとの同時のタスク数も載せています。
- ベータの表記:同じドキュメントの意見募集の節に「現在ベータ」という趣旨の文があります。ページの別の場所には「generally available」とあり、表記が揃っていません。
- データ:Agentへの依頼は、ネットワークを通じてComfyのサービスに送られます。チャットの履歴は保存され、保存場所は環境によって違う、と書かれています。詳しくは、別のデータとプライバシーのページを見るよう案内されています(僕らは読めていません)。
API:ComfyUIのサーバー、Comfy Cloud、Comfy Router
| 種類 | 公式に書かれていること |
|---|---|
| ComfyUIのサーバーAPI(ローカル) | 既定で http://127.0.0.1:8188 に、HTTPサーバーが立つ。ポートは --port、ネットワーク上に開くには --listen 0.0.0.0。主なルートは、POST /prompt(ワークフローの提出)、GET /history、GET /view、POST /upload/image、GET /object_info、WebSocketの /ws など。互換性は、版をまたいで保証されない |
| 認証(ローカル) | 読んだ範囲では、ルートの表に、認証や安全についての注意は見つからなかった。ローカルなら認証なし、パートナーノードを使うときだけAPIキー |
| Comfy Cloud API | APIキーと有料のサブスクリプションが要る。v2は Authorization: Bearer。v1のクラウドAPIは「非推奨、予告なく変わりうる」と書かれている |
| Comfy Router | https://api.comfy.org で、画像・動画の生成モデルを1つのAPIで呼ぶ。従量課金で、サブスクは要らない。残高が空だと 402 が返る。SDKはPythonとTypeScript |
| SDK | 公式のPythonとTypeScriptのSDKがある、と書かれている |
- Comfy RouterのクイックスタートのページはAPIキーを「サーバーか手元の環境に置く」よう書いています。
- Comfy Routerのページには、ベータ・プレビューの表記は見つかりませんでした。リクエストや出力の保存・保持については、そのページには書かれていませんでした。
- 料金ページには、Comfy APIのGPUの時間単価(RTX PRO 6000は3.49ドル/時間など)が出ています。記事04で表をまとめます。
パートナーノード
- 公式の説明:クローズドなモデルや第三者が運営するモデルを、APIで呼ぶノードです。任意で、
--disable-partner-nodesで止められます。--offlineで、有料のAPIノードも止められる、とREADMEは書いています。 - 必要なもの:最新のComfyUI(できればナイトリー)、Comfyのアカウントのログイン、ゼロより多いクレジット。ログインは、
127.0.0.1かlocalhostからは直接できますが、LANなどからはAPIキーが要ります。 - 状態の表記:ドキュメントのFAQは「まだテスト段階」と書き、自分のAPIキーを持ち込むことは未対応、としています。
- 例と数:OpenAI、Kling、Luma などが例として挙がります。別の「モデル提供元」のページは、25社を表にし、うち18社は「Comfyが提供元と契約を結んでいる」、2社は「提供元自身の規約とプライバシーポリシーが適用される」、5社は「確認待ち」としています(確認日2026-10-23)。
- クレジット:前払いで、払い戻しはできず、月ごとのクレジットは期間の終わりに、追加分は購入から1年で失効する、と書かれています。実行のあとに費用が分かる場合があり、残高がマイナスになりうる、とも書かれています。
ComfyUI-ManagerとComfy Registry
- ComfyUI-Managerは、GitHubのComfy-Org組織(Comfy-Org/ComfyUI-Manager)にある拡張で(READMEは「公式」とは明記しておらず、導入手順のURLの一部は別の開発者のアカウントを指しています)、カスタムノードとモデルを、入れる、消す、無効にする、有効にする、スナップショットで元に戻す、といったことをします。ライセンスはGPL-3.0です。
- デスクトップ版は、Managerが標準でついてきて、
--enable-managerで動きます。ポータブル版と手動インストールでは、本体に組み込まれているが、有効にする作業が要ります。 - Comfy Registryは、カスタムノードの公開の集まりで、Managerの裏側です。公式は、公開されたノードを、悪意のある動作(独自のpipのホイール、任意のシステムコールなど)についてスキャンし、通ったノードには確認済みの印が付く、と書いています。
- Managerの設定には、
security_level(strong、normal、normal-、weak)があります。デスクトップ版では「Manager Security Level」という設定で、Strict、Standard(推奨)、Relaxed、Permissive から選びます。GitのURLからの導入とpipの導入は、既定では許可されていません。
コミュニティ製・第三者のもの
カスタムノード
- 公式の「カスタムノードの入れ方」のページは、カスタムノードを「コミュニティが開発したもの」と呼び、「信頼できる作者のもの、コミュニティでよく使われているものだけを入れる」よう警告しています。「ComfyUIはオープンソースなので、悪意のあるプラグインが悪用しうる」という趣旨も書いています。
- 入れ方は3つ:Manager(公式の推奨)、Gitのクローン、ZIP(バージョン管理が失われるため非推奨)。いずれも、ComfyUIの環境にPythonの依存関係を入れます。
- 公式のページは、カスタムノードが公式に支援されているかどうかを、はっきりとは書いていません。
- クラウドでは、よく使われるカスタムノードが入っています(すべてではなく、対応は順次増える)。
- 公式のGitHubのリリースノートには、v0.40.0に「カスタムノードのガバナンスの強制」という項目がありました。内容は、僕らは読めていません。
個人の開発者のMCP・Agentパネル(例:comfyui-mcp)
- 名前の似た「comfyui-mcp」というプロジェクトが、GitHubにあります。公開しているのは個人の開発者のアカウントで、READMEは、公式との提携を書いていません。公式のエージェント用のツールは別物で、Comfyのチームが保守している、と書いています。MITライセンスです。この項目の内容は、そのプロジェクト自身のREADMEによるもので、個人の開発者のアカウント名を含むため、出典の一覧にはURLを載せていません(確認日2026-10-23)。
- READMEによると、ローカルのモードでは、ワークフローと出力と履歴は手元に残ります。選んだAIの提供元(ClaudeやChatGPTなど)には、プロンプトとツールの結果が送られます。Comfy Cloudを選ぶと、リクエストとワークフローはComfy Cloudに送られます。
- 公式のドキュメントは、このプロジェクトを紹介していません。使う場合は、そのプロジェクトのREADMEとライセンス、権限を、自分で確かめてください。
Hugging Face、Civitai などのモデルの入手先
- 公式のドキュメントは、モデルの入手先として、Hugging Face、Civitai、GitHubのプロジェクトのページを挙げています。これらのサイトの利用条件、モデルのライセンスは、それぞれの運営の側で決まります。
データはどこへ流れるか(まとめ)
| つなぎ方 | 送られるもの | 行き先 | 公式に書かれていること |
|---|---|---|---|
| ローカルのComfyUI(つなぎなし) | なし(手元で生成) | 手元のPC | コアは、頼まない限り何もダウンロードしない |
| デスクトップ版のテレメトリ | 使っているアプリの情報(任意の同意が要る) | PostHog、Datadog など | 後述(記事04)。ワークフローの内容やプロンプトは集めない、と書かれている |
| クラウドのMCP、クラウドのAPI | プロンプト、ワークフロー、アップロードしたファイル | Comfy Cloud(Comfy Org) | データ保持は「サービスの運営・分析・改善に必要な間」。学習には使わない、と利用規約が書く |
| ローカルのMCP | ComfyUIへの命令 | 手元のComfyUI | 出力は手元のフォルダ。パートナーのモデルを使えば、パートナーへ |
| CLIの生成 | 参照用のアップロード | Comfy管理のストレージ | 24時間で自動削除 |
| パートナーノード | プロンプト、画像、モデル、パラメーター | 外部のAI提供元 | 利用規約は、利用者の身元やアカウントの情報は送らない、と書く。保存から24時間後に消える、とデータ保持のページが書く |
| Comfy Agent | 依頼の内容 | Comfyのサービス | 履歴の保存場所は環境による。詳しくは別のページ(未読) |
| 個人開発者のMCP | 選んだAIへの内容 | 選んだAIの提供元 | そのプロジェクトのREADMEが説明(公式の資料ではない) |
僕らの見立て(事実とは分けています)
- 見立て: 「画像を作る」だけなら、AIとつながなくても、ローカルのComfyUIで完結します。MCPやAgentは、「組み立ての手間を減らす」ための追加の層と考えると、整理しやすいと思います。
- 見立て: データの行き先を気にするなら、「ローカルのMCP」と「クラウドのMCP」の違いが一番大きいと思います。ただし、パートナーのモデルを使えば、どちらも外に出ます。
- 見立て: カスタムノードは、ドキュメントが勧めるManagerで入れられても、公式が作ったものとは限りません。ノードごとに、作者とスター数、更新の時期を見るのが、無理のない確認の仕方だと思います(公式の基準ではありません)。
誤解されやすい点と、今日からできること
誤解されやすい点
- 「Managerで入れたものは、公式が保証する」とは限らない。 公式は、信頼できる作者のものだけを入れるよう警告しています。
- 「MCPなら無料」とは限らない。 クラウド接続は、サブスクリプションとクレジットが要ります。
- 「ローカルのMCPなら、全部手元で完結」とは限らない。 パートナーのモデルは、外部の設備で動きます。
- 「名前が似ているものは公式」とは限らない。 公式のローカルMCPは
comfy-mcp(Comfy-Org)です。
今日からできること
- 外に出したくない作業なら、
--offlineや--disable-partner-nodesを使うかを決める。 - ClaudeからつなぐならまずMCPのドキュメントのClaude Desktop/Claude Codeの設定を読む。
- カスタムノードを入れる前に、リポジトリの作者と内容を確かめ、ManagerのSecurity Levelを確認する。
- APIキーは、コードの中に書かず、環境変数に置く。
気をつけること
- この記事は、実際に使って確かめた記録ではありません。公式の資料を読んだ範囲です。
- 公式のページは要約の形で取得したため、コマンドや設定名は、版によって違うことがあります。手元のドキュメントと照らしてください。
- ベータや提供の範囲の表記は、ページの中でも揃っていません(MCP、Comfy Agent)。公式の最新の表示を確認してください。
- Comfy Agent、Comfy API、Enterprise、Developer Platform などの詳細ページは、読めていないものがあります。
- 規約・プライバシーの解釈は、公式に確認してください。この記事は法律の助言ではありません。
出典
- Comfy Agent Tools(ComfyUI Docs、Comfy Org、確認日 2026-10-23)
- Comfy MCP(ComfyUI Docs、確認日 2026-10-23)
- Comfy CLI(ComfyUI Docs、確認日 2026-10-23)
- Comfy Skills for Coding Agents(ComfyUI Docs、確認日 2026-10-23)
- Comfy Agent(ComfyUI Docs、確認日 2026-10-23)
- Comfy Router Quickstart(ComfyUI Docs、確認日 2026-10-23)
- Run Workflows Overview(ComfyUI Docs、確認日 2026-10-23)
- ComfyUI Server Overview(ComfyUI Docs、確認日 2026-10-23)
- ComfyUI Server Routes(ComfyUI Docs、確認日 2026-10-23)
- Partner Nodes(ComfyUI Docs、確認日 2026-10-23)
- Model provider verification, licensing, and data residency(ComfyUI Docs、確認日 2026-10-23)
- Data Retention(ComfyUI Docs、確認日 2026-10-23)
- Install custom nodes(ComfyUI Docs、確認日 2026-10-23)
- Manager Installation(ComfyUI Docs、確認日 2026-10-23)
- Manager Overview(ComfyUI Docs、確認日 2026-10-23)
- Comfy Registry Overview(ComfyUI Docs、確認日 2026-10-23)
- ComfyUI-Manager README(GitHub Comfy-Org、確認日 2026-10-23)
- ComfyUI README(GitHub Comfy-Org/ComfyUI、確認日 2026-10-23)
- Releases(GitHub Comfy-Org/ComfyUI、確認日 2026-10-23)
- Terms of Service(Comfy Org、2026年5月13日発効と表示、確認日 2026-10-23)