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/mcpClaude (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/mcpChatGPT
Configurações -> Conectores -> Avançado -> Modo desenvolvedor, adicione um conector com a URL abaixo, depois conecte e faça login.
https://getyoutubetranscript.com/api/mcpClaude 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
| Ferramenta | O que faz | Custo |
|---|---|---|
get_youtube_transcript | Transcrição completa mais título, autor e miniatura | 1 crédito |
search_youtube | Busca vídeos ou canais, com paginação | 1 crédito |
get_channel_latest_videos | Metadados de um canal e uploads recentes | Grátis |
search_channel_videos | Busca dentro de um canal | 1 crédito |
list_channel_videos | Todos os vídeos que um canal enviou | 1 crédito |
list_playlist_videos | Todos os vídeos de uma playlist | 1 crédito |
get_credits | Saldo de créditos restante da chave | Grá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
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: "...")
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
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.