-
Notifications
You must be signed in to change notification settings - Fork 186
docs: prioritize Claude Desktop setup and hide Partner MCP #1288
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -36,55 +36,6 @@ https://cloud.comfy.org/mcp | |
| Pick your client: | ||
|
|
||
| <Tabs> | ||
| <Tab title="Claude Code"> | ||
| Install the **comfy-cloud** plugin. It adds the MCP connection and slash commands in one step. The plugin is published through the [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) repository, which hosts Claude Code plugins and community agent skills for Comfy. | ||
|
|
||
| <Steps> | ||
| <Step title="Add the marketplace"> | ||
| Register the Comfy Skills marketplace (one-time): | ||
|
|
||
| ``` | ||
| /plugin marketplace add Comfy-Org/comfy-skills | ||
| ``` | ||
| </Step> | ||
| <Step title="Install the plugin"> | ||
| ``` | ||
| /plugin install comfy-cloud@comfy-skills | ||
| ``` | ||
| </Step> | ||
| <Step title="Sign in"> | ||
| Run `/mcp`, select **comfy-cloud** → **Authenticate**. Your browser opens to sign in, and tokens refresh automatically. | ||
| </Step> | ||
| </Steps> | ||
|
|
||
| The plugin adds these slash commands: | ||
|
|
||
| | Command | What it does | | ||
| | --- | --- | | ||
| | `/comfy-cloud:generate-image` | Generate, edit, or modify an image | | ||
| | `/comfy-cloud:generate-video` | Generate, edit, or extend a video | | ||
| | `/comfy-cloud:generate-audio` | Generate audio, music, or sound effects | | ||
| | `/comfy-cloud:generate-3d` | Generate a 3D model from text or an image | | ||
| | `/comfy-cloud:remove-background` | Remove the background from an image | | ||
| | `/comfy-cloud:upscale-image` | Upscale an image to higher resolution | | ||
| | `/comfy-cloud:search-templates` | Find pre-built workflow templates on [comfy.org](https://comfy.org) | | ||
| | `/comfy-cloud:search-models` | Search for available models | | ||
| | `/comfy-cloud:search-nodes` | Search for nodes and get wiring suggestions | | ||
| | `/comfy-cloud:help` | See what you can do with ComfyUI Cloud | | ||
|
|
||
| <Accordion title="Prefer just the connection, without the plugin?"> | ||
| Add the server directly: | ||
|
|
||
| ```bash | ||
| claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp | ||
| ``` | ||
|
|
||
| Then run `/mcp`, select **comfy-cloud** → **Authenticate**. Add `-s user` to make it available in all your projects. | ||
|
|
||
| This path still exposes the same workflows as MCP prompts: `/mcp__comfy-cloud__generate-image`, `/mcp__comfy-cloud__search-models`, and so on (the `/mcp__<name>__` prefix uses the name you passed to `claude mcp add`). The plugin above is recommended because it wraps these as the friendlier `/comfy-cloud:*` commands. | ||
| </Accordion> | ||
| </Tab> | ||
|
|
||
| <Tab title="Claude Desktop"> | ||
| Claude Desktop adds Comfy Cloud as a **custom connector** through its UI, then runs the OAuth sign-in. | ||
|
|
||
|
|
@@ -144,6 +95,55 @@ Pick your client: | |
| You can also skip prompts and ask in plain language. The MCP tools work the same way. | ||
| </Tab> | ||
|
|
||
| <Tab title="Claude Code"> | ||
| Install the **comfy-cloud** plugin. It adds the MCP connection and slash commands in one step. The plugin is published through the [Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) repository, which hosts Claude Code plugins and community agent skills for Comfy. | ||
|
|
||
| <Steps> | ||
| <Step title="Add the marketplace"> | ||
| Register the Comfy Skills marketplace (one-time): | ||
|
|
||
| ``` | ||
| /plugin marketplace add Comfy-Org/comfy-skills | ||
| ``` | ||
| </Step> | ||
| <Step title="Install the plugin"> | ||
| ``` | ||
| /plugin install comfy-cloud@comfy-skills | ||
| ``` | ||
|
Comment on lines
+105
to
+112
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value Add a language identifier to the code blocks across all locales. Here's a small little treat for your code so neat! 🧚♂️ You could add a
📍 Affects 4 files
🤖 Prompt for AI Agents |
||
| </Step> | ||
| <Step title="Sign in"> | ||
| Run `/mcp`, select **comfy-cloud** → **Authenticate**. Your browser opens to sign in, and tokens refresh automatically. | ||
| </Step> | ||
| </Steps> | ||
|
|
||
| The plugin adds these slash commands: | ||
|
|
||
| | Command | What it does | | ||
| | --- | --- | | ||
| | `/comfy-cloud:generate-image` | Generate, edit, or modify an image | | ||
| | `/comfy-cloud:generate-video` | Generate, edit, or extend a video | | ||
| | `/comfy-cloud:generate-audio` | Generate audio, music, or sound effects | | ||
| | `/comfy-cloud:generate-3d` | Generate a 3D model from text or an image | | ||
| | `/comfy-cloud:remove-background` | Remove the background from an image | | ||
| | `/comfy-cloud:upscale-image` | Upscale an image to higher resolution | | ||
| | `/comfy-cloud:search-templates` | Find pre-built workflow templates on [comfy.org](https://comfy.org) | | ||
| | `/comfy-cloud:search-models` | Search for available models | | ||
| | `/comfy-cloud:search-nodes` | Search for nodes and get wiring suggestions | | ||
| | `/comfy-cloud:help` | See what you can do with ComfyUI Cloud | | ||
|
|
||
| <Accordion title="Prefer just the connection, without the plugin?"> | ||
| Add the server directly: | ||
|
|
||
| ```bash | ||
| claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp | ||
| ``` | ||
|
|
||
| Then run `/mcp`, select **comfy-cloud** → **Authenticate**. Add `-s user` to make it available in all your projects. | ||
|
|
||
| This path still exposes the same workflows as MCP prompts: `/mcp__comfy-cloud__generate-image`, `/mcp__comfy-cloud__search-models`, and so on (the `/mcp__<name>__` prefix uses the name you passed to `claude mcp add`). The plugin above is recommended because it wraps these as the friendlier `/comfy-cloud:*` commands. | ||
| </Accordion> | ||
| </Tab> | ||
|
|
||
| <Tab title="Cursor"> | ||
| Cursor connects to remote MCP servers over HTTP. Cursor does **not** support MCP OAuth today. Add Comfy Cloud with a Comfy Cloud API key in your MCP config. | ||
|
|
||
|
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -3,16 +3,17 @@ title: "Agent Tools / MCP" | |
| description: "Model Context Protocol (MCP) を使用して AI エージェントを ComfyUI に接続し、画像、動画、オーディオ、3D コンテンツを生成します。" | ||
| sidebarTitle: "概要" | ||
| icon: "robot" | ||
| translationSourceHash: 0647990d | ||
| translationSourceHash: f467366b | ||
| translationFrom: agent-tools/index.mdx | ||
| translationBlockHashes: | ||
| "_intro": 57347fa8 | ||
| "Which One Should I Use?": fa16d052 | ||
| "_intro": 9db234db | ||
| "Which One Should I Use?": 7b3ab710 | ||
| "What about local ComfyUI?": 6e518082 | ||
| "What is MCP?": bb62fbe5 | ||
| --- | ||
|
|
||
|
|
||
|
|
||
| ComfyUI は **MCP サーバー** と **Comfy CLI** を提供しているので、AI エージェントや開発者は、常に ComfyUI キャンバスを開かなくても、画像、動画、オーディオ、3D コンテンツを生成できます。 | ||
|
|
||
| <Note> | ||
|
|
@@ -30,9 +31,6 @@ ComfyUI は **MCP サーバー** と **Comfy CLI** を提供しているので | |
| <Card title="Comfy In-App Agent" icon="comments" href="/ja/agent-tools/in-app-agent"> | ||
| Comfy Cloud 内のエージェント体験(チャットでグラフを構築・編集)。*プライベートアルファ。現在はウェイトリストのみ。* | ||
| </Card> | ||
| <Card title="Comfy Partner MCP" icon="plug" href="/ja/agent-tools/partner-mcp"> | ||
| Comfy Partner-Node SDK を使用したローカル MCP サーバー。30以上のパートナープロバイダーに対応する統一された <code>generate_image</code>、<code>generate_video</code>、<code>generate_3d</code> などのツールを提供します。 | ||
| </Card> | ||
| <Card title="Comfy Local MCP" icon="server" href="/ja/agent-tools/local"> | ||
| ファーストパーティのローカル MCP サーバーです。<code>comfy-cli</code> を使用して、<strong>お使いの</strong> ComfyUI インストールを操作します。<em>非公開テスト。まだ一般公開されていません。</em> | ||
| </Card> | ||
|
|
@@ -43,14 +41,14 @@ ComfyUI は **MCP サーバー** と **Comfy CLI** を提供しているので | |
|
|
||
| ## どちらを使うべき? | ||
|
|
||
| | | Comfy Cloud MCP | Comfy Partner MCP | Comfy Local MCP | Comfy CLI | | ||
| |---|---|---|---|---| | ||
| | **タイプ** | リモート(ホスト型) | ローカル MCP サーバー | ローカル MCP サーバー | ローカル CLI | | ||
| | **必要条件** | Comfy Cloud サブスクリプション | [Comfy APIキー](/ja/development/api-development/getting-an-api-key) | ローカル ComfyUI + [comfy-cli](https://github.com/Comfy-Org/comfy-cli) | [Comfy APIキー](/ja/development/api-development/getting-an-api-key) | | ||
| | **モデル** | Comfy Cloud モデル(プリインストール済み) | 30以上のパートナープロバイダー(BFL、Ideogram、Kling、Runway、Veo、ElevenLabs など) | あなたのローカルモデルとカスタムノード | `comfy generate` によるパートナーノード | | ||
| | **ワークフロー** | 完全な ComfyUI ワークフロー実行 | パートナーAPI生成(カスタムワークフローなし) | 完全なローカル ComfyUI ワークフロー実行 | 単発のパートナーAPI呼び出し(ワークフローJSON不要) | | ||
| | **GPU** | クラウド GPU(ローカル GPU 不要) | GPU不要(APIベース) | あなたのローカル GPU | GPU不要(APIベース) | | ||
| | **最適な用途** | チャット駆動のエージェント、テンプレート検索 | プロバイダー間の統一MCPツール | チャットから自分のローカル 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、バッチジョブ | | ||
|
Comment on lines
+44
to
+51
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value Align Markdown table columns for better readability. A table all squished is a sight that's quite sad, Both translated pages feature tables that render perfectly but are slightly misaligned in the raw Markdown source. Consider adding space padding to align the columns. This optional tweak makes the files easier to read and maintain for future editors.
📍 Affects 2 files
🤖 Prompt for AI Agents |
||
|
|
||
| --- | ||
|
|
||
|
|
||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value
Capitalize the first letter of each list description.
To make this list look perfectly neat, capitalizing the first word would be a sweet treat! 🧚♀️
✨ Proposed optional refactor
📝 Committable suggestion
🤖 Prompt for AI Agents