# Exemplos de Uso do Kinescope MCP


Este artigo contém exemplos prontos de consultas e cenários de uso para o Kinescope MCP Server. Use-os como base para automatizar suas tarefas.

**Funciona com:** Cursor, Claude Desktop, Claude Code e Qwen3 (aplicativo desktop). Todos os exemplos são universais.

> **Информация:**

Sobre o Qwen3: o Qwen3 tem um aplicativo desktop que suporta MCP Server através de configuração JSON. O aplicativo está disponível gratuitamente.



## Para quem é este artigo

* **Gerentes de projeto** — templates prontos para gerenciar conteúdo de vídeo
* **Profissionais de marketing** — exemplos para criar relatórios e analisar desempenho
* **Gestores de conteúdo** — cenários para organizar sua biblioteca de vídeos
* **Analistas** — templates para trabalhar com métricas

## Por onde começar

### Escolha sua plataforma

Todos os exemplos funcionam de forma idêntica no **Cursor**, **Claude Desktop**, **Claude Code** e **Qwen3** (aplicativo desktop). Escolha uma plataforma e configure a conexão:

**Cursor (para desenvolvedores)**

* Configure o MCP Server através de configuração JSON
* Use o chat de IA (Cmd/Ctrl+L)
* [Instruções de configuração](https://docs-br.kinescope.com/kinescope-mcp/kinescope-mcp-server/#opção-1-configuração-no-cursor)

**Claude Desktop (recomendado para uso geral)**

* Assistente de IA oficial da Anthropic
* Instalação rápida via terminal
* [Instruções de configuração](https://docs-br.kinescope.com/kinescope-mcp/kinescope-mcp-server/#opção-2-configuração-no-claude-desktop)

**Claude Code (para desenvolvedores com Claude)**

* IDE com Claude integrado
* Configuração JSON
* [Instruções de configuração](https://docs-br.kinescope.com/kinescope-mcp/kinescope-mcp-server/#opção-3-configuração-no-claude-code)

**Qwen3 (aplicativo desktop)**

* Configure o MCP Server através de configuração JSON nas configurações do aplicativo
* Abra o aplicativo desktop
* Em um novo chat, ative o MCP com o botão
* [Instruções de configuração](https://docs-br.kinescope.com/kinescope-mcp/kinescope-mcp-server/#opção-4-configuração-no-qwen3-aplicativo-desktop)

**Requisitos:**

* Token de API do Kinescope ([obtenha um](https://app.kinescope.io/workspace/api_token))

> **Информация:**

Todas as consultas dos exemplos funcionam **da mesma forma** em todas as plataformas. Simplesmente copie e envie para o chat do seu assistente de IA.



## Operações básicas

### Buscando e visualizando informações

**Busca por tag:**

```
Encontre todos os vídeos com a tag "tutorial"
```

**Busca por período:**

```
Mostre vídeos carregados em dezembro de 2025
```

**Busca por múltiplos critérios:**

```
Encontre vídeos com as tags "onboarding" ou "treinamento" do projeto "RH"
```

**Visualizar informações do vídeo:**

```
Mostre informações detalhadas sobre o vídeo com ID abc123
```

**Lista de todos os projetos:**

```
Mostre uma lista de todos os meus projetos e o número de vídeos em cada um
```

### Editando metadados

**Atualizando o título:**

```
Altere o título do vídeo abc123 para "Introdução ao Trabalho com a Plataforma"
```

**Adicionando uma descrição:**

```
Adicione uma descrição ao vídeo abc123: "Este é um vídeo introdutório para novos funcionários.
Ele abrange os conceitos básicos de trabalho com a plataforma."
```

**Atualizando tags:**

```
Adicione tags ao vídeo abc123: onboarding, treinamento, básico
```

**Atualização completa:**

```
Para o vídeo abc123:
- Altere o título para "Básico de CRM"
- Atualize a descrição: "Vídeo de treinamento sobre como trabalhar com o sistema de CRM"
- Adicione tags: CRM, treinamento, vendas
- Defina privacidade: acesso apenas do nosso domínio
```

### Gerenciando estrutura

**Criando um projeto:**

```
Crie um novo projeto "Materiais de Treinamento 2026" com acesso privado
```

**Criando uma playlist:**

```
Crie uma playlist "Onboarding de Novos Funcionários" e adicione a ela
todos os vídeos com a tag "onboarding"
```

**Movendo um vídeo:**

```
Mova o vídeo abc123 do projeto "Rascunhos" para o projeto "Publicados"
```

**Copiando um vídeo:**

```
Copie o vídeo abc123 para o projeto "Arquivo" como backup
```

## Analytics e relatórios

### Analytics básico

**Estatísticas gerais:**

```
Mostre as estatísticas de visualização de todos os vídeos do último mês
```

**Estatísticas do projeto:**

```
Quais são as estatísticas gerais de visualização do projeto "Marketing" no trimestre?
```

**Geografia do público:**

```
De quais países as pessoas assistem mais frequentemente aos vídeos no projeto "Demos do Produto"?
```

**Análise de engajamento:**

```
Mostre a taxa de retenção de todos os vídeos com a tag "tutorial"
```

### Análise comparativa

**Comparação de vídeos:**

```
Compare as métricas de visualização dos vídeos abc123 e xyz789
```

**Top vídeos:**

```
Quais 10 vídeos têm a maior taxa de retenção este mês?
```

**Tendências ao longo do tempo:**

```
Como os contadores de visualização do vídeo abc123 mudaram semana a semana no último trimestre?
```

### Encontrando problemas

**Vídeos com baixa conclusão:**

```
Encontre todos os vídeos com uma taxa de conclusão abaixo de 50%
```

**Pontos de abandono:**

```
Em quais minutos os espectadores param com mais frequência de assistir ao vídeo abc123?
```

**Conteúdo ineficaz:**

```
Quais vídeos no projeto "Treinamento" têm menos de 100 visualizações no mês?
```

## Gerenciando legendas e capítulos

### Legendas

**Visualizando legendas:**

```
Mostre a lista de legendas disponíveis para o vídeo abc123
```

**Obtendo texto:**

```
Obtenha o texto completo das legendas em inglês com timestamps do vídeo abc123
```

**Verificando disponibilidade:**

```
Mostre todos os vídeos no projeto "Cursos" que não têm legendas
```

### Capítulos

**Adicionando capítulos:**

```
Adicione capítulos ao vídeo abc123:
- 0:00 — "Introdução"
- 2:30 — "Recursos Principais"
- 5:45 — "Exemplos de Uso"
- 10:20 — "Conclusão"
```

**Verificando estrutura:**

```
Mostre os capítulos do vídeo abc123
```

**Verificação em massa:**

```
Encontre todos os vídeos com mais de 10 minutos sem capítulos
```

## Trabalhando com streams

### Criando e gerenciando

**Criando um evento:**

```
Crie um evento de transmissão ao vivo:
- Título: "Webinar Mensal: Atualizações do Produto"
- Data: 25 de janeiro de 2026, 15:00 UTC
- Gravação ativada
```

**Lista de streams:**

```
Mostre todas as transmissões agendadas para a próxima semana
```

**Configurando retransmissão:**

```
Configure a retransmissão para o stream "Webinar do Produto" para YouTube e VK
```

### Trabalhando com gravações

**Obtendo gravações:**

```
Mostre as gravações de todos os streams do último mês
```

**Estatísticas do stream:**

```
Qual foi o número máximo de espectadores no stream "Lançamento do Produto"?
```

## Cenários complexos

### Cenário 1: Relatório semanal

**Objetivo:** Criar um relatório sobre conteúdo de vídeo da semana

**Passos:**

1. Obtenha as estatísticas de visualização:

```
Mostre as estatísticas de visualização de todos os vídeos nos últimos 7 dias
```

2. Identifique os melhores desempenhos:

```
Quais 5 vídeos tiveram mais visualizações esta semana?
```

3. Encontre problemas:

```
Quais vídeos têm taxa de conclusão abaixo de 60%?
```

4. Verifique o novo conteúdo:

```
Quantos vídeos foram carregados esta semana e quais são suas métricas iniciais?
```

5. Crie um resumo:

```
Com base nesses dados, crie uma planilha do Google Sheets com um relatório semanal
```

### Cenário 2: Preparando para uma auditoria de conteúdo

**Objetivo:** Encontrar vídeos que precisam de atualização

**Passos:**

1. Encontre vídeos sem descrições:

```
Mostre todos os vídeos sem descrição
```

2. Encontre vídeos sem tags:

```
Encontre vídeos que não têm tags
```

3. Encontre vídeos longos sem capítulos:

```
Mostre vídeos com mais de 10 minutos que não têm capítulos
```

4. Encontre conteúdo antigo:

```
Encontre vídeos carregados há mais de um ano que não foram visualizados nos últimos 3 meses
```

5. Crie um plano de ação:

```
Crie uma tabela com prioridades: quais vídeos precisam ser atualizados primeiro
```

### Cenário 3: Preparando uma apresentação trimestral

**Objetivo:** Coletar dados para uma apresentação de resultados

**Passos:**

1. Estatísticas gerais:

```
Mostre estatísticas gerais da plataforma para o Q4 2025:
número de vídeos, visualizações, espectadores únicos, tempo total de exibição
```

2. Crescimento do público:

```
Compare os contadores de visualização no Q4 2025 vs Q3 2025
```

3. Conteúdo principal:

```
Quais 10 vídeos foram mais populares no Q4?
```

4. Geografia:

```
De quais países vem a maior parte do tráfego?
```

5. Engajamento:

```
Qual é a taxa média de retenção dos vídeos criados no Q4?
```

6. Criando um documento:

```
Crie uma Apresentação Google com esses dados e adicione gráficos
```

### Cenário 4: Otimização da biblioteca

**Objetivo:** Organizar sua biblioteca de vídeos

**Passos:**

1. Auditoria da estrutura:

```
Mostre todos os projetos e o número de vídeos em cada um
```

2. Encontre duplicatas:

```
Encontre vídeos com títulos idênticos
```

3. Padronização de tags:

```
Mostre uma lista de todas as tags únicas usadas nos vídeos
```

4. Verificação de privacidade:

```
Mostre todos os vídeos públicos e determine quais deveriam ser privados
```

5. Plano de reorganização:

```
Sugira uma estrutura de projetos e pastas com base nas tags e conteúdo atuais
```

## Operações em massa

### Atualizando metadados

**Adição de tags em massa:**

```
Adicione a tag "arquivo-2025" a todos os vídeos carregados em 2025
```

**Atualização de privacidade:**

```
Altere as configurações de privacidade de todos os vídeos no projeto "Treinamento Interno"
para acesso apenas do domínio corporativo
```

### Migração de conteúdo

**Mover por tags:**

```
Mova todos os vídeos com a tag "desatualizado" para o projeto "Arquivo"
```

**Criando backups:**

```
Copie todos os vídeos do projeto "Materiais Importantes" para o projeto "Backup-2026"
```

## Integração com outras ferramentas

### Google Drive

**Sincronização com planilhas:**

```
Exporte uma lista de todos os vídeos com suas métricas para o Google Sheets
```

**Relatórios no Google Docs:**

```
Crie um Google Doc com uma análise do desempenho do conteúdo de vídeo do mês
```

### Calendários

**Planejamento de conteúdo:**

```
Com base no nosso calendário de conteúdo no Google Agenda, quais vídeos precisam ser criados este mês?
```

## Resolução de problemas

### Diagnosticando problemas de vídeo

**Verificando status de processamento:**

```
Mostre todos os vídeos que ainda estão sendo processados
```

**Encontrando erros:**

```
Encontre vídeos com erros de upload ou processamento
```

**Verificando acessibilidade:**

```
Verifique se o vídeo abc123 está disponível para visualização de domínios externos
```

## Dicas para formular consultas

### Seja específico

**Errado:**

```
Mostre vídeos
```

**Correto:**

```
Mostre todos os vídeos com a tag "tutorial" carregados em janeiro de 2026
```

### Use IDs para precisão

**Errado:**

```
Atualize o vídeo do produto
```

**Correto:**

```
Atualize o título do vídeo abc123 para "Visão Geral do Produto 2026"
```

### Divida tarefas complexas

**Errado:**

```
Faça uma análise completa de todos os vídeos e crie um relatório
```

**Correto:**

```
Passo 1: Mostre as estatísticas de visualização do mês
Passo 2: Identifique os 10 melhores vídeos
Passo 3: Encontre vídeos com baixas taxas de conclusão
Passo 4: Crie um Google Doc com esses dados
```

### Especifique períodos de tempo

**Errado:**

```
Mostre estatísticas de vídeos
```

**Correto:**

```
Mostre as estatísticas de vídeos dos últimos 30 dias
```

## Exemplos específicos por plataforma

### Para Cursor (desenvolvedores)

**Integração com código:**

```
Encontre vídeos com a tag "tutorial de API" e crie código TypeScript para incorporar o player
```

**Automação CI/CD:**

```
Obtenha uma lista dos vídeos recentes e crie um arquivo markdown para o README do projeto
```

**Trabalhando com código:**

```
Encontre todos os vídeos de treinamento e crie uma configuração JSON para o player de vídeo
```

### Para Claude Desktop (uso geral)

**Gerenciamento de conteúdo:**

```
Mostre estatísticas de todos os vídeos da semana e crie um breve relatório
```

**Analytics e relatórios:**

```
Encontre vídeos com baixas taxas de conclusão e sugira um plano para melhorá-los
```

### Para Claude Code (desenvolvedores)

**Integração com código:**

```
Encontre vídeos com a tag "tutorial de API" e crie código TypeScript para incorporar o player
```

**Documentação:**

```
Obtenha uma lista dos vídeos de treinamento e crie documentação com descrições e links
```

### Para Qwen3 (tarefas universais)

**Analytics complexo:**

```
Obtenha dados do Kinescope, analise o desempenho dos vídeos,
compare com métricas e crie um relatório
```

**Integração com Google Workspace:**

```
Exporte estatísticas de todos os vídeos para o Google Sheets com fórmulas para calcular ROI
```

**Criação de relatórios:**

```
Analise as visualizações do trimestre e crie uma apresentação com conclusões
```

> **Информация:**

A funcionalidade é a mesma em todas as plataformas. Escolha a que for mais conveniente para você!



## O que fazer a seguir?

### Documentação

1. **[Kinescope MCP Server](https://docs-br.kinescope.com/kinescope-mcp/kinescope-mcp-server/)** — guia completo de capacidades
2. **[Analytics](https://docs-br.kinescope.com/catalog-and-video-management/analytics/)** — mais sobre métricas
3. **[Gerenciamento de Vídeos](https://docs-br.kinescope.com/catalog-and-video-management/)** — trabalhando com conteúdo
4. **[Regras Gerais da API](https://docs-br.kinescope.com/developer-guides/api-general-rules/)** — documentação técnica

### Seleção de plataforma

**Cursor** — para desenvolvedores e integração com código  
**Claude Desktop** — para uso geral  
**Claude Code** — para desenvolvedores com Claude  
**Qwen3** — aplicativo desktop gratuito

[Comparação de plataformas](https://docs-br.kinescope.com/kinescope-mcp/kinescope-mcp-server/#comparação-com-outras-formas-de-trabalho)

---

Ainda tem dúvidas? Escreva para o chat de suporte na interface do Kinescope — nossos especialistas vão ajudar!

