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

# MCP

> AI 앱에서 대화하면서 이미지와 영상을 만들어요.

MCP를 지원하는 AI 앱에 Zet Studio를 연결하면, 대화하면서 이미지와 영상을 만들 수 있어요. REST API와 같은 가격과 규칙을 쓰고, 금액은 같은 잔액에서 빠져요.

## 주소

주소마다 인증 방식이 하나예요. 다른 방식을 보내면 `401`로 거절해요.

| 쓰는 곳 | 주소 | 인증 |
| - | - | - |
| Claude, ChatGPT 같은 앱 | `https://mcp.studio.thezet.io/mcp` | 로그인 |
| 서버와 스크립트 | `https://api.studio.thezet.io/mcp` | [API 키](https://studio-docs.thezet.io/authentication.md) |

앱별 연결 방법은 [연결 안내 페이지](https://studio.thezet.io/mcp)에 있어요. 앱에서 로그인할 때는 **승인받은 계정**을 써 주세요.

## 작업 순서

1. `models_explore`로 모델과 옵션, 가격을 확인해요.
2. `generate_image`나 `generate_video`로 시작해요. 새 작업마다 새 `idempotency_key`를 넣어요.
3. `generation_wait`로 끝날 때까지 기다려요.
4. `outputs[].url`의 링크를 사용자에게 전달해요.

> [!WARNING]
>
> 작업이 오래 걸린다고 다시 시작하지 마세요. `generation_wait`가 `wait_slice_expired: true`로 답하면 같은 ID로 다시 기다려요.

## 도구

| 도구 | 하는 일 | 권한 |
| - | - | - |
| `models_explore` | 모델과 가격을 봐요. `model`을 주면 옵션과 전체 가격을 줘요. | 읽기 |
| `balance` | 잔액과 동시 실행 한도를 봐요. 연결 확인에도 써요. | 읽기 |
| `generation_status` | 작업 상태를 결과 없이 봐요. | 읽기 |
| `generation_wait` | 작업이 끝나길 기다려요. | 읽기 |
| `generation_result` | 작업과 결과 링크를 봐요. | 읽기 |
| `generations_list` | API와 MCP로 만든 작업을 최신순으로 봐요. | 읽기 |
| `usage` | 기간별 작업 수와 금액을 봐요. | 읽기 |
| `generate_image` | 이미지를 만들어요. | 지출 |
| `generate_video` | 영상을 만들어요. | 지출 |
| `generation_cancel` | 시작 전인 작업을 취소하고 금액을 돌려받아요. | 쓰기 |
| `media_upload` | 입력 이미지를 올릴 주소를 받아요. | 쓰기 |
| `media_confirm` | 올린 파일을 확인해요. 이후 입력으로 쓸 수 있어요. | 쓰기 |

MCP로는 작업이나 파일을 지울 수 없어요. 지우려면 [REST API](https://studio-docs.thezet.io/data.md)를 써 주세요.

## 만들기 전에 가격 확인

`generate_image`와 `generate_video`에는 세 가지가 있어요.

| 값 | 뜻 |
| - | - |
| `idempotency_key` | 필수예요. 같은 키로 다시 보내면 첫 작업을 돌려주고 다시 청구하지 않아요. 자세한 내용은 [중복 방지](https://studio-docs.thezet.io/idempotency.md)를 봐 주세요. |
| `dry_run` | `true`면 요청을 검사하고 가격만 알려줘요. 아무것도 시작하지 않고 키도 쓰지 않아요. |
| `max_spend_usd` | 작업 가격이 이 금액을 넘으면 시작하지 않아요. |

## 기다리기

`generation_wait`는 한 번에 작업 20개까지, 최대 55초 기다려요.

| 값 | 뜻 |
| - | - |
| `ids` | 작업 ID예요. 1\~20개를 넣어요. |
| `wait_for` | `all`(기본)은 모두 끝날 때까지, `any`는 하나라도 끝날 때까지 기다려요. |
| `timeout_seconds` | 이번에 기다릴 시간이에요. 1\~55초이고 기본은 50초예요. |
| `include_results` | `false`면 결과 없이 상태만 줘요. |

## 연결된 앱 관리

앱은 잔액으로 이미지와 영상을 만들 수 있어요. [설정의 연결된 앱](https://studio.thezet.io/settings/mcp-apps)에서 앱마다 정할 수 있어요.

* **읽기 전용:** 앱은 쓰기와 지출 도구를 쓸 수 없어요. 조회 도구만 남아요.
* **연결 해제:** 앱의 다음 요청부터 막아요. 앱이 다시 로그인해도 풀리지 않고, 같은 화면에서 **다시 허용**해야 풀려요.

바꾼 내용은 바로 적용돼요. 앱이 도구 목록을 저장해 두었다면 다시 연결해야 목록이 바뀌어 보여요.

## 오류

도구가 거절하면 [REST API와 같은 형식](https://studio-docs.thezet.io/errors.md)의 오류를 돌려줘요. MCP에서만 나오는 코드는 [오류 목록](https://studio-docs.thezet.io/errors.md#mcp)에 있어요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.