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 서버는 크레딧을 구매했거나 구독한 계정에서 사용할 수 있습니다. 클라이언트는 VideoUpscaler 계정으로 로그인하거나 API 키로 연결합니다. 모든 계정은 로그인 후 get_account로 크레딧 잔액을 확인할 수 있습니다. 다른 도구는 유료 계정이 필요합니다.
클라이언트 연결
대부분의 클라이언트는 로그인으로 연결합니다. 서버 URL을 추가하면 브라우저 창이 열리고, VideoUpscaler에 로그인한 뒤 허용을 클릭하면 됩니다. 로그인할 수 없는 클라이언트는 API 키를 사용합니다. 설정 → API 키에서 키를 생성하고 VIDEOUPSCALER_API_KEY 같은 환경 변수에 보관하세요. 커밋하는 설정 파일에 키를 붙여 넣지 마세요.
claude.ai 또는 Claude 데스크톱 앱에서 Settings → Connectors를 열고 Add custom connector를 클릭한 뒤 https://videoupscaler.co/api/mcp를 입력합니다. Connect를 클릭하고 로그인한 다음 액세스를 허용하세요.
claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp --scope userClaude Code에서 /mcp를 실행하고 videoupscaler를 선택한 뒤 Authenticate를 선택하면 브라우저에서 로그인할 수 있습니다. --scope user를 사용하면 모든 프로젝트에서 이 서버를 사용할 수 있습니다.
API 키를 사용하려면 명령에 --header "Authorization: Bearer $VIDEOUPSCALER_API_KEY"를 추가하세요.
Cursor는 API 키로 연결합니다. ~/.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가 로그인을 요청합니다:
{
"servers": {
"videoupscaler": {
"type": "http",
"url": "https://videoupscaler.co/api/mcp"
}
}
}Streamable HTTP 원격 MCP 서버를 지원하는 클라이언트라면 모두 사용할 수 있습니다. URL https://videoupscaler.co/api/mcp를 입력하면 MCP 인증을 지원하는 클라이언트는 자동으로 로그인을 안내합니다. 그 밖의 클라이언트는 Authorization: Bearer <API 키> 헤더를 보내세요.
도구
| 도구 | 설명 |
|---|---|
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 헤더를 확인하고, 설정에 키가 아직 존재하는지 확인하세요. |
| 로그인 페이지에 권한 부여 링크가 유효하지 않다고 표시됨 | 링크는 10분 후 만료됩니다. 클라이언트에서 다시 연결하세요. |
도구가 paid_plan_required를 반환함 | 크레딧을 한 번도 구매하지 않은 계정입니다. 크레딧 팩을 하나라도 구매하세요. |
도구가 insufficient_credits를 반환함 | 요금제 페이지에서 잔액을 충전하세요. |
upscale_video가 타임아웃됨 | 용량이 큰 원격 동영상은 다운로드에 시간이 걸립니다. 어시스턴트에게 list_tasks를 확인하도록 요청하세요. 대개 작업은 이미 생성되어 있습니다. |