Назад в блогИнтеграции

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

How the Model Context Protocol works, how to connect the GetYouTubeTranscript MCP server to Claude Desktop, Claude Code, Cursor, Windsurf, or ChatGPT, and how to troubleshoot the connection.

00:08:00 · SEP 13, 2026

Краткий ответ

Добавьте URL сервера и свой API-ключ в качестве bearer-токена в конфигурацию вашего MCP-клиента (точный JSON ниже), перезапустите клиент и попросите его получить транскрипт по ссылке — копировать и вставлять ничего не нужно.

Что такое MCP на самом деле

Model Context Protocol стандартизирует то, как AI-клиент обнаруживает и вызывает внешние инструменты. Под капотом это JSON-RPC 2.0 — клиент спрашивает сервер, какие инструменты существуют и какие у них входные схемы, затем вызывает их по имени со структурированными аргументами и получает структурированный результат обратно, всё в рамках одного и того же хода разговора.

MCP-серверы работают через один из двух транспортов: stdio, при котором клиент запускает сервер как локальный подпроцесс (типично для инструментов, которым нужен доступ к локальной файловой системе), или Streamable HTTP, при котором сервер удалённый и доступен по HTTPS сразу для любого числа клиентов — именно это использует данный сервер. (В некоторых документах упоминается более старый транспорт HTTP+SSE, но он устарел в пользу Streamable HTTP.) На практике это означает, что вам никогда не нужно ничего запускать локально, чтобы использовать этот сервер — просто укажите клиенту URL.

Доступные инструменты

ИнструментЧто делаетСтоимость
get_youtube_transcriptПолный транскрипт плюс название, автор и метаданные миниатюры1 кредит
search_youtubeПоиск видео или каналов на YouTube с постраничной навигацией1 кредит
get_channel_latest_videosМетаданные канала плюс его последние загрузкиБесплатно
search_channel_videosПоиск запроса внутри одного канала с постраничной навигацией1 кредит
list_channel_videosСписок всех видео, загруженных каналом, с постраничной навигацией1 кредит
list_playlist_videosПолучить все видео в плейлисте с постраничной навигацией1 кредит

Все инструменты с постраничной навигацией (поиск, список канала, список плейлиста) принимают токен continuation из предыдущего ответа для получения следующей страницы, а не пару offset/limit.

01

Получите API-ключ

Зарегистрируйтесь в панели управления и создайте API-ключ — 100 кредитов включены бесплатно, карта не требуется. Этот ключ — bearer-токен, которым MCP-сервер аутентифицируется у большинства клиентов.

02

Добавьте сервер в Claude Desktop или Claude Code

Добавьте это в конфигурацию вашего MCP-клиента (например, claude_desktop_config.json, или через claude mcp add для Claude Code):

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

Замените sk_live_... на свой собственный API-ключ. Полностью перезапустите клиент — и 6 инструментов выше появятся автоматически: большинство клиентов читают эту конфигурацию только при запуске, а не при горячей перезагрузке.

03

Другие клиенты: Cursor, Windsurf и собственные агенты

Любой клиент, поддерживающий удалённый MCP-сервер через Streamable HTTP с пользовательскими заголовками, использует такую же форму конфигурации — отличаются только сам файл и названия полей (например, .cursor/mcp.json у Cursor, панель настроек MCP у Windsurf). Если клиент поддерживает только серверы на основе OAuth, а не статический bearer-заголовок, используйте вместо этого описанный далее OAuth-поток.

04

Коннекторы ChatGPT и клиенты только с OAuth

Для клиентов, которые аутентифицируют MCP-серверы через OAuth, а не через вставленный API-ключ (например, пользовательские коннекторы ChatGPT), этот сервер также поддерживает OAuth 2.1 с динамической регистрацией клиента — укажите клиенту тот же URL сервера, и он обнаружит метаданные OAuth и проведёт вас через процесс авторизации вместо запроса bearer-токена напрямую.

05

Попросите его использовать инструмент

После подключения достаточно обычных запросов на естественном языке — модель сама решает, какой инструмент вызвать:

  • «Получи транскрипт видео youtube.com/watch?v=dQw4w9WgXcQ и сделай его обзор в 3 пунктах».
  • «Найди на YouTube 'Next.js server actions' и покажи топ-5 результатов».
  • «Перечисли все видео, загруженные @mkbhd, и найди те, где упоминается 'battery'».

Устранение неполадок

Код 401 от MCP-сервера означает, что bearer-токен отсутствует, истёк или некорректен — проверьте, что он совпадает с активным ключом в вашей панели управления. Если после добавления конфигурации инструменты вообще не появляются, клиенту почти всегда нужен полный перезапуск, а не перезагрузка.

Создаёте собственного агента вместо использования чат-клиента? Тот же сервер работает с любым MCP-совместимым клиентом через Streamable HTTP. Полное описание REST-эндпоинтов, кредитов и лимитов запросов — в документации API.

Часто задаваемые вопросы об MCP-сервере

Q01

Что такое MCP-сервер и зачем он нужен для транскриптов YouTube?

MCP (Model Context Protocol) позволяет AI-ассистенту, например Claude, вызывать внешние инструменты напрямую во время разговора. Вместо того чтобы вставлять транскрипт в чат, вы просите Claude получить его — он вызывает инструмент, получает транскрипт обратно и может сделать обзор, перевод или поиск в рамках того же хода.

Q02

Это то же самое, что и обычная обёртка над REST API?

Нет. MCP стандартизирует обнаружение и вызов инструментов для любого совместимого клиента — один и тот же сервер работает с Claude Desktop, Claude Code, Cursor, Windsurf или собственным агентом без написания связующего кода под конкретного клиента. Для REST API вам (или модели) по-прежнему нужно знать точную структуру эндпоинта; инструменты MCP самоописываемы, поэтому клиент автоматически получает их список и входные схемы.

Q03

Какой транспорт использует этот MCP-сервер?

Streamable HTTP — актуальный транспорт для удалённых многоклиентских MCP-серверов (старый транспорт HTTP+SSE устарел). Под капотом сообщения MCP — это JSON-RPC 2.0, а транспортный уровень просто отвечает за доставку этих сообщений на сервер и обратно; знать JSON-RPC для использования не нужно, достаточно конфигурации ниже.

Q04

Нужен ли API-ключ для использования MCP-сервера?

Да, для большинства инструментов. Запросы аутентифицируются bearer-токеном — тем же API-ключом, что и для REST API. Зарегистрируйтесь и получите 100 бесплатных кредитов в панели управления, карта не требуется. Этот сервер также поддерживает OAuth 2.1 (динамическую регистрацию клиента) для таких клиентов, как коннекторы ChatGPT, которые аутентифицируются через OAuth-поток вместо статического заголовка.

Q05

Списываются ли кредиты так же, как при использовании REST API?

Да — каждый успешный тарифицируемый вызов инструмента стоит 1 кредит, учёт такой же, как у REST API. get_channel_latest_videos бесплатен и никогда не списывает кредит. Неудачные вызовы никогда не тарифицируются.

Q06

Инструменты не появляются после добавления конфигурации — что проверить?

Полностью перезапустите клиент (не просто перезагрузите окно) — большинство клиентов читают конфигурацию MCP-сервера только при запуске. Затем проверьте, что bearer-токен действителен (истёкший или некорректный ключ вернёт 401, а не симптом отсутствия инструментов), и что в URL нет опечатки — неверный путь вернёт 404 ещё до проверки аутентификации.

Q07

Безопасно ли хранить свой API-ключ в конфигурационном файле?

Относитесь к конфигурационному файлу MCP как к любому другому файлу с учётными данными — не коммитьте его в публичный репозиторий и предпочитайте поддержку секретов/переменных окружения вашего клиента жёстко закодированному ключу, если она доступна. Само соединение работает по HTTPS, поэтому токен не раскрывается при передаче.

Похожие материалы