MCP 서버
AI 에이전트를 위한 transcript.im MCP 서버
transcript.im MCP 서버는 AI 클라이언트가 직접 호출할 수 있는 전사 도구를 제공합니다. Claude, ChatGPT, Cursor 또는 OpenAI Agent Builder를 서버에 연결하고 API 키를 입력하면, 모델이 공개 링크의 전사를 가져오고, 배치를 시작하고, 자막을 내보내거나 YouTube를 검색할 수 있습니다. 브라우저도, 별도 통합도 필요 없습니다. 원격 HTTP 엔드포인트이므로 호스팅 클라이언트에는 URL과 키만 있으면 되고 로컬 설치가 필요 없습니다.
https://mcp.transcript.im/mcp의 원격 엔드포인트 하나, API 키로 인증하며 설치할 것이 없습니다.- 전사, 배치, 내보내기, YouTube 검색, 사용량을 위한 11개 도구.
- AI 도구는 없습니다. 클라이언트가 이미 모델을 실행하고, 서버는 전사와 플랫폼 데이터를 제공합니다.
- REST API로 이미 쓰고 있는 동일한 계정과 동일한 추출 파이프라인.
- 긴 전사는 페이지 토큰으로 나뉘어 하나의 결과가 컨텍스트 창을 넘치게 하지 않습니다.
transcript.im MCP 서버가 하는 일
Model Context Protocol을 사용하면 클라이언트가 서버가 공개한 도구를 검색하고 호출할 수 있습니다. transcript.im MCP 서버는 그 표면을 한 가지 작업에 사용합니다. 공개 동영상이나 오디오 링크를 전사로 바꾸고, 그 주변의 플랫폼 질문에 답하는 것입니다. 클라이언트가 URL과 함께 get_transcript를 호출하면, 서버는 transcript.im 추출 파이프라인에 도달해 제작자의 자막이 있으면 사용하고 없으면 AI 전사로 대체합니다.
- 도구로서의 전사 추출: 호출 한 번으로 링크가 타임스탬프가 있는 텍스트가 됩니다.
- YouTube 검색도: 동영상 검색, 채널 확인, 업로드와 재생목록 항목 나열, 자막 메타데이터 읽기.
- 배치와 내보내기: 여러 링크를 대기열에 넣고 완료된 집합을 내보냅니다.
- 내부에 모델 없음: 서버는 데이터를 반환하고, 클라이언트가 그 데이터로 무엇을 할지 결정합니다.
에이전트가 호출할 수 있는 도구
전사
get_transcript는 URL에서 전사를 추출하거나 긴 전사의 다음 블록을 읽고, get_transcript_info는 추출을 결정하기 전에 동영상 메타데이터와 API가 확인할 수 있는 자막 트랙을 반환합니다. 두 도구를 함께 쓰면 에이전트가 동영상을 전사할 가치가 있는지 판단하고, 실제로 필요한 언어 우선순위를 요청한 뒤 타임스탬프와 함께 또는 없이 텍스트를 가져올 수 있습니다.
배치와 내보내기
create_batch는 URL 목록, 재생목록 또는 채널에서 실행을 시작하고, get_batch는 상태와 집계, 다음 항목 페이지를 알려주며, export_batch는 완료된 배치를 텍스트나 자막으로 바꿉니다. 에이전트가 클립을 하나씩 처리하는 대신 제작자의 전체 백로그를 처리하는 방식이며, 실패한 링크는 나머지를 버리지 않고 따로 보고됩니다.
YouTube 검색
search_video는 주제로 동영상이나 채널을 찾고, get_channel은 핸들이나 URL을 확인하며, list_channel_video는 채널 업로드를 나열하고, list_playlist_item은 재생목록을 따라가며, list_caption은 동영상의 자막 메타데이터와 전사 텍스트를 읽습니다. 에이전트가 틈새를 조사하고, 제작자가 무엇을 공개했는지 확인하고, 전사하기 전에 알맞은 출처를 고르는 데 쓰는 도구입니다.
계정
get_usage는 계정의 사용량 요약을 알려주므로, 에이전트가 큰 배치나 긴 채널에 들어가기 전에 계정이 이미 무엇을 썼는지 확인할 수 있고, 실행 도중에 한도에 부딪히지 않습니다.
이미 쓰는 클라이언트를 연결하세요
Claude
원격 서버를 사용자 지정 커넥터로 추가하거나 명령줄에서 등록하세요. Claude는 MCP 서버와 협상하고 도구를 대화에 노출하며 턴 사이에도 사용할 수 있게 유지하므로, 자연어로 전사를 요청하고 링크를 반복하지 않고 바로 이어서 요약을 요청할 수 있습니다.
ChatGPT
MCP 커넥터를 추가하고 API 키 인증을 선택하세요. 그러면 ChatGPT가 다른 연결된 앱처럼 전사 도구를 호출하므로, 채팅에 붙여 넣은 동영상 링크가 모델이 인용하고 번역하거나 분석할 수 있는 읽을 수 있는 텍스트가 됩니다.
Cursor 및 기타 편집기
편집기의 mcpServers 설정을 API 키와 함께 원격 URL로 지정하세요. 그러면 편집기 에이전트가 링크를 전사해 결과를 프로젝트나 노트에 바로 쓸 수 있습니다.
OpenAI Agent Builder
서버 URL과 Bearer 자격 증명으로 MCP 도구를 추가하면, 에이전트가 전사를 더 큰 워크플로의 한 단계로 사용해 다음 단계로 텍스트를 넘길 수 있습니다. 별도 커넥터가 필요 없습니다.
연결과 인증
서버는 원격 HTTP 엔드포인트이므로 클라이언트 연결은 설치가 아니라 URL과 키입니다.
- 원격 HTTP: MCP 클라이언트에
https://mcp.transcript.im/mcp를 추가하세요. 내 컴퓨터에서 실행할 것은 없습니다. - API 키: 키를
Authorization: Bearer <key>또는x-api-key로 보내세요. 서버가 이를 REST API로 전달하므로 동일한 계정과 권한이 적용됩니다. - 도구 검색: 엔드포인트가 MCP 검색 요청에 응답하므로, 클라이언트가 도구를 호출하기 전에 노출된 도구를 나열할 수 있습니다.
- 동일한 결과: 도구, 청킹, 오류가 같은 계정이 REST API에서 받는 것과 일치하므로 동작이 클라이언트에 의존하지 않습니다.
긴 전사도 관리 가능하게
두 시간짜리 녹음은 모델이 하나의 도구 결과로 받아서는 안 될 만큼 많은 텍스트를 만들 수 있습니다. 그래서 서버는 긴 전사를 제한된 블록으로 반환합니다. 각 블록은 truncated: true와 불투명한 nextPageToken을 알려주며, 그 토큰만으로 get_transcript를 다시 호출하면 다음 블록이 반환되고, 에이전트는 전사가 끝날 때까지 반복합니다.
- 제한된 결과: 각 블록에 상한이 있어 하나의 결과가 컨텍스트 창을 넘치거나 이전 추론을 밀어내지 않습니다.
- 상태 없는 페이징: 토큰이 위치를 담고 호출 사이에 서버 세션을 유지하지 않으므로 어느 복제본이든 다음 블록을 제공할 수 있습니다.
- JSON 페이징: JSON 전사는 세그먼트 단위로 페이지를 나누므로, 구조적 소비자가 기대하는 스키마를 유지한 채 텍스트를 따라갈 수 있습니다.
- 작업 폴링: 자막이 없는 동영상은 작업 ID를 반환하고, 에이전트는 전사가 준비될 때까지 폴링합니다.
- 읽을 수 있는 시작: 첫 블록만으로 도입부에 대한 질문에 답할 수 있어, 짧은 후속 질문이 전체 전사를 가져올 필요가 없습니다.
에이전트가 대응할 수 있는 오류
도구 호출이 실패하면 서버는 스택 트레이스 대신 읽을 수 있는 텍스트가 담긴 MCP 오류를 반환합니다. 구조화된 세부 정보가 결과와 함께 전달되므로 에이전트가 추측 대신 복구할 수 있습니다. code, HTTP status, 한도에 도달했을 때의 upgradeUrl, 요청한 언어가 없을 때의 availableLanguages가 그것입니다. 이는 막다른 길을 다음 행동으로 바꿉니다. 다른 언어를 시도하거나, 다른 링크를 고르거나, 대화 중인 사람에게 한도를 알리는 것입니다. 실패 이유를 읽을 수 있는 모델은 다음 시도를 스스로 고칠 수 있고, 이것이 유용하게 재시도하는 에이전트와 같은 깨진 호출을 반복하는 에이전트의 차이입니다.
관련
MCP 서버 FAQ
transcript.im MCP 서버란 무엇인가요?
transcript.im MCP 서버는 전사 추출, 배치 작업, 내보내기, YouTube 검색을 AI 클라이언트가 호출할 수 있는 도구로 노출하는 Model Context Protocol 표면입니다.
어떤 클라이언트가 transcript.im MCP 서버에 연결할 수 있나요?
Claude, ChatGPT, Cursor, OpenAI Agent Builder와 그 밖의 모든 MCP 클라이언트가 API 키로 원격 HTTP 엔드포인트에 연결할 수 있습니다.
transcript.im MCP 서버에 AI 도구가 포함되나요?
아니요. 서버는 의도적으로 데이터와 추출 도구만 노출합니다. 결과를 요약하거나 다시 쓰는 모델은 클라이언트가 이미 실행하기 때문입니다.
에이전트는 동영상 링크에서 어떻게 전사를 가져오나요?
링크와 함께 전사 도구를 호출합니다. 서버는 기존 자막을 먼저 사용하고 없으면 AI 전사로 대체하며 타임스탬프가 있는 텍스트를 반환합니다.
MCP 서버는 긴 전사를 어떻게 처리하나요?
제한된 블록으로 반환합니다. 각 결과에 잘림 표시와 페이지 토큰이 담기며, 에이전트가 그 토큰으로 도구를 다시 호출해 다음 블록을 읽습니다.
에이전트가 transcript.im MCP 서버로 배치를 실행할 수 있나요?
네. 배치 도구는 URL 목록, 재생목록 또는 채널을 받아 상태와 집계를 보고하고 완료된 집합을 텍스트나 자막으로 내보냅니다.
transcript.im MCP 서버는 YouTube 검색과 채널을 지원하나요?
네. 전용 도구가 동영상과 채널 검색, 채널 확인, 채널 업로드, 재생목록 항목, 자막 메타데이터를 다룹니다.
MCP 서버는 클라이언트를 어떻게 인증하나요?
API 키를 Bearer 토큰 또는 x-api-key 헤더로 받아 REST API로 전달하므로, 호출이 직접 API 요청과 같은 계정에 적용됩니다.