Kinescope MCP Server

Kinescope MCP Server — это сервер, реализующий протокол Model Context Protocol (MCP), который позволяет AI-ассистентам взаимодействовать с платформой Kinescope через естественные языковые запросы. Вы можете управлять видео, получать аналитику, настраивать проекты и работать с контентом, просто общаясь с AI-ассистентом.

Кому подходит этот раздел

• Менеджерам проектов — управляйте видеоконтентом через AI-ассистент, автоматизируйте рутинные задачи
• Маркетологам — быстро анализируйте эффективность видео, создавайте отчёты и управляйте контентом
• Разработчикам — интегрируйте возможности Kinescope в AI-приложения через стандартизованный протокол
• Контент-менеджерам — организуйте видеотеку, обновляйте метаданные и получайте аналитику в диалоговом режиме

С чего начать

Шаг 1: Выберите платформу

Вариант 1: Cursor (рекомендуем для разработчиков)

• Встроенная поддержка MCP
• Простая настройка через JSON
• Интеграция с кодом

Вариант 2: Claude Desktop (рекомендуем для общего использования)

• Официальный AI-ассистент от Anthropic
• Быстрая установка через терминал
• Полная поддержка MCP из коробки

Вариант 3: Claude Code (для разработчиков с Claude)

• IDE с встроенным Claude
• Настройка через JSON конфигурацию
• Интеграция с кодом

Вариант 4: Qwen3 (десктопное приложение, для пользователей из РФ)

• Десктопное приложение с поддержкой MCP
• Настройка через JSON конфигурацию
• Бесплатное использование
• Доступно без VPN для пользователей из РФ

Шаг 2: Подготовка

1. Создайте аккаунт в Kinescope — рекомендуем тариф Супер или выше
2. Получите API ключ:
   • Откройте настройки аккаунта Kinescope
   • Перейдите в раздел “API”
   • Создайте новый API ключ или скопируйте существующий
3. Загрузите несколько видео для тестирования

Если вы уже работаете с Kinescope

1. Получите API ключ (см. выше)
2. Выберите подходящую платформу (Cursor, Claude или Qwen3)
3. Настройте подключение (см. раздел ниже)
4. Ознакомьтесь с примерами запросов для автоматизации ваших задач

Что можно делать через MCP Server

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

• Поиск видео по названию, описанию, тегам
• Просмотр информации о видео, субтитрах, главах, постерах
• Редактирование метаданных: названия, описания, теги
• Копирование и перемещение видео между проектами
• Управление настройками приватности

Работа с проектами и структурой

• Создание и управление проектами
• Организация видео по папкам
• Создание плейлистов и добавление видео
• Просмотр списка проектов и их структуры

Аналитика и статистика

• Получение метрик просмотров
• Анализ вовлечённости аудитории
• Географическое распределение зрителей
• Кастомные аналитические запросы
• Обзорная статистика по видео

Субтитры и главы

• Добавление файлов субтитров
• Управление языками субтитров
• Получение содержимого субтитров
• Обновление глав с временными метками

Прямые трансляции

• Создание событий для трансляций
• Управление настройками стримов
• Планирование трансляций
• Настройка рестриминга
• Получение записей трансляций

Дополнительные возможности

• Управление постерами и превью
• Добавление дополнительных материалов к видео
• Создание запросов на загрузку файлов
• Управление комнатами Speak
• Просмотр статистики использования и биллинга

Настройка подключения к MCP Server

Получение API токена Kinescope

Перед настройкой получите API токен:

1. Откройте app.kinescope.io/workspace/api_token
2. Перейдите в раздел «API токены»
3. Нажмите «Создать API токен»
4. Укажите имя токена (например, «cursor mcp» или «qwen mcp»)
5. Выберите права доступа (только чтение или более широкие в зависимости от ваших задач)
6. Сохраните токен в безопасном месте

Вариант 1: Настройка в Cursor

Шаг 1. Установка Cursor

1. Скачайте Cursor
2. Установите IDE на ваш компьютер
3. Откройте Cursor

Шаг 2. Настройка MCP Server

1. Откройте файл конфигурации MCP:

   • macOS/Linux: ~/.cursor/mcp.json
   • Windows: %APPDATA%\Cursor\mcp.json

2. Добавьте конфигурацию Kinescope:

{
  "mcpServers": {
    "Kinescope MCP": {
      "type": "streamable-http",
      "url": "https://api.kinescope.io/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_API_ТОКЕН"
      }
    }
  }
}

3. Замените ВАШ_API_ТОКЕН на ваш реальный API токен Kinescope
4. Сохраните файл
5. Перезапустите Cursor

Шаг 3. Проверка подключения

1. Откройте AI-чат в Cursor (Cmd/Ctrl+L)
2. Напишите: «Покажи мои проекты в Kinescope»
3. Если всё настроено правильно, вы увидите список проектов

Если подключение не работает:

• Проверьте, что API токен указан правильно (без лишних пробелов)
• Убедитесь, что в заголовке Authorization указано Bearer ВАШ_API_ТОКЕН
• Перезапустите Cursor после изменения конфигурации
• Проверьте логи в Developer Tools (Cmd/Ctrl+Shift+I)

Вариант 2: Настройка в Claude Desktop

Шаг 1. Установка Claude Desktop

1. Скачайте Claude Desktop для вашей платформы
2. Установите приложение на ваш компьютер
3. Пройдите авторизацию или зарегистрируйтесь
4. Откройте приложение Claude Desktop

Шаг 2. Установка MCP Server через терминал

1. Откройте терминал (Terminal на macOS/Linux или PowerShell на Windows)
2. Выполните команду установки:

npx -y @smithery/cli@latest install kinescope/kinescope-mcp --client claude

3. Следуйте инструкциям установщика
4. Когда будет запрошен API ключ, введите ваш токен Kinescope

Шаг 3. Перезапуск приложения

1. Закройте Claude Desktop полностью
2. Откройте приложение снова
3. MCP Server должен быть автоматически подключен

Шаг 4. Проверка подключения

1. Откройте чат в Claude Desktop
2. Напишите: «Покажи мои проекты в Kinescope»
3. Если всё настроено правильно, вы увидите список проектов

Если подключение не работает:

• Проверьте, что установка завершилась успешно (без ошибок в терминале)
• Проверьте API ключ в конфигурации Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
• Перезапустите Claude Desktop
• Попробуйте переустановить сервер командой выше

Вариант 3: Настройка в Claude Code

Шаг 1. Установка Claude Code

1. Скачайте Claude Code для вашей платформы
2. Установите IDE на ваш компьютер
3. Откройте Claude Code

Шаг 2. Настройка MCP Server

1. Откройте файл конфигурации MCP:

   • macOS/Linux: ~/.claude-code/mcp.json
   • Windows: %APPDATA%\Claude Code\mcp.json

2. Добавьте конфигурацию Kinescope:

{
  "mcpServers": {
    "Kinescope MCP": {
      "type": "streamable-http",
      "url": "https://api.kinescope.io/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_API_ТОКЕН"
      }
    }
  }
}

3. Замените ВАШ_API_ТОКЕН на ваш реальный API токен Kinescope
4. Сохраните файл
5. Перезапустите Claude Code

Шаг 3. Проверка подключения

1. Откройте AI-чат в Claude Code
2. Напишите: «Покажи мои проекты в Kinescope»
3. Если всё настроено правильно, вы увидите список проектов

Если подключение не работает:

• Проверьте, что API токен указан правильно (без лишних пробелов)
• Убедитесь, что в заголовке Authorization указано Bearer ВАШ_API_ТОКЕН
• Убедитесь, что JSON конфигурация корректна (проверьте кавычки, запятые)
• Перезапустите Claude Code после изменения конфигурации
• Проверьте логи в Developer Tools

Вариант 4: Настройка в Qwen3 (десктопное приложение)

Шаг 1. Установка Qwen3

1. Скачайте последнюю версию десктопного приложения Qwen3 с сайта qwen.ai/download
2. Установите приложение на ваш компьютер
3. Пройдите регистрацию
4. Откройте приложение Qwen3

Шаг 2. Настройка MCP Server

1. Кликните на аватар в левом нижнем углу
2. Выберите Настройки → MCP (слева в меню) → вкладка «Мой MCP»
3. Нажмите кнопку + Добавить MCP и выберите вариант «Добавить с использованием JSON»
4. Вставьте следующую конфигурацию в поле редактора:

{
  "mcpServers": {
    "Kinescope MCP": {
      "type": "streamable-http",
      "url": "https://api.kinescope.io/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_API_ТОКЕН"
      }
    }
  }
}

5. Замените ВАШ_API_ТОКЕН на ваш реальный API токен Kinescope
6. Нажмите кнопку «Сохранить и включить»
7. Убедитесь, что Kinescope MCP активен (зеленый индикатор)
8. При необходимости перезагрузите приложение Qwen3

Шаг 3. Проверка подключения

1. Откройте новый чат в Qwen3
2. Важно: Предварительно кликните на кнопку MCP, чтобы агент понимал, что нужно использовать сервер
3. Убедитесь, что сервер активен (зеленый статус)
4. Напишите: «Покажи список моих проектов в Kinescope»
5. Qwen3 должен вернуть список ваших проектов

Если возникли проблемы:

• Проверьте правильность API токена
• Проверьте синтаксис JSON конфигурации (правильность кавычек, запятых)
• Убедитесь, что Kinescope MCP активирован (зеленый индикатор)
• Убедитесь, что в новом чате активирована кнопка MCPц
• Перезапустите приложение Qwen3
• Проверьте интернет-соединение

Требования для всех платформ

Системные требования:

• Интернет: стабильное подключение
• API ключ Kinescope: обязателен для работы

Примеры использования

Поиск и управление видео

Простой поиск:

Найди все видео с тегом «tutorial» за последний квартал

Просмотр информации:

Покажи информацию о видео с ID fb6ee692-c7bc-475c-a0ef-6eaba6574766

Редактирование метаданных:

Обнови название видео fb6ee692-c7bc-475c-a0ef-6eaba6574766 на «MCP Integration Demo» 
и добавь описание «Демонстрация работы с Kinescope через Model Context Protocol»

Аналитика видео

Общая статистика:

Покажи статистику просмотров для всех видео в проекте «Маркетинг» за последний месяц

Детальный анализ:

Какие страны чаще всего смотрят наши демо-видео?

Анализ вовлечённости:

Покажи retention rate для обучающих видео и определи, какие из них работают хуже всего

Организация контента

Создание структуры:

Создай новый проект «Маркетинговые видео 2026» с приватными настройками доступа

Работа с плейлистами:

Добавь все видео с тегом «onboarding» в плейлист «Обучение новых сотрудников»

Управление папками:

Покажи список всех моих проектов и укажи, в каких больше всего видео

Работа с субтитрами и главами

Субтитры:

Получи полный текст субтитров с таймкодами из видео «Презентация продукта»

Главы:

Добавь главы к видео: в 5:30 — «Обзор API», в 12:15 — «Обсуждение тарифов»

Прямые трансляции

Создание события:

Создай событие для прямой трансляции «Запуск продукта Q4» на следующую неделю

Управление трансляциями:

Покажи все активные трансляции в моём аккаунте

Рестриминг:

Включи рестриминг для события «Серия вебинаров» на YouTube и Twitch

Работа с билингом

Использование ресурсов:

Покажи статистику использования хранилища за последние 3 месяца

Анализ по проектам:

Какой проект потребляет больше всего трафика в этом месяце?

Продвинутые сценарии использования

Создание квартального отчёта по видеоаналитике

Шаг 1. Сбор данных из Google Drive:

Получи мою таблицу с OKR за Q3 по метрикам видеоплатформы из Google Drive

Шаг 2. Анализ видео в Kinescope:

Найди все видео с тегами «tutorial» или «demo» за последний квартал и получи их аналитику

Шаг 3. Детальная статистика:

Покажи retention rate и географическое распределение для каждого видео

Шаг 4. Сравнение с целями:

Сравни метрики вовлечённости с целевыми KPI из моей таблицы

Шаг 5. Выявление проблем:

Какой контент показывает результаты ниже нашей цели в 80% retention?

Шаг 6. Создание отчёта:

Создай документ Google Doc с отчётом, который объединяет данные по видео и прогресс по OKR

Шаг 7. Рекомендации:

Добавь рекомендации по контенту, требующему переработки, на основе точек оттока зрителей

Шаг 8. План действий:

На основе видео с completion rate меньше 50% и нашего календаря контента на Q4, 
какие видео нужно обновить в первую очередь?

Аудит контента и оптимизация

Поиск неоптимизированного контента:

Найди все видео без описаний, глав или с устаревшими тегами

Массовое обновление:

Создай таблицу для отслеживания видео, которым нужны новые главы, 
улучшенные описания или перезапись

Управление правами доступа

Обновление приватности:

Обнови настройки приватности для нашей внутренней демонстрации, 
чтобы доступ был только с корпоративных доменов

Аудит доступа:

Покажи все видео с публичным доступом в проекте «Внутреннее обучение»

Управление доступом команды

Участники вашей команды получают доступ к MCP Server в соответствии с правами доступа к проектам в Kinescope.

Настройка прав:

Для Cursor:

1. Каждый разработчик создаёт свой API токен в Kinescope
2. Каждый настраивает MCP Server в своём файле конфигурации со своим токеном
3. Права доступа определяются аккаунтом Kinescope
4. Каждый видит только свои проекты

Для Claude Desktop:

1. Каждый участник создаёт свой API токен
2. Устанавливает MCP Server через терминал со своим токеном
3. Права доступа определяются аккаунтом Kinescope
4. Каждый видит только свои проекты

Для Claude Code:

1. Каждый разработчик создаёт свой API токен в Kinescope
2. Каждый настраивает MCP Server в своём файле конфигурации со своим токеном
3. Права доступа определяются аккаунтом Kinescope
4. Каждый видит только свои проекты

Для Qwen3:

1. Каждый участник создаёт свой API токен
2. Каждый настраивает свою конфигурацию с личным токеном
3. Используйте корпоративные аккаунты для управления доступом
4. Права наследуются из Kinescope

Безопасность API токенов:

• Не делитесь API токенами с коллегами
• Не храните токены в публичных репозиториях
• Каждый сотрудник использует свой токен
• Регулярно обновляйте токены
• Удаляйте токены уволенных сотрудников

Ограничения и особенности

Что недоступно в MCP Server

• Удаление данных — видео, проекты, плейлисты нельзя удалить через MCP Server из соображений безопасности
• Изменение настроек аккаунта — управление тарифом, платёжными данными доступно только в веб-интерфейсе
• Загрузка файлов — прямая загрузка видеофайлов через MCP пока недоступна (используйте веб-интерфейс или API)

Ограничения по тарифам

• Rate limits — количество запросов к API зависит от вашего тарифа Kinescope
• Объём данных — на более высоких тарифах доступны расширенные возможности аналитики
• Функции — некоторые продвинутые функции доступны на тарифах Business и выше

Рекомендуем использовать тариф Супер или выше для полного доступа к возможностям MCP Server.

Безопасность и лучшие практики

Безопасность данных

• Аутентификация — все запросы проходят через защищённое соединение
• Разграничение прав — доступ ограничен правами вашего аккаунта и проектов
• Логирование — все действия через MCP Server записываются в логи аккаунта
• Шифрование — данные передаются по протоколу HTTPS

Рекомендации по использованию

1. Используйте конкретные запросы — чем точнее формулировка, тем лучше результат
2. Проверяйте ID видео — при редактировании убедитесь, что работаете с нужным видео
3. Начинайте с просмотра — перед изменениями сначала получите текущую информацию
4. Тестируйте на копиях — для сложных операций создайте тестовые видео
5. Сохраняйте резервные копии метаданных — перед массовыми изменениями экспортируйте данные

Решение проблем

MCP Server не отвечает

Возможные причины:

• Неправильно указан API токен
• Проблемы с сетевым подключением
• Ошибка в JSON конфигурации

Решение:

Для Cursor:

1. Проверьте API токен в ~/.cursor/mcp.json (macOS/Linux) или %APPDATA%\Cursor\mcp.json (Windows)
2. Проверьте логи в Developer Tools (Cmd/Ctrl+Shift+I)
3. Перезапустите Cursor

Для Claude Desktop:

1. Проверьте API токен в конфигурации:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Попробуйте переустановить сервер: npx -y @smithery/cli@latest install kinescope/kinescope-mcp --client claude
3. Перезапустите Claude Desktop

Для Claude Code:

1. Проверьте API токен в ~/.claude-code/mcp.json (macOS/Linux) или %APPDATA%\Claude Code\mcp.json (Windows)
2. Проверьте синтаксис JSON конфигурации
3. Проверьте логи в Developer Tools
4. Перезапустите Claude Code

Для Qwen3:

1. Проверьте API токен в настройках MCP приложения
2. Проверьте синтаксис JSON конфигурации (правильность кавычек, запятых)
3. Убедитесь, что Kinescope MCP активирован (зеленый индикатор)
4. Убедитесь, что в чате активирована кнопка MCP
5. Перезапустите приложение Qwen3

Для всех платформ:

• Проверьте интернет-соединение
• Убедитесь, что API токен активен в настройках Kinescope
• Попробуйте создать новый API токен
• Обратитесь в поддержку

Ошибки авторизации

Возможные причины:

• Неправильный API токен
• API токен был удалён или деактивирован
• Недостаточно прав доступа
• Аккаунт заблокирован или приостановлен

Решение:

1. Проверьте API токен в настройках Kinescope
2. Убедитесь, что токен активен и не удалён
3. Создайте новый API токен, если старый не работает
4. Обновите API токен в конфигурации:
   • Cursor: ~/.cursor/mcp.json (macOS/Linux) или %APPDATA%\Cursor\mcp.json (Windows)
   • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows)
   • Claude Code: ~/.claude-code/mcp.json (macOS/Linux) или %APPDATA%\Claude Code\mcp.json (Windows)
   • Qwen3: Настройки → MCP → «Мой MCP»
5. Перезапустите приложение
6. Свяжитесь с поддержкой

Медленные ответы

Возможные причины:

• Высокая нагрузка на сервер
• Сложный запрос требует обработки большого объёма данных
• Достигнут rate limit

Решение:

1. Упростите запрос — разбейте на несколько меньших
2. Используйте фильтры для сужения выборки
3. Подождите несколько секунд перед повторной попыткой
4. Рассмотрите переход на более высокий тариф

Неожиданные результаты

Возможные причины:

• Неточная формулировка запроса
• AI-ассистент неправильно интерпретировал запрос
• Данные изменились с момента последнего запроса

Решение:

1. Переформулируйте запрос более конкретно
2. Укажите точные ID объектов (видео, проектов)
3. Используйте примеры из документации
4. Проверьте актуальность данных в веб-интерфейсе

Сравнение с другими способами работы

Что дальше?

Дополнительные ресурсы

1. API Reference — полная документация по API Kinescope, которые использует MCP Server
2. Документация MCP — официальная документация Model Context Protocol от Anthropic
3. GitHub репозиторий — актуальная техническая документация и примеры

Связанные разделы

1. Инструкции для разработчиков — работа с API и SDK для глубокой интеграции
2. Аналитика — подробнее о метриках и отчётах
3. Интеграции — другие способы интеграции Kinescope
4. Управление видео — организация и управление видеотекой

Нужна помощь?

• Telegram поддержка — быстрые ответы от специалистов
• Сайт Kinescope — форма обратной связи
• База знаний — инструкции и руководства

Остались вопросы? Напишите в чат поддержки — специалисты помогут!