diff --git a/agent-tools/cloud.mdx b/agent-tools/cloud.mdx index 997c51598..70f4d9330 100644 --- a/agent-tools/cloud.mdx +++ b/agent-tools/cloud.mdx @@ -145,48 +145,44 @@ Pick your client: - Cursor connects to remote MCP servers over HTTP. Add Comfy Cloud in **Cursor Settings → Tools & MCP**, or edit your MCP config file directly. + 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. - - Create or edit `.cursor/mcp.json` in your project, or `~/.cursor/mcp.json` for a global setup: + + Click the **Settings** gear in the top-right corner (labeled **1**). + + ![Cursor — open Settings](/images/agent_tools/cursor_mcp_setup_step1.png) + + + 1. In the sidebar, click **Tools & MCPs** (labeled **2**). + 2. Click **+ New MCP Server** (labeled **3**) → **Add a Custom MCP Server**. + + ![Cursor — Tools & MCPs](/images/agent_tools/cursor_mcp_setup_step2.png) + + + Edit `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project). Set the server URL and pass your Comfy Cloud API key in the `X-API-Key` header. Create a key at [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) (starts with `comfyui-`): ```json { "mcpServers": { "comfy-cloud": { - "url": "https://cloud.comfy.org/mcp" + "url": "https://cloud.comfy.org/mcp", + "headers": { + "X-API-Key": "${env:COMFY_API_KEY}" + } } } } ``` - - - Open **Cursor Settings → Tools & MCP**. Select **comfy-cloud** and click **Connect** to sign in through your browser (OAuth). Tokens refresh automatically. + + 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) Ask in plain language ("generate an image of a cat astronaut", "find a Wan 2.2 video template"). Cursor invokes the MCP tools on your behalf. - - - When no browser is available, pass a Comfy Cloud API key in the `X-API-Key` header. Create one at [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) (starts with `comfyui-`): - - ```json - { - "mcpServers": { - "comfy-cloud": { - "url": "https://cloud.comfy.org/mcp", - "headers": { - "X-API-Key": "${env:COMFY_API_KEY}" - } - } - } - } - ``` - - Set `COMFY_API_KEY` in your shell or system environment. Do not commit the key to version control. - @@ -451,7 +447,7 @@ Comfy Cloud MCP is an early release. These limitations are known and being worke **Authentication** -- **OAuth or API key.** Claude Code and Claude Desktop use a one-time browser OAuth flow. 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. +- **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. ## FAQ @@ -460,7 +456,7 @@ Comfy Cloud MCP is an early release. These limitations are known and being worke 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**, and **Codex**. **Windsurf**, **Amp**, **OpenClaw**, and other agents follow the same URL with OAuth or an API key. See [Install Comfy Cloud MCP](#install-comfy-cloud-mcp). - Not for interactive clients that support OAuth (Claude Code, Claude Desktop, Cursor, Codex, and others). An API key is only needed for headless or CI setups with no browser. See the **Other clients** tab under [Install Comfy Cloud MCP](#install-comfy-cloud-mcp). + Not for interactive clients that support OAuth (Claude Code, Claude Desktop, Codex, 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 or **Other clients** tab under [Install Comfy Cloud MCP](#install-comfy-cloud-mcp). 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). diff --git a/images/agent_tools/cursor_mcp_setup_step1.png b/images/agent_tools/cursor_mcp_setup_step1.png new file mode 100644 index 000000000..56b895765 Binary files /dev/null and b/images/agent_tools/cursor_mcp_setup_step1.png differ diff --git a/images/agent_tools/cursor_mcp_setup_step2.png b/images/agent_tools/cursor_mcp_setup_step2.png new file mode 100644 index 000000000..6ff774572 Binary files /dev/null and b/images/agent_tools/cursor_mcp_setup_step2.png differ diff --git a/images/agent_tools/cursor_mcp_setup_step3.png b/images/agent_tools/cursor_mcp_setup_step3.png new file mode 100644 index 000000000..d2535f6b8 Binary files /dev/null and b/images/agent_tools/cursor_mcp_setup_step3.png differ diff --git a/ja/agent-tools/cloud.mdx b/ja/agent-tools/cloud.mdx index 90385c3df..e26bcb9f8 100644 --- a/ja/agent-tools/cloud.mdx +++ b/ja/agent-tools/cloud.mdx @@ -3,21 +3,22 @@ title: "Comfy Cloud MCP" sidebarTitle: "Cloud MCP" description: "Claude Code、Claude Desktop、Cursor、Codex、またはMCP互換エージェントからComfy Cloud MCPに接続: 画像・ビデオ・オーディオ・3Dの生成、モデルとノードの検索、ワークフローの実行。" icon: "cloud" -translationSourceHash: 2c8d585c +translationSourceHash: 01763e3c translationFrom: agent-tools/cloud.mdx translationBlockHashes: "_intro": b1c56a40 "Overview": 4b68a7b5 - "Install Comfy Cloud MCP": b6975c91 + "Install Comfy Cloud MCP": ca5e817e "What your agent can do": 2c2a22e6 "MCP tools": a9211dee "Credits and spending": 20e94ef0 "Outputs and downloads": a2c8c12f "Related resources": 58e75560 "Feedback": 6872768e - "Known limitations": 52477743 - "FAQ": 4e76854d + "Known limitations": 2f9e13ba + "FAQ": 920ab7b8 --- + import CloudFeature from '/snippets/ja/cloud-feature.mdx' @@ -160,48 +161,44 @@ https://cloud.comfy.org/mcp - CursorはリモートMCPサーバーにHTTPで接続します。**Cursor Settings → Tools & MCP**でComfy Cloudを追加するか、MCP設定ファイルを直接編集します。 + CursorはリモートMCPサーバーにHTTPで接続します。Cursorは現在MCP OAuthをサポートしていません。MCP設定にComfy Cloud APIキーを指定してComfy Cloudを追加します。 - - プロジェクト内に`.cursor/mcp.json`を作成または編集するか、グローバル設定として`~/.cursor/mcp.json`を作成します： + + 右上隅の**設定**歯車アイコン（ラベル**1**）をクリックします。 + + ![Cursor — 設定を開く](/images/agent_tools/cursor_mcp_setup_step1.png) + + + 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-`で始まります）： ```json { "mcpServers": { "comfy-cloud": { - "url": "https://cloud.comfy.org/mcp" + "url": "https://cloud.comfy.org/mcp", + "headers": { + "X-API-Key": "${env:COMFY_API_KEY}" + } } } } ``` - - - **Cursor Settings → Tools & MCP**を開きます。**comfy-cloud**を選択し、**Connect**をクリックしてブラウザからログインします（OAuth）。トークンは自動的に更新されます。 + + シェルまたはシステム環境に`COMFY_API_KEY`を設定します。キーをgitにコミットする可能性のあるファイルに直接記述するよりも、`${env:COMFY_API_KEY}`を推奨します。 + + ![Cursor — APIキーを含むmcp.json](/images/agent_tools/cursor_mcp_setup_step3.png) 平易な言葉で質問します（「猫の宇宙飛行士の画像を生成して」「Wan 2.2の動画テンプレートを探して」）。Cursorがあなたに代わってMCPツールを呼び出します。 - - - ブラウザが利用できない場合は、`X-API-Key`ヘッダーにComfy Cloud APIキーを渡します。[platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)でキーを作成します（`comfyui-`で始まります）： - - ```json - { - "mcpServers": { - "comfy-cloud": { - "url": "https://cloud.comfy.org/mcp", - "headers": { - "X-API-Key": "${env:COMFY_API_KEY}" - } - } - } - } - ``` - - シェルまたはシステム環境に`COMFY_API_KEY`を設定します。キーをバージョン管理にコミットしないでください。 - @@ -288,7 +285,7 @@ https://cloud.comfy.org/mcp } ``` - **Windsurf**は`url`の代わりに`serverUrl`を使用します。**Amp**は**Settings → MCP Servers**または`~/.config/amp/settings.json`で同じ`mcpServers`構造を使用します。 + **Windsurf**は`url`の代わりに`serverUrl`を使用します。**Amp**は**設定 → MCPサーバー**または`~/.config/amp/settings.json`で同じ`mcpServers`構造を使用します。 クライアントがMCP OAuthをサポートしている場合は、ブラウザからログインします。それ以外の場合は、APIキーヘッダーを追加します（下記参照）。 @@ -320,7 +317,6 @@ https://cloud.comfy.org/mcp ``` 設定ファイルにキーを直接記述するのではなく、`${env:COMFY_API_KEY}`またはクライアントのシークレット補間を使用することをお勧めします（gitにコミットする設定ファイルで）。 - @@ -468,7 +464,7 @@ Comfy Cloud MCP は初期リリースです。以下の制限事項は既知で **認証** -- **OAuth または API キー。** Claude Code および Claude Desktop は、1回限りのブラウザ OAuth フローを使用します。ヘッドレスクライアントは、代わりに `X-API-Key` ヘッダー経由で Comfy Cloud API キーを渡すことができます。ブラウザを開けないクライアント向けのデバイスコード OAuth フローが計画されています。 +- **OAuth または API キー。** Claude Code および Claude Desktop は、1回限りのブラウザ OAuth フローを使用します。**Cursor** は、MCP 設定で Comfy Cloud API キーを必要とします（OAuth なし）。その他のヘッドレスクライアントは、代わりに `X-API-Key` ヘッダー経由で Comfy Cloud API キーを渡すことができます。ブラウザを開けないクライアント向けのデバイスコード OAuth フローが計画されています。 ## FAQ @@ -477,7 +473,7 @@ Comfy Cloud MCP は初期リリースです。以下の制限事項は既知で MCP に対応し、リモート HTTP トランスポートをサポートしているクライアントはすべて `https://cloud.comfy.org/mcp` に接続できます。**Claude Code**、**Claude Desktop**、**Cursor**、**Codex** のセットアップ方法を文書化しています。**Windsurf**、**Amp**、**OpenClaw** などの他のエージェントも、同じ URL に OAuth または APIキーで接続します。詳細は [Comfy Cloud MCP のインストール](#install-comfy-cloud-mcp) を参照してください。 - OAuth に対応した対話型クライアント（Claude Code、Claude Desktop、Cursor、Codex など）では不要です。APIキーは、ブラウザがないヘッドレスまたは CI 環境でのみ必要です。詳細は [Comfy Cloud MCP のインストール](#install-comfy-cloud-mcp) の **その他のクライアント** タブを参照してください。 + OAuth に対応した対話型クライアント（Claude Code、Claude Desktop、Codex など）では不要です。**Cursor** では、MCP 設定に Comfy Cloud の APIキーが必要です。APIキーは、ブラウザのないヘッドレス環境や CI 環境でも必要です。詳細は [Comfy Cloud MCP のインストール](#install-comfy-cloud-mcp) の **Cursor** タブまたは **その他のクライアント** タブを参照してください。 有料の生成は支出ゲートの対象です：実行が Comfy Cloud のクレジットを消費する場合（パートナーモデル、または有料 API ノードを含むワークフロー/テンプレート）、サーバーは実行前に明示的な同意を必要とします。詳細は [クレジットと支出](#credits-and-spending) を参照してください。 @@ -488,8 +484,8 @@ Comfy Cloud MCP は初期リリースです。以下の制限事項は既知で `/comfy` や `/cloud` というコマンドはありません。コマンドは、接続方法に応じて2つのプレフィックスのいずれかに表示されます。 - - **プラグイン（推奨）：** `/comfy-cloud:generate-image`、`/comfy-cloud:generate-video` ... — すべて表示するには `/comfy-cloud:` と入力してください。 - - **直接接続（プラグインなし）：** `/mcp__comfy-cloud__generate-image` ... — 表示するには `/mcp__` と入力してください。 + - **プラグイン（推奨）：** `/comfy-cloud:generate-image`、`/comfy-cloud:generate-video` … — すべて表示するには `/comfy-cloud:` と入力してください。 + - **直接接続（プラグインなし）：** `/mcp__comfy-cloud__generate-image` … — 表示するには `/mcp__` と入力してください。 どちらの場合でも、プレーン言語で質問するだけでも構いません（「...の画像を生成して」など）。MCP ツールはモデルによって呼び出されるため、スラッシュコマンドは必要ありません。 diff --git a/ko/agent-tools/cloud.mdx b/ko/agent-tools/cloud.mdx index e00dd412e..e327860e1 100644 --- a/ko/agent-tools/cloud.mdx +++ b/ko/agent-tools/cloud.mdx @@ -3,21 +3,22 @@ title: "Comfy Cloud MCP" sidebarTitle: "Cloud MCP" description: "Claude Code, Claude Desktop, Cursor, Codex 또는 MCP 호환 에이전트에서 Comfy Cloud MCP에 연결하여 이미지, 비디오, 오디오 및 3D를 생성하고, 모델과 노드를 검색하며, 워크플로를 실행하세요." icon: "cloud" -translationSourceHash: 2c8d585c +translationSourceHash: 01763e3c translationFrom: agent-tools/cloud.mdx translationBlockHashes: "_intro": b1c56a40 "Overview": 4b68a7b5 - "Install Comfy Cloud MCP": b6975c91 + "Install Comfy Cloud MCP": ca5e817e "What your agent can do": 2c2a22e6 "MCP tools": a9211dee "Credits and spending": 20e94ef0 "Outputs and downloads": a2c8c12f "Related resources": 58e75560 "Feedback": 6872768e - "Known limitations": 52477743 - "FAQ": 4e76854d + "Known limitations": 2f9e13ba + "FAQ": 920ab7b8 --- + import CloudFeature from '/snippets/ko/cloud-feature.mdx' @@ -160,48 +161,44 @@ https://cloud.comfy.org/mcp - Cursor는 원격 MCP 서버에 HTTP로 연결됩니다. **Cursor Settings → Tools & MCP**에서 Comfy Cloud를 추가하거나 MCP 구성 파일을 직접 편집하세요. + Cursor는 원격 MCP 서버에 HTTP로 연결됩니다. Cursor는 현재 MCP OAuth를 지원하지 않습니다. MCP 구성에 Comfy Cloud API 키를 사용하여 Comfy Cloud를 추가하세요. - - 프로젝트에 `.cursor/mcp.json`을 생성하거나 편집하거나, 전역 설정을 위해 `~/.cursor/mcp.json`을 편집하세요: + + 오른쪽 상단의 **Settings** 기어(**1**로 표시)를 클릭하세요. + + ![Cursor — 설정 열기](/images/agent_tools/cursor_mcp_setup_step1.png) + + + 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-`로 시작): ```json { "mcpServers": { "comfy-cloud": { - "url": "https://cloud.comfy.org/mcp" + "url": "https://cloud.comfy.org/mcp", + "headers": { + "X-API-Key": "${env:COMFY_API_KEY}" + } } } } ``` - - - **Cursor Settings → Tools & MCP**를 엽니다. **comfy-cloud**를 선택하고 **Connect**를 클릭하여 브라우저를 통해 로그인합니다(OAuth). 토큰은 자동으로 새로 고쳐집니다. + + `COMFY_API_KEY`를 셸 또는 시스템 환경에 설정하세요. Git에 커밋할 수 있는 파일에 키를 하드코딩하는 대신 `${env:COMFY_API_KEY}`를 사용하는 것이 좋습니다. + + ![Cursor — API 키가 있는 mcp.json](/images/agent_tools/cursor_mcp_setup_step3.png) 일반 언어로 요청하세요("고양이 우주비행사 이미지 생성", "Wan 2.2 비디오 템플릿 찾기"). Cursor가 대신 MCP 도구를 호출합니다. - - - 브라우저를 사용할 수 없는 경우 `X-API-Key` 헤더에 Comfy Cloud API 키를 전달하세요. [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)에서 키를 생성하세요(`comfyui-`로 시작): - - ```json - { - "mcpServers": { - "comfy-cloud": { - "url": "https://cloud.comfy.org/mcp", - "headers": { - "X-API-Key": "${env:COMFY_API_KEY}" - } - } - } - } - ``` - - `COMFY_API_KEY`를 셸 또는 시스템 환경에 설정하세요. 키를 버전 관리에 커밋하지 마세요. - @@ -467,7 +464,7 @@ Comfy Cloud MCP는 초기 릴리스입니다. 다음 제한 사항이 알려져 **인증** -- **OAuth 또는 API 키.** Claude Code와 Claude Desktop은 일회성 브라우저 OAuth 흐름을 사용합니다. 헤드리스 클라이언트는 대신 `X-API-Key` 헤더를 통해 Comfy Cloud API 키를 전달할 수 있습니다. 브라우저를 열 수 없는 클라이언트를 위한 장치 코드 OAuth 흐름이 계획되어 있습니다. +- **OAuth 또는 API 키.** Claude Code와 Claude Desktop은 일회성 브라우저 OAuth 흐름을 사용합니다. **Cursor**는 MCP 구성에 Comfy Cloud API 키가 필요합니다(OAuth 없음). 다른 헤드리스 클라이언트는 대신 `X-API-Key` 헤더를 통해 Comfy Cloud API 키를 전달할 수 있습니다. 브라우저를 열 수 없는 클라이언트를 위한 장치 코드 OAuth 흐름이 계획되어 있습니다. ## 자주 묻는 질문 @@ -476,7 +473,7 @@ Comfy Cloud MCP는 초기 릴리스입니다. 다음 제한 사항이 알려져 원격 HTTP 전송을 지원하는 모든 MCP 호환 클라이언트는 `https://cloud.comfy.org/mcp`에 연결할 수 있습니다. **Claude Code**, **Claude Desktop**, **Cursor** 및 **Codex**에 대한 일급 설정을 문서화합니다. **Windsurf**, **Amp**, **OpenClaw** 및 기타 에이전트는 OAuth 또는 API 키를 사용하여 동일한 URL을 따릅니다. [Comfy Cloud MCP 설치](#install-comfy-cloud-mcp)를 참조하세요. - OAuth를 지원하는 대화형 클라이언트(Claude Code, Claude Desktop, Cursor, Codex 등)에는 필요하지 않습니다. API 키는 브라우저 없이 헤드리스 또는 CI 설정에서만 필요합니다. [Comfy Cloud MCP 설치](#install-comfy-cloud-mcp)의 **기타 클라이언트** 탭을 참조하세요. + OAuth를 지원하는 대화형 클라이언트(Claude Code, Claude Desktop, Codex 등)에는 필요하지 않습니다. **Cursor**의 경우 MCP 구성에 Comfy Cloud API 키가 필요합니다. API 키는 브라우저 없이 헤드리스 또는 CI 설정에서도 필요합니다. [Comfy Cloud MCP 설치](#install-comfy-cloud-mcp)의 **Cursor** 탭 또는 **기타 클라이언트** 탭을 참조하세요. 유료 생성에는 지출 게이트가 적용됩니다: 실행이 Comfy Cloud 크레딧을 소모하는 경우(파트너 모델 또는 유료 API 노드가 포함된 워크플로/템플릿), 서버는 실행 전에 사용자의 명시적 동의를 요구합니다. 자세한 내용은 [크레딧 및 지출](#credits-and-spending)을 참조하세요. @@ -487,8 +484,8 @@ Comfy Cloud MCP는 초기 릴리스입니다. 다음 제한 사항이 알려져 `/comfy` 또는 `/cloud` 명령은 없습니다. 명령은 연결 방식에 따라 두 가지 접두사 중 하나로 나타납니다: - - **플러그인 (권장):** `/comfy-cloud:generate-image`, `/comfy-cloud:generate-video`, … : 전체를 보려면 `/comfy-cloud:`를 입력하세요. - - **직접 연결 (플러그인 없음):** `/mcp__comfy-cloud__generate-image`, … : 보려면 `/mcp__`를 입력하세요. + - **플러그인 (권장):** `/comfy-cloud:generate-image`, `/comfy-cloud:generate-video`, … — 전체를 보려면 `/comfy-cloud:`를 입력하세요. + - **직접 연결 (플러그인 없음):** `/mcp__comfy-cloud__generate-image`, … — 보려면 `/mcp__`를 입력하세요. 어느 쪽이든 일반 언어로 요청할 수도 있습니다 ("...의 이미지 생성"). MCP 도구는 모델에 의해 호출되며 슬래시 명령이 필요하지 않습니다. diff --git a/zh/agent-tools/cloud.mdx b/zh/agent-tools/cloud.mdx index a7c9e9300..dc117fc6e 100644 --- a/zh/agent-tools/cloud.mdx +++ b/zh/agent-tools/cloud.mdx @@ -3,21 +3,22 @@ title: "Comfy Cloud MCP" sidebarTitle: "Cloud MCP" description: "从 Claude Code、Claude Desktop、Cursor、Codex 或任何兼容 MCP 的代理连接 Comfy Cloud MCP：生成图像、视频、音频和 3D，搜索模型与节点，并运行工作流。" icon: "cloud" -translationSourceHash: 2c8d585c +translationSourceHash: 01763e3c translationFrom: agent-tools/cloud.mdx translationBlockHashes: "_intro": b1c56a40 "Overview": 4b68a7b5 - "Install Comfy Cloud MCP": b6975c91 + "Install Comfy Cloud MCP": ca5e817e "What your agent can do": 2c2a22e6 "MCP tools": a9211dee "Credits and spending": 20e94ef0 "Outputs and downloads": a2c8c12f "Related resources": 58e75560 "Feedback": 6872768e - "Known limitations": 52477743 - "FAQ": 4e76854d + "Known limitations": 2f9e13ba + "FAQ": 920ab7b8 --- + import CloudFeature from '/snippets/zh/cloud-feature.mdx' @@ -160,48 +161,44 @@ https://cloud.comfy.org/mcp - Cursor 通过 HTTP 连接到远程 MCP 服务器。在 **Cursor Settings → Tools & MCP** 中添加 Comfy Cloud，或直接编辑你的 MCP 配置文件。 + Cursor 通过 HTTP 连接到远程 MCP 服务器。Cursor 目前**不**支持 MCP OAuth。在 MCP 配置中使用 Comfy Cloud API 密钥添加 Comfy Cloud。 - - 在项目中创建或编辑 `.cursor/mcp.json`，或使用 `~/.cursor/mcp.json` 进行全局设置： + + 点击右上角的设置齿轮（标记为 **1**）。 + + ![Cursor — 打开设置](/images/agent_tools/cursor_mcp_setup_step1.png) + + + 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-` 开头）： ```json { "mcpServers": { "comfy-cloud": { - "url": "https://cloud.comfy.org/mcp" + "url": "https://cloud.comfy.org/mcp", + "headers": { + "X-API-Key": "${env:COMFY_API_KEY}" + } } } } ``` - - - 打开 **Cursor Settings → Tools & MCP**。选择 **comfy-cloud** 并点击 **Connect** 通过浏览器登录（OAuth）。令牌会自动刷新。 + + 在你的 shell 或系统环境中设置 `COMFY_API_KEY`。推荐使用 `${env:COMFY_API_KEY}` 而不是在可能提交到 git 的文件中硬编码密钥。 + + ![Cursor — 带有 API 密钥的 mcp.json](/images/agent_tools/cursor_mcp_setup_step3.png) 用自然语言提问（"生成一张猫宇航员的图像"、"找一个 Wan 2.2 视频模板"）。Cursor 会代表你调用 MCP 工具。 - - - 当没有浏览器可用时，在 `X-API-Key` 标头中传递 Comfy Cloud API 密钥。在 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) 创建一个（以 `comfyui-` 开头）： - - ```json - { - "mcpServers": { - "comfy-cloud": { - "url": "https://cloud.comfy.org/mcp", - "headers": { - "X-API-Key": "${env:COMFY_API_KEY}" - } - } - } - } - ``` - - 在你的 shell 或系统环境中设置 `COMFY_API_KEY`。不要将密钥提交到版本控制。 - @@ -467,7 +464,7 @@ Comfy Cloud MCP 为早期版本。以下为已知的限制，团队正在努力 **身份验证** -- **OAuth 或 API 密钥。** Claude Code 和 Claude Desktop 使用一次性浏览器 OAuth 流程。无头客户端可以通过 `X-API-Key` 标头传递 Comfy Cloud API 密钥作为替代。计划为无法打开浏览器的客户端提供设备码 OAuth 流程。 +- **OAuth 或 API 密钥。** Claude Code 和 Claude Desktop 使用一次性浏览器 OAuth 流程。**Cursor** 需要你在 MCP 配置中提供 Comfy Cloud API 密钥（不支持 OAuth）。其他无头客户端可以通过 `X-API-Key` 标头传递 Comfy Cloud API 密钥作为替代。计划为无法打开浏览器的客户端提供设备码 OAuth 流程。 ## 常见问题 @@ -476,7 +473,7 @@ Comfy Cloud MCP 为早期版本。以下为已知的限制，团队正在努力 任何支持远程 HTTP 传输的 MCP 兼容客户端都可以连接到 `https://cloud.comfy.org/mcp`。我们为 **Claude Code**、**Claude Desktop**、**Cursor** 和 **Codex** 提供了最优先的配置说明。**Windsurf**、**Amp**、**OpenClaw** 和其他代理使用相同的 URL，通过 OAuth 或 API 密钥连接。参见[安装 Comfy Cloud MCP](#install-comfy-cloud-mcp)。 - 对于支持 OAuth 的交互式客户端（Claude Code、Claude Desktop、Cursor、Codex 等）不需要。仅在没有浏览器的无头或 CI 环境中才需要 API 密钥。请参见[安装 Comfy Cloud MCP](#install-comfy-cloud-mcp) 下的 **其他客户端** 标签。 + 对于支持 OAuth 的交互式客户端（Claude Code、Claude Desktop、Codex 等）不需要。**Cursor** 需要在你的 MCP 配置中提供 Comfy Cloud API 密钥。在没有浏览器的无头或 CI 环境中也需要 API 密钥。请参见[安装 Comfy Cloud MCP](#install-comfy-cloud-mcp) 下的 **Cursor** 标签或 **其他客户端** 标签。 付费生成受消费确认保护：当一次运行会消耗 Comfy Cloud 积分时（使用合作伙伴模型，或包含付费 API 节点的工作流/模板），服务器会要求你明确同意后才执行。请参阅[积分与消费](#credits-and-spending)。