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

> MCP 받아쓰기로 Claude, ChatGPT, 코드 에디터에서 SNS 영상과 녹음 파일을 텍스트로 바꿔보세요. OAuth나 API 키로 연결하고 타임스탬프가 있는 스크립트를 읽을 수 있어요.

Canonical: https://transcript1.com/ko/features/mcp-badasseugi
Language: ko
Last updated: 2026-10-19

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

- Claude, ChatGPT, Cursor, VS Code, Claude Code 지원
- REST API와 같은 크레딧과 한도
- 전체 영상 링크는 최근 24시간의 스크립트 재사용 가능

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

### 로컬 서버 설치 없이 연결

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 연결 문서](https://transcript1.com/ko/docs/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로 커스텀 커넥터를 추가하고 로그인해요. [앱별 연결 방법](https://transcript1.com/ko/docs/mcp#claude)을 확인하세요.

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을 호출하면 돼요. [도구 파라미터](https://transcript1.com/ko/docs/mcp#tools)와 [에이전트 활용 방법](https://transcript1.com/ko/use-cases/ai-eijeonteu-yeongsang-seukeuripteu)을 참고하세요.

기본 응답은 타임스탬프가 있는 텍스트예요. 긴 스크립트에 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를 호출해야 해요. 경계는 [파일 업로드 문서](https://transcript1.com/ko/docs/mcp#files)에 설명돼 있어요.

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

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

같은 연결로 [Bluesky 영상](https://transcript1.com/ko/features/bluesky-yeongsang-tekseuteu-byeonhwan)이나 [TikTok 스크립트](https://transcript1.com/ko/features/tiktok-jamak-chuchul)도 가져올 수 있어요. 게시물은 공개 상태여야 해요. 스크립트는 음성을 담고 있으므로 화면에만 나온 내용은 별도로 확인해야 해요.

## 자주 묻는 질문

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

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와 크레딧을 함께 써요. 과금 방식, 사용 한도, 요청 속도 제한, 오류 코드도 같아요.

## 함께 보면 좋은 페이지

- [AI 에이전트 연동](https://transcript1.com/ko/use-cases/ai-eijeonteu-yeongsang-seukeuripteu)
- [MCP 서버 연결 (문서)](https://transcript1.com/ko/docs/mcp)
- [TikTok 스크립트](https://transcript1.com/ko/features/tiktok-jamak-chuchul)
- [파일 변환 API](https://transcript1.com/ko/features/eumseong-tekseuteu-byeonhwan-api)