YouTube Transcript MCP Server: Setup Guide for Claude and Other AI Tools

O Model Context Protocol padroniza como um cliente de IA descobre e chama ferramentas externas. Por baixo dos panos é JSON-RPC 2.0 - o cliente pergunta ao servidor quais ferramentas existem e seus esquemas de entrada, depois as invoca pelo nome com argumentos estruturados e recebe um resultado estruturado de volta, tudo dentro do mesmo turno de conversa.

Servidores MCP funcionam sobre um de dois transportes: stdio, onde o cliente lança o servidor como um subprocesso local (típico para ferramentas que precisam de acesso ao sistema de arquivos local), ou Streamable HTTP, onde o servidor é remoto e acessível via HTTPS por qualquer número de clientes ao mesmo tempo - que é o que este servidor usa. (Um transporte HTTP+SSE mais antigo existe em algumas documentações, mas está obsoleto em favor do Streamable HTTP.) Na prática, isso significa que você nunca roda nada localmente para usar este servidor - basta apontar seu cliente para a URL.

As ferramentas paginadas (search, list-channel, list-playlist) aceitam um token de continuation de uma resposta anterior para buscar a próxima página, em vez de um par offset/limit.

Cadastre-se pelo painel e crie uma chave de API - 100 créditos estão incluídos grátis, sem cartão necessário. Esta chave é o bearer token com o qual o servidor MCP se autentica na maioria dos clientes.

Para o Claude Desktop, adicione isto ao claude_desktop_config.json - no Mac fica em ~/Library/Application Support/Claude/claude_desktop_config.json, no Windows em %APPDATA%\Claude\claude_desktop_config.json:

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

Substitua sk_live_... pela sua própria chave de API. Reinicie o cliente completamente e as 6 ferramentas acima aparecem automaticamente - a maioria dos clientes só lê essa configuração ao iniciar, não em um hot reload.

Para o Claude Code, pule o arquivo JSON completamente e registre o servidor pela CLI:

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

Por padrão, o Claude Code armazena isso por projeto (-s local); passe -s user para deixá-lo disponível em todos os projetos.

Qualquer cliente que suporte um servidor MCP remoto via Streamable HTTP com cabeçalhos personalizados usa o mesmo formato de configuração - apenas o arquivo e os nomes dos campos variam (por exemplo, o .cursor/mcp.json do Cursor, o painel de configurações de MCP do Windsurf). Se um cliente só suportar servidores baseados em OAuth em vez de um cabeçalho bearer estático, use o fluxo OAuth descrito a seguir.

Para clientes que autenticam servidores MCP via OAuth em vez de uma chave de API colada (por exemplo, os conectores personalizados do ChatGPT), este servidor também suporta OAuth 2.1 com Dynamic Client Registration - aponte o cliente para a mesma URL do servidor e ele descobre os metadados OAuth e guia você por um fluxo de autorização em vez de pedir um bearer token diretamente.

Depois de conectado, comandos naturais bastam - o modelo decide qual ferramenta chamar:

• "Pegue a transcrição de youtube.com/watch?v=dQw4w9WgXcQ e resuma em 3 tópicos."
• "Pesquise no YouTube por 'Next.js server actions' e liste os 5 melhores resultados."
• "Liste todos os vídeos que @mkbhd enviou e encontre os que mencionam 'bateria'."