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

에이전트에 FastClip 추가하기

연결하는 방법은 두 가지예요. Claude Code, Codex, Cursor, VS Code는 토큰을 사용해요. FastClip에 로그인해 Settings를 열고 Agents로 가서 토큰을 만드세요. FastClip은 토큰을 한 번만 보여 줘요. 그다음 아래에서 에이전트에 서버를 추가하세요. 서버 주소는 https://api.fastclip.it/mcp이고, 에이전트가 요청마다 토큰을 함께 보내요.

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"
      }
    }
  }
}

code --add-mcp '{"name":"fastclip","type":"http","url":"https://api.fastclip.it/mcp","headers":{"Authorization":"Bearer ${input:fastclip-token}"},"inputs":[{"type":"promptString","id":"fastclip-token","description":"FastClip token","password":true}]}'

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

에이전트를 연결하는 법

1. 1. 토큰 만들기 (또는 건너뛰기)

   Claude Code, Codex, Cursor, VS Code는 토큰을 사용해요. 웹 앱이나 iPhone 앱에서 FastClip에 로그인하세요. “Settings”(설정)를 열고 “Connect an agent”(에이전트 연결)를 고르세요. “Agents”(에이전트) 페이지에서 토큰 이름을 정하고(예: Claude Code) 만드세요. 바로 복사해 두세요. FastClip은 토큰을 한 번만 보여 줘요. 주소로 커스텀 MCP 서버를 추가하는 앱은 토큰이 필요 없어요. 다음 단계로 넘어가세요.

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

   위 섹션에서 사용하는 에이전트의 설치 링크나 명령을 쓰세요. YOUR_TOKEN 자리에 내 토큰을 넣으세요. 커스텀 커넥터를 지원하는 앱이라면 https://api.fastclip.it/mcp을 추가하고, 앱이 요청할 때 FastClip에 로그인하세요.

3. 3. 클립 요청하기

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

4. 4. 클립 받기

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

에이전트가 할 수 있는 일

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

import_video

링크로 영상을 추가해요. YouTube, 영상이 있는 X 게시물, 링크가 있는 모든 사용자에게 공유된 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개, 연결한 앱 최대 50개. “Settings”의 “Agents”에서 토큰을 해지하거나 앱 연결을 해제하면 바로 작동을 멈춰요. 50개를 넘는 새 연결이 생기면 가장 오래 쓰지 않은 앱의 연결이 해제돼요.

시작용 프롬프트 두 개

레시피: 하나의 작업을 처음부터 끝까지

레시피마다 붙여넣을 프롬프트, 에이전트가 차례로 호출하는 도구, 그리고 한계가 있어요.

• Claude로 YouTube 영상 클립 만들기인용구를 말하면 Claude가 스크립트에서 찾아 잘라요.
• Claude로 YouTube Shorts 만들기시청자가 가장 많이 다시 본 부분에서 시작해 세로 Shorts로 잘라요.
• Claude Code 영상 편집Claude Code가 스크립트를 읽고 내 라이브러리에서 클립을 잘라요.
• YouTube 스크립트 MCP에이전트가 스크립트 전체를 읽고, 의미로 구간을 찾아 잘라요.
• AI 에이전트로 팟캐스트 클립 만들기에피소드의 챕터 하나를 검색해 세로 클립으로 잘라요.
• AI 에이전트로 챕터 클립 만들기챕터 이름으로 요청하면 클립으로 받아요.
• 타임스탬프를 클립으로댓글이나 메모의 타임스탬프를 붙여넣으면 클립이 하나씩 나와요.
• 북마크로 클립 만들기영상을 보며 북마크하고, 클립은 나중에 에이전트가 잘라 줘요.
• Twitch VOD를 클립으로Twitch VOD를 가져와서 소리가 큰 구간을 확인하고 세로 클립을 잘라요.

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

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

자주 묻는 질문