MCP 받아쓰기, 영상 링크와 녹음 파일을 채팅에서

AI 어시스턴트에 MCP 받아쓰기 연결하기

MCP 받아쓰기를 연결하면 AI 어시스턴트가 영상이나 녹음에서 스크립트를 가져올 수 있어요. YouTube, X, TikTok, Instagram, Facebook, Bluesky와 Twitch 클립·종료된 VOD, Dailymotion 영상, Pinterest 동영상 핀, LinkedIn 동영상 게시물, Snapchat Spotlight, 업로드한 녹음을 지원해요. Claude와 ChatGPT는 OAuth로, Cursor·VS Code·Claude Code는 API 키로 연결하세요.

연결해 두면 어시스턴트가 스크립트를 가져와요

로컬 서버 설치 없이 연결

https://api.transcript1.com/mcp에 Streamable HTTP로 연결해요. 별도 MCP 서버를 컴퓨터에 설치할 필요는 없어요.

사용하는 앱에 맞게 인증

Claude와 ChatGPT에서는 OAuth로 로그인하세요. Cursor, VS Code, Claude Code와 에이전트에서는 API 키를 Bearer 토큰으로 보내세요.

조회와 업로드까지 도구로

transcribe, get_transcription, list_transcriptions, create_upload, get_upload_status, complete_upload, delete_transcription, get_account를 쓸 수 있어요.

긴 녹음은 나눠서 읽기

스크립트는 구간이 끊기는 지점에서 페이지를 나눠요. 기본 텍스트 형식은 줄마다 타임스탬프를 붙여서 돌려줘요.

이미 변환했다면 다시 만들지 않기

전체 영상 링크로 transcribe를 호출하면 최근 24시간 안에 만든 일치하는 스크립트를 재사용해요. 짧은 링크는 이 방식으로 찾을 수 없어요. ID를 알고 있다면 get_transcription으로 읽으세요.

Cursor에 MCP 받아쓰기 연결하기

.cursor/mcp.json에 서버 URL과 API 키를 넣으세요. VS Code는 같은 URL을 .vscode/mcp.json에 설정해요. MCP 연결 문서에는 두 앱의 원클릭 설치도 있어요.

클라이언트가 원격 MCP를 지원하고 요청마다 Authorization 헤더를 보낼 수 있어야 해요. Cursor와 VS Code의 설정 구조는 달라요. 파일 이름만 바꾸지 말고 앱별 예제를 복사하세요.

연결 후에는 get_account나 list_transcriptions부터 호출해 보세요. 유료 변환을 만들지 않고 인증을 확인할 수 있어요. 도구가 보이지 않으면 설정을 불러왔는지, 서버를 켰는지 확인하세요. 인증 오류가 나면 클라이언트에 저장한 키를 확인하세요.

.cursor/mcp.json

{
  "mcpServers": {
    "transcript1": {
      "url": "https://api.transcript1.com/mcp",
      "headers": {
        "Authorization": "Bearer t1_YOURKEY"
      }
    }
  }
}

Claude Code와 채팅 앱에서 연결하기

Claude Code에서는 서버 URL과 API 키를 넣어 claude mcp add를 실행하세요. Claude와 ChatGPT에서는 같은 URL로 커스텀 커넥터를 추가하고 로그인해요. 앱별 연결 방법을 확인하세요.

Claude와 ChatGPT의 커스텀 커넥터는 OAuth로 인증해요. 사용할 수 있는지는 어시스턴트 요금제와 워크스페이스 설정에 따라 달라요. 코드 에디터의 API 키 설정과는 다르니 지금 사용하는 앱의 안내를 따르세요.

도구가 준비되면 공개 영상 링크와 할 일을 함께 알려주세요. 예를 들어 Instagram Reel의 스크립트를 가져온 뒤 말로 설명한 순서를 정리해 달라고 할 수 있어요. 어시스턴트가 영상을 직접 살펴본 건 아니에요. 스크립트에 없는 화면 정보까지 안다고 가정하지 마세요.

Claude Code

claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"

스크립트를 요청하고 끝까지 읽게 하기

어시스턴트가 transcribe를 호출해 첫 페이지를 읽어요. 아직 처리 중이면 받은 ID로 get_transcription을 호출하면 돼요. 도구 파라미터와 에이전트 활용 방법을 참고하세요.

기본 응답은 타임스탬프가 있는 텍스트예요. 긴 스크립트에 next_from_seconds가 있으면 다음 호출의 from_seconds에 넣어 이어 읽으세요. 첫 페이지만 읽고 전체 녹음을 요약하지 않도록, 필요한 페이지를 모두 읽어 달라고 요청하세요.

전체 영상 링크는 최근 24시간 안의 일치하는 작업을 재사용할 수 있어요. 짧은 공유 링크는 요청할 때 이전 작업과 맞추지 못해요. 링크 종류와 상관없이 기존 ID가 있다면 get_transcription으로 읽으면 돼요. 아래 예제의 자리표시자는 실제 공개 TikTok 영상 URL로 바꾸세요.

어시스턴트가 호출하는 도구 예시

transcribe(url="[public TikTok video URL]")

get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", format="srt")

로컬 파일은 실제 업로드가 필요해요

채팅에 파일 경로를 적는 것만으로는 파일이 전송되지 않아요. MCP는 요청과 응답을 주고받을 뿐, 녹음 파일 내용을 옮기지 않아요. create_upload로 예약한 뒤 에이전트가 파일을 읽어 MCP 밖에서 HTTP로 청크를 보내고 complete_upload를 호출해야 해요. 경계는 파일 업로드 문서에 설명돼 있어요.

로컬 파일을 읽거나 바이너리 HTTP 요청을 보낼 수 없는 어시스턴트도 있어요. 그런 환경에서는 대시보드에 파일을 올린 뒤 완료된 변환 ID를 알려주세요.

완료 웹훅은 REST API에서만 설정할 수 있어요. 대화 중에는 잠시 기다린 뒤 get_transcription으로 상태를 확인하세요. 도구 호출 중 연결이 끊겨도 작업은 생성됐을 수 있어요. 최근 변환 목록이나 저장한 ID부터 확인하세요.

같은 연결로 Bluesky 영상이나 TikTok 스크립트도 가져올 수 있어요. 게시물은 공개 상태여야 해요. 스크립트는 음성을 담고 있으므로 화면에만 나온 내용은 별도로 확인해야 해요.

자주 묻는 질문

궁금한 점이 더 있나요? 문의하기

어떤 앱에서 연결할 수 있나요?

Claude와 ChatGPT의 커스텀 커넥터, Cursor와 VS Code의 원클릭 설치, Claude Code 명령으로 연결할 수 있어요. 그 밖에도 원격 MCP 서버를 지원하는 클라이언트면 사용할 수 있어요.

API 키가 꼭 필요한가요?

Claude와 ChatGPT에서는 OAuth로 로그인하면 돼요. 다른 클라이언트는 t1_로 시작하는 API 키를 Authorization 헤더에 넣으세요. 키는 대시보드의 “API keys”에서 만들어요.

내 컴퓨터의 녹음도 변환할 수 있나요?

네. create_upload로 업로드를 예약하고, 파일 내용을 HTTP로 나눠 보낸 뒤 complete_upload를 호출해요. 에이전트가 파일을 읽고 전송할 수 없는 환경이라면 대시보드에서 업로드하세요.

MCP용 크레딧을 따로 사야 하나요?

아니요. 같은 계정의 API를 호출하므로 REST API와 크레딧을 함께 써요. 과금 방식, 사용 한도, 요청 속도 제한, 오류 코드도 같아요.