MCP 서버: 동영상 업스케일
VideoUpscaler MCP 서버를 Claude Code, Cursor, VS Code에 연결하면 AI 어시스턴트에게 요청하는 것만으로 동영상을 1080p, 2K, 4K로 업스케일할 수 있습니다.
VideoUpscaler는 Model Context Protocol 기반의 동영상 업스케일용 원격 MCP 서버를 운영합니다. AI 어시스턴트에 연결한 뒤 "이 동영상을 4K로 업스케일해 줘"처럼 요청하면, 어시스턴트가 이 문서에서 설명하는 것과 동일한 API를 호출하고 크레딧을 사용합니다.
서버 URL: https://videoupscaler.co/api/mcp (Streamable HTTP)
유료 계정 전용
API와 마찬가지로 MCP 서버는 크레딧을 구매했거나 구독한 계정에서 사용할 수 있습니다. API 키가 필요합니다.
클라이언트 연결
설정 → API 키에서 API 키를 생성하고 VIDEOUPSCALER_API_KEY 같은 환경 변수에 보관하세요. 커밋하는 설정 파일에 키를 붙여 넣지 마세요.
claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp \
--header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
--scope user--scope user를 사용하면 모든 프로젝트에서 서버를 사용할 수 있고, 키가 프로젝트의 .mcp.json에 들어가지 않습니다. Claude Code에서 /mcp를 실행해 연결을 확인하세요.
~/.cursor/mcp.json(모든 프로젝트) 또는 .cursor/mcp.json(프로젝트 하나)에 추가합니다.
{
"mcpServers": {
"videoupscaler": {
"url": "https://videoupscaler.co/api/mcp",
"headers": {
"Authorization": "Bearer ${env:VIDEOUPSCALER_API_KEY}"
}
}
}
}.vscode/mcp.json에 추가합니다. VS Code는 처음 한 번 키를 묻고 안전하게 저장합니다.
{
"inputs": [
{
"type": "promptString",
"id": "videoupscaler-key",
"description": "VideoUpscaler API key",
"password": true
}
],
"servers": {
"videoupscaler": {
"type": "http",
"url": "https://videoupscaler.co/api/mcp",
"headers": {
"Authorization": "Bearer ${input:videoupscaler-key}"
}
}
}
}Streamable HTTP를 통한 원격 MCP 서버를 지원하는 클라이언트라면 모두 사용할 수 있습니다. 다음과 같이 설정하세요.
- URL:
https://videoupscaler.co/api/mcp - 헤더:
Authorization: Bearer <your API key>
OAuth 로그인(Claude 데스크톱 및 claude.ai 커넥터용)은 곧 지원될 예정입니다.
도구
| 도구 | 설명 |
|---|---|
upscale_video | 공개된 video_url을 1080p, 2k 또는 4k로 업스케일하기 시작하고 크레딧을 차감합니다. idempotency_key가 필요합니다. |
get_task | 작업 하나를 반환합니다. wait_seconds(최대 45)를 지정하면 작업이 끝날 때까지 먼저 기다립니다. |
list_tasks | 웹사이트에서 시작한 작업을 포함해 최근 작업 목록을 조회합니다. |
get_account | 크레딧 잔액과 해상도별 초당 가격을 반환합니다. |
create_upload | 공개 URL이 없는 로컬 파일(최대 100MB)을 업로드할 수 있는 서명된 URL을 반환합니다. |
각 도구는 해당 API 엔드포인트와 똑같이 동작합니다. 업스케일 생성, 작업, 크레딧 및 요금, 파일 업로드를 참고하세요. MCP로 시작한 작업도 동일한 크레딧이 차감됩니다.
모든 upscale_video 호출에는 idempotency_key가 필요합니다. 호출이 타임아웃되면 어시스턴트는 list_tasks를 확인하고 같은 키로 재시도해야 하며, 이렇게 하면 동영상이 절대 두 번 차감되지 않습니다.
예시 프롬프트
- "VideoUpscaler 크레딧이 얼마나 남았어?"
- "https://example.com/clip.mp4 를 4K로 업스케일하고 완료되면 링크를 줘."
- "
./intro.mp4를 2K로 업스케일해 줘." (명령을 실행할 수 있는 클라이언트는 먼저create_upload로 파일을 업로드합니다)
문제 해결
| 문제 | 해결 방법 |
|---|---|
클라이언트에 401이 표시되거나 로그인을 요청함 | API 키가 없거나 잘못되었습니다. Authorization 헤더를 확인하고, 설정에 키가 아직 존재하는지 확인하세요. |
도구가 paid_plan_required를 반환함 | 크레딧을 한 번도 구매하지 않은 계정입니다. 크레딧 팩을 하나라도 구매하세요. |
도구가 insufficient_credits를 반환함 | 요금제 페이지에서 잔액을 충전하세요. |
upscale_video가 타임아웃됨 | 용량이 큰 원격 동영상은 다운로드에 시간이 걸립니다. 어시스턴트에게 list_tasks를 확인하도록 요청하세요. 대개 작업은 이미 생성되어 있습니다. |