FAQ do Kinescope MCP
Respostas às perguntas mais comuns sobre o trabalho com o Kinescope MCP Server.
Perguntas gerais
O que é MCP e para que serve?
Model Context Protocol (MCP) é um padrão aberto desenvolvido pela Anthropic que permite que assistentes de IA interajam com segurança com serviços externos e dados.
Por que o MCP é necessário para o Kinescope:
- Gerenciar vídeos por meio de linguagem natural
- Automatizar tarefas de rotina
- Criar relatórios rapidamente e analisar dados
- Integrar o Kinescope com outras ferramentas por meio de IA
Quais plataformas suportam MCP?
O Kinescope MCP Server funciona com qualquer plataforma que suporte o protocolo MCP. Recomendamos quatro opções:
1. Cursor (para desenvolvedores)
- Suporte MCP integrado
- Integração com código
- Configuração JSON
- IDE pago (~$20/mês)
- Disponível globalmente
- Requer: token de API do Kinescope
2. Claude Desktop (recomendado para uso geral)
- Assistente de IA oficial da Anthropic
- Instalação rápida via terminal
- Suporte MCP completo out-of-the-box
- Assinatura paga (~$20/mês)
- Disponível globalmente
- Requer: token de API do Kinescope
3. Claude Code (para desenvolvedores com Claude)
- IDE com Claude integrado
- Configuração JSON
- Integração com código
- IDE pago (~$20/mês)
- Disponível globalmente
- Requer: token de API do Kinescope
4. Qwen3 (aplicativo desktop)
- Aplicativo desktop com suporte MCP
- Configuração JSON
- Uso gratuito
- Requer: token de API do Kinescope
Recomendações:
- Para desenvolvedores — Cursor ou Claude Code (integração com código)
- Para uso geral — Claude Desktop (assistente de IA oficial)
- Outros — qualquer uma das plataformas acima
Veja a lista atualizada de todos os clientes MCP na documentação do MCP .
Usar o MCP tem algum custo?
Para o Kinescope MCP Server:
- O MCP Server em si é fornecido gratuitamente
- Os limites padrão do seu plano do Kinescope se aplicam
- Recomendamos o plano Business ou superior para acesso completo
Para a plataforma:
| Plataforma | Custo | Adicional |
|---|---|---|
| Cursor | ~$20/mês | Assinatura IDE |
| Claude Desktop | ~$20/mês | Assinatura Claude Pro |
| Claude Code | ~$20/mês | Assinatura IDE |
| Qwen3 | Gratuito | Aplicativo desktop |
Requisitos adicionais:
- Token de API do Kinescope — gratuito (incluído no plano)
Usar o MCP é seguro?
Sim, é seguro:
- Todos os dados são transmitidos via conexão HTTPS segura
- Os direitos de acesso da sua conta do Kinescope são aplicados
- Operações de exclusão estão desativadas por razões de segurança
- Todas as ações são registradas
Recomendações de segurança:
- Não compartilhe configurações de conexão com outros
- Use senhas fortes para as contas
- Verifique regularmente os logs de atividades
Configuração e conexão
Como configurar a conexão com o MCP Server?
Posso usar versões web dos assistentes de IA?
Não, versões web não são suportadas.
Por quê:
- O Kinescope MCP Server requer especificar um token de API na configuração
- Versões web (qwen.chat, etc.) não permitem especificar tokens de API
- Esta é uma limitação de segurança das próprias plataformas web
O que usar em vez disso:
- Cursor — IDE para desenvolvedores
- Claude Desktop — assistente de IA oficial da Anthropic
- Claude Code — IDE com Claude integrado
- Qwen3 — aplicativo desktop (gratuito)
Como começar:
- Baixe o Cursor, Claude Desktop, Claude Code ou Qwen3 (aplicativo desktop)
- Obtenha um token de API no Kinescope
- Configure a conexão seguindo as instruções
- Comece a trabalhar
Posso usar opções gratuitas?
Sim, existem opções gratuitas:
Opções gratuitas:
| Plataforma | Disponibilidade | Limitações |
|---|---|---|
| Cursor Trial | Período de teste | Limitado por tempo (geralmente 14 dias) |
| Claude Desktop Trial | Período de teste | Limitado por tempo |
| Claude Code Trial | Período de teste | Limitado por tempo |
| Qwen3 | Gratuito | Aplicativo desktop |
Requisitos adicionais (gratuitos):
- Token de API do Kinescope — gratuito (incluído no plano)
Recomendações:
- Para desenvolvimento — Cursor Trial ou Claude Code Trial, depois assinatura paga
- Para uso geral — Claude Desktop
- Para trabalho contínuo — Cursor, Claude Desktop ou Claude Code
- Para usuários que querem uma opção gratuita — Qwen3
A funcionalidade do Kinescope MCP é independente da plataforma:
- Acesso a dados — o mesmo
- Métodos de API — os mesmos
- Capacidades — as mesmas
A diferença está apenas na interface, custo e limites de uso da IA.
</div>
Por que o MCP Server não está respondendo?
Posso usar várias contas do Kinescope?
Sim, você pode configurar várias conexões:
No Cursor ou Claude Code:
- Adicione vários servidores à configuração MCP
- Dê nomes diferentes:
kinescope-trabalho,kinescope-pessoal
No Claude Desktop:
- Adicione vários servidores via Smithery CLI (
mcp add) com nomes diferentes - Configure manualmente para cada conta
No Qwen3:
- Adicione vários servidores nas configurações de MCP
- Nomeie-os claramente: “Kinescope Trabalho”, “Kinescope Pessoal”
Alternando entre contas:
Especifique qual conta usar na consulta, ou alterne o servidor ativo nas configurações.
Como alternar entre projetos?
O MCP Server trabalha automaticamente com todos os projetos aos quais você tem acesso. Simplesmente especifique o nome do projeto na consulta:
Mostre vídeos do projeto "Marketing"
Trabalhando com dados
Quais dados estão disponíveis através do MCP?
Disponível:
- Informações do vídeo (metadados, status)
- Analytics de visualização
- Projetos e pastas
- Playlists
- Legendas e capítulos
- Streams e gravações
- Estatísticas de faturamento
Indisponível:
- Exclusão de dados
- Configurações da conta
- Informações de pagamento
- Upload direto de arquivos de vídeo
Posso editar vídeos através do MCP?
Você pode editar metadados do vídeo:
- Título e descrição
- Tags
- Configurações de privacidade
- Capítulos
- Legendas
Não é possível editar:
- O arquivo de vídeo em si
- Recortar ou editar o vídeo
- Alterar a codificação
Use a interface web ou ferramentas especializadas para edição de arquivos.
Com que frequência os dados são atualizados?
Os dados são atualizados em tempo real. Quando você faz uma consulta através do MCP Server, obtém informações atuais da sua conta do Kinescope.
Observação:
- O analytics pode ser atualizado com um pequeno atraso (até 5 minutos)
- O processamento de novos vídeos leva tempo
Posso fazer download de vídeos através do MCP?
Não, o download direto de arquivos de vídeo através do MCP não está disponível.
O que está disponível:
- Obter links de vídeo
- Exportar metadados
- Obter links de legendas e materiais complementares
Use a interface web do Kinescope para downloads.
Analytics e relatórios
Quais métricas estão disponíveis através do MCP?
Métricas básicas:
- Contagem de visualizações
- Espectadores únicos
- Tempo de exibição
- Taxa de conclusão (percentual assistido)
Métricas avançadas:
- Taxa de retenção (retenção do público)
- Geografia de visualização
- Dispositivos e navegadores
- Pontos de abandono dos espectadores
Faturamento:
- Uso de tráfego
- Uso de armazenamento
- Estatísticas por projeto
A disponibilidade de métricas depende do seu plano do Kinescope.
Posso exportar dados?
Sim, você pode pedir ao assistente de IA para exportar dados:
Exporte as estatísticas de todos os vídeos do mês para o Google Sheets
Crie um arquivo CSV com uma lista de todos os vídeos e seus metadados
O assistente de IA pode criar:
- Tabelas do Google Sheets
- Google Docs
- Arquivos CSV
- Apresentações
Como criar um relatório trimestral?
Use uma abordagem passo a passo:
- Colete dados:
Mostre estatísticas de visualização do Q4 2025
- Analise:
Quais foram os 10 vídeos mais populares?
Quais vídeos têm baixas taxas de conclusão?
- Crie um documento:
Crie uma Apresentação Google com esses dados e conclusões
Exemplos detalhados: Exemplos de Uso
Limitações e desempenho
Existem limites no número de solicitações?
Sim, os limites de taxa padrão da API do Kinescope se aplicam:
- Plano Business: até 100 solicitações por minuto
- Plano Enterprise: até 500 solicitações por minuto
Quando o limite é excedido, você receberá um erro sugerindo nova tentativa após alguns segundos.
Recomendações:
- Formule consultas com precisão para obter o resultado necessário na primeira tentativa
- Para operações em massa, faça pausas entre as consultas
- Considere fazer upgrade para um plano superior
Por que o MCP está lento?
Possíveis causas:
- Grande volume de dados — a consulta processa muitos vídeos
- Analytics complexo — os cálculos de métricas levam tempo
- Carga do servidor — alta carga no momento
- Limite de taxa — limite de solicitações atingido
Solução:
- Especifique a consulta, adicione filtros
- Divida em várias consultas menores
- Aguarde alguns segundos
- Use um plano de nível superior
Posso usar o MCP para operações em massa?
Sim, mas com limitações:
O que é possível:
- Atualizar metadados de vários vídeos
- Adição de tags em massa
- Mover vídeos entre projetos
- Criar relatórios sobre um grande número de vídeos
Limitações:
- Observe os limites de taxa
- Para operações com milhares de vídeos, use a API direta
- Operações de exclusão não estão disponíveis
Qual plano do Kinescope é necessário para o MCP?
Mínimo: qualquer plano do Kinescope
Recomendado: Business ou superior
Por que Business ou superior:
- Limites de taxa mais altos (mais solicitações)
- Acesso a todas as métricas de analytics
- Recursos avançados (DRM, SSO, etc.)
- Suporte prioritário
Segurança e direitos de acesso
Quem pode usar meu conector MCP?
Apenas você, se não tiver compartilhado as configurações de conexão.
Para colaboração em equipe:
- Cada membro da equipe configura seu próprio conector
- Os direitos de acesso são determinados no Kinescope
- Os membros veem apenas seus próprios projetos
O que a IA pode fazer com meus vídeos?
A IA só pode fazer o que é permitido pelos seus direitos no Kinescope:
- Visualizar informações
- Editar metadados
- Criar projetos e playlists
- Obter analytics
- Não pode excluir dados (desativado no MCP)
- Não pode alterar configurações da conta
- Não pode gerenciar pagamentos
As ações são registradas através do MCP?
Sim, todas as ações através do MCP Server são registradas nos logs da sua conta do Kinescope, assim como ações através da interface web.
O que é registrado:
- Visualização de informações
- Alterações de metadados
- Criação e modificação de estrutura
- Horário da solicitação e endereço IP
Posso revogar o acesso?
Integrações
Posso integrar com o Google Drive?
Sim, os assistentes de IA podem trabalhar simultaneamente com o Kinescope MCP e outros serviços:
Obtenha dados de vídeo do Kinescope e crie um relatório no Google Docs
Carregue uma lista de vídeos do Google Sheets e atualize seus metadados no Kinescope
O MCP funciona com outras plataformas?
O MCP Server permite que o assistente de IA trabalhe com vários serviços simultaneamente.
Exemplos de integração:
- Google Workspace (Docs, Sheets, Drive)
- Slack (notificações e relatórios)
- Notion (documentação)
- E outros serviços suportados pelo seu assistente de IA
Posso automatizar tarefas?
Parcialmente. Assistentes de IA com suporte a MCP são ótimos para:
- Criar relatórios regulares
- Análise de dados sob demanda
- Atualizações de metadados em massa
Para automação completa (tarefas agendadas, webhooks), use a API do Kinescope .
Resolução de problemas
Recebendo erro 401 (Unauthorized)
Causa: problemas de autorização
Solução:
- Verifique se você está autorizado no Kinescope
- Reconecte o conector no Claude
- Verifique o status da conta do Kinescope
- Entre em contato com o chat de suporte na interface do Kinescope
Recebendo erro 429 (Too Many Requests)
Causa: limite de taxa excedido
Solução:
- Aguarde 30-60 segundos
- Reduza a frequência de solicitações
- Divida a tarefa grande em várias menores
- Considere fazer upgrade para um plano superior
A IA não entende minha consulta
Causa: a consulta foi formulada de forma ambígua
Solução:
- Seja mais específico: especifique IDs, tags, datas
- Divida uma consulta complexa em etapas simples
- Use exemplos da documentação
- Tente reformular
Os dados não estão sendo atualizados
Causa: cache ou atraso de processamento
Solução:
- Aguarde 1-2 minutos
- Faça a consulta novamente
- Verifique os dados na interface web
- Entre em contato com o chat de suporte na interface do Kinescope se o problema persistir
O que fazer a seguir?
Recursos adicionais
- Kinescope MCP Server — guia completo
- Exemplos de Uso — cenários prontos
- Documentação da API — documentação técnica
- Protocolo MCP — documentação oficial do protocolo
Ainda tem dúvidas? Escreva para o chat de suporte na interface do Kinescope — nossos especialistas vão ajudar!