Servidor MCP do YouTube

Uma única URL remota dá ao Claude, ChatGPT, Cursor e qualquer outro cliente compatível com MCP acesso real ao YouTube - transcrições, busca, canais e playlists - direto na conversa.

  • ✓100 créditos grátis para começar, sem cartão de crédito
  • ✓Uma única chave de API funciona tanto para o servidor MCP quanto para a API REST
  • ✓Consultar os uploads mais recentes de um canal é sempre grátis
  • ✓Funciona com Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline e Codex

O que é o MCP?

O Model Context Protocol permite que um assistente de IA chame ferramentas no meio da conversa, em vez de você copiar e colar dados manualmente. Este servidor é hospedado - aponte um cliente para uma URL e ele descobre as ferramentas disponíveis automaticamente. Nada para instalar ou rodar localmente.

Conecte em cerca de um minuto

HTTP em streaming. Cada cliente abaixo aponta para a mesma URL:

https://getyoutubetranscript.com/api/mcp

Claude (Web e Desktop)

Configurações -> Conectores -> Adicionar conector personalizado, depois cole a URL abaixo. O Claude pede para você entrar e conectar - nenhuma chave para copiar.

https://getyoutubetranscript.com/api/mcp

ChatGPT

Configurações -> Conectores -> Avançado -> Modo desenvolvedor, adicione um conector com a URL abaixo, depois conecte e faça login.

https://getyoutubetranscript.com/api/mcp

Claude Code

Um único comando, usando uma chave de API do seu painel:

claude mcp add --transport http getyoutubetranscript https://getyoutubetranscript.com/api/mcp \
  --header "Authorization: Bearer sk_live_..."

Cursor

Adicione ao ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (somente este projeto):

{
  "mcpServers": {
    "getyoutubetranscript": {
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

VS Code (Copilot)

Adicione ao .vscode/mcp.json. O VS Code pede a chave uma vez pelo input abaixo e a guarda com segurança em vez de gravá-la no arquivo:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gyt-api-key",
      "description": "GetYouTubeTranscript API key",
      "password": true
    }
  ],
  "servers": {
    "getyoutubetranscript": {
      "type": "http",
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gyt-api-key}"
      }
    }
  }
}

Codex CLI

Adicione ao ~/.codex/config.toml, depois exporte a variável de ambiente referenciada:

[mcp_servers.getyoutubetranscript]
url = "https://getyoutubetranscript.com/api/mcp"
bearer_token_env_var = "GYT_API_KEY"
export GYT_API_KEY="sk_live_..."

Windsurf e Cline

Mesmo formato JSON de mcpServers do Cursor acima, no próprio arquivo de configuração de MCP do Windsurf ou do Cline.

Ferramentas disponíveis

FerramentaO que fazCusto
get_youtube_transcriptTranscrição completa mais título, autor e miniatura1 crédito
search_youtubeBusca vídeos ou canais, com paginação1 crédito
get_channel_latest_videosMetadados de um canal e uploads recentesGrátis
search_channel_videosBusca dentro de um canal1 crédito
list_channel_videosTodos os vídeos que um canal enviou1 crédito
list_playlist_videosTodos os vídeos de uma playlist1 crédito
get_creditsSaldo de créditos restante da chaveGrátis

Mesmas ferramentas, mesmos custos em créditos, que a API REST - veja a documentação da API para os endpoints equivalentes.

Como fica na conversa

> O que o último vídeo do 3Blue1Brown disse sobre redes neurais?

Vou verificar o canal em busca do upload mais recente e depois buscar a transcrição.

get_channel_latest_videos(channel: "@3blue1brown")

get_youtube_transcript(video_url: "...")

O vídeo mais recente explica a retropropagação como perguntar repetidamente "como mudar esse número afeta o custo final?" - cobrindo a regra da cadeia, vetores de gradiente e por que redes mais profundas precisam de uma inicialização mais cuidadosa...

Preços

100 créditos grátis para começar. Depois $5/mês por 1.000 créditos ($4,50/mês na cobrança anual). Um crédito equivale a uma chamada de ferramenta bem-sucedida - chamadas com falha ou limitadas por taxa nunca são cobradas. O detalhamento completo, incluindo limites de taxa por plano, está na documentação da API.

Nota

Construindo seu próprio cliente, ou alimentando isso em geração de código? O contrato completo dos endpoints REST está publicado em /openapi.json (OpenAPI 3.0) - os mesmos endpoints que essas ferramentas MCP chamam por baixo dos panos. Versão legível para humanos: documentação da API.

Perguntas frequentes sobre o servidor MCP

Com quais clientes MCP isso funciona?

Qualquer cliente que fale MCP via HTTP em streaming: Claude (web, desktop, Code), ChatGPT, Cursor, VS Code, Windsurf, Cline e Codex CLI estão cobertos acima. Se um cliente suporta um servidor MCP remoto via HTTP, funcionará aqui também.

Preciso instalar ou rodar algo?

Não. O servidor é hospedado em getyoutubetranscript.com - um cliente só precisa da URL (e, para clientes sem OAuth, de uma chave de API). Não há processo local, nem yt-dlp, nem proxy para gerenciar.

Qual a diferença para um servidor MCP de código aberto que eu mesmo rodo?

Um servidor autohospedado roda na sua máquina ou no seu próprio servidor e geralmente exige que você gerencie o acesso ao YouTube (cookies, proxies, limites de taxa) sozinho. Este é hospedado: o cadastro é self-service, as requisições passam pela nossa infraestrutura, e você é cobrado em créditos em vez de gerenciar infraestrutura de scraping.

Recebi um erro 401 - o que faço?

Para clientes com OAuth (Claude, ChatGPT), reconecte o conector na página de configurações dele - a conexão provavelmente expirou ou foi revogada. Para clientes com chave de API (Cursor, VS Code, Claude Code, Codex), verifique se a chave foi colada corretamente sem espaços extras e se não foi revogada no painel.

Meu assistente respondeu de memória em vez de chamar uma ferramenta

Às vezes os modelos assumem que já conhecem o conteúdo de um vídeo. Peça explicitamente: "use a ferramenta MCP do YouTube para buscar a transcrição primeiro" - normalmente isso já força a chamada da ferramenta.

O que acontece se um vídeo não tiver legendas no idioma que pedi?

get_youtube_transcript retorna um erro TRANSCRIPT_NOT_FOUND em vez de um palpite no idioma errado. Tente sem o parâmetro de idioma (padrão em inglês) ou verifique antes se o vídeo realmente tem legendas nesse idioma no YouTube.

Isso consome minha cota da YouTube Data API?

Não. Não faz proxy do captions.download com sua própria chave, então não há um teto diário de 10.000 unidades para gerenciar - apenas o limite de taxa de requisições do seu plano.

Posso usar a mesma chave de API para MCP e a API REST?

Sim - uma chave, um saldo de créditos, compartilhado entre os dois. Conectar via OAuth (conectores do Claude/ChatGPT) em vez de uma chave também consome o mesmo saldo da conta; criamos uma chave dedicada nos bastidores que aparece na lista de chaves do seu painel, para você ver ou revogar essa conexão como qualquer outra chave.