> ## 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 Partner MCP

> 30개 이상의 파트너 제공업체(BFL, Ideogram, Kling, Runway, Veo, Meshy, ElevenLabs 등)에 걸쳐 통합된 생성 도구를 제공하는 로컬 MCP 서버입니다.

<Warning>
  **비공개 테스트 중 — 아직 공개되지 않았습니다.** Comfy Partner MCP 서버는 현재 비공개 테스트 중입니다. 기능과 API는 변경될 수 있습니다. 액세스는 초대된 파트너로 제한됩니다.
</Warning>

Comfy Partner MCP는 BFL, Ideogram, Kling, Runway, Veo, Meshy, ElevenLabs 등 **30개 이상의 파트너 제공업체**에 걸쳐 AI 에이전트에게 통합된 생성 도구를 제공하는 로컬 MCP 서버입니다. 모든 생성 유형에 대해 단일 표준 요청 형식을 사용합니다.

**주요 특징:**

* 🎨 **6가지 생성 모달리티** — 이미지, 동영상, 3D, SVG, 오디오, 음악
* 🔌 **30개 이상의 제공업체** 한 인터페이스로 통합
* 💻 **로컬 서버** — 사용자의 컴퓨터에서 실행되며 Comfy API와 연결됩니다.
* 🔍 **내장된 모델 검색** 및 BM25 텍스트 검색 기능
* 🧩 Claude Desktop, Claude Code, Amp와 **즉시 호환 가능**

***

## 요구사항

* **Node.js 20+**
* **pnpm 10**
* **[Comfy API 키](/ko/development/api-development/getting-an-api-key)** (‘comfyui-’로 시작) — Comfy 파트너 대시보드에서 받으세요

***

## 설치

```bash theme={null}
git clone <repo-url> partner-mcp
cd partner-mcp
pnpm install
pnpm build
```

빌드 후, MCP 서버 런처는 `packages/mcp/dist/bin.js`에 있습니다.

***

## 구성

서버를 MCP 클라이언트 구성에 추가하세요. 같은 JSON 형식은 Claude Desktop, Claude Code, Amp에서도 동일하게 작동합니다:

```json theme={null}
{
  "mcpServers": {
    "comfy-partner": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/bin.js"],
      "env": {
        "COMFY_API_KEY": "comfyui-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}
```

**클라이언트 구성 위치:**

| 클라이언트          | 구성 파일                                                                                                                               |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) / `%APPDATA%/Claude/claude_desktop_config.json` (Windows) |
| Claude Code    | `~/.claude/mcp.json` (또는 `claude mcp add` 실행)                                                                                       |
| Amp            | 설정 → MCP 서버, 또는 `~/.config/amp/settings.json`                                                                                       |

구성 추가 후, MCP 클라이언트를 다시 시작하세요. 그러면 `comfy-partner` 서버 아래에 **10개의 도구**가 등록된 것을 확인할 수 있습니다.

서버를 클라이언트에 연결하기 전에 정상적으로 시작되는지 확인하려면 직접 실행해 보세요—JSON-RPC 핸드셰이크 메시지를 출력하고 이후 유휴 상태가 되어야 합니다:

```bash theme={null}
COMFY_API_KEY=comfyui-... node /ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/bin.js
```

***

## 환경 변수

| 변수                         | 필수  | 목적                                                                              |
| -------------------------- | --- | ------------------------------------------------------------------------------- |
| `COMFY_API_KEY`            | 예   | API 키 (`comfyui-…`). `X-API-Key` 헤더로 전송됩니다.                                     |
| `COMFY_API_BASE_URL`       | 아니요 | 프록시 호스트 재정의 (기본값은 프로덕션 Comfy API).                                              |
| `COMFY_INLINE_LIMIT_KB`    | 아니요 | 도구 결과에 이미지 바이트를 인라인으로 포함하는 최대 크기(KB). 기본값 `600`.                                |
| `COMFY_MCP_RESOURCE_LINKS` | 아니요 | `resource_link` 콘텐츠 블록 활성화/비활성화 강제. 기본값은 허용 목록(`claude-*`, `mcp-inspector`)입니다. |

***

## 사용 가능한 도구

MCP 서버는 **10개의 도구**를 노출합니다. 성공적으로 설치한 후, MCP 클라이언트는 `comfy-partner` 서버 아래에 등록된 10개의 도구 모두를 표시해야 합니다.

| 도구               | 설명                                                             |
| ---------------- | -------------------------------------------------------------- |
| `generate_image` | 정지 이미지 생성 — 텍스트-to-image, 편집 또는 업스케일링                          |
| `generate_video` | 동영상 클립 생성 — 텍스트-to-video, 이미지-to-video 또는 립싱크                  |
| `generate_3d`    | 텍스트 또는 참조 이미지로부터 3D 메쉬(GLB/FBX/OBJ) 생성                         |
| `generate_svg`   | 텍스트 프롬프트로부터 SVG 벡터 일러스트레이션 생성                                  |
| `generate_audio` | 텍스트로부터 음성, 보이스 클론 또는 효과음 생성                                    |
| `generate_music` | 프롬프트로부터 악기나 보컬 음악 생성                                           |
| `media_upload`   | 파일(이미지/동영상/오디오) 업로드 및 `media:<id>` 참조 획득 — `generate_*` 호출에 사용 |
| `read_media`     | 미디어 아트팩트를 가져와 인라인으로 렌더링 — HTTPS URL 또는 `media:…` 토큰 수락         |
| `models_explore` | 모델 탐색, 기능별 검색 및 모델의 전체 호출 형식 읽기                                |
| `balance`        | 현재 계정의 남은 USD 잔액 조회                                            |

***

## 예제 프롬프트

설치 후, 다음을 AI 어시스턴트에서 시도해 보세요:

```
우주를 떠다니는 고양이 우주비행사의 포토리얼리스틱 스타일 이미지 생성
```

```
바다 위 석양의 짧은 동영상 생성
```

```
현대적인 의자의 3D 모델 생성
```

```
30초 길이의 차분하고 로파이한 분위기의 음악 생성
```

***

## 관련

* [Comfy Cloud MCP](/ko/agent-tools/cloud) — Comfy Cloud 워크플로우 실행을 위한 호스팅 MCP 서버
* [Comfy Partner Nodes CLI](/ko/comfy-cli/reference#generate-partner-nodes) — 명령줄에서 파트너 노드 사용