# 숏츠생성기 MCP 개발자 안내

> 숏츠생성기 MCP는 무료 쇼츠 영상을 찾고 받기 링크와 제목·설명을 주는 읽기 전용 MCP 서버입니다. 주소 하나를 AI 앱이나 코드에 넣으면 되고 로그인이 없습니다.

쪽 주소: https://videocreate.kr/developers/ · 확인일 2026-11-14 · 운영: 엔터애즈(ENTERADS) · 문의 contact@enterads.kr

## 한눈에

주소:
```text
https://videocreate.kr/mcp
```

- 방식: MCP Streamable HTTP(POST 하나, 응답은 JSON). 세션 없이 바로 `tools/call` 해도 됩니다
- 로그인: 없음
- 도구: `list_artists`, `search_videos`, `get_video` — 셋 다 읽기 전용(`readOnlyHint: true`)
- 공식 MCP Registry: `kr.videocreate/free-shorts`
- 비용: 없음

## 앱에 붙이기

### Claude (웹·데스크톱 앱)

1. **Customize > Connectors**(커넥터)에서 **Add** → **Add custom connector**를 누릅니다.
2. 이름에 `숏츠생성기`, 주소에 `https://videocreate.kr/mcp`를 넣고 **Continue**를 누릅니다.
3. Authentication은 **No sign-in**(로그인 없음)을 고르고 **Add**를 누릅니다.
4. 채팅창의 **+ > Connectors**에서 숏츠생성기를 켭니다.

무료 요금제는 사용자 지정 커넥터를 1개까지 추가할 수 있습니다. Team·Enterprise는 조직 Owner가 추가합니다.

### Claude Code

```bash
claude mcp add --transport http videocreate https://videocreate.kr/mcp
```

`/mcp`로 연결을 확인합니다.

### ChatGPT (웹)

1. **chatgpt.com/plugins**에서 **+** → **Add custom MCP server**를 누릅니다.
2. Name에 `숏츠생성기`, Server URL에 `https://videocreate.kr/mcp`를 넣습니다.
3. Authentication은 **No authentication**을 고릅니다.
4. **I understand and want to continue** → **Create as a plugin**을 누르고 설치합니다.
5. 대화창에 `@`를 입력하고 숏츠생성기를 고릅니다.

요금제나 워크스페이스 설정에 따라 이 메뉴가 보이지 않을 수 있습니다. 그럴 때는 [무료 스킬 파일](https://videocreate.kr/assets/downloads/videocreate-free-shorts.zip)을 쓰거나 [영상 목록](https://videocreate.kr/creator/)에서 받으세요.

### Cursor

- [Cursor에 추가](cursor://anysphere.cursor-deeplink/mcp/install?name=videocreate&config=eyJ1cmwiOiJodHRwczovL3ZpZGVvY3JlYXRlLmtyL21jcCJ9)
- [웹 링크로 추가](https://cursor.com/en/install-mcp?name=videocreate&config=eyJ1cmwiOiJodHRwczovL3ZpZGVvY3JlYXRlLmtyL21jcCJ9)

직접 넣기 — `~/.cursor/mcp.json`(모든 프로젝트) 또는 `.cursor/mcp.json`(이 프로젝트만):

```json
{
  "mcpServers": {
    "videocreate": { "url": "https://videocreate.kr/mcp" }
  }
}
```

### VS Code (GitHub Copilot 에이전트 모드)

- [VS Code에 추가](https://insiders.vscode.dev/redirect/mcp/install?name=videocreate&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fvideocreate.kr%2Fmcp%22%7D)
- [앱 링크로 추가](vscode:mcp/install?%7B%22name%22%3A%22videocreate%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fvideocreate.kr%2Fmcp%22%7D)

명령줄:

```bash
code --add-mcp '{"name":"videocreate","type":"http","url":"https://videocreate.kr/mcp"}'
```

또는 `.vscode/mcp.json`:

```json
{
  "servers": {
    "videocreate": { "type": "http", "url": "https://videocreate.kr/mcp" }
  }
}
```

### Windsurf

`~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "videocreate": { "serverUrl": "https://videocreate.kr/mcp" }
  }
}
```

### Gemini CLI

```bash
gemini mcp add --transport http -s user videocreate https://videocreate.kr/mcp
```

실행한 뒤 `gemini`를 열고 `/mcp`로 연결을 확인합니다.

### Claude 데스크톱 설정 파일 — 커넥터 메뉴를 쓸 수 없을 때

커넥터(Customize > Connectors)로 넣는 것이 기본입니다. 설정 파일만 쓸 수 있는 환경이면 `claude_desktop_config.json`에 다리(mcp-remote)를 둡니다(Node.js 필요):

```json
{
  "mcpServers": {
    "videocreate": { "command": "npx", "args": ["-y", "mcp-remote", "https://videocreate.kr/mcp"] }
  }
}
```

메뉴 이름은 각 서비스의 2026년 11월 13일 안내를 기준으로 했습니다. 화면이 바뀌면 다를 수 있습니다.

## AI 앱에서 쓰기

### 연결 확인

연결한 뒤 이렇게 물어봅니다. 아티스트 이름과 편수가 나오면 연결된 것입니다.

- "숏츠생성기에 지금 어떤 아티스트 영상이 있어?"

### 이렇게 말해 보세요

- "숏츠생성기에서 아이칠린 쇼츠 3개 찾아서 제목·길이·받기 링크를 표로 줘"
- "하트오브우먼 영상 중에 20초 안쪽인 것만 골라 줘"
- "이 영상 제목과 설명을 한 글자도 바꾸지 말고 코드 블록으로 줘"
- "올리기 전에 확인할 것도 같이 알려 줘(유료 프로모션 표시 포함)"
- "다음 쪽 더 보여 줘"

### 잘 안 될 때

| 이럴 때 | 이렇게 |
|---|---|
| 커넥터·플러그인 메뉴가 안 보인다 | 요금제·워크스페이스 설정 때문일 수 있습니다. [무료 스킬 파일](https://videocreate.kr/assets/downloads/videocreate-free-shorts.zip)을 쓰거나 [영상 목록](https://videocreate.kr/creator/)에서 바로 받습니다. |
| AI가 "0편"이라고 한다 | 아티스트 이름이 목록과 다를 수 있습니다. "숏츠생성기 아티스트 목록 보여 줘"로 이름을 확인하고 다시 말합니다. |
| AI가 숏츠생성기를 모른다고 한다 | 대화에서 연결이 꺼져 있습니다. Claude는 채팅창 **+ > Connectors**에서 숏츠생성기를 켜고, ChatGPT는 대화창에 `@`를 입력해 숏츠생성기를 고릅니다. |
| AI가 설명을 고쳐서 준다 | "설명은 그대로, 자료 제공 줄과 EAV 줄은 지우지 마"라고 말합니다. |
| 받기 링크가 잠깐 안 열린다 | 한꺼번에 많이 받으면 잠시 막힙니다. 몇 분 뒤 다시 엽니다. |

### 노코드 자동화 (n8n)

- 노드: MCP Client Tool
- Endpoint: `https://videocreate.kr/mcp`
- Server Transport: HTTP Streamable
- Authentication: None

AI Agent 노드의 도구로 붙입니다. 숏츠생성기 MCP는 찾기와 받기 정보까지입니다. 올리기는 채널이 직접 하고, 설명의 자료 제공 줄과 영상 코드 줄은 그대로 둡니다.

## 코드에서 부르기

### curl (어느 언어든)

```bash
curl -s https://videocreate.kr/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -H 'mcp-protocol-version: 2025-06-18' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_videos","arguments":{"artist":"하트오브우먼"}}}'
```

- `mcp-protocol-version: 2025-06-18`을 붙이면 결과에 `structuredContent`(JSON 객체)가 함께 옵니다. 빼면 글(`content[0].text`)로만 옵니다.
- Windows PowerShell·Git Bash에서는 한글이 든 본문을 파일로 보냅니다: `--data-binary @body.json`.

### Python (공식 MCP SDK)

```bash
pip install mcp
```

```python
import asyncio

from mcp import Client


async def main():
    async with Client("https://videocreate.kr/mcp") as client:
        found = await client.call_tool("search_videos", {"artist": "하트오브우먼"})
        first = found.structured_content["items"][0]["video_id"]
        video = await client.call_tool("get_video", {"video_id": first})
        print(video.structured_content["download_url"])


asyncio.run(main())
```

### TypeScript (공식 MCP SDK)

```bash
npm i @modelcontextprotocol/sdk
```

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-app", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(new URL("https://videocreate.kr/mcp")));
const found = await client.callTool({ name: "search_videos", arguments: { query: "아이칠린" } });
console.log(found.structuredContent);
await client.close();
```

### Claude API (MCP 커넥터)

**베타 기능**입니다. 서버 정의(`mcp_servers`)와 도구 묶음(`mcp_toolset`) 두 쪽이 다 있어야 합니다. 거절(refusal)에 대비해 서버 쪽 대체 모델도 켜 둡니다.

```python
import anthropic

client = anthropic.Anthropic()
response = client.beta.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    betas=["mcp-client-2025-11-20", "server-side-fallback-2026-07-01"],
    fallbacks="default",
    mcp_servers=[{"type": "url", "url": "https://videocreate.kr/mcp", "name": "videocreate"}],
    tools=[{"type": "mcp_toolset", "mcp_server_name": "videocreate"}],
    messages=[{"role": "user", "content": "하트오브우먼 쇼츠 하나 골라서 제목과 받기 링크를 알려 줘"}],
)
if response.stop_reason == "refusal":
    print("거절됨:", response.stop_details)
else:
    print("".join(block.text for block in response.content if block.type == "text"))
```

### OpenAI Responses API (원격 MCP 도구)

```python
from openai import OpenAI

client = OpenAI()
resp = client.responses.create(
    model="<사용하는 모델>",
    tools=[{"type": "mcp", "server_label": "videocreate", "server_url": "https://videocreate.kr/mcp", "require_approval": "never"}],
    input="하트오브우먼 쇼츠 하나 골라서 제목과 받기 링크를 알려 줘",
)
print(resp.output_text)
```

`model`에는 사용하는 모델 이름을 넣습니다.

## 도구

| 도구 | 입력 | 돌려주는 것 |
|---|---|---|
| `list_artists` | 없음 | `total_videos`, `artists[{name, count, aliases}]`, `browse_url` |
| `search_videos` | `artist`(아티스트 이름. 영어 이름 같은 별칭도 됨), `query`(제목·아티스트·태그 검색어), `page`(1부터), `limit`(한 쪽에 1~50편, 기본 12편) — 모두 선택, 그 밖의 입력은 오류 | `total`, `page`, `pages`, `page_size`, `items[{video_id, title, artist, duration_s, thumbnail_url, video_page_url}]`, `next_page` |
| `get_video` | `video_id`(필수) | `title`, `description`(자료 제공 줄·영상 코드 줄 포함, 그대로 붙여 넣기), `code`(EAV-…), `credit`, `download_url`(바로 받는 mp4), `thumbnail_url`, `duration_s`, `video_page_url`, `usage_notes` |

- 영상: 세로 1080×1920 mp4. `download_url`은 로그인 없이 바로 받습니다(HEAD 200 `video/mp4`).
- `search_videos`의 `artist`는 띄어쓰기나 대소문자가 달라도, 이름의 일부여도, 영어 이름 같은 별칭(`list_artists`의 `aliases`)이어도 한 아티스트로 정해지면 그 아티스트로 찾고 답의 `artist`에 실제 이름을 돌려줍니다. 정해지지 않으면 그 말을 검색어로 찾고 답의 `notice`에 그 사실을 적습니다.
- 과도한 내려받기를 막으려고 1시간 단위로 내려받기 수를 셉니다. 한꺼번에 많이 받으면 잠시 막힐 수 있습니다([사이트 이용안내](https://videocreate.kr/terms/)).

## 지킬 것

- 설명은 고치거나 줄이지 말고 그대로 씁니다(자료 제공 줄과 `EAV-` 영상 코드 줄 유지).
- 올리기는 채널이 직접 합니다.
- 유료 프로모션 표시가 필요한지는 채널이 판단합니다([유료 프로모션 표시 안내](https://videocreate.kr/guides/youtube-paid-promotion/)).

## 자주 묻는 것

### 새 영상을 만들어 주나요?

아니요. 이미 편집을 마친 완성본을 찾아 받기 정보를 줍니다.

### 유튜브에 올려 주나요?

아니요. 올리는 것은 채널이 직접 합니다.

### 키나 가입이 필요한가요?

아니요. 키도 로그인도 필요 없습니다.