Subscribr MCP
oficialSeu assistente de IA para YouTube para criar mais vídeos e economizar mais de 10 horas por semana
O que você pode fazer com Subscribr MCP?
- List your recent scripts — Ask the assistant to fetch your scripts with
my_scriptsand open a specific one viaget_my_scriptfor review or feedback. - Research YouTube channels — Use
intel_search_channelsorget_youtube_channelto look up a channel by handle, ID, or URL and get a summary. - Find outlier videos on a topic — Search Intel with
intel_search_videosto discover high-performing videos and patterns in your niche. - Generate video ideas — Ask the assistant to call
generate_ideasfor one of your channels, optionally inspired by Intel research. - Bookmark channels or videos — Save a YouTube channel or video to your Subscribr bookmarks using
add_bookmarkfor later reference. - Check your team plan and credits — Retrieve your team info, plan status, and available credits with
my_team.
Documentação
Conecte sua conta paga do Subscribr ao Claude, ChatGPT, OpenClaw, Cursor, VS Code e outros assistentes de IA usando MCP. Acesse seus canais, scripts, ideias, pesquisas do Intel e favoritos diretamente da conversa.
O Que Isso Faz
O Subscribr oferece suporte ao Model Context Protocol (MCP), que permite que clientes de IA se conectem com segurança a ferramentas e dados externos.
Uma vez conectado, seu cliente de IA pode:
- Ler dados do seu espaço de trabalho do Subscribr
- Consultar canais e vídeos do YouTube pelo Intel
- Abrir cartões ricos do aplicativo MCP para resultados do Intel e pré-visualizações de scripts
- Executar ações de gravação, como adicionar favoritos ou gerar ideias, se a função da sua equipe permitir
Exemplos de prompts:
- "Mostre meus scripts mais recentes"
- "Pesquise no Intel por vídeos fora da curva sobre treinos em casa"
- "Consulte @mkbhd e resuma o canal"
- "Adicione este canal aos meus favoritos"
O acesso MCP está disponível para equipes pagas do Subscribr. As ferramentas do Intel exigem um plano com Intel habilitado, que nas assinaturas normais atualmente é Creator ou superior.
Por Onde Começar
Abra Integrações de IA na navegação principal do aplicativo. Essa página fornece:
- A URL do seu servidor MCP
- Orientações de configuração específicas para cada cliente
- Instruções de conexão OAuth-first
- Notas avançadas para clientes manuais baseados em token
Clientes Compatíveis
| Tipo de Cliente | Estilo de Configuração |
|---|---|
| Claude Desktop | Configuração guiada por OAuth |
| Claude.ai | Configuração guiada por OAuth |
| ChatGPT | Configuração guiada por OAuth quando MCP remoto/conectores disponíveis |
| Cursor / VS Code | Configuração avançada de MCP HTTP remoto |
| OpenClaw | Configuração avançada de ponte MCP ou servidor remoto |
| Outros clientes MCP | Use a mesma URL do servidor; as etapas exatas variam por cliente |
Configuração Padrão
Passo 1: Abra Integrações de IA no Subscribr
- Faça login no Subscribr
- Abra Integrações de IA na navegação principal
- Copie a URL do seu servidor MCP
A URL do servidor de produção é:
https://subscribr.ai/mcp/subscribr
Passo 2: Adicione o Subscribr ao Seu Cliente de IA
No seu cliente de IA, adicione um novo servidor MCP ou integração e use:
- URL do Servidor:
https://subscribr.ai/mcp/subscribr - Transporte:
HTTPouStreamable HTTPse o cliente perguntar - Autenticação: OAuth, se o cliente oferecer suporte
Passo 3: Complete o OAuth
A maioria dos clientes de usuário final redirecionará você para o Subscribr automaticamente.
- Faça login no Subscribr na janela do navegador
- Aprove a conexão MCP
- Retorne ao seu cliente de IA
- Inicie um novo chat e use as ferramentas do Subscribr
Notas do Cliente
Claude Desktop
- Adicione uma nova integração/servidor
- Cole a URL MCP do Subscribr
- Complete o fluxo de autorização do navegador
Claude.ai
- Abra Integrações
- Adicione a URL MCP do Subscribr
- Complete o OAuth no navegador
ChatGPT
- Adicione o Subscribr através do fluxo de MCP remoto/conectores quando sua conta ChatGPT oferecer suporte
- Use a mesma URL MCP
- Complete o OAuth no navegador
Cursor / VS Code
Estes são clientes MCP mais orientados a desenvolvedores.
- Adicione um novo servidor MCP HTTP remoto
- Use a URL MCP do Subscribr acima
- Escolha
HTTPouStreamable HTTPse perguntado - Se o cliente oferecer suporte a OAuth, use-o
- Se o cliente oferecer suporte apenas a cabeçalhos bearer manuais, use um token de acesso pessoal
OpenClaw
As configurações do OpenClaw variam mais do que as do Claude ou ChatGPT.
- Adicione o Subscribr através da sua ponte MCP, plugin ou configurações de servidor remoto do OpenClaw
- Use a mesma URL MCP
- Prefira OAuth se sua configuração do OpenClaw oferecer suporte
- Se oferecer suporte apenas a autenticação bearer manual, use um token de acesso pessoal
Tokens de Acesso Pessoal (Avançado)
A maioria dos clientes não precisa de um token para Claude, Claude.ai ou ChatGPT.
Tokens são apenas para clientes avançados ou fluxos de trabalho locais que não oferecem bom suporte a OAuth.
Restrições importantes:
- Tokens são gerenciados na página Desenvolvedor
- Apenas administradores da equipe podem gerenciar tokens
- A página Desenvolvedor requer um plano com API habilitada
Se seu cliente precisar de autenticação bearer manual, use:
Authorization: Bearer YOUR_TOKEN_HERE
Ferramentas Disponíveis
O Subscribr expõe 15 ferramentas para o cliente.
Dados da Sua Conta
| Ferramenta | O Que Faz |
|---|---|
| my_team | Informações da equipe, status do plano, créditos e dados do usuário |
| my_channels | Lista seus canais do Subscribr |
| get_my_channel | Obtém detalhes de um canal específico |
| my_scripts | Lista seus scripts |
| get_my_script | Obtém o conteúdo completo do script por ID |
| my_videos | Navega pelos vídeos dos seus canais monitorados |
| get_my_video | Obtém detalhes completos do vídeo e transcrição opcional |
| get_my_channel_ideas | Visualiza ideias de vídeos para um canal |
| my_bookmarks | Lista favoritos salvos |
Pesquisa do YouTube (Intel)
| Ferramenta | O Que Faz | Plano Necessário |
|---|---|---|
| intel_search_channels | Pesquisa o banco de dados de canais do Intel do Subscribr | Creator ou superior |
| intel_search_videos | Pesquisa no Intel por vídeos fora da curva e padrões | Creator ou superior |
| get_youtube_channel | Consulta um canal do YouTube por handle, ID ou URL | Creator ou superior |
| get_youtube_video | Consulta um vídeo do YouTube por ID ou URL | Creator ou superior |
Ações
| Ferramenta | O Que Faz | Permissão Necessária |
|---|---|---|
| generate_ideas | Gera novas ideias de vídeos para um canal do Subscribr | Editor ou superior |
| add_bookmark | Salva um canal ou vídeo do YouTube nos favoritos | Editor ou superior |
Visualizadores podem usar ferramentas somente leitura. Ações de gravação exigem acesso de editor ou superior.
Exemplos de Fluxos de Trabalho
Pesquisa e Ideação
- Pergunte: "Pesquise no Intel por vídeos fora da curva sobre preparo de refeições"
- Pergunte: "Consulte o canal principal desses resultados"
- Pergunte: "Gere 5 ideias para meu canal inspiradas por esse padrão"
- Pergunte: "Adicione esse canal aos favoritos para mais tarde"
Revisão de Script
- Pergunte: "Mostre meus scripts recentes"
- Pergunte: "Abra o primeiro script"
- Revise o script com seu assistente de IA e peça feedback ou reescritas
Pesquisa Competitiva
- Pergunte: "Consulte o canal do YouTube @concorrente"
- Pergunte: "Pesquise no Intel por vídeos semelhantes a este nicho"
- Pergunte: "Resuma o que faz os principais destaques se sobressaírem"
Solução de Problemas
"Não vejo todas as 15 ferramentas"
As ferramentas do Intel exigem Creator, Automation ou Scale. Chame my_team para verificar os detalhes do seu plano atual.
"Não consigo adicionar favoritos ou gerar ideias"
Ações de gravação exigem acesso de editor ou superior na sua equipe.
"O cliente diz que é necessária autenticação"
Isso é normal para clientes compatíveis com OAuth. Complete o fluxo de login e autorização no navegador.
"Meu cliente só oferece suporte a cabeçalhos bearer manuais"
Use um token de acesso pessoal, mas apenas se:
- sua equipe tiver um plano com API habilitada
- um administrador da equipe puder criar o token para você
"Falha na conexão"
Verifique:
- A URL do servidor é exatamente
https://subscribr.ai/mcp/subscribr - Sua equipe está em um plano pago
- Seu cliente está usando MCP HTTP remoto, não o modo stdio local
Segurança e Privacidade
- Todos os dados MCP estão limitados à sua conta autenticada do Subscribr
- Você só pode acessar os dados da sua própria equipe
- Autenticação por cookie de sessão não é permitida para solicitações MCP
- OAuth é preferível porque seu cliente de IA nunca recebe sua senha
- Tokens podem ser revogados a qualquer momento na página Desenvolvedor
Skill para Agente de IA e CLI (Claude Code / Codex / Cursor / OpenClaw)
Se você usa um agente de codificação de IA como Claude Code, Codex, Cursor ou OpenClaw, pode instalar um arquivo de skill que ensina o agente a usar a API REST do Subscribr. A skill cobre autenticação, endpoints, fluxos de trabalho comuns e links para a referência completa da API.
Instale com um comando a partir da raiz do seu projeto:
npx @giltotherescue/subscribr-cli
Isso instala a skill tanto em .agents/skills/ (Codex, Cursor, OpenClaw) quanto em .claude/skills/ (Claude Code). Também funciona com qualquer outro agente que siga a especificação Agent Skills. Para instalar também a CLI Python sem dependências junto:
npx @giltotherescue/subscribr-cli --with-cli
A CLI encapsula todos os endpoints da API do Subscribr e é útil para automação, scripting e uso de ferramentas por agentes de IA. Veja o repositório no GitHub.
A skill é focada na API REST (plano Automation e superior), que cobre toda a plataforma, incluindo criação de conteúdo, geração de scripts, exportações e webhooks. Ela também documenta as ferramentas MCP para pesquisa e ideação.
Você pode encontrar isso na página Desenvolvedor no aplicativo, na aba Visão Geral.
A Skill para Agente de IA é para agentes de codificação que chamam APIs em seu nome. Para clientes de IA conversacionais como Claude Desktop ou ChatGPT, use a configuração MCP descrita acima.
MCP vs API REST
O servidor MCP é projetado para pesquisa, ideação e revisão de conteúdo dentro de clientes de chat de IA. Ele fornece acesso de leitura aos dados da sua conta e pesquisa do Intel, além de ações leves de gravação, como adicionar favoritos e gerar ideias.
Para criação de conteúdo — criar scripts, gerar esboços, exportar conteúdo, gerenciar concorrentes ou configurar webhooks — use a API REST. A API REST requer um plano Automation ou superior e é gerenciada na página Desenvolvedor.
Próximos Passos
- Abra
/ai-integrationsno Subscribr para conectar seu cliente de IA - Instale a Skill para Agente de IA para Claude Code ou Codex
- Aprenda sobre pesquisa do Intel
- Explore Ideias de Vídeos
- Confira a documentação da API para acesso programático completo