숏츠생성기 MCP 개발자 안내

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

확인일 · AI 앱 사용자용 가이드 · 글로 된 전체 내용

한눈에

주소
https://videocreate.kr/mcp
방식MCP Streamable HTTP(POST 하나, 응답은 JSON). 세션 없이 바로 tools/call 해도 됩니다
로그인없음
도구list_artists, search_videos, get_video — 셋 다 읽기 전용(readOnlyHint: true)
공식 MCP Registrykr.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

터미널
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. 대화창에 @를 입력하고 숏츠생성기를 고릅니다.

요금제나 워크스페이스 설정에 따라 이 메뉴가 보이지 않을 수 있습니다. 그럴 때는 무료 스킬 파일을 쓰거나 영상 목록에서 받으세요.

Cursor

Cursor에 추가웹 링크로 추가

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

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

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

VS Code에 추가앱 링크로 추가

명령줄:

터미널
code --add-mcp '{"name":"videocreate","type":"http","url":"https://videocreate.kr/mcp"}'

또는 .vscode/mcp.json:

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

Windsurf

~/.codeium/windsurf/mcp_config.json:

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

Gemini CLI

터미널
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 필요):

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

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

AI 앱에서 쓰기

연결 확인

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

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

이렇게 말해 보세요

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

잘 안 될 때

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

노코드 자동화 (n8n)

노드MCP Client Tool
Endpointhttps://videocreate.kr/mcp
Server TransportHTTP Streamable
AuthenticationNone

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

코드에서 부르기

curl (어느 언어든)

터미널
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)

터미널
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)

터미널
npm i @modelcontextprotocol/sdk
TypeScript
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_videosartist(아티스트 이름. 영어 이름 같은 별칭도 됨), 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_videovideo_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시간 단위로 내려받기 수를 셉니다. 한꺼번에 많이 받으면 잠시 막힐 수 있습니다(사이트 이용안내).

지킬 것

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

자주 묻는 것

새 영상을 만들어 주나요?

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

유튜브에 올려 주나요?

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

키나 가입이 필요한가요?

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