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 user

Claude 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를 확인하도록 요청하세요. 대개 작업은 이미 생성되어 있습니다.