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