Как подключить vidIQ MCP к Claude Code: пошагово и что он отдаёт

Q: Сервер добавился, но не появился в `/mcp` — что смотреть?

Если правили JSON руками — проверьте поле type. Запись с url, но без type, Claude Code трактует как stdio-сервер и молча пропускает, выдавая ошибку про отсутствующий type. Если конфиг в .mcp.json из репозитория, сервер может ждать вашего подтверждения — Claude Code спрашивает разрешение на project-scoped серверы; сбросить прошлые ответы можно командой claude mcp reset-project-choices.

Коротко

vidIQ отдаёт свои данные по YouTube через один удалённый MCP-сервер по адресу https://mcp.vidiq.com/mcp. Транспорт — HTTP, авторизация — OAuth, никаких API-ключей в конфиге. В Claude Code подключается одной командой:

claude mcp add --transport http vidiq https://mcp.vidiq.com/mcp

Дальше запускаете claude, вводите /mcp, выбираете vidiq → Authenticate, входите в свой аккаунт vidIQ в браузере. После этого /mcp должен показывать сервер как connected. Проверить, что авторизовались тем аккаунтом, помогает бесплатный вызов vidiq_user_channels — он возвращает поле authenticatedAs с почтой и список подключённых каналов.

На 28 июля 2026 подключённый сервер отдаёт 52 инструмента: исследование ключей, поиск «выстреливших» видео, статистика каналов, транскрипты, разбор превью, а также генеративный блок (превью, клипы, озвучка, видео). Почти все стоят 5 кредитов за вызов, служебные — 0, vidiq_video_watch — 25. Кредиты общие с остальной подпиской vidIQ: Free — 150 в месяц, Boost — 2 000, Max — 6 000.

Зачем это нужно

Без MCP агент про YouTube знает только то, что успел прочитать в интернете, и охотно выдумывает цифры просмотров. С подключённым сервером он ходит за данными в vidIQ и возвращает то, что там реально лежит.

Практическая разница видна на трёх задачах:

Разведка ниши. «Найди видео на русском по теме X, которые обогнали среднее по своему каналу за последний месяц» — это один вызов vidiq_outliers вместо получаса в интерфейсе.
Разбор конкурента. vidiq_channel_stats + vidiq_channel_videos + vidiq_video_transcript — и агент сам сводит, о чём канал говорит и что у него зашло.
Проверка гипотезы до съёмки. vidiq_score_title и vidiq_score_thumbnail дают оценку 0–100 с разбором до того, как вы что-то сняли.

Если вы вообще первый раз подключаете MCP, сначала прочитайте общую инструкцию по подключению MCP к Claude Code — здесь дальше только специфика vidIQ.

Готовый пример целиком

Вариант через CLI, чтобы сервер был доступен во всех проектах:

claude mcp add --transport http vidiq --scope user https://mcp.vidiq.com/mcp
claude
# в сессии:
/mcp
# выбрать vidiq → Authenticate → браузер → вход в vidIQ

Вариант через файл, если хотите положить конфиг в репозиторий команды — .mcp.json в корне проекта:

{
  "mcpServers": {
    "vidiq": {
      "type": "http",
      "url": "https://mcp.vidiq.com/mcp"
    }
  }
}

Первый же запрос после подключения — бесплатный:

Покажи, каким аккаунтом vidIQ я подключён и какие каналы там авторизованы

Агент вызовет vidiq_user_channels (0 кредитов). Пустой список каналов — не ошибка сервера, а почти всегда признак того, что вы авторизовались не тем аккаунтом.

Разбор по частям

--transport http — это тот самый транспорт, который в спецификации MCP называется streamable-http. В JSON-конфигах Claude Code принимает оба написания в поле type. Здесь же лежит главная ловушка ручной правки: запись с url, но без type, Claude Code читает как stdio-сервер, пропускает его и пишет MCP server "vidiq" has a "url" but no "type"; add "type": "http". Если сервер не появился в /mcp — сначала проверьте это поле.

--scope. Без флага сервер пишется в ~/.claude.json для текущего проекта. --scope user делает его доступным во всех проектах на машине; --scope project создаёт .mcp.json, который коммитится, и тогда Claude Code при первом запуске спросит у каждого члена команды подтверждение (сбросить эти ответы — claude mcp reset-project-choices). Для vidIQ логичнее user: аккаунт личный, к репозиторию отношения не имеет.

Никаких заголовков и токенов. Здесь OAuth, поэтому --header "Authorization: Bearer ..." не нужен и в конфиг не попадает ничего секретного. Это редкий случай, когда .mcp.json можно коммитить без опаски.

Сколько это стоит в кредитах. Каждый инструмент объявляет цену прямо в своём описании — вот что показывает подключённый сервер на 28 июля 2026:

Инструмент	Кредитов	Что возвращает
`vidiq_balance`	0	Остаток кредитов: возобновляемые + бонусные, дата обновления
`vidiq_user_channels`	0	`authenticatedAs` (почта) и список авторизованных каналов
`vidiq_outliers`	5	Видео, обогнавшие средние показатели своего канала, с breakout score
`vidiq_keyword_research`	5	Volume, competition, overall score (0–100), оценка месячного объёма, топ-страны
`vidiq_channel_stats`	5	Подписчики, просмотры, число видео, рост за период, страна, язык, дата создания
`vidiq_video_transcript`	5	Полный текст субтитров видео
`vidiq_score_thumbnail`	5	Оценка превью 0–100 с разбором сильных мест и правок
`vidiq_video_watch`	25	Асинхронный посценный разбор длинного видео с таймкодами
`vidiq_generate_video`	зависит	Секунды × ставка модели × 20; цена сообщается в момент отправки

Заметное расхождение: справка vidIQ утверждает, что Video Watch стоит 10 кредитов, а сам сервер в описании инструмента объявляет 25. Верить стоит серверу — списывать будет он. Так же расходятся данные о тарифе: лендинг vidiq.com/mcp пишет «available on the Max plan», а справочная статья — что на период запуска MCP доступен на всех планах, включая Free. Проверяйте на своём аккаунте вызовом vidiq_balance, а не по лендингу.

Что именно отдаёт vidiq_outliers — по нему приходит отдельный поток вопросов. На вход: keyword и/или channelIds (принимает и UC…, и @handle, и URL канала), плюс фильтры minViews/maxViews, minSubscribers/maxSubscribers, minOutlierScore, minVph, contentType (long/short/all), publishedWithin, limit до 100. На выход — список видео с breakout score: насколько ролик превысил обычные показатели своего же канала.

И главная деталь для тех, кто работает с русским YouTube: параметр language по умолчанию равен en, и поиск идёт только по английским заголовкам. Если не передать language: "ru" явно, вы просто не увидите русских видео и решите, что в нише пусто. Плюс для неанглийских языков окно publishedWithin упирается в threeMonths — allTime работает только для английского.

Чего в него класть не надо

Не гоняйте vidiq_video_watch там, где хватает транскрипта. 25 кредитов против 5. Посценный разбор нужен, когда важна картинка — монтаж, врезки, что показано в первые три секунды. Если вопрос «о чём говорят» — берите vidiq_video_transcript.

Не оставляйте агента в цикле без потолка. Формулировка «проанализируй топ-100 конкурентов» превращается в сотню вызовов по 5 кредитов и съедает месячный лимит Free-тарифа за один заход. Ставьте limit явно и просите агент сначала показать план вызовов.

Не считайте «read-only» синонимом «безопасно». vidIQ действительно не может опубликовать видео или поменять настройки вашего канала — но генеративная половина сервера (vidiq_generate_video, vidiq_generate_clips, vidiq_generate_music, vidiq_voiceover_clone) создаёт файлы и списывает кредиты пачками. У vidiq_generate_video цена вообще плавающая: длительность × ставка модели × 20.

Не тащите этот сервер в проект, где он не нужен. Пятьдесят два описания инструментов постоянно висят в контексте агента и отъедают его на каждом сообщении. Если vidIQ нужен раз в неделю — держите его в отдельном рабочем каталоге, а не в --scope user.

Российский контекст. Оплата vidIQ идёт зарубежной картой — это единственный реальный барьер, сам сервер по протоколу ничем не отличается от любого другого. Free-тарифа с его 150 кредитами хватает примерно на 30 обычных вызовов в месяц: попробовать — да, работать — нет. И помните, что запросы уходят на серверы vidIQ вместе с почтой аккаунта и идентификаторами каналов.

Как поддерживать в актуальном виде

Роспись инструментов у vidIQ меняется: лендинг обещает «44 основных инструмента и 6 бесплатных утилит», подключённый сервер на 28 июля 2026 отдаёт 52. Ничего страшного в этом нет — обновлять конфиг не нужно, список тянется с сервера при каждом подключении. Практика такая:

Раз в пару недель запускайте /mcp и смотрите список инструментов — новые появляются без вашего участия.
Перед дорогой серией запросов вызывайте vidiq_balance (0 кредитов) — он показывает, сколько осталось в возобновляемом пуле и когда он обновится.
Если сервер вдруг показывает failed, первым делом переавторизуйтесь через /mcp: OAuth-токен истекает, и это выглядит как «сломался сервер».
Отозвать доступ можно в любой момент: app.vidiq.com → Account Settings → MCP. Из Claude Code — claude mcp remove vidiq.

Карточки инструмента с текущими фактами — в арсенале MCP и в бизнес-разделе; соседние серверы, которые ставят вместе с этим, собраны в подборке MCP-серверов.

Частые вопросы

Работает ли vidIQ MCP в Claude Code, или только в claude.ai?

Работает и там, и там — сервер один и тот же. В веб-версии его добавляют через Settings → Connectors → Add custom connector и вставляют https://mcp.vidiq.com/mcp. В Claude Code — командой claude mcp add --transport http. Тем же URL подключаются Cursor, Codex и любой другой MCP-клиент; разница только в том, где нажимать.

Какие данные передаёт `vidiq_outliers`?

Список видео с оценкой breakout score — насколько ролик превысил среднюю планку собственного канала, — плюс просмотры, просмотры в час, подписчики канала и дату публикации. Фильтровать можно по ключу, конкретным каналам, диапазонам просмотров и подписчиков, типу контента (long/short) и окну публикации. Ключевое: параметр language по умолчанию en, для русских роликов его надо передавать явно.

Обязательна ли платная подписка?

Нет, но Free-тариф упирается в 150 кредитов в месяц. Большинство вызовов стоят 5 кредитов, значит это порядка тридцати запросов — на разведку одной ниши хватит, на регулярную работу нет. Boost даёт 2 000 кредитов в месяц, Max — 6 000 и стоит $39 в месяц (на июль 2026, по официальной странице тарифов). Кредиты общие с обычным интерфейсом vidIQ: то, что вы потратили в веб-приложении, уменьшает лимит MCP.

Сервер добавился, но не появился в `/mcp` — что смотреть?

Если правили JSON руками — проверьте поле type. Запись с url, но без type, Claude Code трактует как stdio-сервер и молча пропускает, выдавая ошибку про отсутствующий type. Если конфиг в .mcp.json из репозитория, сервер может ждать вашего подтверждения — Claude Code спрашивает разрешение на project-scoped серверы; сбросить прошлые ответы можно командой claude mcp reset-project-choices.

Может ли агент что-то сломать в моём канале?

Опубликовать видео, изменить настройки или удалить что-либо через этот сервер нельзя — доступ к YouTube-каналу только на чтение. Но списывать кредиты и генерировать медиафайлы он может свободно, поэтому единственный реальный риск — израсходованный лимит. Права отзываются в один клик на app.vidiq.com в разделе Account Settings → MCP.

Источники: страница vidIQ MCP · справка vidIQ по MCP · тарифы vidIQ · документация Claude Code по MCP

Базовый разбор темы — Claude Code: с него удобно начать, если тема новая.