Genviral

$ claude mcp add --transport http genviral https://mcp.genviral.io/mcp

Adiciona Genviral ao projeto atual. Execute /mcp depois para concluir o login OAuth.

Genviral publica em

TikTokInstagramYouTubePinterestLinkedInFacebookXBlueskyMastodonTelegram

Na prática

O que as pessoas realmente digitam

Cada um se resolve em chamadas de ferramentas reais contra sua conta — lendo o que já está agendado, gerando o que está faltando e enfileirando o resultado.

• O que eu postei na semana passada e qual teve melhor desempenho?
• Gere três apresentações de slides do TikTok sobre rotinas matinais e agende-as para esta semana.
• Mova tudo o que está agendado para sexta-feira para segunda-feira de manhã.
• Qual das minhas contas conectadas não postou nos últimos 10 dias?
• Faça um vídeo 9:16 a partir desta imagem e coloque-o na fila como um Instagram Reel.
• Rascunhe uma postagem no LinkedIn a partir deste changelog, mas não publique.

Duas camadas

Seu assistente decide. Genviral executa.

O assistente é bom em saber o que criar e quando deve ser publicado. Genviral é bom em ser a única conexão que pode realmente criar e publicar.

Seu assistente é responsável por

• Ele já sabe o que você quis dizer Você descreve a semana que deseja. O assistente escolhe o formato, escreve as legendas e decide o que vai para onde — sem sintaxe de comando, sem painel.
• Ele roda onde você já trabalha Claude, ChatGPT, Cursor, VS Code e todos os outros clientes MCP leem o mesmo servidor. Conecte-se uma vez por cliente, não uma vez por recurso.
• Ele carrega seu contexto Qualquer outra coisa na conversa — um documento de lançamento, um repositório, uma planilha de ganchos — vira material de origem para as postagens que ele rascunha.
• Ele fecha o ciclo As análises voltam pela mesma conexão, então o próximo lote é escrito com base no que realmente teve desempenho, em vez do que você esperava que tivesse.

Genviral é responsável por

• Contas sociais conectadas 10 plataformas atrás de uma única conexão OAuth — sem espera de aprovação de parceiro Meta ou TikTok e sem tokens por plataforma na configuração do seu assistente.
• Geração de mídia por IA Apresentações de slides, imagens e vídeos renderizados no Studio da Genviral. O assistente pede um ativo e recebe um pronto — a maioria dos servidores MCP só consegue agendar o que você já criou.
• Publicação segura contra duplicatas Cada gravação pelo servidor MCP exige uma chave de idempotência, e a publicação exige uma decisão explícita. Um agente que tenta novamente não pode postar a mesma coisa duas vezes.
• Espaços de trabalho e equipes Cada conexão está vinculada ao espaço pessoal ou a um espaço de trabalho que você escolhe durante o consentimento, então um assistente de agência não consegue alcançar um cliente para o qual não foi apontado.

Conecte-se

Uma URL, em menos de um minuto

Não há pacote para instalar nem servidor para executar. Escolha seu cliente, cole o endpoint e aprove as permissões que deseja que ele tenha.

$ claude mcp add --transport http genviral https://mcp.genviral.io/mcp

Adiciona Genviral ao projeto atual. Execute /mcp depois para concluir o login OAuth.

1. 02Etapa 2 de 4

   Adicione o servidor ao seu cliente

   Uma URL remota, nada para instalar e nenhum processo para manter em execução. O Claude Code aceita como comando; Cursor e VS Code aceitam como quatro linhas de JSON; Claude e ChatGPT aceitam nas configurações do conector. Claude Code $ claude mcp add --transport http genviral https://mcp.genviral.io/mcp
2. 03Etapa 3 de 4

   Aprove as permissões que você realmente deseja

   Fazer login abre uma tela de consentimento da Genviral. Escolha o espaço de trabalho ao qual a conexão está vinculada e conceda apenas os escopos que deseja que ela tenha — leitura e rascunho são separados da publicação, e a geração é separada novamente. Revogue qualquer conexão depois sem afetar as outras. Crie uma conta gratuita
3. 04Etapa 4 de 4

   Peça uma postagem e veja ela chegar

   Comece com um rascunho em vez de uma publicação, revise a legenda e a mídia no painel e deixe o assistente agendar o resto. A mídia que ele gera volta como uma galeria em clientes que renderizam recursos MCP. No seu assistente $ Draft one TikTok slideshow about this week's launch, $ put it in my content library, and stop before publishing.

Ferramentas

32 ferramentas, 4 permissões

Esta lista é gerada a partir do mesmo contrato que o servidor autoriza, então não pode anunciar uma ferramenta que o servidor não registra. Tudo aqui executa trabalho real — não há stubs que entregam um link e pedem para você terminar o trabalho.

Leia sua conta

context:read

Contas, postagens, análises e conteúdos da biblioteca. Nada nesta lista altera qualquer coisa.

• show_studio Somente leitura Mostra imagens e vídeos finalizados do Studio quando estiverem prontos.
• show_posts Somente leitura Mostra seu calendário de conteúdo, ou uma postagem nele, quando você pedir para ver.
• show_video Somente leitura Mostra um projeto de vídeo com uma prévia reproduzível e abre o editor completo a partir dele.
• show_library Somente leitura Mostra uma prévia visual dos seus arquivos ou apresentações de slides quando solicitado.
• show_viral_library Somente leitura Mostra cartões de referência viral quando você quiser navegar por inspiração.
• show_analytics Somente leitura Mostra um painel de análises para suas postagens ou uma conta rastreada quando você pedir para ver.
• browse_music Somente leitura Navegue pela biblioteca de músicas e suas próprias faixas enviadas.
• get_context Somente leitura Contas conectadas, espaços de trabalho, saldo do plano e de créditos e os modelos do Studio disponíveis para você.
• list_posts Somente leitura Postagens agendadas, rascunhadas e publicadas, com status de entrega por conta em cada uma.
• get_analytics Somente leitura Desempenho de postagens e contas, além de todas as contas que você rastreia para análises.
• research_trends Somente leitura Briefings de tendências para um nicho e uma prévia de qualquer apresentação de slides pública do TikTok antes de importá-la.
• research_reddit Somente leitura Pesquise no Reddit por postagens de origem e leia amostras limitadas de comentários dos tópicos que você escolher.
• analyze_content Somente leitura Avalie um gancho contra postagens virais reais, sugira estruturas de gancho comprovadas e encontre referências virais para uma ideia.
• search_viral_library Somente leitura Pesquise a biblioteca curada de postagens virais da Genviral e abra qualquer uma delas por completo.
• browse_library Somente leitura Arquivos, pastas, influenciadores (personagens consistentes), pacotes de imagens, modelos e apresentações de slides na sua biblioteca de conteúdo.
• search_images Somente leitura
• get_job Somente leitura Status de uma renderização, geração ou atualização de análises em andamento.

Crie e edite conteúdo

content:write

Rascunhos, envios, pastas, pacotes, modelos e apresentações de slides. Ainda não pode publicar.

• manage_music GravaçõesPode remover dados Adicione, renomeie, importe e exclua suas próprias faixas de música.
• manage_studio GravaçõesPode remover dados Salve criações do Studio na sua biblioteca, exclua-as ou favorite um modelo.
• upload_media Gravações Envie uma imagem ou vídeo para sua biblioteca de mídia.
• manage_library GravaçõesPode remover dados Crie, mova e exclua pastas, e mova itens entre elas.
• manage_assets GravaçõesPode remover dados Crie e edite pacotes de imagens e modelos reutilizáveis de apresentações de slides.
• manage_slideshow GravaçõesPode remover dados Duplique, edite, renderize ou exclua uma apresentação de slides, ou regenere um único slide.
• manage_analytics_targets GravaçõesPode remover dados Adicione, edite, remova e atualize as contas que você rastreia para análises.
• create_post Gravações Prepare uma postagem: mídia, legenda, configurações por plataforma, contas de destino e agendamento.
• update_post GravaçõesPode remover dados Reagende, edite, tente novamente ou exclua postagens que você já criou.

Agende e publique

posts:publish

O único escopo que pode colocar algo diante de um público. Conceda-o separadamente.

• schedule_editor_versions Gravações Prepare e agende versões renderizadas de um projeto de vídeo em suas contas.
• publish_post GravaçõesPode remover dados Confirme uma postagem preparada — publique agora ou entregue ao agendador.

Gere mídia

media:generate

Geração de imagens, vídeos e apresentações de slides. Este é o escopo que gasta créditos.

• edit_video GravaçõesPode remover dados Crie e edite projetos de vídeo: clipes, texto, legendas e música, depois renderize o corte final.
• remix_video Gravações Encontre vídeos de origem para remixar, visualize-os e importe clipes para um projeto.
• generate_slideshow GravaçõesPode remover dados Gere um carrossel de vários slides a partir de um briefing, ou importe um do TikTok, e depois renderize.
• generate_studio_media GravaçõesPode remover dados Gere imagens e vídeos no AI Studio a partir de um prompt ou de uma imagem de referência.

Segurança

O que ele pode fazer é sua decisão, não a do modelo

Entregar suas contas sociais a um assistente só é razoável se os limites forem aplicados em algum lugar que ele não alcance. Todos os quatro vivem no backend.

OAuth, não uma chave de API colada

Você faz login na Genviral para conectar. Sem chave de longa duração em um arquivo de configuração, em um perfil de shell ou em uma URL que seu assistente registra. Revogue uma conexão e ela para de funcionar imediatamente.

Permissões que você escolhe por conexão

4 escopos separados, aprovados em uma tela de consentimento da Genviral. Um assistente pode ter permissão para rascunhar e nunca publicar, ou para ler análises e nada mais.

Limitado a um espaço de trabalho

Você escolhe o espaço pessoal ou um espaço de trabalho específico ao aprovar. A conexão não pode ver, postar ou gastar créditos de nada fora dele.

Publicação é sempre deliberada

Publicar exige uma decisão explícita de publicar ou agendar, e cada gravação carrega uma chave de idempotência. Um agente que tenta novamente uma chamada falha não posta duas vezes.

Casos de uso

Seis fluxos de trabalho que valem a conexão

Cada um é uma única solicitação no assistente que você já tem aberto. O ciclo é o mesmo sempre: ele lê a conta, gera o que está faltando e coloca o resultado na fila.

• TikTok Uma semana de apresentações de slides a partir de uma frase O assistente puxa um briefing de tendências, gera cinco carrosséis a partir dele e coloca um por dia na fila — você aprova o lote em vez de escrevê-lo.
• Instagram Reels com legendas a partir de uma pasta aprovada Aponte para uma pasta da biblioteca de mídia. Ele legenda cada clipe, adiciona hashtags e os coloca na fila sem que nada saia do seu fluxo de aprovação.
• LinkedIn Postagens escritas a partir do trabalho que você já fez Como o assistente pode ver seu repositório, documentos ou changelog na mesma conversa, a postagem é rascunhada a partir de detalhes reais em vez de um resumo de um resumo.
• YouTube Shorts publicados com uma etapa de revisão Ele envia, preenche os metadados e publica como não listado primeiro. Você torna público depois de assistir — o assistente nunca recebe essa decisão por padrão.
• Pinterest Pins de infográficos gerados em um ritmo O Studio renderiza a imagem, o assistente escreve o texto do pin e tudo vai para o quadro certo — um prompt, sem etapa de design.
• Facebook Compartilhamento cruzado sem um segundo fluxo de trabalho Uma conexão cobre todas as plataformas, então espelhar o TikTok de hoje em uma página do Facebook uma hora depois é uma frase, não uma integração.

Guias

O que ler a seguir

As superfícies de desenvolvedor por trás da conexão. Cada chamada de ferramenta MCP termina em um desses endpoints.

• Referência da API de Parceiros da Genviral Cada ferramenta MCP é um wrapper fino sobre esses endpoints. Leia isto quando quiser as formas exatas de solicitação e resposta por trás de uma chamada de ferramenta. Ler guia
• Genviral para agentes de IA A visão geral curta e legível por máquina de ambos os caminhos de conexão — MCP para assistentes, REST para código — com a mesma lista de capacidades. Ler guia
• CLI da Genviral A alternativa para agentes de codificação: um binário, uma chave de API com escopo e nenhum cliente MCP envolvido. Útil para Codex, trabalhos de CI e cron. Ler guia

FAQ

Perguntas sobre MCP

O que as equipes perguntam antes de apontar um assistente para suas contas sociais.

O que é MCP?

O Model Context Protocol é um padrão aberto, introduzido pela Anthropic, para conectar assistentes de IA a ferramentas e dados externos. Um servidor MCP publica um conjunto de ferramentas; qualquer cliente MCP — Claude, ChatGPT, Cursor, VS Code e muitos outros — pode chamá-las. Isso significa que a Genviral só precisa expor suas capacidades uma vez para que todos os assistentes as usem.

Qual é a URL do servidor MCP da Genviral?

https://mcp.genviral.io/mcp. É um servidor remoto streamable-HTTP, então não há nada para instalar e nenhum processo local para manter ativo. Clientes que suportam descoberta também podem ler https://www.genviral.io/.well-known/mcp/server-card.json para encontrar o endpoint, a lista completa de ferramentas e os escopos disponíveis automaticamente.

Como faço para autenticar? Com OAuth. Quando seu cliente se conecta pela primeira vez, ele envia você para uma tela de consentimento da Genviral onde você faz login, escolhe o workspace ao qual a conexão está vinculada e aprova as permissões que deseja que ela tenha. Não há chave de API para gerar, copiar ou colar em um arquivo de configuração, e você pode revogar qualquer conexão individual posteriormente sem afetar as outras.

Quais clientes de IA funcionam com ele?

Qualquer cliente MCP que suporte servidores remotos com OAuth. Isso inclui Claude (desktop, web, mobile e Claude Code), conectores personalizados do ChatGPT, Cursor, VS Code com Copilot, Windsurf, Cline, Zed, IDEs JetBrains e qualquer coisa construída sobre uma estrutura de agentes com suporte a MCP.

O que o assistente pode realmente fazer?

32 ferramentas, cobrindo todo o ciclo: ler suas contas e análises, navegar e gerenciar sua biblioteca de conteúdo, gerar imagens, vídeos e apresentações de slides no Studio, preparar publicações e agendá-las ou publicá-las em 10 plataformas. A geração é a parte que a maioria dos servidores MCP de redes sociais não possui — eles podem agendar conteúdo, mas não podem criá-lo.

Ele pode publicar sem me perguntar?

Somente se você conceder a permissão de publicação, e somente para as contas no workspace que você conectou. Leitura, rascunho e geração são escopos separados, então uma conexão pode ser autorizada a construir uma fila de conteúdo inteira enquanto permanece incapaz de colocar qualquer coisa no ar. A publicação também exige uma decisão explícita de publicar ou agendar em cada chamada, em vez de assumir como padrão a publicação imediata.

Um agente com novas tentativas vai publicar em duplicidade?

Não. Toda escrita através do servidor MCP exige uma chave de idempotência, então uma chamada repetida resolve para a mesma publicação em vez de criar uma segunda. Essa garantia vem do mesmo backend que o painel e a API de Parceiros usam, não de algo que o assistente precise lembrar de fazer.

Preciso de um plano pago?

Você pode criar uma conta Genviral gratuita e conectá-la. Gerar mídia consome créditos, e os limites de contas conectadas seguem seu plano, então automação mais pesada precisa de um plano pago da mesma forma que no painel.

Devo usar MCP ou a API REST?

Use MCP quando um assistente de chat estiver conduzindo — é o caminho mais rápido de uma frase para uma publicação agendada. Use a API REST de Parceiros, ou a CLI da Genviral, quando você estiver escrevendo código, executando tarefas agendadas ou construindo um produto sobre a Genviral. Ambos acessam os mesmos serviços de backend, então nada é exclusivo de um caminho.