ComfyUIをClaudeなどのAIにつなぐ（その1）：Comfy MCP（クラウド・ローカル）、Comfy Skills、Comfy CLIの設定を、公式の手順でクライアントごとに並べる

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。コマンドと設定ファイルの例は、公式のページに書かれていたものを写しています（ページの要約の形で読んだため、全文は公式ページで確かめてください）。この記事で組んだ文は、そのつど「この記事の案」と区別して書きます。画面の表記は変わるので、手元の画面と照らしてください。

先に結論

• つなぐ相手を決めてから、道を選びます。 Claude DesktopやClaude Codeなどのチャットや開発用のAIから動かしたいなら、MCPかSkills。コマンドで動かしたいなら、CLIです。ComfyUIの画面の中でAIと話したいなら、記事08のComfy Agentです。
• クラウドとローカルは、別々の接続です。 両方使えますが、サインインはそれぞれ別、と公式は書いています。
• クラウドのMCPは、認証の方法がクライアントで違います。 Claude Desktop、Claude Code、Codex、OpenClawはブラウザのサインイン（OAuth）。Cursorは、MCPのOAuthに対応していないため、APIキーです。
• ローカルのMCPで、生成は手元で動きます。 公式の説明では、出力は作業場の output/ に書かれます。ただし、パートナーのモデルは別です。
• 成熟度の表記が揃っていません。 クラウドのMCPは、FAQで「generally available」、既知の制限の節で「early release」と書かれています。

前提：用語をそろえる

• MCP（Model Context Protocol）：AIアプリが、外のツールにつながるための決まりです。ここでは、ClaudeなどがComfyUIを操作する入口です。
• OAuth：パスワードを渡さず、ブラウザでサインインして、アプリに権限を与える仕組みです。
• APIキー：プログラムが、サービスを呼び出すときの「通行証」の文字列です。公式は、コミットするファイルに直接書かないよう書いています。
• HTTPヘッダー：リクエストに添える付加情報です。APIキーを X-API-Key というヘッダーで渡すことがあります。
• stdio（標準入出力）：ローカルのMCPが、AIアプリと話すときの経路です。URLは使いません。
• プラグイン／スキル：Claude Codeに、追加の機能や知識を入れる仕組みです。
• スラッシュコマンド：チャットに / から始めて打つ、決まった命令です。
• ワークスペース（Comfy Cloudの）：Comfyのアカウントの、作業の単位です。サインインのとき、選ぶ画面が出る、と公式は書いています。

先に整理：3つの道の違い（Comfy Agentは記事08）

接続1：Comfy MCP（クラウド）

公式の「Comfy MCP」のページに沿った内容です。

認証の方法（クライアント別）

手順A：Claude Desktopにつなぐ

1. Claude Desktopで「Customize」を押し、「Connectors」を開きます。
2. 「+」を押し、「Add custom connector」を選びます。
3. 名前（公式の例は「Comfy Cloud MCP」）と、リモートMCPサーバーのURL https://cloud.comfy.org/mcp を入れ、「Add」を押します。

4. ブラウザが開くので、ワークスペースを選び、「Continue」を押します。

5. 期待される結果：コネクタが追加され、サインインの許可が済みます。そのあと、チャットで公式の例（「generate an image of a cat astronaut」、「find a Wan 2.2 video template」、「upscale this photo」）のような依頼ができる、と公式は書いています（この記事ではそのまま日本語にせず、公式の例の英語を引いています）。

6. 公式は、Claude Desktopではスラッシュコマンドは使えない、として、普通の言葉か、プロンプトの選択画面を使うよう書いています。選択画面に出るプロンプトは、generate-image、generate-video、generate-audio、generate-3d、upscale-image、remove-background、search-templates、search-models、search-nodes、help です。

手順B：Claude Codeにつなぐ（プラグイン経由。公式のページが recommended と付けている方）

1. Claude Codeで、次の2つのコマンドを順に実行します（公式の写し）。

/plugin marketplace add Comfy-Org/comfy-skills
/plugin install comfy-cloud@comfy-skills

1. /mcp を実行し、一覧から「comfy-cloud」を選び、「Authenticate」を選びます。ブラウザでサインインします。
2. 期待される結果：/comfy-cloud:* のスラッシュコマンドが使えるようになります。公式のSkillsのリポジトリのREADMEが挙げるコマンドは、次のとおりです。

手順B'：Claude Codeにつなぐ（プラグインを使わない直接の追加）

1. 次のコマンドを実行します（公式の写し）。

claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp

1. すべてのプロジェクトで使うなら、-s user を付ける、と公式は書いています。
2. このとき、プロンプトは /mcp__comfy-cloud__... の形で出ます（プラグインの /comfy-cloud: とは別の形）。
3. APIキーで使う場合の例として、公式は、-H "X-API-Key: comfyui-…" をコマンドに付ける形を挙げています。

手順C：Cursorにつなぐ（APIキーが必要）

1. Cursorの「Settings → Tools & MCPs」を開き、「+ New MCP Server → Add a Custom MCP Server」を選びます。
2. ~/.cursor/mcp.json（全体）か、.cursor/mcp.json（そのプロジェクトだけ）を、次のように書きます（公式の例の写し）。

{
  "mcpServers": {
    "comfy-cloud": {
      "url": "https://cloud.comfy.org/mcp",
      "headers": {
        "X-API-Key": "${env:COMFY_API_KEY}"
      }
    }
  }
}

1. 環境変数 COMFY_API_KEY に、APIキーを入れます。公式は、キーが comfyui- で始まること、platform.comfy.org/profile/api-keys で作ることを書き、コミットするファイルに、キーを直接書かないよう注意しています。

手順D：Codexにつなぐ

1. 画面から：「Settings → MCP servers → ＋ Add server」で「Streamable HTTP」を選び、名前とURLを入れて「Save」。そのあと「Authenticate」。
2. コマンドから（公式の写し）：

codex mcp add comfy-cloud --url https://cloud.comfy.org/mcp
codex mcp login comfy-cloud

1. 設定は、~/.codex/config.toml（または、信頼したプロジェクトの .codex/config.toml）に書かれます。
2. APIキーで入れる場合（CIなどの画面のない場面）の公式の例：

[mcp_servers.comfy-cloud]
url = "https://cloud.comfy.org/mcp"
env_http_headers = { "X-API-Key" = "COMFY_API_KEY" }

手順E：OpenClawにつなぐ（クラウドだけ。ローカルのインストールは動かせない）

1. 次のコマンドを順に実行します（公式の写し）。

openclaw skills install @comfy-org/comfy
openclaw mcp set comfy '{"url":"https://cloud.comfy.org/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login comfy
openclaw gateway restart

1. 確かめるコマンド：openclaw mcp status --verbose。
2. 公式は、auth: "oauth" のとき、静的なヘッダーは無視される、と書いています。APIキーで入れる場合は、COMFY_API_KEY を設定し、Authorization: Bearer ${COMFY_API_KEY} のヘッダーで登録します。公式は、ビルドによってはカスタムヘッダーが落ちることがあるため、OpenClawでは X-API-Key よりBearerを選ぶ、という趣旨で書いています。

そのほかのクライアント

• mcpServers のJSONに "url": "https://cloud.comfy.org/mcp" を書く形です。Windsurfは serverUrl を使う、と公式は書いています。Ampは「Settings → MCP Servers」か、~/.config/amp/settings.json。

クラウドのMCPが持つツール（公式の一覧）

何が渡るか、権限、出力の受け取り

外し方

• 公式のMCPのページには、クラウドのMCPを外す（切断する、コネクタを消す）手順の記載が見つかりませんでした。Claude DesktopのコネクタやClaude Codeの設定から外す操作は、それぞれのアプリの公式の説明で確かめてください。この記事は、そちらのページを読んでいません。
• APIキーで入れた場合のキーの取り消しの手順も、このページには書かれていません。

うまくいかないときの確認点

既知の制限（クラウド、公式の記載）

• submit_workflow で作った資産に、ワークフローのメタデータが入らないことがある。
• 複雑なワークフローは、再試行が要ることがある。
• 出力は、シェルのダウンロードが要る。
• アップロードのサイズの上限は、クライアントによって決まることがある。
• Cursorは、APIキーが要る（デバイスコードのOAuthは計画中）。

接続2：Comfy MCP（ローカル）

公式の「Comfy MCP」のページの、ローカルの節に沿った内容です。comfy-mcp は、Comfyの first-party（自社）のローカルMCPサーバーと、公式は書いています。リポジトリは github.com/Comfy-Org/comfy-mcp です。

必要なもの

• Python 3.10以上
• comfy-cli 1.14.0以上（pip install "comfy-cli>=1.14.0"）
• ComfyUIの作業場（comfy install、または、すでにあるチェックアウトなら comfy set-default <path>）
• 実行のために動いているComfyUI（comfy launch か、ツールの launch_comfyui）。サーバーが、ComfyUIを暗黙に起動することはない、と公式は書く

手順（公式のクイックスタートの順）

1. 次のコマンドを順に実行します（公式の写し）。

pip install "comfy-cli>=1.14.0"
comfy install
pip install comfy-mcp
comfy launch

1. 使うAIアプリの設定を書きます。Claude Desktop、Claude Codeの .mcp.json、Cursorで、中身は同じJSONです（公式の例の写し）。

{
  "mcpServers": {
    "comfy-mcp": {
      "command": "comfy-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}

• Claude Desktop：claude_desktop_config.json を編集します（「Settings → Developer → Edit Config」、macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json）。編集後、再起動します。
• Claude Code：次のコマンド、または、リポジトリのルートの .mcp.json（公式の写し）。

claude mcp add comfy-mcp -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-mcp

• Cursor：~/.cursor/mcp.json（全体）か .cursor/mcp.json（プロジェクト）。

• 環境変数 COMFY_BIN は任意で、comfy の絶対パスを渡します。仮想環境の中に入れたときや、AIアプリの環境に、シェルのPATHがないときに必要、と公式は書きます。

• AIアプリを再起動し、AIに、ワークフローを動かすよう頼みます。

ローカルのMCPが持つツール（公式の一覧）

server_info、run_workflow、job_status、wait_for_job、watch_job、fetch_outputs、launch_comfyui、stop_comfyui、search_templates、fetch_template、search_nodes、get_node、list_nodes、search_models、validate_workflow。それぞれが、--where local を付けた comfy-cli のコマンドに対応します。ノードとモデルの検索は、手元の環境（カスタムノードを含む）を読みます。

何が渡るか、出力、費用

外し方、うまくいかないとき

• 外し方は、このページには書かれていません（記載が見つからない）。
• ComfyUIが動いていないときの動作や、エラーの一覧は、このページには書かれていません。公式は、サーバーがComfyUIを暗黙に起動しないことだけを書いています。まず、comfy launch でComfyUIが動いているかを確かめるのが、公式の手順に沿った確認です。
• この記事の案：AIアプリに登録したあと、AIに server_info の結果を見せるよう頼むと、つながりが確かめやすいと思います（ツール名は公式の一覧にあるが、この頼み方は公式の手順ではありません）。

接続3：Comfy Skills（Claude Code用のプラグインと、スキル）

公式の「Comfy Skills for Coding Agents」のページと、リポジトリ（Comfy-Org/comfy-skills）のREADMEに沿った内容です。

• READMEは、古い comfy-cloud-mcp のcurlインストーラー向けの skills/ フォルダが廃止予定で、凍結されている、と書いています。
• READMEには、コマンドを足す人向けの書き方（claude-code/commands/ に、短いYAMLの description つきのMarkdownを置き、claude plugin validate ./claude-code を実行し、プルリクエストを出す）が書かれています。

接続4：Comfy CLI（コマンドでつなぐ）

公式の「Comfy CLI」のページに沿った内容です。

入れ方とサインイン

pip install comfy-cli

• Homebrewなら、公式のページは、brew tap Comfy-Org/comfy-cli のあと、brew install comfy-org/comfy-cli/comfy-cli と書いています。
• comfy setup：公式のページは「Install and set up」の見出しの下に載せ、このコマンド単体の説明は書いていません。-y を付けると、画面の問い合わせなしで動きます（CIなど）。全部のフラグは、公式の「getting started」のページにある、と書かれています（この記事では読んでいません）。
• comfy cloud login：ブラウザのOAuthでサインイン。comfy cloud whoami：サインインの状態を確かめる。
• APIキーで使う場合（画面のない場面）：--api-key のフラグか、環境変数 COMFY_API_KEY。クレジットが要ります。

主なコマンド（公式のページが挙げるもの）

comfy generate の例（公式の例の写し）

comfy generate flux-pro \
    --prompt "a cat on the moon, cinematic lighting" \
    --width 1024 --height 1024 \
    --download cat.png

comfy generate nano-banana \
    --prompt "add a top hat" \
    --image ./cat.png \
    --download edited.png

comfy generate kling \
    --prompt "a paper boat drifting on a river at dusk" \
    --duration 5 \
    --download boat.mp4

• ほかに、flux-kontext（--input_image）、ideogram-edit（--image と --mask）、seedance（--resolution 1080p）、luma（--aspect_ratio 16:9 --async）、dalle（--json を jq に渡す例）の例が公式のページにあります。全文は公式で確認してください。
• モデルの別名（公式の記載）：画像は flux-pro、flux-ultra、flux-kontext、nano-banana、grok、grok-edit、ideogram-edit、dalle、recraft、stability。動画は seedance、kling、luma、runway、pika、vidu、hailuo、moonvalley、grok-video。環境ごとの全部は comfy generate list。
• 動作：ローカルのファイルをアップロードし、ジョブを出し、終わるまで確認して、結果を保存します。動画のジョブは、既定では終わるまで待ちます。--async は、ジョブIDをすぐ返します。
• 出力：--download <path> でファイルに保存、--json で標準出力にJSON。

接続先（クラウドかローカルか）

• サインイン済みならクラウド、そうでなければローカル、と自動で決まります。
• 1回ごとの指定は --where local|cloud、環境変数は COMFY_WHERE、ずっと使う既定は comfy set-default --where cloud。

何が渡るか、ベータの表記、外し方

• ページには、「Quick reference for agents」の囲みや「Agent skills」の節があり、AIエージェントに読ませる想定の作りです。この記事の手順には使っていません。

組み合わせの早見表（この記事の案）

公式の資料にある連携を、使うAIアプリごとに並べ替えた表です。この記事で組んだもので、公式の表ではありません。

誤解されやすい点と、今日からできること

誤解されやすい点

• 「ローカルのMCPなら、タダで全部手元で完結する」とは限りません。パートナーのモデルは外の設備で動き、クレジットを使う、と公式が書いています。
• 「クラウドのMCPは、クレジットがあれば動く」とは限りません。有効なサブスクが要ります。
• 「/comfy と打てば出る」とは限りません。プラグインは /comfy-cloud:、直接の接続は /mcp__ の形です。

今日からできること

1. 使うAIアプリを決め、「組み合わせの早見表」で道を選ぶ。
2. APIキーを使うなら、環境変数に置き、設定ファイルには直接書かない。
3. クラウドに送る内容（依頼、ワークフロー、ファイル）を、送ってよいものか見直す。
4. 外し方の記載が公式のMCPのページにないことを知ったうえで、使うAIアプリの外し方（コネクタ、MCPの設定）を、あらかじめ確かめておく。

気をつけること

• この記事は、実際に使って確かめた記録ではありません。公式の資料を読んだ範囲です。
• コマンドと設定の例は、公式のページの要約から写しています。全文と最新の内容は、公式ページで確かめてから使ってください。
• 公式のページ同士で、成熟度の表記が揃っていません（クラウドのMCP）。
• MCPやプラグイン、CLIの「外し方」は、読んだ公式のページに記載が見つかりませんでした。
• 接続したAIは、そのAIアプリで許された範囲で、ComfyUIのツールを呼べます。何を許すか、どこまで自動にするかは、AIアプリ側（Claude Codeの許可の設定など）で決まります。
• 読んだページの先頭に、ドキュメントの目次を読むよう促す一文（AI向けのもの）があり、MCPのページには、AIに「コマンドを自分のシェルで実行するよう」読める文もありました。この記事の内容には関係がないため、従っていません。
• 版や機能は更新が速く、読んだ日の内容が古くなることがあります。
• 規約・プライバシーの解釈は、公式に確認してください。この記事は法律の助言ではありません。

出典

• Comfy MCP（ComfyUI Docs、Comfy Org、確認日 2026-10-25）
• Comfy CLI（ComfyUI Docs、確認日 2026-10-25）
• Comfy Skills for Coding Agents（ComfyUI Docs、確認日 2026-10-25）
• comfy-skills（GitHub Comfy-Org、確認日 2026-10-25）