MCP-сервер YouTube

Один удалённый URL даёт Claude, ChatGPT, Cursor и любому другому MCP-совместимому клиенту настоящий доступ к YouTube - транскрипты, поиск, каналы и плейлисты - прямо в разговоре.

  • ✓100 бесплатных кредитов для старта, банковская карта не нужна
  • ✓Один API-ключ работает и для MCP-сервера, и для REST API
  • ✓Проверка последних загрузок канала всегда бесплатна
  • ✓Работает с Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline и Codex

Что такое MCP?

Model Context Protocol позволяет ИИ-ассистенту вызывать инструменты прямо посреди разговора, вместо того чтобы вы вручную копировали и вставляли данные. Этот сервер размещён у нас - достаточно указать клиенту один URL, и он сам обнаружит доступные инструменты. Ничего устанавливать или запускать локально не нужно.

Подключение примерно за минуту

Streamable HTTP. Каждый клиент ниже указывает на один и тот же URL:

https://getyoutubetranscript.com/api/mcp

Claude (веб и десктоп)

Settings -> Connectors -> Add custom connector, затем вставьте URL ниже. Claude попросит вас войти и подключиться - копировать ключ не нужно.

https://getyoutubetranscript.com/api/mcp

ChatGPT

Settings -> Connectors -> Advanced -> Developer mode, добавьте коннектор с URL ниже, затем подключитесь и войдите.

https://getyoutubetranscript.com/api/mcp

Claude 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, затем экспортируйте переменную окружения, на которую идёт ссылка:

[mcp_servers.getyoutubetranscript]
url = "https://getyoutubetranscript.com/api/mcp"
bearer_token_env_var = "GYT_API_KEY"
export GYT_API_KEY="sk_live_..."

Windsurf и Cline

Тот же формат JSON mcpServers, что и у Cursor выше, в собственном файле настроек MCP Windsurf или Cline.

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

ИнструментЧто делаетСтоимость
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.

Как это выглядит в разговоре

> Что говорилось в последнем видео 3Blue1Brown о нейросетях?

Проверю канал на предмет последней загрузки, а затем получу её транскрипт.

get_channel_latest_videos(channel: "@3blue1brown")

get_youtube_transcript(video_url: "...")

В последнем видео обратное распространение ошибки объясняется как постоянный вопрос "как изменение этого числа повлияет на итоговую ошибку?" - с разбором цепного правила, векторов градиента и того, почему более глубоким сетям нужна более осторожная инициализация...

Цены

100 бесплатных кредитов для старта. Далее $5/мес за 1000 кредитов ($4,50/мес при годовой оплате). Один кредит - один успешный вызов инструмента; неудачные или ограниченные по скорости вызовы никогда не тарифицируются. Полная разбивка, включая лимиты скорости по тарифам, - в документации API.

Примечание

Создаёте собственный клиент или используете это для генерации кода? Полная спецификация REST-эндпоинтов опубликована по адресу /openapi.json (OpenAPI 3.0) - те же эндпоинты, которые эти MCP-инструменты вызывают под капотом. Версия для чтения человеком: документация API.

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

С какими MCP-клиентами это работает?

С любым клиентом, поддерживающим MCP по Streamable HTTP: Claude (веб, десктоп, Code), ChatGPT, Cursor, VS Code, Windsurf, Cline и Codex CLI описаны выше. Если клиент поддерживает удалённый HTTP MCP-сервер, здесь он тоже будет работать.

Нужно ли что-то устанавливать или запускать?

Нет. Сервер размещён на getyoutubetranscript.com - клиенту нужен только URL (а для клиентов без OAuth - ещё и API-ключ). Никакого локального процесса, yt-dlp или прокси, которым нужно управлять.

Чем это отличается от опенсорсного MCP-сервера, который я запускаю сам?

Сервер с самостоятельным хостингом работает на вашей машине или вашем собственном сервере и обычно требует, чтобы вы сами управляли доступом к YouTube (куки, прокси, лимиты скорости). Этот сервер размещён у нас: регистрация в режиме самообслуживания, запросы идут через нашу инфраструктуру, а оплата - в кредитах, а не в управлении инфраструктурой скрапинга.

Я получил ошибку 401 - что делать?

Для OAuth-клиентов (Claude, ChatGPT) переподключите коннектор на его странице настроек - вероятно, подключение истекло или было отозвано. Для клиентов с API-ключом (Cursor, VS Code, Claude Code, Codex) проверьте, что ключ вставлен верно, без лишних пробелов, и не был отозван в дашборде.

Мой ассистент ответил по памяти, не вызвав инструмент

Модели иногда считают, что уже знают содержание видео. Попросите явно: "сначала используй MCP-инструмент YouTube, чтобы получить транскрипт" - обычно этого достаточно, чтобы вызвать инструмент.

Что произойдёт, если у видео нет субтитров на нужном языке?

get_youtube_transcript возвращает ошибку TRANSCRIPT_NOT_FOUND вместо догадки на неверном языке. Попробуйте без параметра language (по умолчанию английский) или сначала проверьте на YouTube, действительно ли у видео есть субтитры на этом языке.

Расходует ли это мою квоту YouTube Data API?

Нет. Сервис не проксирует captions.download через ваш собственный ключ, поэтому нет суточного лимита в 10 000 единиц, которым нужно управлять - только лимит скорости запросов по вашему тарифу.

Могу ли я использовать один и тот же API-ключ для MCP и REST API?

Да - один ключ, один баланс кредитов, общий для обоих. Подключение через OAuth (коннекторы Claude/ChatGPT) вместо ключа тоже расходует тот же баланс аккаунта; мы незаметно создаём отдельный ключ, который появляется в списке ключей вашего дашборда, так что вы можете просматривать или отзывать это подключение, как любой другой ключ.