- ✓무료 크레딧 100개로 시작, 신용카드 불필요
- ✓MCP 서버와 REST API 모두에 API 키 하나만 사용
- ✓채널의 최신 업로드 확인은 언제나 무료
- ✓Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline, Codex와 함께 사용 가능
MCP란?
Model Context Protocol을 사용하면 AI 어시스턴트가 데이터를 직접 복사해서 붙여넣는 대신 대화 도중에 도구를 호출할 수 있습니다. 이 서버는 호스팅형입니다 - 클라이언트를 URL 하나에 연결하면 사용 가능한 도구를 자동으로 찾아냅니다. 설치하거나 로컬에서 실행할 것이 전혀 없습니다.
1분 만에 연결하기
Streamable HTTP 방식입니다. 아래 모든 클라이언트는 동일한 URL을 가리킵니다:
https://getyoutubetranscript.com/api/mcpClaude (웹 & 데스크톱)
설정 -> 커넥터 -> 사용자 지정 커넥터 추가 후 아래 URL을 붙여넣으세요. Claude가 로그인 및 연결을 요청합니다 - 복사할 키가 없습니다.
https://getyoutubetranscript.com/api/mcpChatGPT
설정 -> 커넥터 -> 고급 -> 개발자 모드에서 아래 URL로 커넥터를 추가한 뒤 연결하고 로그인하세요.
https://getyoutubetranscript.com/api/mcpClaude Code
대시보드의 API 키를 사용한 명령어 한 줄이면 됩니다:
claude mcp add --transport http getyoutubetranscript https://getyoutubetranscript.com/api/mcp \
--header "Authorization: Bearer sk_live_..."Cursor
~/.cursor/mcp.json(모든 프로젝트) 또는 .cursor/mcp.json(이 프로젝트만)에 추가하세요:
{
"mcpServers": {
"getyoutubetranscript": {
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_..."
}
}
}
}VS Code (Copilot)
.vscode/mcp.json에 추가하세요. VS Code는 아래 입력창을 통해 키를 한 번만 물어보고 파일에 쓰는 대신 안전하게 저장합니다:
{
"inputs": [
{
"type": "promptString",
"id": "gyt-api-key",
"description": "GetYouTubeTranscript API key",
"password": true
}
],
"servers": {
"getyoutubetranscript": {
"type": "http",
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer ${input:gyt-api-key}"
}
}
}
}Codex CLI
~/.codex/config.toml에 추가한 뒤, 참조된 환경 변수를 export하세요:
[mcp_servers.getyoutubetranscript]
url = "https://getyoutubetranscript.com/api/mcp"
bearer_token_env_var = "GYT_API_KEY"export GYT_API_KEY="sk_live_..."Windsurf & Cline
위 Cursor와 동일한 mcpServers JSON 형식을 Windsurf 또는 Cline 자체의 MCP 설정 파일에 작성하면 됩니다.
사용 가능한 도구
| 도구 | 기능 | 비용 |
|---|---|---|
get_youtube_transcript | 전체 스크립트와 제목, 작성자, 썸네일 | 1크레딧 |
search_youtube | 동영상 또는 채널 검색, 페이지네이션 지원 | 1크레딧 |
get_channel_latest_videos | 채널의 메타데이터와 최근 업로드 | 무료 |
search_channel_videos | 특정 채널 내에서 검색 | 1크레딧 |
list_channel_videos | 채널이 업로드한 모든 동영상 | 1크레딧 |
list_playlist_videos | 재생목록의 모든 동영상 | 1크레딧 |
get_credits | 키의 남은 크레딧 잔액 | 무료 |
REST API와 동일한 도구, 동일한 크레딧 비용입니다 - 대응하는 엔드포인트는 API 문서를 참고하세요.
대화에서 이렇게 보입니다
채널에서 최신 업로드를 확인한 다음 스크립트를 가져올게요.
get_channel_latest_videos(channel: "@3blue1brown")
get_youtube_transcript(video_url: "...")
요금제
무료 크레딧 100개로 시작. 이후 월 $5에 크레딧 1,000개(연간 결제 시 월 $4.50). 크레딧 1개는 성공한 도구 호출 1회입니다 - 실패하거나 속도 제한에 걸린 호출은 절대 과금되지 않습니다. 요금제별 속도 제한을 포함한 전체 내역은 API 문서에서 확인하세요.
참고
MCP 서버 FAQ
어떤 MCP 클라이언트와 호환되나요?
Streamable HTTP MCP를 지원하는 모든 클라이언트: Claude(웹, 데스크톱, Code), ChatGPT, Cursor, VS Code, Windsurf, Cline, Codex CLI가 위에서 다뤄졌습니다. 원격 HTTP MCP 서버를 지원하는 클라이언트라면 여기서도 동작합니다.
설치하거나 실행해야 할 것이 있나요?
아니요. 서버는 getyoutubetranscript.com에서 호스팅됩니다 - 클라이언트는 URL만 있으면 됩니다(OAuth를 지원하지 않는 클라이언트는 API 키도 필요). 로컬 프로세스, yt-dlp, 프록시 관리가 전혀 필요 없습니다.
직접 운영하는 오픈소스 MCP 서버와 무엇이 다른가요?
직접 호스팅하는 서버는 자신의 컴퓨터나 서버에서 실행되며, 보통 유튜브 접근(쿠키, 프록시, 속도 제한)을 직접 관리해야 합니다. 이 서버는 호스팅형입니다: 가입은 셀프서비스이고, 요청은 저희 인프라를 거치며, 스크래핑 인프라를 관리하는 대신 크레딧으로 과금됩니다.
401 오류가 났어요 - 어떻게 해야 하나요?
OAuth 클라이언트(Claude, ChatGPT)의 경우 해당 설정 페이지에서 커넥터를 다시 연결하세요 - 연결이 만료되었거나 취소되었을 가능성이 높습니다. API 키 클라이언트(Cursor, VS Code, Claude Code, Codex)의 경우 키가 여분의 공백 없이 정확히 붙여넣어졌는지, 대시보드에서 취소되지 않았는지 확인하세요.
어시스턴트가 도구를 호출하지 않고 기억만으로 답했어요
모델이 영상 내용을 이미 알고 있다고 가정하는 경우가 있습니다. "먼저 유튜브 MCP 도구로 스크립트를 가져와줘"라고 명확히 요청하면 대개 도구 호출을 강제할 수 있습니다.
요청한 언어의 자막이 없는 영상은 어떻게 되나요?
get_youtube_transcript는 잘못된 언어로 추측하는 대신 TRANSCRIPT_NOT_FOUND 오류를 반환합니다. language 매개변수 없이 시도하거나(기본값은 영어) 해당 언어 자막이 유튜브에 실제로 있는지 먼저 확인하세요.
이게 제 유튜브 데이터 API 쿼터를 소모하나요?
아니요. 여러분의 키로 captions.download를 프록시하지 않으므로 하루 10,000 단위 한도를 관리할 필요가 없습니다 - 요금제별 요청 속도 제한만 적용됩니다.
MCP와 REST API에 같은 API 키를 사용할 수 있나요?
네 - 키 하나, 크레딧 잔액 하나를 두 곳에서 공유합니다. 키 대신 OAuth(Claude/ChatGPT 커넥터)로 연결해도 동일한 계정 잔액을 사용합니다. 내부적으로 전용 키를 발급해 대시보드의 키 목록에 표시하므로, 다른 키와 마찬가지로 이 연결을 확인하거나 취소할 수 있습니다.