MCP 참조로 이동

MCP 문서

AI 도우미에서 전사문을 활용하세요.

클라이언트 연결도구 살펴보기
이 페이지의 내용

Taption MCP

Taption을 MCP 호환 클라이언트에 연결하여 대화 중에 오디오와 비디오를 전사·번역하고, 완료된 전사문과 번역, 최근 작업을 확인하세요.

Model Context Protocol(MCP)을 통해 도우미가 Taption 도구를 호출합니다. 이 사용자 지정 연결은 전사문 읽기와 새 전사·번역 작업 생성을 지원합니다.

Streamable HTTPOAuth 2.1

서버 URL

https://api.taption.com/mcp-custom

Taption을 원격 MCP 서버로 추가할 때 전체 URL을 사용하세요.

전송 방식
Streamable HTTP
인증 방식
OAuth 2.1

사용 조건

  • Taption 계정. 유료 구독은 필요하지 않습니다. 이메일과 비밀번호로 로그인한다면 연결 전에 이메일을 인증하세요.
  • 전사 및 번역 작업 생성에는 사용 가능한 시간이 필요합니다. 계정 요금제와 사용량 제한이 적용됩니다.
  • 원격 Streamable HTTP와 OAuth 로그인을 지원하는 클라이언트. 클라이언트 요금제나 워크스페이스 정책에 따라 접근이 제한될 수 있습니다.

지원 미디어 소스

오디오·비디오 직접 URL, 공개 Google Drive 파일, YouTube 동영상을 사용할 수 있습니다. 사용자 지정 엔드포인트는 Facebook, Instagram, TikTok, X, Threads, Vimeo, Dailymotion, Bilibili(bilibili.tv) 공개 게시물과 Twitch 동영상·클립도 지원합니다.

ChatGPT 파일 연동이 제공되면 업로드한 오디오·비디오를 사용할 수 있습니다. 다른 클라이언트는 다운로드 가능한 미디어 URL을 사용하세요.

Taption이 링크에 접근할 수 있어야 합니다. 실시간 방송은 지원하지 않으므로 종료된 녹화본을 사용하세요.

클라이언트 설정

앱을 선택하여 단계별 설정 안내를 확인하세요.

인증

Taption은 OAuth 2.1과 PKCE를 사용합니다. 로그인하여 연결을 승인하면 클라이언트가 인증을 처리하고 유효 기간이 1시간인 액세스 토큰을 자동 갱신합니다.

MCP는 OAuth 액세스 토큰을 사용합니다. Taption REST API 키로는 인증할 수 없습니다.

설정 전 과정에서 /mcp-custom URL을 사용하세요. /mcp용 토큰은 /mcp-custom에서 사용할 수 없습니다.

접근을 취소하려면 Taption의 계정 → 연결된 앱에서 클라이언트 연결을 해제하세요. 다시 사용하려면 연결하고 승인하세요.

연결 권한

transcripts:read
전사 상태와 내용을 읽고 최근 전사문을 나열합니다.
transcripts:write
계정의 시간을 사용하여 전사 및 번역 작업을 생성합니다.

지원 워크플로

미디어와 원하는 출력을 알려주면 도우미가 Taption 도구로 다음 단계를 수행합니다.

  1. 미디어와 출력 선택

    링크 또는 지원 업로드, 음성 언어, 용도(일반 전사문·화자 표시·자막)를 제공하세요. 누락된 항목은 시작 전에 도우미가 질문합니다.

  2. 전사 및 진행 확인

    transcribe가 즉시 ID를 반환합니다. get_transcript는 곧 끝나는 작업을 잠시 기다립니다. 아직 처리 중이면 약 1분 후 다시 요청하세요. Taption에서 이메일 알림을 켜 두면 완료 시 이메일도 받습니다.

  3. 읽기, 요약, 내보내기

    도우미에서 완료된 전사문을 읽거나 요약을 요청하세요. 제공되는 SRT 다운로드 및 편집기 링크를 사용하세요. Taption 편집기는 다른 내보내기 형식도 제공합니다.

도우미에게 요청해 보세요

이 영어 녹화본을 두 명의 화자 표시와 함께 전사해 주세요: [your media URL].
이 일본어 동영상에 자막을 만들어 주세요: [your media URL]. 한 줄에 16자로 설정해 주세요.
이 영어 인터뷰를 자막으로 전사한 뒤 일본어와 스페인어로 번역해 주세요: [your media URL].
제 “Weekly sync” 전사문을 중국어 번체로 번역해 주세요.
최근 Taption 전사문을 찾아 완료된 인터뷰를 요약해 주세요. 자막 다운로드와 편집기 링크가 있으면 포함해 주세요.

[your media URL]을 실제 링크로 바꾸세요. 요약은 도우미가 전사문을 바탕으로 생성하며 자막 길이 설정은 Taption 요금제에 따라 달라집니다.

transcribe

작업 생성transcripts:write

백그라운드 전사 작업을 시작합니다. media_url 또는 file을 제공하세요. 음성 언어와 용도는 사용자가 지정해야 하며 누락되면 작업 대신 질문을 반환합니다. translate_to를 추가하면 전사가 끝난 뒤 자동으로 번역합니다.

매개변수

media_urlstring미디어 소스 하나

지원 미디어 링크, 최대 2,048자. file과 둘 중 하나를 제공하세요.

fileobject미디어 소스 하나

download_url과 file_id가 있는 업로드 정보. mime_type과 file_name은 선택 사항입니다. Taption이 URL에서 다운로드할 수 있어야 합니다.

languagestring시작 전 필요

음성 언어 태그(예: en-US, zh-TW, ja-JP, es-ES). 파일명이나 대화 언어로 추측하지 말고 사용자에게 물어보세요.

지원 언어 태그 보기
purposestring시작 전 필요

transcript: 문장 부호가 있는 텍스트, speakers: 화자 표시, captions: 짧은 자막. 단순히 전사 요청만 한 경우 용도가 지정되지 않습니다.

transcriptspeakerscaptions
speaker_countinteger

speakers의 예상 화자 수: 2–10. 미지정 시 2.

max_charactersinteger

해당 유료 요금제의 captions에 한 줄당 1–200자. 기본값은 zh/ja/ko/yue 16자, 나머지 65자.

translate_tostring[]

선택. 전사가 끝난 뒤 번역할 1–5개 언어(예: en, ja, zh-TW). 언어마다 전사와 별도로 미디어 길이만큼 시간이 차감됩니다.

extensionstring

업로드 형식을 추론할 수 없을 때 확장자를 지정합니다. 링크에는 불필요합니다. 오디오와 지원 비디오 형식을 사용하며 3gp는 지원하지 않습니다.

namestring

전사문 이름, 최대 200자. 생략하면 원본 파일명을 사용합니다.

도구 인수 예시

{
  "media_url": "https://example.com/interview.mp4",
  "language": "en-US",
  "purpose": "speakers",
  "speaker_count": 2,
  "translate_to": [
    "ja"
  ],
  "name": "Interview"
}

예시 값입니다. 미디어 URL 또는 전사 ID를 실제 값으로 바꾸세요.

전사 ID와 상태를 반환합니다. 생성에 성공할 때마다 새 작업이 시작되어 전사 시간이 사용되며, translate_to의 언어마다 미디어 길이만큼 추가로 차감됩니다. 재제출하지 말고 동일 ID로 진행을 확인하세요.

get_transcript

읽기 전용transcripts:read

진행 상태 또는 완료된 전사문을 타임스탬프 텍스트, SRT, VTT로 읽습니다. language를 전달하면 번역을 읽을 수 있습니다. 첫 페이지에 제공 가능한 download_url과 editing_url, 전사문의 번역과 상태가 포함됩니다.

매개변수

idstring필수

transcribe 또는 list_transcripts의 ID. 영문자, 숫자, 밑줄, 하이픈으로 구성된 1–128자.

languagestring

읽을 번역의 언어 코드(예: ja). 생략하면 원본 전사문을 읽습니다.

formatstring

출력 형식. 기본값 text.

textsrtvtt
offsetinteger

0부터 시작하는 구절 위치. 기본값 0. 다음 페이지는 next_offset을 사용하세요.

limitinteger

페이지당 구절 수: 1–500. 기본값 200.

도구 인수 예시

{
  "id": "TRANSCRIPT_ID",
  "format": "text",
  "offset": 0,
  "limit": 200
}

예시 값입니다. 미디어 URL 또는 전사 ID를 실제 값으로 바꾸세요.

next_offset을 offset으로 전달해 다음 페이지를 읽습니다. 페이지당 최대 30,000자이며 MCP로는 처음 2,000개 구절만 읽을 수 있습니다. 전체 내용은 Taption에서 확인하세요. 음성이 없으면 total_phrases: 0을 반환합니다.

translate_transcript

작업 생성transcripts:write

완료된 전사문을 최대 다섯 개 언어로 번역합니다. 이름으로 전사문을 언급하면 도우미가 list_transcripts로 찾고, 명확히 일치하지 않으면 선택을 요청합니다. 번역할 언어는 사용자가 지정해야 합니다.

매개변수

idstring필수

transcribe 또는 list_transcripts의 ID. 영문자, 숫자, 밑줄, 하이픈으로 구성된 1–128자.

target_languagesstring[]필수

번역 언어 코드 1–5개(예: en, ja, es, zh-TW). 전사문과 같은 언어로는 번역할 수 없습니다.

overwriteboolean

true로 설정하면 Taption에서 편집한 내용을 포함해 기존 번역을 교체합니다. 사용자가 동의한 뒤에만 사용하세요.

도구 인수 예시

{
  "id": "TRANSCRIPT_ID",
  "target_languages": [
    "ja",
    "es"
  ]
}

예시 값입니다. 미디어 URL 또는 전사 ID를 실제 값으로 바꾸세요.

대기열에 추가된 언어와 언어별로 차감되는 시간(미디어 길이와 동일)을 반환합니다. 기존 번역에는 편집 내용이 있을 수 있으므로, 동의한 뒤 overwrite를 지정할 때만 교체합니다. 결과는 get_transcript와 language로 읽습니다.

list_transcripts

읽기 전용transcripts:read

최근 수정 순으로 전사문을 나열하며 ID, 이름, 상태, 언어, 번역, 수정 시간을 반환합니다. query로 이름에서 전사문을 찾을 수 있습니다. ID를 get_transcript에 전달해 내용을 읽으세요.

매개변수

limitinteger

반환할 전사문 수: 1–50. 기본값 10.

querystring

최근 전사문 100개에서 찾을 이름의 일부. 대소문자를 구분하지 않습니다.

도구 인수 예시

{
  "query": "weekly sync",
  "limit": 10
}

예시 값입니다. 미디어 URL 또는 전사 ID를 실제 값으로 바꾸세요.

녹음이 없으면 빈 transcripts 배열을 반환합니다. 결과 개수 제한만 있으며 페이지 이동은 지원하지 않습니다.

문제 해결

연결 또는 권한 오류

OAuth로 재연결하여 요청 권한을 허용하세요. URL이 /mcp-custom으로 끝나는지 확인하세요.

미디어 다운로드 실패

공개된 지원 파일·게시물인지, 실시간 방송이 아닌지 확인하세요. Google Drive는 링크 접근을 허용하세요.

전사 시간 부족 또는 작업 수 초과

Taption의 남은 시간을 확인하세요. 요청 빈도나 동시 작업 제한이라면 기존 작업 완료 후 안내된 지연 시간에 따라 다시 시도하세요.

처리 중 또는 전사 실패

처리 중에는 약 1분마다 같은 ID를 확인하세요. error 상태라면 실패 메시지를 읽고 원인을 해결한 뒤 새 작업을 시작하세요.

추가 내보내기 형식

Taption에서 전사문을 열어 TXT, PDF, SRT, VTT, Final Cut Pro XML, JSON 또는 자막이 삽입된 비디오로 내보내세요. 별도 MCP 내보내기 도구는 없습니다.

REST API 문서 읽기