Publicar no Telegram a partir do Cursor

Hermoso é um servidor MCP de marketing: 922+ ferramentas em um endpoint único com OAuth, que permitem a um agente pesquisar os anúncios que já rodam em um mercado, gerar anúncios finalizados em imagem e vídeo, publicá-los e montar as campanhas pagas por trás deles. O Cursor acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Cursor consegue fazer de fato no Telegram, e o que o Telegram não deixa que ele faça.

Conectar o Hermoso ao Cursor

1. Instale e entre.

   npm install -g hermoso && hermoso auth login

   O seu navegador abre uma vez. Não há nada para criar nem para colar: a credencial fica guardada, só com acesso do dono, em ~/.hermoso/config.json. Em uma máquina sem navegador, hermoso auth login --token hmk_… usa uma chave de MCP & CLI → Terminal e chaves de API.
2. Adicione em ~/.cursor/mcp.json (ou no .cursor/mcp.json do projeto). Nenhuma chave vai no arquivo, porque hermoso mcp lê o login feito acima:

   { "mcpServers": { "hermoso": { "command": "npx", "args": ["-y", "hermoso", "mcp"] } } }

3. Ou use a instalação com um clique pela página do MCP. Esse deeplink instala a URL hospedada e deixa a autenticação com o fluxo OAuth do próprio Cursor. Os dois funcionam, são só pré-requisitos diferentes.
4. Peça algo ao Cursor. “Puxe os anúncios mais duradouros dos meus três concorrentes mais próximos e refaça o melhor gancho em um vídeo 9:16”, ou “publique este render no canal”. O agente escolhe as ferramentas; você aprova o gasto.

O bloco acima roda o pacote npm hermoso publicado na sua máquina, e é por isso que nada é colado e por que a lista de ferramentas não custa nada até uma ferramenta ser chamada. Se você usar o deeplink, o Cursor faz o registro dinâmico de cliente no nosso servidor de autorização, e você também nunca precisa guardar uma chave.

Depois conecte o próprio Telegram, uma vez, em Configurações → Conectores na Hermoso, colando um token de bot do @BotFather, e adicione esse bot ao seu canal como administrador. Não há tela de consentimento: o token é a credencial, e o bot é quem publica.

As ferramentas do Telegram que o Cursor recebe

• post_to_telegram: envia uma mensagem como o seu bot para o chat que você indicar: texto de até 4.096 caracteres, ou uma foto, um vídeo, ou um álbum de 2 a 10 com fotos e vídeos misturados.
• schedule_post: coloca na fila com o seu chatId, no mesmo calendário de todos os outros canais.
• list_telegram_chats: os chats que enviaram mensagem ao bot nas últimas 24 horas. Ajuda a encontrar um ID, e não é uma lista de todos os chats em que o bot está.
• edit_telegram_message / pin_telegram_message: corrige o texto ou a legenda de uma mensagem sem perder as visualizações, e fixa ou desafixa a chamada para ação.
• create_telegram_invite_link: um link de convite nomeado por campanha, com validade, limite de membros ou aprovação de entrada opcionais, para você ver quem entrou e por onde.
• telegram_account: a contagem de assinantes ou membros do chat, o título, a descrição e o link de convite.
• list_telegram_dms: o que as pessoas enviaram ao bot nas últimas 24 horas, da mais recente para a mais antiga, para responder com post_to_telegram.
• delete_telegram_message: remove uma mensagem que o bot enviou, dentro da janela de 48 horas do Telegram, depois de uma etapa de confirmação.

O Telegram conecta com um token de bot, e não com uma tela de login. Crie um bot com o @BotFather no Telegram, cole o token em Configurações → Conectores e depois adicione o bot ao seu canal como administrador com a permissão Publicar mensagens, ou a um grupo como membro que pode publicar. A Hermoso publica como esse bot, nunca como você. Dois limites são do próprio Telegram e vale planejar em torno deles: um bot não recebe visualizações por publicação nem histórico de publicações, então a contagem de assinantes e os links de convite nomeados são os números que você tem; e as mensagens enviadas ao bot são guardadas por 24 horas e depois somem. Publicar não consome créditos.

Limites do Telegram que vale conhecer antes de automatizar qualquer coisa

Experimente no Cursor

Peça em linguagem comum. São frases simples, não uma DSL:

“Publique as notas de lançamento de CHANGELOG.md no nosso canal do Telegram como mensagem de texto, com a prévia de links desligada, e depois fixe-a em silêncio.”

Isso percorre render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. O Cursor mostra cada chamada de ferramenta no compositor antes de rodá-la, então publicar é um clique, e não um efeito colateral.

Cursor no Telegram: a parte que pega

Fixar é silencioso por padrão, então fixar um anúncio não avisa todos os membros; peça uma notificação se quiser uma. O bot precisa de permissão de fixar como administrador. Em um post só de texto, a prévia do link é o padrão do próprio Telegram e pode ser desligada, o que vale a pena quando um changelog linka cinco coisas e a prévia da primeira tomaria a mensagem.

Coloque a configuração no .cursor/mcp.json do projeto, e não no diretório pessoal, quando um repositório deve sempre rodar com uma só marca; caso contrário, é o hermoso auth login que fixa o workspace.

Pesquise o Telegram antes de publicar

Não existe biblioteca de anúncios do Telegram nem busca de canais na Hermoso, então ela não afirma fazer pesquisa de concorrentes no Telegram. Pesquise o criativo onde ele é público (as bibliotecas de anúncios da Meta, do Google e do LinkedIn, além do TikTok, Instagram, YouTube, Reddit e Threads orgânicos) e publique o anúncio pronto aqui.

A metade paga

Não há anúncios do Telegram na Hermoso, e não damos a entender que haja. Aqui o Telegram é um canal que você possui e administra pelo seu bot: publicar, fixar, editar, contar assinantes e acompanhar convites. As ferramentas pagas cobrem Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads e AppLovin Ads.

O que o Cursor não consegue fazer sozinho

Um agente com orçamento só é útil se o raio de impacto for limitado, então a cerca fica no servidor, e não em um prompt. Toda campanha, conjunto de anúncios, grupo de anúncios e anúncio é criado pausado, e as trocas de status que ativam dinheiro real se recusam a rodar sem uma flag de confirmação explícita. Cada render é cotado antes (hermoso_capabilities publica o custo exato em créditos de cada modelo antes de qualquer gasto). Os créditos são reservados antes da primeira chamada ao provedor e acertados pelo custo exato depois, então uma falha no envio devolve o valor em vez de deixar você cobrado por nada. As exclusões também exigem confirmação, e cada árvore de campanha é relida da plataforma de anúncios antes que o seu agente diga o que construiu.

Um passo fica propositalmente com você: criar o bot com o @BotFather e adicioná-lo ao seu canal. Tudo depois disso é uma chamada de ferramenta.

O resto da matriz

Pelo Cursor, publique em: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. Ou veja tudo o que o Cursor consegue publicar.

Publique no Telegram a partir de: Claude · ChatGPT · Claude Code · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip

Perguntas frequentes

O Cursor consegue publicar no Telegram?

Sim, pelo servidor MCP da Hermoso. Rode npm install -g hermoso && hermoso auth login e depois aponte ~/.cursor/mcp.json para npx -y hermoso mcp. O login no navegador guarda a credencial, então nenhuma chave vai no arquivo. O Cursor passa a ter mais de 922+ ferramentas, incluindo as que publicam no Telegram e as que pesquisam os anúncios que já estão rodando no seu mercado e criam o criativo do zero.

Como conecto o Telegram ao Cursor?

Duas etapas, uma vez cada. Rode npm install -g hermoso && hermoso auth login e depois aponte ~/.cursor/mcp.json para npx -y hermoso mcp. O login no navegador guarda a credencial, então nenhuma chave vai no arquivo. Depois crie um bot com o @BotFather no Telegram, cole o token em Configurações → Conectores na Hermoso e adicione o bot ao seu canal como administrador com a permissão Postar mensagens. Depois disso o Cursor publica no Telegram como uma chamada de ferramenta comum, citando o chat a cada vez.

Qual é o limite de legenda do Telegram ao publicar a partir do Cursor?

Uma mensagem de texto no Telegram vai até 4.096 caracteres; quando há uma foto ou um vídeo anexado, o texto vira legenda e o limite é de 1.024. A Hermoso diz qual limite se aplicou. Ela aplica o limite quando a publicação é criada ou colocada na fila, então o Cursor é avisado na hora, em vez de falhar depois, quando ninguém está acompanhando.

O Cursor consegue rodar anúncios no Telegram, além de publicar?

Não. Não há anúncios do Telegram na Hermoso. Aqui o Telegram é um canal que você administra pelo seu próprio bot: publicações, fixações, edições, links de convite e a contagem de assinantes.

O Cursor consegue publicar no Telegram de forma privada ou como rascunho?

A API de Bots não tem rascunho nem mensagem privada. A privacidade no Telegram pertence ao chat: publique em um grupo ou canal privado e só os membros verão. A Hermoso recusa uma visibilidade que o Telegram não consegue cumprir no momento em que você pede, em vez de publicar discretamente algo mais fraco.

O Cursor consegue pesquisar o Telegram antes de publicar?

Não. A Hermoso não tem biblioteca de anúncios nem busca de canais do Telegram. Ela pesquisa o criativo nas bibliotecas públicas de anúncios e nas plataformas orgânicas, e o Telegram é onde você publica o resultado.