문서 메뉴

MCP 서버

MCP 서버를 쓰면 AI 어시스턴트가 내 Evocal 계정에서 일할 수 있어요. 동영상을 보내고, 더빙을 시작하고, 세그먼트를 확인하고 고치고, 파일을 내려받아요. API 키를 쓰고, 크레딧과 규칙은 앱과 같아요.

2026년 11월 20일 업데이트

시작하기 전에

  • MCP 서버는 API처럼 Pro, Studio, Enterprise 요금제에 포함돼요.
  • 앱의 계정, API에서 키를 만드세요. 어시스턴트에게는 전용 키를 주세요. 다른 것을 멈추지 않고 그 키만 폐기할 수 있어요.
  • 어시스턴트에서 헤더가 있는 원격 MCP 서버를 추가할 수 있어야 해요. 터미널에서 일하는 에이전트와 코드 편집기는 할 수 있어요. 로그인으로만 연결하는 채팅 앱은 아직 쓸 수 없어요.

연결하기

서버 주소는 https://www.evocal.app/api/mcp(Streamable HTTP)예요. 키는 Authorization 헤더로 받아요. 예를 들어 Claude Code에서는 이렇게 해요:

claude mcp add --transport http evocal https://www.evocal.app/api/mcp \
  --header "Authorization: Bearer evk_..."

서버를 JSON 파일에 두는 편집기에는 이런 항목을 넣어요. 파일 이름과 정확한 형식은 사용하는 편집기의 안내를 확인하세요.

{
  "mcpServers": {
    "evocal": {
      "url": "https://www.evocal.app/api/mcp",
      "headers": { "Authorization": "Bearer evk_..." }
    }
  }
}

그다음, 예를 들어 이렇게 부탁하세요: “lesson-4.mp4를 포르투갈어에서 영어로 더빙해 줘. 시작하기 전에 비용을 알려줘.”

어시스턴트가 할 수 있는 일

도구하는 일
get_account지금의 요금제와 크레딧.
list_languages지금 열려 있는 언어 쌍.
list_projects내 프로젝트, 최신순.
get_project프로젝트 하나와 그 파일의 상태, 더빙.
create_project대상 언어마다 더빙 하나가 있는 프로젝트를 만들어요.
start_upload파일 업로드를 열고 처음 파트들의 주소를 줘요.
get_upload_part_urls다른 파트들의 주소, 또는 실패한 파트의 새 주소.
complete_upload업로드를 끝내요. 그다음 파일을 확인해요.
start_dub더빙을 시작해요. 크레딧을 써요.
get_job작업의 상태와 진행률.
get_dub더빙 하나와, 그 더빙에서 마지막으로 실행된 작업.
get_segments더빙의 세그먼트: 시간, 텍스트, 알림. 알림이나 수정이 있는 것만 보여줄 수도 있어요.
edit_segment세그먼트의 새 텍스트를 저장해요.
quote_regeneration세그먼트 몇 개를 재생성하는 비용.
regenerate_segments저장된 텍스트로 세그먼트를 재생성해요. 크레딧을 써요.
finish_dub편집을 끝내고 다운로드를 열어요.
get_download_links더빙 파일로 가는 링크로, 5분 동안 유효해요.
get_subtitles자막을 텍스트로, SRT 또는 WebVTT로 줘요.
delete_project프로젝트를 파일, 더빙과 함께 삭제해요.

파일 보내기

어시스턴트는 내 컴퓨터의 파일을 읽어 여러 파트로 보내요. 그래서 터미널이나 파일 접근 권한을 갖고, 파일이 있는 곳에서 실행돼야 해요. 파일을 part_size 바이트씩 잘라 각 파트를 PUT으로 그 주소에 보내요.

내 파일에 닿지 못하는 어시스턴트도 앱에서 보낸 프로젝트로는 일할 수 있어요. 세그먼트를 읽고, 고치고, 재생성하고, 내려받을 수 있어요.

크레딧과 안전

  • 어시스턴트는 내 크레딧을 써요. 더빙은 동영상 1초에 1크레딧(최소 30), 재생성은 그 세그먼트의 초만큼(최소 15)이에요. 서버는 둘 다 하기 전에 비용을 알려주고 내 동의를 기다리라고 안내하지만, 내 키로 이루어진 모든 호출은 본인 책임이에요.
  • 더빙 완료와 프로젝트 삭제는 되돌릴 수 없어요. 어시스턴트는 먼저 나에게 물어보도록 안내받아요.
  • 모든 파일은 앱과 같은 규칙을 따라요. 내 목소리이거나, 말하는 사람이 서면으로 허락한 목소리만 보내세요. 키의 음성 확인이 각 파일에 적용돼요.
  • 그 호출은 API 한도에 포함돼요. 계정 전체로 분당 120번, 시간당 3,600번이에요.
  • 어시스턴트는 API가 보여주는 것만 봐요: 내 프로젝트, 더빙, 세그먼트, 크레딧. 키가 유출되면 계정, API에서 폐기하세요.

다음 읽을거리