Subscribr MCP

Conecte sua conta paga do Subscribr ao Claude, ChatGPT, OpenClaw, Cursor, VS Code e outros assistentes de IA usando MCP. Acesse seu quadro de Projects, Tasks, notificações, canais, scripts, ideias, templates, Voice Profiles e pesquisa Intel diretamente da conversa.

O Que Isto Faz

O Subscribr suporta o 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 workspace do Subscribr
• Pesquisar canais e vídeos do YouTube a partir do Intel
• Abrir rich MCP Apps para resultados Intel, pré-visualizações de scripts e o quadro interativo de Projects
• Criar, atualizar, mover, promover, comentar, arquivar e restaurar Projects quando sua função permitir
• Gerenciar templates personalizados e validar um Voice Profile rigoroso antes de confirmá-lo explicitamente

Exemplos de prompts:

• "Mostre-me meus scripts mais recentes"
• "Pesquise no Intel vídeos outliers sobre treinos em casa"
• "Consulte @mkbhd e resuma o canal"
• "Mostre meu quadro de Projects e o que precisa da minha atenção"

O acesso via MCP está disponível para todas as equipes pagas do Subscribr.

Por Onde Começar

Abra AI Integrations na navegação principal do aplicativo. Essa página fornece:

• A URL do seu servidor MCP
• Orientações de configuração específicas por cliente
• Instruções de conexão com OAuth como primeira opção
• 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	Conector em modo desenvolvedor com OAuth guiado
Cursor / VS Code	Configuração avançada de MCP HTTP remoto
OpenClaw	Ponte MCP avançada ou configuração de servidor remoto
Outros clientes MCP	Use a mesma URL do servidor; os passos exatos variam por cliente

Configuração Padrão

Etapa 1: Abra AI Integrations no Subscribr

1. Entre no Subscribr
2. Abra o menu da sua conta e selecione AI Integrations
3. Copie a URL do seu servidor MCP

A URL do servidor de produção é:

https://subscribr.ai/mcp/subscribr

Etapa 2: Adicione o Subscribr ao Seu Cliente de IA

No seu cliente de IA, adicione um novo servidor ou integração MCP e use:

• Server URL: https://subscribr.ai/mcp/subscribr
• Transport: HTTP ou Streamable HTTP se o cliente solicitar
• Auth: OAuth, se o cliente suportar

Etapa 3: Conclua o OAuth

A maioria dos clientes de usuário final redirecionará você para o Subscribr automaticamente.

1. Entre no Subscribr na janela do navegador
2. Aprove a conexão MCP
3. Volte ao seu cliente de IA
4. Inicie um novo chat e use as ferramentas do Subscribr

Notas por Cliente

Claude Desktop

• Adicione uma nova integração/servidor
• Cole a URL MCP do Subscribr
• Conclua o fluxo de autorização no navegador

Claude.ai

• Abra Integrations
• Adicione a URL MCP do Subscribr
• Conclua o OAuth no navegador

ChatGPT

• Abra Settings → Apps & Connectors → Advanced settings
• Ative o Developer mode, crie um conector e use a mesma URL MCP
• Conclua o OAuth no navegador

Estamos preparando o Subscribr para o diretório de aplicativos do ChatGPT e o Claude Connectors Directory. Até que essas listagens sejam aprovadas, conecte-se diretamente com a URL do servidor acima.

Cursor / VS Code

Esses são clientes MCP mais voltados para desenvolvedores.

• Adicione um novo remote HTTP MCP server
• Use a URL MCP do Subscribr acima
• Escolha HTTP ou Streamable HTTP se for solicitado
• Se o cliente suportar OAuth, use-o
• Se o cliente suportar apenas cabeçalhos bearer manuais, use um personal access token

OpenClaw

As configurações do OpenClaw variam mais do que as do Claude ou ChatGPT.

• Adicione o Subscribr por meio da ponte MCP, plugin ou configurações de servidor remoto do OpenClaw
• Use a mesma URL MCP
• Prefira OAuth se sua configuração do OpenClaw suportar
• Se suportar apenas autenticação bearer manual, use um personal access token

Personal Access Tokens (Avançado)

A maioria dos clientes não precisa de um token para Claude, Claude.ai ou ChatGPT.

Os tokens são apenas para clientes avançados ou fluxos de trabalho locais que não suportam bem OAuth.

Restrições importantes:

• Os tokens são gerenciados na página Developer
• Somente administradores da equipe podem gerenciar tokens
• A página Developer requer um plano com API habilitada

Se o seu cliente precisar de autenticação bearer manual, use:

Authorization: Bearer YOUR_TOKEN_HERE

Ferramentas Disponíveis

O Subscribr expõe um catálogo semântico focado de 23 ferramentas em /mcp/subscribr. As ferramentas de leitura que produzem aplicativos são separadas pelo formato do resultado para que Claude e ChatGPT possam selecionar a interface interativa correta durante a descoberta de ferramentas.

Projects e Trabalho

Ferramenta	O Que Faz
list_projects	Listar/filtrar Projects e iniciar o quadro interativo
get_project	Buscar um Project canônico baseado em ideia ou Script
get_script_project	Buscar um Project baseado em Script e iniciar sua pré-visualização interativa
create_project	Criar um Project de ideia ou Script com idempotência
update_project	Editar, mover, pré-visualizar/arquivar ou restaurar um Project
promote_idea	Pré-visualizar ou promover uma ideia para um Script vinculado sem geração
add_project_comment	Adicionar um comentário de Project e menções limitadas
list_my_work	Listar trabalho atribuído e notificações de Project
mark_project_notifications_read	Marcar uma, várias ou todas as notificações de Project como lidas

Pesquisa, Operações e Workspace

Ferramenta	O Que Faz
search_youtube_channels	Pesquisar canais do YouTube por meio do Intel
search_youtube_videos	Pesquisar vídeos do YouTube por meio do Intel
get_youtube_channel	Consultar um canal do YouTube e mostrar seu aplicativo de detalhes
get_youtube_video	Consultar um vídeo do YouTube e mostrar seu aplicativo de detalhes
generate_ideas	Pré-visualizar e despachar geração assíncrona de ideias
get_operation	Consultar uma operação durável retornada pelo Subscribr
get_channel_workspace	Ler contexto limitado de Canal, concorrente, template e voice
list_research_videos	Navegar por vídeos de canais monitorados no aplicativo de vídeo interativo
get_research_video	Buscar um vídeo monitorado e mostrar seu aplicativo de detalhes
list_research_bookmarks	Navegar por bookmarks salvos de Canais e vídeos
save_bookmark	Salvar um bookmark de canal ou vídeo do Intel com idempotência
save_template	Criar, atualizar, pré-visualizar/arquivar ou restaurar um template personalizado
validate_voice_profile	Validar/canonicalizar um Voice Profile completo e emitir um recibo
commit_voice_profile	Confirmar explicitamente o Voice Profile exato vinculado ao recibo

Ações destrutivas ou custosas usam recibos de pré-visualizar-depois-confirmar. Gravações repetidas usam chaves de idempotência, e gravações com revisão usam a revisão esperada mais recente.

Fluxos de Trabalho de Exemplo

Pesquisa e Ideação

1. Pergunte: "Pesquise no Intel vídeos outliers sobre preparo de refeições"
2. Pergunte: "Consulte o principal canal desses resultados"
3. Pergunte: "Gere 5 ideias para o meu canal inspiradas nesse padrão"
4. Pergunte: "Marque esse canal como bookmark para depois"

Revisão de Scripts

1. Pergunte: "Mostre-me meus scripts recentes"
2. Pergunte: "Abra o primeiro script"
3. Revise o script com seu assistente de IA e peça feedback ou reescritas

Pesquisa Competitiva

1. Pergunte: "Consulte o canal do YouTube @competitorhandle"
2. Pergunte: "Pesquise no Intel vídeos semelhantes a este nicho"
3. Pergunte: "Resuma o que faz os principais outliers se destacarem"

Solução de Problemas

"Não vejo as ferramentas de Projects"

Confirme que a conexão usa https://subscribr.ai/mcp/subscribr.

Se o Subscribr já estava conectado antes das ferramentas mais recentes serem lançadas, atualize a lista de ferramentas ou reconecte-o e inicie uma nova conversa.

"Não consigo adicionar bookmarks ou gerar ideias"

Ações de escrita exigem acesso de editor ou superior na sua equipe.

"O cliente diz que a autenticação é necessária"

Isso é normal para clientes com capacidade OAuth. Conclua o fluxo de login e autorização no navegador.

"Meu cliente suporta apenas cabeçalhos bearer manuais"

Use um personal access token, mas somente se:

• sua equipe tiver um plano com API habilitada
• um administrador da equipe puder criar o token para você

"Falha na conexão"

Verifique:

1. Se a URL do servidor é exatamente https://subscribr.ai/mcp/subscribr
2. Se sua equipe está em um plano pago
3. Se seu cliente está usando MCP HTTP remoto, não o modo stdio local

Segurança e Privacidade

• Todos os dados MCP são limitados à sua conta autenticada do Subscribr
• Você só pode acessar dados da sua própria equipe
• Autenticação por cookie de sessão não é permitida para solicitações MCP
• OAuth é preferido porque seu cliente de IA nunca recebe sua senha
• Os tokens podem ser revogados a qualquer momento na página Developer

AI Agent Skill 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 skill file 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 em .agents/skills/ (Codex, Cursor, OpenClaw) e .claude/skills/ (Claude Code). O pacote npm também inclui um manifesto portátil de Agent Plugins para clientes com suporte a plugins. Para instalar também a CLI Python sem dependências junto:

npx @giltotherescue/subscribr-cli --with-cli

A CLI encapsula cada endpoint da API do Subscribr e é útil para automação, scripts e uso por agentes de IA. Use a CLI para trabalho determinístico de API; use MCP para fluxos de conversação de Projects, workspace e Intel. Veja o repositório no GitHub.

A skill é focada na REST API (plano Automation ou superior), que cobre a plataforma completa, incluindo criação de conteúdo, geração de scripts, exportações e webhooks. Ela também documenta ferramentas MCP para pesquisa e ideação.

Você pode encontrá-la na página Developer no aplicativo, na aba Overview.

A AI Agent Skill é 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 gerenciamento de Projects/fluxos de trabalho dentro de clientes de chat de IA. O endpoint canônico fornece fluxos de trabalho suportados de Projects, Tasks/notificações, templates personalizados e Voice Profile rigoroso, com fallback somente texto e um quadro de Projects integrado.

Para criação de conteúdo — criar scripts, gerar outlines, 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 Developer.

Próximos Passos

• Abra /ai-integrations no Subscribr para conectar seu cliente de IA
• Instale a AI Agent Skill para Claude Code ou Codex
• Aprenda sobre pesquisa Intel
• Explore Video Ideas
• Consulte a documentação da API para acesso programático completo