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
Краткий ответ
Что такое 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.
Получите API-ключ
Зарегистрируйтесь в панели управления и создайте API-ключ — 100 кредитов включены бесплатно, карта не требуется. Этот ключ — bearer-токен, которым MCP-сервер аутентифицируется у большинства клиентов.
Добавьте сервер в 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 инструментов выше появятся автоматически: большинство клиентов читают эту конфигурацию только при запуске, а не при горячей перезагрузке.
Другие клиенты: Cursor, Windsurf и собственные агенты
Любой клиент, поддерживающий удалённый MCP-сервер через Streamable HTTP с пользовательскими заголовками, использует такую же форму конфигурации — отличаются только сам файл и названия полей (например, .cursor/mcp.json у Cursor, панель настроек MCP у Windsurf). Если клиент поддерживает только серверы на основе OAuth, а не статический bearer-заголовок, используйте вместо этого описанный далее OAuth-поток.
Коннекторы ChatGPT и клиенты только с OAuth
Для клиентов, которые аутентифицируют MCP-серверы через OAuth, а не через вставленный API-ключ (например, пользовательские коннекторы ChatGPT), этот сервер также поддерживает OAuth 2.1 с динамической регистрацией клиента — укажите клиенту тот же URL сервера, и он обнаружит метаданные OAuth и проведёт вас через процесс авторизации вместо запроса bearer-токена напрямую.
Попросите его использовать инструмент
После подключения достаточно обычных запросов на естественном языке — модель сама решает, какой инструмент вызвать:
- «Получи транскрипт видео youtube.com/watch?v=dQw4w9WgXcQ и сделай его обзор в 3 пунктах».
- «Найди на YouTube 'Next.js server actions' и покажи топ-5 результатов».
- «Перечисли все видео, загруженные @mkbhd, и найди те, где упоминается 'battery'».
Устранение неполадок
Создаёте собственного агента вместо использования чат-клиента? Тот же сервер работает с любым MCP-совместимым клиентом через Streamable HTTP. Полное описание REST-эндпоинтов, кредитов и лимитов запросов — в документации API.
Часто задаваемые вопросы об MCP-сервере
Что такое MCP-сервер и зачем он нужен для транскриптов YouTube?
MCP (Model Context Protocol) позволяет AI-ассистенту, например Claude, вызывать внешние инструменты напрямую во время разговора. Вместо того чтобы вставлять транскрипт в чат, вы просите Claude получить его — он вызывает инструмент, получает транскрипт обратно и может сделать обзор, перевод или поиск в рамках того же хода.
Это то же самое, что и обычная обёртка над REST API?
Нет. MCP стандартизирует обнаружение и вызов инструментов для любого совместимого клиента — один и тот же сервер работает с Claude Desktop, Claude Code, Cursor, Windsurf или собственным агентом без написания связующего кода под конкретного клиента. Для REST API вам (или модели) по-прежнему нужно знать точную структуру эндпоинта; инструменты MCP самоописываемы, поэтому клиент автоматически получает их список и входные схемы.
Какой транспорт использует этот MCP-сервер?
Streamable HTTP — актуальный транспорт для удалённых многоклиентских MCP-серверов (старый транспорт HTTP+SSE устарел). Под капотом сообщения MCP — это JSON-RPC 2.0, а транспортный уровень просто отвечает за доставку этих сообщений на сервер и обратно; знать JSON-RPC для использования не нужно, достаточно конфигурации ниже.
Нужен ли API-ключ для использования MCP-сервера?
Да, для большинства инструментов. Запросы аутентифицируются bearer-токеном — тем же API-ключом, что и для REST API. Зарегистрируйтесь и получите 100 бесплатных кредитов в панели управления, карта не требуется. Этот сервер также поддерживает OAuth 2.1 (динамическую регистрацию клиента) для таких клиентов, как коннекторы ChatGPT, которые аутентифицируются через OAuth-поток вместо статического заголовка.
Списываются ли кредиты так же, как при использовании REST API?
Да — каждый успешный тарифицируемый вызов инструмента стоит 1 кредит, учёт такой же, как у REST API. get_channel_latest_videos бесплатен и никогда не списывает кредит. Неудачные вызовы никогда не тарифицируются.
Инструменты не появляются после добавления конфигурации — что проверить?
Полностью перезапустите клиент (не просто перезагрузите окно) — большинство клиентов читают конфигурацию MCP-сервера только при запуске. Затем проверьте, что bearer-токен действителен (истёкший или некорректный ключ вернёт 401, а не симптом отсутствия инструментов), и что в URL нет опечатки — неверный путь вернёт 404 ещё до проверки аутентификации.
Безопасно ли хранить свой API-ключ в конфигурационном файле?
Относитесь к конфигурационному файлу MCP как к любому другому файлу с учётными данными — не коммитьте его в публичный репозиторий и предпочитайте поддержку секретов/переменных окружения вашего клиента жёстко закодированному ключу, если она доступна. Само соединение работает по HTTPS, поэтому токен не раскрывается при передаче.
Похожие материалы
- YouTube API Quota Exceeded: Causes and Fixes
- YouTube Transcript API Rate Limit: What It Is and How to Handle 429s
- YouTube Transcripts in n8n: HTTP Request Workflow Guide
- GetYouTubeTranscript против TranscriptAPI
- GetYouTubeTranscript против youtubetotranscript.com
- GetYouTubeTranscript против youtube-transcript.io