Um servidor MCP do YouTube fornece ferramentas de assistente de IA para um fluxo de trabalho específico do YouTube. Não há um único recurso definido por trás do nome. Um servidor de transcrição pode ler faixas de legendas públicas, mas não possui login de conta ou ferramenta de upload; um conector de conta pode usar OAuth e expor operações totalmente diferentes.
Para criadores e pequenas empresas, comece com o resultado: um resumo do vídeo original, uma tabela dos envios do seu canal ou um rascunho do pacote de envio. Não escolha um servidor pelo número de ferramentas. Este guia verifica a documentação pública em 12 de novembro de 2026; ele não reivindica uma conexão de conta ativa ou teste de upload.
Escolha por dados e permissões
| Objetivo | Conexão necessária | Limite para verificar |
|---|---|---|
| Resuma um vídeo público | Um servidor com capacidade de transcrição | Disponibilidade de legenda e cobertura de carimbo de data/hora; não há garantia para todos os vídeos públicos |
| Leia títulos públicos, opiniões e comentários | Acesso à API de dados do YouTube, geralmente uma chave de API | Cota, paginação e escopo de dados públicos |
| Leia dados privados da conta ou modifique um canal | OAuth com os escopos e ferramentas apropriados | A conta/canal real e a ação permitida |
| Estude a retenção de público ou receita | O serviço de análise relevante ou uma exportação autorizada | As estatísticas de vídeos públicos não são privadas do YouTube Analytics |
Uma opção comunitária concreta para Claude Desktop
Promethic-Labs/youtube-mcp é um servidor comunitário com extensão Desktop. Sua configuração documentada é:
- Revise o repositório e baixe
YouTube.mcpbde sua versão vinculada do GitHub. - Abra o arquivo com Claude Desktop e revise os detalhes da instalação.
- Para transcrições, sua implementação não requer chave de API. Para ferramentas públicas de pesquisa e metadados, adicione uma chave da API de dados do YouTube do projeto do Google nas configurações da extensão.
- Inicie uma nova conversa com o conector habilitado. Primeiro liste as ferramentas disponíveis e leia um vídeo público que você conhece.
O mantenedor afirma que a extensão Desktop usa o tempo de execução do aplicativo; sua configuração de origem/CLI separada precisa do Node e de uma compilação. Não coloque o arquivo de extensão em um campo de URL do conector remoto. O oficial Guia de extensão de desktop explica essa superfície de instalação local.
Este exemplo é uma forma de ler dados públicos, não uma recomendação para conceder acesso de gravação de canal. Sua lista de ferramentas inclui transcrições, metadados de vídeo/canal, comentários e listas de reprodução; uma ferramenta pública de leitura de playlists não implica uma ferramenta de edição de playlists.
Sua primeira tarefa de pesquisa deve preservar as evidências
Leia estes três URLs de vídeo. Retorne uma tabela com o URL do vídeo, data de publicação, reivindicações principais e carimbos de data/hora da transcrição de apoio. Marque legendas e lacunas ausentes. Sugira três ângulos originais para nosso próximo tutorial de produto, separando os fatos originais de suas sugestões. Não poste comentários nem carregue nada.
Este é um exemplo de solicitação, não um resultado de teste. Verifique se cada carimbo de data/hora existe e dá suporte à reivindicação. Um título e uma descrição não são uma transcrição; se apenas estes estivessem disponíveis, o relatório deveria dizê-lo. Se forem usados comentários, preserve o tamanho da amostra e o método de classificação em vez de chamar alguns comentários principais de “o que o público pensa”.
Para comparações de canais, controle por idade. Um vídeo publicado ontem teve menos tempo para acumular visualizações do que um publicado no ano passado. Mantenha as datas de publicação, as janelas comparáveis e o tempo de recuperação; não conclua que um estilo de título causou desempenho apenas a partir da contagem bruta de visualizações.
Limites de transcrição, API e cota que muitas vezes ficam confusos
do Google endpoint de download de legenda oficial requer permissão para editar o vídeo. Isso é diferente da recuperação de legendas do player público do servidor da comunidade. Este último pode falhar quando uma faixa está faltando, um vídeo é restrito ou o YouTube altera seus endpoints internos. “Nenhuma chave de API para transcrições” não é acesso oficial irrestrito às legendas.
Para a API oficial, uma chave de API identifica um projeto para chamadas de dados públicos; OAuth é necessário para dados e alterações privadas do usuário. Fazer login em um canal não cria uma transcrição que não existe.
A orientação de cotas pode envelhecer rapidamente. O README da comunidade contém uma tabela de custos de pesquisa mais antiga; Atual do Google calculadora de cotas separa os buckets de pesquisa e upload dos outros endpoints. Use a documentação atual do Google e seu console do Cloud, e não a suposição geral de que “todas as chamadas compartilham 10.000 unidades”. A paginação também consome chamadas; comece com uma lista limitada em vez de rastrear um canal inteiro.
Usando o conector do YouTube no Orkas
O catálogo de conectores do Orkas inclui o YouTube. Abra Connectors, encontre o YouTube, preencha a autorização oferecida e confirme seu estado. Selecione-o para a tarefa, solicite as operações disponíveis e faça da primeira solicitação uma pequena leitura. As ferramentas reais dependem da autorização e do serviço conectado; a descrição do catálogo não é prova de que todas as legendas, métricas ou uploads funcionarão.
Uma progressão útil é pesquisa → esboço → roteiro → rascunho do vídeo → pacote de upload revisado. Forneça ao redator ou ao agente do VideoStudio a pesquisa de origem e os fatos do produto aprovado. Mantenha o título final, a descrição, a miniatura e a escolha de visibilidade juntos para revisão. Este artigo não estabelece um fluxo de publicação automático ou uma conexão bem-sucedida do Orkas com o YouTube.
Para a etapa de edição, consulte Habilidades de edição de vídeo de Claude; para uma tarefa de produção mais ampla, consulte produção de vídeo em Orkas.
Diagnosticar a falha antes de substituir a ferramenta
| Sintoma | Verificação útil |
|---|---|
| Sem transcrição | Verifique as legendas no player e qual faixa/idioma a ferramenta solicitou; relatar evidências indisponíveis. |
| A pesquisa pública falha | Verifique a ativação da API, as principais restrições e a cota atual do projeto. |
| Canal errado | Confirme a conta autorizada e a identidade do canal antes de qualquer leitura ou gravação privada. |
| Os números discordam | Compare o mesmo vídeo, definição de métrica, período e tempo de recuperação; permitir atrasos na atualização. |
| Ferramenta de upload ou edição ausente | Inspecione a lista de ferramentas reais e os escopos OAuth do servidor. Não presuma que um conector de leitura inclui gravações. |
Perguntas frequentes
Todo servidor MCP do YouTube é um servidor oficial do Google?
Não. O servidor usado neste guia é um projeto comunitário. A API de dados do Google é oficial; um invólucro não é automaticamente um produto do Google.
Ele consegue ler as legendas de todos os vídeos públicos?
Não. As legendas podem estar faltando, restritas ou inacessíveis para esse método de recuperação. A API de download oficial também requer permissão de edição.
Uma chave de API permite que o agente carregue vídeos?
Não. Dados privados e operações de modificação exigem autorização OAuth apropriada e uma implementação que expõe a ação.
As contagens de visualizações públicas podem substituir os dados de retenção?
Não. As estatísticas públicas não estabelecem onde os espectadores saem ou como um vídeo gerou receita. Use análises autorizadas ou uma exportação para essas perguntas.
Fontes e escopo
Servidor da comunidade e lista de ferramentas; do Google baixar legenda, autorização e cota documentos. Verificado em 12 de novembro de 2026. A configuração é documentada, não testada ao vivo com uma conta do YouTube; nenhuma recuperação ou upload de transcrição é apresentado como um experimento aqui.