Kinescope MCP server

O Kinescope MCP Server é um servidor que implementa o Model Context Protocol (MCP), permitindo que assistentes de IA interajam com a plataforma Kinescope por meio de consultas em linguagem natural. Você pode gerenciar vídeos, obter analytics, configurar projetos e trabalhar com conteúdo simplesmente conversando com um assistente de IA.

Para quem é esta seção

• Gerentes de projeto — gerencie conteúdo de vídeo através de um assistente de IA, automatize tarefas de rotina
• Profissionais de marketing — analise rapidamente o desempenho de vídeos, crie relatórios e gerencie conteúdo
• Desenvolvedores — integre as capacidades do Kinescope em aplicações de IA por meio de um protocolo padronizado
• Gestores de conteúdo — organize sua biblioteca de vídeos, atualize metadados e obtenha analytics em modo de diálogo

Por onde começar

Passo 1: Escolha uma plataforma

Opção 1: Cursor (recomendado para desenvolvedores)

• Suporte MCP integrado
• Configuração JSON simples
• Integração com código

Opção 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

Opção 3: Claude Code (para desenvolvedores com Claude)

• IDE com Claude integrado
• Configuração JSON
• Integração com código

Opção 4: Qwen3 (aplicativo desktop)

• Aplicativo desktop com suporte MCP
• Configuração JSON
• Uso gratuito

Passo 2: Preparação

1. Crie uma conta no Kinescope — recomendado plano Super ou superior
2. Obtenha uma chave de API:
   • Abra as configurações da conta no Kinescope
   • Vá para a seção “API”
   • Crie uma nova chave de API ou copie uma existente
3. Faça upload de alguns vídeos para teste

Se você já trabalha com o Kinescope

1. Obtenha uma chave de API (veja acima)
2. Escolha uma plataforma adequada (Cursor, Claude ou Qwen3)
3. Configure a conexão (veja a seção abaixo)
4. Revise os exemplos de consultas para automatizar suas tarefas

O que você pode fazer através do MCP Server

Gerenciamento de vídeos e conteúdo

• Buscar vídeos por título, descrição, tags
• Visualizar informações sobre vídeos, legendas, capítulos, posters
• Editar metadados: títulos, descrições, tags
• Copiar e mover vídeos entre projetos
• Gerenciar configurações de privacidade

Trabalhando com projetos e estrutura

• Criar e gerenciar projetos
• Organizar vídeos em pastas
• Criar playlists e adicionar vídeos
• Visualizar listas de projetos e sua estrutura

Analytics e estatísticas

• Obter métricas de visualização
• Analisar engajamento do público
• Distribuição geográfica dos espectadores
• Consultas de analytics personalizadas
• Estatísticas gerais dos vídeos

Legendas e capítulos

• Adicionar arquivos de legendas
• Gerenciar idiomas de legendas
• Obter conteúdo das legendas
• Atualizar capítulos com timestamps

Transmissões ao vivo

• Criar eventos de stream
• Gerenciar configurações de stream
• Agendar streams
• Configurar retransmissão
• Obter gravações de streams

Recursos adicionais

• Gerenciar posters e prévias
• Adicionar materiais complementares aos vídeos
• Criar solicitações de upload de arquivos
• Gerenciar salas do Speak
• Visualizar estatísticas de uso e faturamento

Configurando a conexão com o MCP Server

Obtendo um token de API do Kinescope

Antes de configurar, obtenha um token de API:

1. Abra app.kinescope.io/workspace/api_token
2. Vá para a seção “Tokens de API”
3. Clique em “Criar token de API”
4. Especifique um nome para o token (por exemplo, “cursor mcp” ou “qwen mcp”)
5. Escolha os direitos de acesso (somente leitura ou mais amplos conforme necessário)
6. Salve o token em um lugar seguro

Opção 1: Configuração no Cursor

Passo 1. Instale o Cursor

1. Baixe o Cursor
2. Instale o IDE no seu computador
3. Abra o Cursor

Passo 2. Configure o MCP Server

1. Abra o arquivo de configuração MCP:

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

2. Adicione a configuração do Kinescope:

{
  "mcpServers": {
    "Kinescope MCP": {
      "type": "streamable-http",
      "url": "https://api.kinescope.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

3. Substitua YOUR_API_TOKEN pelo seu token de API do Kinescope
4. Salve o arquivo
5. Reinicie o Cursor

Passo 3. Verifique a conexão

1. Abra o chat de IA no Cursor (Cmd/Ctrl+L)
2. Digite: “Mostre meus projetos no Kinescope”
3. Se tudo estiver configurado corretamente, você verá uma lista de projetos

Se a conexão não funcionar:

• Verifique se o token de API foi inserido corretamente (sem espaços extras)
• Certifique-se de que o cabeçalho Authorization diz Bearer YOUR_API_TOKEN
• Reinicie o Cursor após alterar a configuração
• Verifique os logs nas Ferramentas de Desenvolvedor (Cmd/Ctrl+Shift+I)

Opção 2: Configuração no Claude Desktop

Passo 1. Instale o Claude Desktop

1. Baixe o Claude Desktop para sua plataforma
2. Instale o aplicativo no seu computador
3. Conclua a autorização ou registro
4. Abra o aplicativo Claude Desktop

Passo 2. Instale o MCP Server via terminal

1. Abra um terminal (Terminal no macOS/Linux ou PowerShell no Windows)
2. Execute o comando de instalação:

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

3. Siga as instruções do instalador
4. Quando solicitada a chave de API, insira seu token do Kinescope

Passo 3. Reinicie o aplicativo

1. Encerre o Claude Desktop por completo (feche o app, não só a janela do chat)
2. Abra o aplicativo novamente para que a configuração MCP atualizada seja aplicada
3. O MCP Server deve conectar automaticamente

Passo 4. Verifique a conexão

1. Abra o chat no Claude Desktop
2. Digite: “Mostre meus projetos no Kinescope”
3. Se tudo estiver configurado corretamente, você verá uma lista de projetos

Se a conexão não funcionar:

• Verifique se a instalação foi concluída com sucesso (sem erros no terminal)
• Verifique a chave de API na configuração do Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
• Reinicie o Claude Desktop para aplicar as alterações na configuração
• Tente adicionar o servidor novamente com o comando acima (mcp add)

Opção 3: Configuração no Claude Code

Passo 1. Instale o Claude Code

1. Baixe o Claude Code para sua plataforma
2. Instale o IDE no seu computador
3. Abra o Claude Code

Passo 2. Configure o MCP Server

1. Abra o arquivo de configuração MCP:

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

2. Adicione a configuração do Kinescope:

{
  "mcpServers": {
    "Kinescope MCP": {
      "type": "streamable-http",
      "url": "https://api.kinescope.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

3. Substitua YOUR_API_TOKEN pelo seu token de API do Kinescope
4. Salve o arquivo
5. Reinicie o Claude Code

Passo 3. Verifique a conexão

1. Abra o chat de IA no Claude Code
2. Digite: “Mostre meus projetos no Kinescope”
3. Se tudo estiver configurado corretamente, você verá uma lista de projetos

Se a conexão não funcionar:

• Verifique se o token de API foi inserido corretamente (sem espaços extras)
• Certifique-se de que o cabeçalho Authorization diz Bearer YOUR_API_TOKEN
• Certifique-se de que a configuração JSON está correta (verifique aspas, vírgulas)
• Reinicie o Claude Code após alterar a configuração
• Verifique os logs nas Ferramentas de Desenvolvedor

Opção 4: Configuração no Qwen3 (aplicativo desktop)

Passo 1. Instale o Qwen3

1. Baixe a versão mais recente do aplicativo desktop Qwen3 em qwen.am/download
2. Instale o aplicativo no seu computador
3. Conclua o registro
4. Abra o aplicativo Qwen3

Passo 2. Configure o MCP Server

1. Clique no avatar no canto inferior esquerdo
2. Selecione Configurações → MCP (no menu esquerdo) → aba “Meu MCP”
3. Clique no botão + Adicionar MCP e selecione “Adicionar usando JSON”
4. Cole a seguinte configuração no campo do editor:

{
  "mcpServers": {
    "Kinescope MCP": {
      "type": "streamable-http",
      "url": "https://api.kinescope.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

5. Substitua YOUR_API_TOKEN pelo seu token de API do Kinescope
6. Clique no botão “Salvar e ativar”
7. Certifique-se de que o Kinescope MCP está ativo (indicador verde)
8. Reinicie o aplicativo Qwen3 se necessário

Passo 3. Verifique a conexão

1. Abra um novo chat no Qwen3
2. Importante: Clique no botão MCP primeiro para que o agente entenda que deve usar o servidor
3. Certifique-se de que o servidor está ativo (status verde)
4. Digite: “Mostre a lista dos meus projetos no Kinescope”
5. O Qwen3 deve retornar uma lista dos seus projetos

Se surgirem problemas:

• Verifique se o token de API está correto
• Verifique a sintaxe da configuração JSON (aspas e vírgulas corretas)
• Certifique-se de que o Kinescope MCP está ativado (indicador verde)
• Certifique-se de que o botão MCP está ativado no novo chat
• Reinicie o aplicativo Qwen3
• Verifique sua conexão com a internet

Requisitos para todas as plataformas

Requisitos do sistema:

• Internet: conexão estável
• Chave de API do Kinescope: necessária para operação

Exemplos de uso

Buscando e gerenciando vídeos

Busca simples:

Encontre todos os vídeos com a tag "tutorial" do último trimestre

Visualizando informações:

Mostre informações sobre o vídeo com ID fb6ee692-c7bc-475c-a0ef-6eaba6574766

Editando metadados:

Atualize o título do vídeo fb6ee692-c7bc-475c-a0ef-6eaba6574766 para "Demo de Integração MCP"
e adicione a descrição "Demonstração de trabalho com o Kinescope via Model Context Protocol"

Analytics de vídeos

Estatísticas gerais:

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

Análise detalhada:

Quais países assistem mais aos nossos vídeos de demonstração?

Análise de engajamento:

Mostre a taxa de retenção de vídeos de treinamento e identifique quais têm pior desempenho

Organização de conteúdo

Criando estrutura:

Crie um novo projeto "Vídeos de Marketing 2026" com configurações de acesso privado

Trabalhando com playlists:

Adicione todos os vídeos com a tag "onboarding" à playlist "Treinamento de Novos Funcionários"

Gerenciamento de pastas:

Mostre a lista de todos os meus projetos e indique quais têm mais vídeos

Trabalhando com legendas e capítulos

Legendas:

Obtenha o texto completo das legendas com timestamps do vídeo "Apresentação do Produto"

Capítulos:

Adicione capítulos ao vídeo: aos 5:30 — "Visão Geral da API", aos 12:15 — "Discussão de Preços"

Transmissões ao vivo

Criando um evento:

Crie um evento de transmissão ao vivo "Lançamento do Produto Q4" para a próxima semana

Gerenciamento de stream:

Mostre todas as transmissões ativas na minha conta

Retransmissão:

Ative a retransmissão para o evento "Série de Webinars" para YouTube e Twitch

Trabalhando com faturamento

Uso de recursos:

Mostre as estatísticas de uso de armazenamento dos últimos 3 meses

Análise de projetos:

Qual projeto consome mais tráfego este mês?

Cenários de uso avançado

Criando um relatório trimestral de analytics de vídeos

Passo 1. Coletando dados do Google Drive:

Obtenha minha planilha de OKRs do Q3 com métricas da plataforma de vídeo do Google Drive

Passo 2. Analisando vídeos no Kinescope:

Encontre todos os vídeos com tags "tutorial" ou "demo" do último trimestre e obtenha seus analytics

Passo 3. Estatísticas detalhadas:

Mostre a taxa de retenção e a distribuição geográfica de cada vídeo

Passo 4. Comparando com metas:

Compare as métricas de engajamento com as KPIs alvo da minha planilha

Passo 5. Identificando problemas:

Qual conteúdo apresenta resultados abaixo da nossa meta de retenção de 80%?

Passo 6. Criando o relatório:

Crie um Google Doc com um relatório combinando dados de vídeo e progresso dos OKRs

Passo 7. Recomendações:

Adicione recomendações para conteúdo que requer reformulação com base nos pontos de abandono dos espectadores

Passo 8. Plano de ação:

Com base nos vídeos com taxa de conclusão abaixo de 50% e nosso calendário de conteúdo do Q4,
quais vídeos precisam ser atualizados primeiro?

Auditoria e otimização de conteúdo

Encontrando conteúdo não otimizado:

Encontre todos os vídeos sem descrições, capítulos ou com tags desatualizadas

Atualização em massa:

Crie uma planilha de rastreamento para vídeos que precisam de novos capítulos,
descrições melhoradas ou reescritas

Gerenciamento de direitos de acesso

Atualizando privacidade:

Atualize as configurações de privacidade para nossa demonstração interna
para que o acesso seja apenas de domínios corporativos

Auditoria de acesso:

Mostre todos os vídeos com acesso público no projeto "Treinamento Interno"

Gerenciamento de acesso da equipe

Os membros da equipe obtêm acesso ao MCP Server de acordo com seus direitos de acesso ao projeto no Kinescope.

Configuração de direitos:

Para o Cursor:

1. Cada desenvolvedor cria seu próprio token de API no Kinescope
2. Cada pessoa configura o MCP Server em seu arquivo de configuração com seu próprio token
3. Os direitos de acesso são determinados pela conta do Kinescope
4. Cada pessoa vê apenas seus próprios projetos

Para o Claude Desktop:

1. Cada membro cria seu próprio token de API
2. Instala o MCP Server via terminal com seu próprio token
3. Os direitos de acesso são determinados pela conta do Kinescope
4. Cada pessoa vê apenas seus próprios projetos

Para o Claude Code:

1. Cada desenvolvedor cria seu próprio token de API no Kinescope
2. Cada pessoa configura o MCP Server em seu arquivo de configuração com seu próprio token
3. Os direitos de acesso são determinados pela conta do Kinescope
4. Cada pessoa vê apenas seus próprios projetos

Para o Qwen3:

1. Cada membro cria seu próprio token de API
2. Cada pessoa configura suas definições com um token pessoal
3. Use contas corporativas para gerenciamento de acesso
4. Os direitos são herdados do Kinescope

Segurança do token de API:

• Não compartilhe tokens de API com colegas
• Não armazene tokens em repositórios públicos
• Cada funcionário usa seu próprio token
• Atualize os tokens regularmente
• Exclua os tokens de funcionários que saíram

Limitações e especificidades

O que está indisponível no MCP Server

• Exclusão de dados — vídeos, projetos, playlists não podem ser excluídos através do MCP Server por razões de segurança
• Alterações nas configurações da conta — gerenciamento de planos, detalhes de pagamento estão disponíveis apenas na interface web
• Upload de arquivos — o upload direto de arquivos de vídeo através do MCP ainda não está disponível (use a interface web ou a API)

Limitações baseadas no plano

• Limites de taxa — o número de solicitações de API depende do seu plano do Kinescope
• Volume de dados — recursos de analytics avançados estão disponíveis em planos superiores
• Recursos — alguns recursos avançados estão disponíveis em planos Business e superiores

Recomendamos usar o plano Super ou superior para acesso completo às capacidades do MCP Server.

Segurança e boas práticas

Segurança de dados

• Autenticação — todas as solicitações passam por uma conexão segura
• Separação de direitos — o acesso é limitado pelos direitos da sua conta e do projeto
• Registro — todas as ações através do MCP Server são registradas nos logs da conta
• Criptografia — os dados são transmitidos via protocolo HTTPS

Recomendações de uso

1. Use consultas específicas — quanto mais precisa a formulação, melhor o resultado
2. Verifique os IDs dos vídeos — ao editar, certifique-se de estar trabalhando com o vídeo correto
3. Comece pela visualização — antes de fazer alterações, primeiro obtenha as informações atuais
4. Teste em cópias — para operações complexas, crie vídeos de teste
5. Salve backups de metadados — exporte dados antes de alterações em massa

Resolução de problemas

O MCP Server não responde

Possíveis causas:

• Token de API incorreto
• Problemas de conexão de rede
• Erro na configuração JSON

Solução:

Para o Cursor:

1. Verifique o token de API em ~/.cursor/mcp.json (macOS/Linux) ou %APPDATA%\Cursor\mcp.json (Windows)
2. Verifique os logs nas Ferramentas de Desenvolvedor (Cmd/Ctrl+Shift+I)
3. Reinicie o Cursor

Para o Claude Desktop:

1. Verifique o token de API na configuração:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Tente executar novamente: npx -y @smithery/cli@latest mcp add kinescope/kinescope-mcp --client claude
3. Reinicie o Claude Desktop para aplicar as alterações

Para o Claude Code:

1. Verifique o token de API em ~/.claude-code/mcp.json (macOS/Linux) ou %APPDATA%\Claude Code\mcp.json (Windows)
2. Verifique a sintaxe da configuração JSON
3. Verifique os logs nas Ferramentas de Desenvolvedor
4. Reinicie o Claude Code

Para o Qwen3:

1. Verifique o token de API nas configurações de MCP do aplicativo
2. Verifique a sintaxe da configuração JSON (aspas e vírgulas corretas)
3. Certifique-se de que o Kinescope MCP está ativado (indicador verde)
4. Certifique-se de que o botão MCP está ativado no chat
5. Reinicie o aplicativo Qwen3

Para todas as plataformas:

• Verifique sua conexão com a internet
• Certifique-se de que o token de API está ativo nas configurações do Kinescope
• Tente criar um novo token de API
• Entre em contato com o chat de suporte na interface do Kinescope

Erros de autorização

Possíveis causas:

• Token de API incorreto
• O token de API foi excluído ou desativado
• Direitos de acesso insuficientes
• Conta bloqueada ou suspensa

Solução:

1. Verifique o token de API em Configurações do Kinescope
2. Certifique-se de que o token está ativo e não foi excluído
3. Crie um novo token de API se o antigo não funcionar
4. Atualize o token de API na configuração:
   • Cursor: ~/.cursor/mcp.json (macOS/Linux) ou %APPDATA%\Cursor\mcp.json (Windows)
   • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows)
   • Claude Code: ~/.claude-code/mcp.json (macOS/Linux) ou %APPDATA%\Claude Code\mcp.json (Windows)
   • Qwen3: Configurações → MCP → “Meu MCP”
5. Reinicie o aplicativo
6. Entre em contato com o chat de suporte na interface do Kinescope

Respostas lentas

Possíveis causas:

• Alta carga do servidor
• Consulta complexa requer processamento de grande volume de dados
• Limite de taxa atingido

Solução:

1. Simplifique a consulta — divida-a em várias menores
2. Use filtros para restringir a seleção
3. Aguarde alguns segundos antes de tentar novamente
4. Considere fazer upgrade para um plano superior

Resultados inesperados

Possíveis causas:

• Formulação imprecisa da consulta
• O assistente de IA interpretou mal a consulta
• Os dados mudaram desde a última consulta

Solução:

1. Reformule a consulta de forma mais específica
2. Especifique IDs exatos dos objetos (vídeos, projetos)
3. Use exemplos da documentação
4. Verifique a precisão dos dados na interface web

Comparação com outras formas de trabalho

O que fazer a seguir?

Recursos adicionais

1. Referência de API — documentação completa das APIs do Kinescope usadas pelo MCP Server
2. Documentação MCP — documentação oficial do Model Context Protocol da Anthropic
3. Repositório GitHub — documentação técnica atual e exemplos

Seções relacionadas

1. Guias para Desenvolvedores — trabalhando com API e SDK para integração profunda
2. Analytics — mais sobre métricas e relatórios
3. Integrações — outras formas de integrar o Kinescope
4. Gerenciamento de Vídeos — organizando e gerenciando sua biblioteca de vídeos

Precisa de ajuda?

• Chat de suporte na interface do Kinescope — respostas rápidas dos especialistas
• Site do Kinescope — formulário de feedback

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