# FAQ do Kinescope MCP Respostas às perguntas mais comuns sobre o trabalho com o Kinescope MCP Server. ## Perguntas gerais {{< faq >}} {{< faq-item q="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 {{< /faq-item >}} {{< faq-item q="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 > **Внимание:** Versões web dos assistentes de IA (qwen.chat, claude.am, etc.) **não são suportadas**, pois não permitem especificar tokens de API na configuração. **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](https://modelcontextprotocol.io/). {{< /faq-item >}} {{< faq-item q="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) > **Информация:** Todas as plataformas suportam os mesmos recursos do Kinescope MCP. A única diferença é na interface e no custo. {{< /faq-item >}} {{< faq-item q="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 {{< /faq-item >}} {{< /faq >}} ## Configuração e conexão {{< faq >}} {{< faq-item q="Como configurar a conexão com o MCP Server?" >}} A configuração passo a passo atual para diferentes clientes (Cursor, Claude Desktop, Claude Code, Qwen3, etc.) está descrita na seção [Configurando a conexão com o MCP Server](https://docs-br.kinescope.com/kinescope-mcp/kinescope-mcp-server/#configurando-a-conexão-com-o-mcp-server). {{< /faq-item >}} {{< faq-item q="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:** 1. Baixe o Cursor, Claude Desktop, Claude Code ou Qwen3 (aplicativo desktop) 2. Obtenha um token de API no Kinescope 3. Configure a conexão seguindo as [instruções](https://docs-br.kinescope.com/kinescope-mcp/kinescope-mcp-server/#configurando-a-conexão-com-o-mcp-server) 4. Comece a trabalhar {{< /faq-item >}} {{< faq-item q="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. {{< /faq-item >}} {{< faq-item q="Por que o MCP Server não está respondendo?" >}} As possíveis causas (token de API errado, rede, erro de configuração) e soluções passo a passo para Cursor, Claude Desktop, Claude Code e Qwen3 estão descritas na seção [Resolução de Problemas](https://docs-br.kinescope.com/kinescope-mcp/kinescope-mcp-server/#resolução-de-problemas) do guia principal. {{< /faq-item >}} {{< faq-item q="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. {{< /faq-item >}} {{< faq-item q="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" ``` {{< /faq-item >}} {{< /faq >}} ## Trabalhando com dados {{< faq >}} {{< faq-item q="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 {{< /faq-item >}} {{< faq-item q="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. {{< /faq-item >}} {{< faq-item q="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 {{< /faq-item >}} {{< faq-item q="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. {{< /faq-item >}} {{< /faq >}} ## Analytics e relatórios {{< faq >}} {{< faq-item q="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. {{< /faq-item >}} {{< faq-item q="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 {{< /faq-item >}} {{< faq-item q="Como criar um relatório trimestral?" >}} Use uma abordagem passo a passo: 1. Colete dados: ``` Mostre estatísticas de visualização do Q4 2025 ``` 2. Analise: ``` Quais foram os 10 vídeos mais populares? Quais vídeos têm baixas taxas de conclusão? ``` 3. Crie um documento: ``` Crie uma Apresentação Google com esses dados e conclusões ``` Exemplos detalhados: [Exemplos de Uso](https://docs-br.kinescope.com/kinescope-mcp/usage-examples/) {{< /faq-item >}} {{< /faq >}} ## Limitações e desempenho {{< faq >}} {{< faq-item q="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 {{< /faq-item >}} {{< faq-item q="Por que o MCP está lento?" >}} **Possíveis causas:** 1. **Grande volume de dados** — a consulta processa muitos vídeos 2. **Analytics complexo** — os cálculos de métricas levam tempo 3. **Carga do servidor** — alta carga no momento 4. **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 {{< /faq-item >}} {{< faq-item q="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 {{< /faq-item >}} {{< faq-item q="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 {{< /faq-item >}} {{< /faq >}} ## Segurança e direitos de acesso {{< faq >}} {{< faq-item q="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 {{< /faq-item >}} {{< faq-item q="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 {{< /faq-item >}} {{< faq-item q="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 {{< /faq-item >}} {{< faq-item q="Posso revogar o acesso?" >}} Sim, simplesmente exclua ou desative o servidor MCP nas configurações do seu assistente de IA (Cursor ou Qwen3). O acesso através do MCP será imediatamente encerrado. {{< /faq-item >}} {{< /faq >}} ## Integrações {{< faq >}} {{< faq-item q="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 ``` {{< /faq-item >}} {{< faq-item q="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 {{< /faq-item >}} {{< faq-item q="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 [Referência da API](https://docs-br.kinescope.com/api/). {{< /faq-item >}} {{< /faq >}} ## Resolução de problemas {{< faq >}} {{< faq-item q="Recebendo erro 401 (Unauthorized)" >}} **Causa:** problemas de autorização **Solução:** 1. Verifique se você está autorizado no Kinescope 2. Reconecte o conector no Claude 3. Verifique o status da conta do Kinescope 4. Entre em contato com o chat de suporte na interface do Kinescope {{< /faq-item >}} {{< faq-item q="Recebendo erro 429 (Too Many Requests)" >}} **Causa:** limite de taxa excedido **Solução:** 1. Aguarde 30-60 segundos 2. Reduza a frequência de solicitações 3. Divida a tarefa grande em várias menores 4. Considere fazer upgrade para um plano superior {{< /faq-item >}} {{< faq-item q="A IA não entende minha consulta" >}} **Causa:** a consulta foi formulada de forma ambígua **Solução:** 1. Seja mais específico: especifique IDs, tags, datas 2. Divida uma consulta complexa em etapas simples 3. Use exemplos da [documentação](https://docs-br.kinescope.com/kinescope-mcp/usage-examples/) 4. Tente reformular {{< /faq-item >}} {{< faq-item q="Os dados não estão sendo atualizados" >}} **Causa:** cache ou atraso de processamento **Solução:** 1. Aguarde 1-2 minutos 2. Faça a consulta novamente 3. Verifique os dados na interface web 4. Entre em contato com o chat de suporte na interface do Kinescope se o problema persistir {{< /faq-item >}} {{< /faq >}} ## O que fazer a seguir? {{< faq >}} {{< faq-item q="Recursos adicionais" >}} 1. **[Kinescope MCP Server](https://docs-br.kinescope.com/kinescope-mcp/kinescope-mcp-server/)** — guia completo 2. **[Exemplos de Uso](https://docs-br.kinescope.com/kinescope-mcp/usage-examples/)** — cenários prontos 3. **[Referência da API](https://docs-br.kinescope.com/api/)** — documentação técnica 4. **[Protocolo MCP](https://modelcontextprotocol.io/)** — documentação oficial do protocolo {{< /faq-item >}} {{< faq-item q="Não encontrou resposta para sua pergunta?" >}} * **Chat de suporte na interface do Kinescope** — respostas rápidas dos especialistas * **[E-mail](https://kinescope.io/contact)** — para perguntas detalhadas * **[GitHub](https://github.com/kinescope/kinescope-mcp-docs)** — documentação técnica {{< /faq-item >}} {{< /faq >}} --- Ainda tem dúvidas? Escreva para o chat de suporte na interface do Kinescope — nossos especialistas vão ajudar!