AI 에이전트로 영상 클립 만들기: Claude Code, Codex, Cursor

에이전트를 연결하는 법

1. 1. 토큰 만들기

   웹 앱이나 iPhone 앱에서 FastClip에 로그인하세요. “Settings”(설정)를 열고 “Connect an agent”(에이전트 연결)를 고르세요. “Agents”(에이전트) 페이지에서 토큰 이름을 정하고(예: Claude Code) 만드세요. 바로 복사해 두세요. FastClip은 토큰을 한 번만 보여 줘요.

2. 2. 에이전트 연결하기

   다음 섹션에서 사용하는 에이전트의 명령을 실행하세요. YOUR_TOKEN 자리에 내 토큰을 넣으세요. Cursor는 명령 대신 설정 파일에 해당 줄을 추가하세요.

3. 3. 클립 요청하기

   에이전트에게 링크나 라이브러리에 있는 영상 이름을 알려 주고 원하는 내용을 말하세요. 에이전트가 영상을 가져오고, 스크립트를 검색하고, 일치하는 부분 앞뒤를 읽어 이야기가 시작하고 끝나는 지점을 찾은 다음 클립을 만들어요.

4. 4. 클립 받기

   완성된 클립은 직접 만든 클립처럼 FastClip 계정에 있어요. 열어서 제목과 게시글 문구를 고치거나 거기서 MP4를 다운로드하세요. 에이전트도 다운로드 링크를 받아 전해 줘요.

에이전트 연결하기

서버 주소: https://api.fastclip.it/mcp. 에이전트가 요청마다 토큰을 함께 보내요. YOUR_TOKEN 자리에 내 토큰을 넣으세요.

claude mcp add --transport http --scope user fastclip https://api.fastclip.it/mcp --header "Authorization: Bearer YOUR_TOKEN"

export FASTCLIP_TOKEN="YOUR_TOKEN"
codex mcp add fastclip --url https://api.fastclip.it/mcp --bearer-token-env-var FASTCLIP_TOKEN

{
  "mcpServers": {
    "fastclip": {
      "url": "https://api.fastclip.it/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Claude Code와 Codex는 서버를 자체 설정에 저장해요. 에이전트 사용을 멈추면 FastClip에서 토큰을 해지하세요.

에이전트가 할 수 있는 일

서버는 에이전트에게 도구 7개를 줘요. 모든 시간은 초 단위예요.

import_video

링크로 영상을 추가해요. YouTube, 영상이 있는 X 게시물, Twitch VOD나 클립, 링크가 있는 모든 사용자에게 공유된 Google Drive 영상을 쓸 수 있어요. 같은 링크로 다시 요청하면 진행 상황을 보여 줘요. 같은 영상을 두 번 가져오는 일은 없어요.

list_videos

계정의 영상을 최신순으로, 가져오기 상태와 함께 보여 줘요. 링크 없이 영상 이름만 말했을 때 에이전트가 써요.

get_transcript

영상에서 하는 말을 읽거나 특정 단어를 검색해요. 에이전트는 한 시점부터 다른 시점까지 읽으며 이야기가 시작하고 끝나는 지점을 찾아요.

get_moments

FastClip이 이미 아는, 살펴볼 만한 위치를 알려 줘요. 업로더가 정한 챕터, YouTube “Most replayed” 그래프에서 많이 다시 본 지점, 내 북마크, 스크립트에서 고른 구간, 소리가 큰 구간이에요. 찾아볼 위치일 뿐이에요. 클립의 성과를 예측하는 것은 아니에요.

create_clip

고른 범위를 잘라 MP4로 렌더링해요. 에이전트가 시작과 끝, 형식(원본 또는 세로 9:16), 자막 켜기 또는 끄기, 선택 사항인 제목을 정해요.

get_clip

클립이 아직 렌더링 중인지 완성됐는지 보여 줘요. 완성된 클립에는 다운로드 링크와 FastClip에서 여는 링크가 있어요.

list_clips

계정의 클립을 보여 줘요. 에이전트는 클립을 다시 만들기 전에 그 범위가 이미 클립으로 만들어졌는지 확인할 수 있어요.

클립은 이렇게 나와요

• 원본 또는 세로. 원본은 영상의 화면을 그대로 유지해요. 세로는 Shorts, Reels, TikTok용 9:16, 1080 × 1920픽셀이에요. 세로에서는 FastClip이 얼굴을 찾으면 화면이 얼굴을 따라가고, 찾지 못하면 가운데에 머물러요.
• 자막. 단어 단위 자막을 “Settings”에서 정한 스타일로 영상에 입혀요. 에이전트가 끌 수도 있어요.
• 1초부터 5분까지. 에이전트가 시작과 끝을 정해요.
• FastClip 워터마크 없음. MP4에도, 무료 플랜에서도 없어요.
• 완성된 클립은 내 계정에. 제목과 게시글 문구를 고치고 MP4를 다운로드하는 일은 FastClip에서 해요.

에이전트가 할 수 없는 일과 한도

구간은 내가 골라요

FastClip은 클립 여러 개를 알아서 자르지 않고 점수도 매기지 않아요. 에이전트는 요청한 클립만 만들어요.

게시와 설정

토큰으로는 게시할 수 없고, 설정을 바꾸거나 무엇이든 삭제할 수도 없어요. MCP 서버에서만 쓸 수 있어요.

검색

키워드 검색이에요. 의미로 찾는 검색이 아니에요. 입력한 단어를 화자가 실제로 말한 구간을 찾아요. 단어마다 오타 1개까지 허용하고, 단어끼리 가까이 있어야 해요(약 45초 이내). 에이전트에게는 화자가 실제로 한 말을 알려 주세요.

스크립트

에이전트는 FastClip이 영상에 대해 가진 스크립트를 읽어요. YouTube 영상은 FastClip이 자막을 가져와요. 스크립트가 없으면 에이전트는 챕터, 북마크, “Most replayed” 지점이나 사용자가 알려 준 시간을 써요.

파일

에이전트는 파일을 업로드할 수 없어요. 앱에서 업로드하면 에이전트가 라이브러리에서 볼 수 있어요.

클립 길이

1초부터 5분까지.

요청

토큰당 분당 120회.

새 영상과 클립

계정당 10분에 새 영상 6개와 클립 20개. 에이전트는 기다릴 시간이 담긴 명확한 오류를 받아요.

플랜

에이전트가 만드는 클립과 가져오기도 내가 직접 한 것처럼 플랜에 포함돼요. 클립 하나는 초안 클립 1개와 완성 클립 1개를 써요. 무료 플랜은 완성 클립 100개와 YouTube 또는 업로드 가져오기 총 50회, 하루 최대 완성 클립 30개예요.

토큰

계정당 최대 10개. “Settings”의 “Agents”에서 해지하면 바로 작동을 멈춰요.

시작용 프롬프트 두 개

에이전트가 없거나, 아직 쓰지 않나요?

에이전트 없이 YouTube 링크로 시작하나요? YouTube 클립 만들기를 쓰세요. AI 클립 생성기 페이지에서 FastClip 안의 AI가 하는 일과 하지 않는 일을 확인하세요. 훅과 클립 길이에 관한 가이드는 요청할 범위를 고르는 데 도움이 돼요.

자주 묻는 질문