Claude Code·Cursor·Codex·Hermes 같은 에이전트에게 영상 제작을 직접 위임할 수 있습니다.
Claude Code·Cursor·Codex·Hermes 같은 에이전트가 DemoCut으로 영상 제작을 직접 위임할 수 있습니다. democut CLI 로 한 번 로그인하면 내 워크스페이스 스코프 토큰이 저장되고, 이후 에이전트의 DemoCut 호출에 자동으로 인증이 붙습니다.
쓰시는 에이전트만 고르면 되는 짧은 안내는 설치 페이지에 있습니다. 이 챕터는 그 뒤의 배경 — 왜 그렇게 등록하는지와 실패했을 때 볼 것 — 을 다룹니다.
아래 단계를 직접 하지 않아도 됩니다. 쓰고 계신 에이전트에게 이 문장을 붙여넣으면 설치·등록·확인까지 알아서 합니다 — 사람이 할 일은 에이전트가 보여주는 주소에서 로그인을 승인하는 것 하나입니다(계정 승인은 대신 시킬 수 없습니다).
DemoCut 을 도구로 붙여줘. 1) `npx -y democut@latest auth login` 을 **백그라운드로** 실행하고, 출력에 뜨는 URL 과 코드를 나한테 보여줘. 네 셸에는 화면이 없어서 브라우저가 자동으로 안 열려 — 내가 그 주소에서 승인하면 그 명령이 스스로 끝나. 2) 로그인이 끝나면 네 MCP 설정에 stdio 서버로 등록해줘 — 실행 명령은 `claude mcp add democut -- npx -y democut@latest mcp` 야. 3) 등록되면 `democut_auth_status` 를 불러서 워크스페이스가 맞는지 확인해줘. 워크스페이스가 내가 기대한 것과 다르면 알려줘.
직접 하시겠다면 아래 단계를 따르세요. 브라우저가 없는 서버라면 아래 CLI 방식이어야 합니다 — 맨 아래 “주소로 연결” 방식은 브라우저가 열려야 로그인이 시작됩니다.
따로 설치할 것이 없습니다 — npx 가 실행할 때 받아옵니다. 브라우저가 열리고 워크스페이스를 선택해 승인하면 완료. 서버·에이전트 호스트(헤드리스)에서는 코드와 URL 을 출력해 사람이 승인합니다.
$ npx -y democut@latest auth loginMCP 서버로 등록하면 에이전트가 도구로 직접 영상을 만듭니다. 비용을 먼저 계산해 알려주고, 확인한 금액을 그대로 실어 보내야만 생성이 진행됩니다.
$ claude mcp add democut -- npx -y democut@latest mcp이 명령은 지금 있는 폴더에서만 유효합니다. 모든 프로젝트에서 쓰려면 democut 앞에 -s user 를 붙이세요.
npx -y democut@latest video generate 명령을 사용하세요. 매번 받아오는 것이 싫다면 npm install -g democut 로 한 번 설치해 두고 위 명령에서 npx -y democut@latest 를 democut 으로 바꿔도 됩니다 — 선택 사항이고, 로그인 정보는 어느 쪽이든 그대로 쓰입니다. 다만 그때는 새 버전이 나와도 자동으로 따라가지 않으니, 도구가 이상하게 굴면 다시 설치해 최신으로 맞추세요.에이전트가 연결에 실패했다고만 말하고 이유를 알려주지 않는다면, 대개 로그인이 풀린 경우입니다. 먼저 상태를 확인하세요.
$ npx -y democut@latest auth status로그아웃 상태로 나오면 1단계를 다시 실행하면 됩니다.
이 명령은 되는데 에이전트만 실패한다면, 예전 안내대로 democut mcp 로 등록해 둔 설정일 수 있습니다. 그 방식은 프로그램이 미리 설치돼 있어야 동작하므로, 설치가 없거나 다른 곳으로 옮겨졌다면 연결만 조용히 실패합니다 — 위 2단계 명령으로 다시 등록하면 해결됩니다(같은 이름으로 다시 등록하거나, 기존 등록을 지운 뒤 추가하세요).
이 명령 자체가 실행되지 않으면 사내망·오프라인 등으로 패키지를 받지 못하는 환경입니다 — 이때는 아래 주소 방식으로 붙이세요.
명령 하나로 끝내고 싶거나 사내망 등으로 패키지를 받을 수 없다면, 주소만으로 붙일 수 있습니다. 연결할 때 브라우저가 열려 로그인·동의를 거치므로 위 1단계도 필요 없고, 권한은 워크스페이스 소속과 등급을 그대로 따릅니다. 토큰이 설정 파일에 남지 않는 것도 위 방식과 같습니다 — 저장되는 것은 아래 두 공개값뿐입니다.
어느 쪽을 쓸까. 지금 보고 계신 것처럼 사람이 앉아 있는 컴퓨터라면 이 주소 방식이 편합니다 — 브라우저가 바로 열리고, 설치본이 낡아 생기는 문제가 아예 없습니다. 반대로 사람이 없는 서버·자동화 호스트라면 위의 CLI 방식을 쓰셔야 합니다 — 취향 문제가 아닙니다. 이 주소 방식은 연결할 때 브라우저가 열려야 로그인이 시작되는데, 화면이 없는 곳에서는 그 과정 자체가 돌지 않습니다. CLI 는 화면에 코드를 찍어 주고 사람이다른 기기에서 승인하는 방식이라 그런 곳에서도 됩니다.
$ claude mcp add --transport http --client-id 7ovjLP6E85qLNAyq --callback-port 33418 democut https://democut.ai/mcp두 옵션은 생략할 수 없습니다. --client-id 는 이 서버가 아무 클라이언트나 받지 않기 때문이고, --callback-port 는 로그인 후 돌아올 주소가 미리 등록돼 있어야 하기 때문입니다. 값을 바꾸면 연결이 거부됩니다.
원격에서는 완성된 영상을 링크로 받습니다 — 서버가 여러분 컴퓨터에 파일을 대신 저장할 수 없습니다. 링크는 24시간 뒤 만료되니 받는 즉시 저장하세요. 파일로 바로 받으려면 위의 CLI 방식을 쓰시면 됩니다.
설정이 끝나면 에이전트에게 “DemoCut 으로 영상 만들어줘” 라고 말하면 됩니다. 에이전트가 자동으로 워크스페이스 토큰을 사용해 인증되고, 시나리오 작성부터 렌더·발행까지 전체 파이프라인을 위임할 수 있습니다.
워크스페이스의 팀 멤버 전체가 다양한 에이전트를 자유롭게 붙여서 쓸 수 있으며, 모두 같은 프로젝트·플랜 범위에서 작업합니다. 더 자세한 내용은 워크스페이스·설정 챕터를 참고하세요.