> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy Cloud MCP

> Claude Code와 Claude Desktop의 Comfy Cloud를 Comfy Cloud MCP 서버를 통해 사용하세요 — 이미지, 비디오, 오디오 및 3D 생성, 모델 및 노드 검색, 워크플로우 실행 가능

<Note>
  이 기능은 **컴피 클라우드**의 기능으로, 클라우드 버전에서만 사용할 수 있습니다. 컴피 클라우드에 대해 자세히 알아보려면 [컴피 클라우드](/ko/get_started/cloud)를 참조하세요.
</Note>

## 개요

<Note>
  Comfy Cloud MCP는 **클로즈드 베타입니다 — 초대 전용**입니다. 액세스는 사용자별 기능 플래그로 제어됩니다. 아직 액세스 권한이 없다면 [대기자 명단에 등록](https://form.typeform.com/to/hHmvw1UH)하세요.
</Note>

<CardGroup cols={1}>
  <Card title="🚀 대기자 명단에 가입하기" icon="rocket" href="https://form.typeform.com/to/hHmvw1UH">
    아직 액세스 권한이 없나요? Comfy Cloud MCP 베타 대기자 명단에 등록하세요.
  </Card>
</CardGroup>

**Comfy Cloud MCP 서버**는 [Model Context Protocol](https://modelcontextprotocol.io)을 통해 AI 에이전트를 [Comfy Cloud](https://cloud.comfy.org)에 연결합니다. 연결 후에는 이미지, 비디오, 오디오 및 3D 생성, 모델, 노드 및 템플릿 검색, ComfyUI 워크플로우 실행 등 모든 작업을 에이전트와의 채팅에서 수행할 수 있습니다.

현재 지원되는 클라이언트는 **Claude Code**와 **Claude Desktop**이며, 이들은 **OAuth**를 통해 로그인합니다 — 한 번만 브라우저에서 로그인하면 됩니다. 더 많은 클라이언트 지원은 곧 제공될 예정입니다.

## 설치

원하는 클라이언트를 선택하세요:

<CardGroup cols={2}>
  <Card title="Claude Code" icon="terminal" href="#claude-code">
    플러그인을 설치하세요 — 연결과 명령어가 한 번에 완료됩니다.
  </Card>

  <Card title="Claude Desktop" icon="desktop" href="#claude-desktop">
    앱에 맞춤형 커넥터를 추가한 다음 로그인하세요.
  </Card>
</CardGroup>

### <span style={{ marginRight: "0.6rem" }}><Icon icon="terminal" size={22} /></span> Claude Code

**comfy-cloud** 플러그인을 설치하세요 — MCP 연결과 슬래시 명령어가 한 번에 추가됩니다.

<Steps>
  <Step title="마켓플레이스 추가">
    ```
    /plugin marketplace add Comfy-Org/comfy-skills
    ```
  </Step>

  <Step title="플러그인 설치">
    ```
    /plugin install comfy-cloud@comfy-skills
    ```
  </Step>

  <Step title="로그인">
    `/mcp`를 실행하고, **comfy-cloud** → **인증**을 선택하세요. 브라우저가 열려 로그인하고, 토큰은 자동으로 갱신됩니다.
  </Step>
</Steps>

플러그인은 다음과 같은 슬래시 명령어를 추가합니다:

| 명령어                              | 무엇을 하는지          |
| -------------------------------- | ---------------- |
| `/comfy-cloud:generate-image`    | 이미지 생성, 편집 또는 수정 |
| `/comfy-cloud:generate-video`    | 비디오 생성, 편집 또는 확장 |
| `/comfy-cloud:generate-audio`    | 오디오 생성           |
| `/comfy-cloud:generate-3d`       | 3D 모델 생성         |
| `/comfy-cloud:remove-background` | 이미지의 배경 제거       |
| `/comfy-cloud:upscale-image`     | 이미지 고해상도화        |
| `/comfy-cloud:search-models`     | 사용 가능한 모델 검색     |
| `/comfy-cloud:search-nodes`      | 노드 검색            |
| `/comfy-cloud:search-templates`  | 사전 구축된 워크플로우 찾기  |
| `/comfy-cloud:help`              | 할 수 있는 작업 보기     |

<Accordion title="플러그인 없이 연결만 선호하시나요?">
  서버를 직접 추가하세요:

  ```bash theme={null}
  claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp
  ```

  그런 다음 `/mcp`를 실행하고, **comfy-cloud** → **인증**을 선택하세요. `-s user`를 추가하면 모든 프로젝트에서 사용 가능합니다.

  이 방법도 슬래시 명령어를 제공하지만, 원시 MCP 형식입니다 — `/mcp__comfy-cloud__generate-image`, `/mcp__comfy-cloud__search-models` 등 (`/mcp__<이름>__` 접두사는 `claude mcp add`에 전달한 이름을 사용합니다). 위의 플러그인은 이를 더 친숙한 `/comfy-cloud:*` 명령어로 감싸므로 권장됩니다.
</Accordion>

### <span style={{ marginRight: "0.6rem" }}><Icon icon="desktop" size={22} /></span> Claude Desktop

Claude Desktop은 UI를 통해 Comfy Cloud를 **맞춤형 커넥터**로 추가한 다음 OAuth 로그인을 실행합니다.

<Steps>
  <Step title="커넥터 열기">
    Claude Desktop에서 **맞춤 설정**을 열고, **커넥터**를 선택하세요.

    <img src="https://mintcdn.com/dripart/hggE7jk4IUe9Dgn5/images/cloud/mcp/desktop-connectors.png?fit=max&auto=format&n=hggE7jk4IUe9Dgn5&q=85&s=64d90eeac78724a81cee358e4a509a9b" alt="Claude Desktop 커넥터" width="566" height="232" data-path="images/cloud/mcp/desktop-connectors.png" />
  </Step>

  <Step title="맞춤형 커넥터 추가">
    **+** 버튼을 클릭한 다음, **맞춤형 커넥터 추가**를 선택하세요.

    <img src="https://mintcdn.com/dripart/VcJUoOhemC23a4kR/images/cloud/mcp/desktop-add-custom-connector.png?fit=max&auto=format&n=VcJUoOhemC23a4kR&q=85&s=ace4d0901bcbfcccf6e688c9f88ac369" alt="맞춤형 커넥터 추가" width="794" height="292" data-path="images/cloud/mcp/desktop-add-custom-connector.png" />
  </Step>

  <Step title="서버 URL 입력">
    이름을 아무거나 지정하고 (예: *Comfy Cloud*), **원격 MCP 서버 URL**을 다음과 같이 설정하세요:

    ```
    https://cloud.comfy.org/mcp
    ```

    <img src="https://mintcdn.com/dripart/hggE7jk4IUe9Dgn5/images/cloud/mcp/desktop-connector-url.png?fit=max&auto=format&n=hggE7jk4IUe9Dgn5&q=85&s=89ff669fd6d2ec94917a1ccfecdd2608" alt="커넥터 세부 정보" width="1138" height="898" data-path="images/cloud/mcp/desktop-connector-url.png" />
  </Step>

  <Step title="로그인">
    **추가**를 클릭한 다음, 알림이 뜨면 Claude Desktop을 통해 로그인하세요. 연결이 완료됩니다.

    <img src="https://mintcdn.com/dripart/hggE7jk4IUe9Dgn5/images/cloud/mcp/desktop-signin.png?fit=max&auto=format&n=hggE7jk4IUe9Dgn5&q=85&s=2a9dbc39cdac3aa4626b3dc911e74568" alt="Claude Desktop을 통한 로그인" width="430" height="561" data-path="images/cloud/mcp/desktop-signin.png" />
  </Step>
</Steps>

### 헤드리스 / CI (API 키)

Claude Code와 Claude Desktop은 OAuth를 사용하므로 API 키가 필요하지 않습니다. 브라우저가 없는 **헤드리스 또는 CI** 환경에서는 API 키를 사용해 인증하세요:

<Steps>
  <Step title="키 생성">
    [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys)로 이동해 **새 API 키**를 클릭하고 복사하세요 (앞에 `comfyui-`가 붙습니다).
  </Step>

  <Step title="키 헤더로 서버 추가">
    ```bash theme={null}
    claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp -H "X-API-Key: comfyui-…"
    ```
  </Step>
</Steps>

## FAQ

<AccordionGroup>
  <Accordion title="지원되는 클라이언트는 무엇인가요?">
    오늘은 Claude Code와 Claude Desktop이 지원되며, 모두 OAuth를 통해 로그인합니다. 더 많은 클라이언트 지원은 곧 제공될 예정입니다.
  </Accordion>

  <Accordion title="API 키가 필요한가요?">
    Claude Code와 Claude Desktop에서는 필요하지 않습니다 — OAuth를 사용합니다. API 키는 브라우저가 없는 헤드리스 또는 CI 환경에서만 필요합니다.
  </Accordion>

  <Accordion title="슬래시 명령어가 Claude Desktop에서도 작동하나요?">
    아닙니다. 슬래시 명령어는 Claude Code 플러그인에 포함되어 있습니다. Claude Desktop은 동일한 MCP 서버에 연결되지만 (그래서 도구는 작동합니다 — 그냥 평범한 언어로 요청하세요), Claude Code 플러그인이나 슬래시 명령어는 지원되지 않습니다.
  </Accordion>

  <Accordion title="/comfy 또는 /cloud를 입력했는데 아무것도 나타나지 않습니다.">
    `/comfy` 또는 `/cloud` 명령어는 없습니다. 명령어는 연결 방식에 따라 두 가지 접두사 중 하나로 나타납니다:

    * **플러그인 (권장):** `/comfy-cloud:generate-image`, `/comfy-cloud:generate-video`, … — 모두 보려면 `/comfy-cloud:`를 입력하세요.
    * **직접 연결 (플러그인 없음):** `/mcp__comfy-cloud__generate-image`, … — 보려면 `/mcp__`를 입력하세요.

    어느 쪽이든 평범한 언어로 요청할 수도 있습니다 ("이미지 생성 …") — MCP 도구는 모델에 의해 호출되므로 슬래시 명령어가 필요하지 않습니다.
  </Accordion>

  <Accordion title="로그인이 브라우저를 열지 않았어요.">
    Claude Code에서는 `/mcp`를 실행하고 **comfy-cloud**를 선택한 다음 **인증**을 선택하세요. Claude Desktop에서는 **맞춤 설정 → 커넥터**에서 커넥터를 다시 열고 로그인을 트리거하세요.
  </Accordion>
</AccordionGroup>