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

Ответы на популярные вопросы о работе с Kinescope MCP Server.

Общие вопросы

Что такое MCP и зачем он нужен?

Model Context Protocol (MCP) — это открытый стандарт, разработанный Anthropic, который позволяет AI-ассистентам безопасно взаимодействовать с внешними сервисами и данными.

Зачем нужен MCP для Kinescope:

• Управляйте видео через естественный язык
• Автоматизируйте рутинные задачи
• Быстро создавайте отчёты и анализируйте данные
• Интегрируйте Kinescope с другими инструментами через AI

Какие платформы поддерживают MCP?

Kinescope MCP Server работает с любыми платформами, поддерживающими протокол MCP. Мы рекомендуем четыре варианта:

1. Cursor (для разработчиков)

• Встроенная поддержка MCP
• Интеграция с кодом
• Настройка через JSON конфигурацию
• Платная IDE (~$20/мес)
• Доступен глобально
• Требует: API токен Kinescope

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

• Официальный AI-ассистент от Anthropic
• Быстрая установка через терминал
• Полная поддержка MCP из коробки
• Платная подписка (~$20/мес)
• Доступен глобально
• Требует: API токен Kinescope

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

• IDE с встроенным Claude
• Настройка через JSON конфигурацию
• Интеграция с кодом
• Платная IDE (~$20/мес)
• Доступен глобально
• Требует: API токен Kinescope

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

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

Рекомендации:

• Разработчикам — Cursor или Claude Code (интеграция с кодом)
• Для общего использования — Claude Desktop (официальный AI-ассистент)
• Пользователям из РФ — Qwen3 (бесплатно, без VPN)
• Остальным — любая из вышеперечисленных платформ

Актуальный список всех MCP-клиентов см. в документации MCP.

Нужно ли платить за использование MCP?

За Kinescope MCP Server:

• Сам MCP Server предоставляется бесплатно
• Действуют стандартные лимиты вашего тарифа Kinescope
• Рекомендуем тариф Business или выше для полного доступа

За платформу:

Дополнительные требования:

• API токен Kinescope — бесплатно (входит в тариф)

Безопасно ли использовать MCP?

Да, безопасно:

• Все данные передаются по защищённому HTTPS-соединению
• Действуют права доступа вашего аккаунта Kinescope
• Операции удаления отключены для безопасности
• Все действия логируются

Рекомендации по безопасности:

• Не делитесь настройками подключения с посторонними
• Используйте сложные пароли для аккаунтов
• Регулярно проверяйте логи активности

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

Как настроить подключение к MCP Server?

Шаг 1: Получите API токен

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

Шаг 2: Настройте платформу

Для Cursor:

1. Откройте файл ~/.cursor/mcp.json (macOS/Linux) или %APPDATA%\Cursor\mcp.json (Windows)
2. Добавьте конфигурацию:

{
  "mcpServers": {
    "kinescope": {
      "command": "npx",
      "args": ["-y", "@kinescope/mcp@latest", "--client=cursor"],
      "env": {
        "KINESCOPE_API_KEY": "ВАШ_API_ТОКЕН"
      }
    }
  }
}

3. Перезапустите Cursor

Для Claude Desktop:

1. Скачайте Claude Desktop для вашей платформы
2. Установите приложение и пройдите авторизацию
3. Откройте терминал (Terminal на macOS/Linux или PowerShell на Windows)
4. Выполните команду установки:

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

5. Следуйте инструкциям установщика и введите ваш API токен Kinescope
6. Перезапустите Claude Desktop

Для Claude Code:

1. Откройте файл ~/.claude-code/mcp.json (macOS/Linux) или %APPDATA%\Claude Code\mcp.json (Windows)
2. Добавьте конфигурацию:

{
  "mcpServers": {
    "kinescope": {
      "command": "npx",
      "args": ["-y", "@kinescope/mcp@latest", "--client=claude-code"],
      "env": {
        "KINESCOPE_API_KEY": "ВАШ_API_ТОКЕН"
      }
    }
  }
}

3. Перезапустите Claude Code

Для Qwen3 (десктопное приложение):

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

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

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

Подробные инструкции:

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

Можно ли использовать веб-версии AI-ассистентов?

Нет, веб-версии не поддерживаются.

Почему:

• Kinescope MCP Server требует указания API токена в конфигурации
• Веб-версии (qwen.chat и др.) не позволяют указывать API токены
• Это ограничение безопасности самих веб-платформ

Что использовать вместо:

• Cursor — IDE для разработчиков
• Claude Desktop — официальный AI-ассистент от Anthropic
• Claude Code — IDE с встроенным Claude
• Qwen3 — десктопное приложение (бесплатно, доступно без VPN для пользователей из РФ)

Как начать:

1. Скачайте Cursor, Claude Desktop, Claude Code или Qwen3 (десктопное приложение)
2. Получите API токен в Kinescope
3. Настройте подключение через JSON конфигурацию
4. Начните работать

Подробные инструкции: Настройка подключения

Можно ли использовать бесплатные варианты?

Да, есть бесплатные опции:

Бесплатные варианты:

Дополнительные требования (бесплатно):

• API токен Kinescope — бесплатно (входит в тариф)

Рекомендации:

• Для разработки — Cursor Trial или Claude Code Trial, затем платная подписка
• Для общего использования — Claude Desktop
• Для постоянной работы — Cursor, Claude Desktop или Claude Code
• Для пользователей из РФ — Qwen3 (бесплатно, без VPN)

Почему MCP Server не отвечает?

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

1. Неправильно указан API ключ
2. Проблемы с сетевым подключением
3. Ошибка в 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. Проверьте, что MCP Server активирован (зеленый индикатор)
3. Проверьте синтаксис JSON конфигурации
4. Перезапустите приложение Qwen3

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

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

Можно ли использовать несколько аккаунтов Kinescope?

Да, можно настроить несколько подключений:

В Cursor или Claude Code:

• Добавьте несколько серверов в конфигурацию MCP
• Дайте разные имена: kinescope-work, kinescope-personal

В Claude Desktop:

• Установите несколько серверов через Smithery CLI с разными именами
• Настройте конфигурацию вручную для каждого аккаунта

В Qwen3:

• Добавьте несколько серверов в настройках MCP
• Назовите их понятно: «Kinescope Работа», «Kinescope Личное»

Переключение между аккаунтами:

В запросе указывайте, какой аккаунт использовать, или переключайте активный сервер в настройках.

Как переключаться между проектами?

MCP Server автоматически работает со всеми проектами, к которым у вас есть доступ. Просто указывайте название проекта в запросе:

Покажи видео из проекта «Маркетинг»

Работа с данными

Какие данные доступны через MCP?

Доступно:

• Информация о видео (метаданные, статус)
• Аналитика просмотров
• Проекты и папки
• Плейлисты
• Субтитры и главы
• Трансляции и записи
• Статистика биллинга

Недоступно:

• Удаление данных
• Настройки аккаунта
• Платёжная информация
• Прямая загрузка видеофайлов

Можно ли редактировать видео через MCP?

Вы можете редактировать метаданные видео:

• Название и описание
• Теги
• Настройки приватности
• Главы
• Субтитры

Нельзя редактировать:

• Сам видеофайл
• Обрезать или монтировать видео
• Изменять кодировку

Для редактирования файлов используйте веб-интерфейс или специализированные инструменты.

Как часто обновляются данные?

Данные обновляются в реальном времени. Когда вы делаете запрос через MCP Server, вы получаете актуальную информацию из вашего аккаунта Kinescope.

Обратите внимание:

• Аналитика может обновляться с небольшой задержкой (до 5 минут)
• Обработка новых видео занимает время

Можно ли скачать видео через MCP?

Нет, прямое скачивание видеофайлов через MCP недоступно.

Что можно:

• Получить ссылки на видео
• Экспортировать метаданные
• Получить ссылки на субтитры и дополнительные материалы

Для скачивания используйте веб-интерфейс Kinescope.

Аналитика и отчёты

Какие метрики доступны через MCP?

Базовые метрики:

• Количество просмотров
• Уникальные зрители
• Время просмотра
• Completion rate (процент досмотра)

Продвинутые метрики:

• Retention rate (удержание аудитории)
• География просмотров
• Устройства и браузеры
• Точки оттока зрителей

Биллинг:

• Использование трафика
• Использование хранилища
• Статистика по проектам

Доступность метрик зависит от вашего тарифа Kinescope.

Можно ли экспортировать данные?

Да, вы можете попросить AI экспортировать данные:

Экспортируй статистику всех видео за месяц в Google Sheets

Создай CSV-файл со списком всех видео и их метаданными

AI-ассистент может создавать:

• Таблицы Google Sheets
• Документы Google Docs
• CSV-файлы
• Презентации

Как создать квартальный отчёт?

Используйте пошаговый подход:

1. Соберите данные:

Покажи статистику просмотров за Q4 2025

2. Проанализируйте:

Какие 10 видео были самыми популярными?
Какие видео имеют низкую досмотрел?

3. Создайте документ:

Создай Google Презентацию с этими данными и выводами

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

Ограничения и производительность

Есть ли лимиты на количество запросов?

Да, действуют стандартные rate limits API Kinescope:

• Business тариф: до 100 запросов в минуту
• Enterprise тариф: до 500 запросов в минуту

При превышении лимита вы получите ошибку с предложением повторить запрос через несколько секунд.

Рекомендации:

• Формулируйте запросы точно, чтобы получить нужный результат с первого раза
• Для массовых операций делайте паузы между запросами
• Рассмотрите переход на более высокий тариф

Почему MCP работает медленно?

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

1. Большой объём данных — запрос обрабатывает много видео
2. Сложная аналитика — вычисление метрик требует времени
3. Нагрузка на сервер — высокая загрузка в данный момент
4. Rate limiting — достигнут лимит запросов

Решение:

• Уточните запрос, добавьте фильтры
• Разбейте на несколько меньших запросов
• Подождите несколько секунд
• Используйте более высокий тариф

Можно ли использовать MCP для массовых операций?

Да, но с ограничениями:

Что можно:

• Обновление метаданных нескольких видео
• Массовое добавление тегов
• Перемещение видео между проектами
• Создание отчётов по большому количеству видео

Ограничения:

• Соблюдайте rate limits
• Для операций с тысячами видео используйте прямое API
• Операции удаления недоступны

Какой тариф Kinescope нужен для MCP?

Минимальный: любой тариф Kinescope

Рекомендуемый: Business или выше

Почему Business или выше:

• Более высокие rate limits (больше запросов)
• Доступ ко всем метрикам аналитики
• Продвинутые функции (DRM, SSO и др.)
• Приоритетная поддержка

Безопасность и права доступа

Кто может использовать мой MCP connector?

Только вы, если вы не поделились настройками подключения.

Для командной работы:

• Каждый член команды настраивает свой connector
• Права доступа определяются в Kinescope
• Участники видят только свои проекты

Что может делать AI с моими видео?

AI может делать только то, что разрешено вашими правами в Kinescope:

• Просматривать информацию
• Редактировать метаданные
• Создавать проекты и плейлисты
• Получать аналитику
• Не может удалять данные (отключено в MCP)
• Не может изменять настройки аккаунта
• Не может управлять платежами

Логируются ли действия через MCP?

Да, все действия через MCP Server записываются в логи вашего аккаунта Kinescope так же, как и действия через веб-интерфейс.

Что логируется:

• Просмотр информации
• Изменение метаданных
• Создание и изменение структуры
• Время и IP-адрес запроса

Можно ли отозвать доступ?

Да, просто удалите или отключите MCP сервер в настройках вашего AI-ассистента (Cursor или Qwen3). Сразу после этого доступ через MCP будет прекращён.

Интеграции

Можно ли интегрировать с Google Drive?

Да, AI-ассистенты могут работать одновременно с Kinescope MCP и другими сервисами:

Получи данные о видео из Kinescope и создай отчёт в Google Docs

Загрузи список видео из Google Sheets и обнови их метаданные в Kinescope

Работает ли MCP с другими платформами?

MCP Server позволяет AI-ассистенту работать с несколькими сервисами одновременно.

Примеры интеграций:

• Google Workspace (Docs, Sheets, Drive)
• Slack (уведомления и отчёты)
• Notion (документация)
• И другие сервисы, поддерживаемые вашим AI-ассистентом

Можно ли автоматизировать задачи?

Частично. AI-ассистенты с поддержкой MCP отлично подходят для:

• Создания регулярных отчётов
• Анализа данных по запросу
• Массового обновления метаданных

Для полной автоматизации (scheduled tasks, webhooks) используйте Kinescope API.

Troubleshooting

Получаю ошибку 401 (Unauthorized)

Причина: проблемы с авторизацией

Решение:

1. Проверьте, что вы авторизованы в Kinescope
2. Переподключите connector в Claude
3. Проверьте статус аккаунта Kinescope
4. Обратитесь в поддержку

Получаю ошибку 429 (Too Many Requests)

Причина: превышен rate limit

Решение:

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

AI не понимает мой запрос

Причина: запрос сформулирован неоднозначно

Решение:

1. Будьте конкретнее: указывайте ID, теги, даты
2. Разбейте сложный запрос на простые шаги
3. Используйте примеры из документации
4. Попробуйте переформулировать

Данные не обновляются

Причина: кеширование или задержка обработки

Решение:

1. Подождите 1-2 минуты
2. Сделайте запрос повторно
3. Проверьте данные в веб-интерфейсе
4. Обратитесь в поддержку, если проблема не решается

Что дальше?

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

1. Kinescope MCP Server — полное руководство
2. Примеры использования — готовые сценарии
3. API Documentation — техническая документация
4. MCP Protocol — официальная документация протокола

Не нашли ответ на свой вопрос?

• Telegram поддержка — быстрые ответы от специалистов
• Email — для детальных вопросов
• GitHub — техническая документация

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