YouTube Transcript MCP Server: Setup Guide for Claude and Other AI Tools

Model Context Protocol은 AI 클라이언트가 외부 도구를 발견하고 호출하는 방식을 표준화합니다. 내부적으로는 JSON-RPC 2.0입니다 - 클라이언트가 서버에 어떤 도구가 있는지와 입력 스키마를 묻고, 이름으로 구조화된 인자와 함께 호출한 다음, 같은 대화 턴 안에서 구조화된 결과를 돌려받습니다.

MCP 서버는 두 가지 전송 방식 중 하나로 동작합니다: 클라이언트가 서버를 로컬 하위 프로세스로 실행하는 stdio(로컬 파일 시스템 접근이 필요한 도구에 일반적) 또는, 서버가 원격에 있고 여러 클라이언트가 동시에 HTTPS로 접근할 수 있는 Streamable HTTP입니다 - 이 서버가 사용하는 방식입니다. (일부 문서에는 더 오래된 HTTP+SSE 전송 방식이 등장하지만 Streamable HTTP로 대체되어 더 이상 권장되지 않습니다.) 실질적으로 이는 이 서버를 사용하는 데 로컬에서 아무것도 실행할 필요가 없다는 뜻입니다 - 클라이언트를 URL에 연결하기만 하면 됩니다.

페이지네이션을 지원하는 도구(검색, 채널 목록, 재생목록 목록)는 모두 오프셋/제한 쌍 대신 이전 응답의 continuation 토큰을 받아 다음 페이지를 가져옵니다.

대시보드에서 가입하고 API 키를 생성하세요 - 무료 크레딧 100개가 포함되며 카드 등록도 필요 없습니다. 이 키는 대부분의 클라이언트에서 MCP 서버가 인증하는 데 쓰이는 베어러 토큰입니다.

MCP 클라이언트 설정(예: claude_desktop_config.json, 또는 Claude Code라면 claude mcp add)에 다음을 추가하세요:

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

sk_live_... 부분을 본인의 API 키로 바꾸세요. 클라이언트를 완전히 재시작하면 위 6개의 도구가 자동으로 나타납니다 - 대부분의 클라이언트는 이 설정을 시작할 때만 읽고, 핫 리로드로는 반영하지 않습니다.

커스텀 헤더가 있는 Streamable HTTP 방식의 원격 MCP 서버를 지원하는 클라이언트라면 모두 같은 형태의 설정을 사용하며, 파일 이름과 필드 명칭만 다릅니다(예: Cursor의 .cursor/mcp.json, Windsurf의 MCP 설정 패널). 클라이언트가 고정 베어러 헤더 대신 OAuth 기반 서버만 지원한다면, 대신 다음에 설명할 OAuth 흐름을 사용하세요.

붙여넣은 API 키 대신 OAuth로 MCP 서버를 인증하는 클라이언트(예: ChatGPT의 커스텀 커넥터)를 위해, 이 서버는 동적 클라이언트 등록을 지원하는 OAuth 2.1도 지원합니다 - 클라이언트를 동일한 서버 URL에 연결하면 OAuth 메타데이터를 자동으로 발견하고 베어러 토큰을 직접 묻는 대신 인증 흐름을 안내합니다.

연결되면 자연스러운 문장만으로 충분합니다 - 어떤 도구를 호출할지는 모델이 판단합니다:

• "youtube.com/watch?v=dQw4w9WgXcQ의 스크립트를 가져와서 3개의 항목으로 요약해 줘."
• "YouTube에서 'Next.js server actions'를 검색해서 상위 5개 결과를 알려줘."
• "@mkbhd가 업로드한 모든 동영상을 나열하고 'battery'가 언급된 것을 찾아줘."