Blog

Como automatizar o seu app GoodBarber com n8n e MCP — sem escrever código

Passámos um dia a ligar o n8n ao servidor MCP da GoodBarber para montar uma automação a sério: um workflow que traduz todas as manhãs para francês os artigos do blog do nosso app, sob a forma de rascunhos prontos a rever. Esta é a configuração exata que usámos, o que correu mal pelo caminho e as três lições que lhe poupam uma tarde.

Porquê n8n + MCP em vez de Zapier + API REST

A resposta curta: com MCP, é a API que se explica à máquina — deixa de construir os pedidos à mão.

Uma integração REST clássica significa ler a documentação de uma API, construir cada pedido HTTP e gerir a autenticação e a paginação por conta própria. MCP (Model Context Protocol) inverte esse trabalho: o seu app GoodBarber expõe as suas operações como tools que qualquer cliente MCP descobre e chama sozinho. O nosso app de teste — uma Content App — expôs 62 tools no momento em que nos ligámos: artigos, parágrafos, eventos, mapas, galerias, vídeos, sons.

O n8n conta aqui porque é uma das raras plataformas de automação com um MCP Client node nativo — e porque os seus nodes AI Agent podem entregar esses 62 tools ao Claude e deixar o modelo decidir quais chamar. As plataformas ao estilo do Zapier automatizam apps; o n8n + MCP automatiza o seu app.

REST + automação clássicaMCP + n8n
Trabalho de integraçãoUm pedido por ação, feito à mãoTools descobertos automaticamente
AutenticaçãoUma chave API por pedidoUma única ligação OAuth
A IA no cicloVocê faz o parsing, a IA vê fragmentosO agente chama os tools diretamente

Setup: n8n ligado à GoodBarber em 5 minutos

Toda a ligação cabe num node e num ecrã OAuth. Esta é a sequência que seguimos no n8n.cloud:

  1. Crie um workflow, adicione um node AI Agent e ligue-lhe um modelo Claude (uma chave API Anthropic nos credentials do n8n).
  2. Adicione um node MCP Client Tool com o endpoint https://mcp.goodbarber.dev/mcp/sse, o transport HTTP Streamable e a autenticação MCP OAuth2.
  3. Clique em Connect. O n8n regista-se sozinho junto do servidor GoodBarber (dynamic client registration) e abre-se uma página de autorização da GoodBarber.
  4. Cole a Public API key do seu app — gera-a no back-office, na página Public API / MCP server — e valide.

É tudo. O credential mostra «Account connected» e o node lista todos os tools que o seu app expõe — a página GoodBarber MCP detalha o catálogo completo por tipo de app. Cinco minutos, sem código, sem ginástica de webhooks.

Workflow 1 — traduzir os artigos do blog automaticamente

O objetivo: cada artigo publicado na nossa secção de blog em inglês recebe uma tradução em francês na secção francesa, todas as manhãs às 9 h.

A nossa primeira versão era a óbvia: um trigger Schedule e um único AI Agent com todos os tools de artigo — listar os artigos, detetar as traduções em falta, traduzir, criar. Funcionou no primeiro ensaio em seco. Depois bateu numa parede: um agente reenvia toda a sua conversa a cada passo, e os payloads de artigo são pesados. As nossas execuções queimavam entre 40.000 e 77.000 tokens de entrada por minuto — acima dos limites de uma conta API de gama básica, com qualquer modelo.

A versão que corre em produção todos os dias é mais sóbria, e ensinou-nos o padrão verdadeiro: nodes determinísticos para a canalização, e o modelo só onde há discernimento. Quatro nodes HTTP Request chamam os tools MCP diretamente (o credential MCP OAuth2 do n8n liga-se a um simples node HTTP — é esse o truque), um pequeno node Code escolhe o artigo mais antigo por traduzir, e uma única chamada ao Claude traduz o artigo inteiro de uma vez. As traduções chegam ao CMS com as imagens e os embeds preservados, por cerca de 5.000 tokens por execução em vez de 70.000.

Duas decisões de design fazem todo o trabalho sobre o custo. Só expomos os tools de que o workflow realmente precisa — o node MCP Client do n8n aceita uma seleção de tools, e reduzir a nossa aos cinco tools de artigo poupou milhares de tokens de esquema em cada chamada ao modelo. E a idempotência cabe numa convenção de slug: a versão francesa de health-benefits-journaling é health-benefits-journaling-fr — se o slug existe, o artigo já está feito, por isso o pipeline nunca traduz duas vezes.

Hoje o pipeline escreve rascunhos e quem publica somos nós. É uma escolha editorial, não um limite técnico: a qualidade de tradução do Claude é suficientemente constante para confiarmos neste workflow sem humano no ciclo — direto para publicação.

Workflow 2 — transformar um feed RSS em rascunhos de artigo

O mesmo padrão ingere conteúdo em vez de o traduzir. O trigger RSS integrado do n8n vigia qualquer feed; um node Claude reformata cada entrada num título, um resumo e um corpo limpos; cms_create_article e cms_create_article_paragraph criam o rascunho na secção que escolher. A sua equipa editorial abre o back-office de manhã com uma fila de rascunhos preparados em vez de uma lista de links por tratar.

Workflow 3 — um resumo editorial semanal no Telegram

O reporting é onde o agente brilha, porque o número de operações é pequeno. Um trigger Schedule dispara todas as sextas-feiras; o agente chama cms_list_articles sobre a janela da semana, o Claude escreve um resumo curto — o que saiu, o que continua em rascunho, o que está agendado — e um node Telegram entrega-o no canal da equipa. Dez minutos de configuração para um batimento editorial recorrente.

A que estar atento

A honestidade torna um tutorial útil, por isso aqui ficam as duas coisas que realmente nos morderam.

  • Os limites de API de gama básica não combinam com agentes faladores. Num tier baixo da Anthropic, uma única execução de um agente tudo-em-um ultrapassava os limites de tokens por minuto. Separe a canalização da inteligência, ou conte com um tier superior.
  • As respostas de lista são pesadas. As listas de artigos devolvem o conteúdo completo e os conjuntos de imagens — ótimo para um assistente interativo, pesado dentro do ciclo de um agente. Recupere um artigo de cada vez quando o orçamento de tokens conta.

O que vem a seguir

O nosso app de teste agora traduz-se sozinho todas as manhãs. Se quiser o mesmo ponto de partida: a página 44 skills da GoodBarber explica o que o servidor MCP expõe, Connect Claude detalha a configuração do lado do assistente, e o repositório open source goodbarber-skills contém as receitas prontas a usar — incluindo os workflows de CMS sobre os quais este artigo é construído. E se está a perguntar-se porque tornámos os nossos apps prontos para agentes de IA em primeiro lugar, também contámos essa história. E para encontrar todos os outros clientes e workflows suportados pelo servidor, percorra o guia completo do MCP da GoodBarber.

Continue lendo

  5 min de leitura

Encontre respostas nos podcasts com GoodBarber Chatbot

Imagine uma rádio local com programas em direto, uma grelha de programação e entrevistas disponíveis a pedido na sua app. Cada gravação tem um título e uma descrição. Estas informações ajudam os ouvintes a explorar os conteúdos, mas uma entrevista contém muitas vezes detalhes úteis que não aparecem no resumo.No nosso exemplo, o episódio chama-se «A cidade que partilhamos». A descrição apresenta uma conversa sobre a vida quotidiana na cidade. Durante a gravação, um urbanista explica as medidas contra o calor no verão: plantar árvores nos percursos para as escolas, criar sombra nos recreios e substituir algumas superfícies pavimentadas por zonas verdes.Nenhuma destas medidas aparece no título ou na descrição. Um ouvinte lembra-se do tema e pergunta:Que episódio explicou como a cidade pretende reduzir o calor no verão?Adicionámos os podcasts áudio às fontes de conhecimento do GoodBarber Chatbot para que perguntas como esta possam levar aos seus programas. Há dois níveis: a informação escrita que publica sobre cada episódio e o conteúdo falado que decide transcrever.

  4 min de leitura

Suas lives e seus vídeos da Twitch, agora no seu app

Em resumo. Twitch é uma extensão da GoodBarber, o app builder sem código, que adiciona um canal da Twitch como fonte de uma seção de vídeos. Quando o canal está ao vivo, a live fica no topo da seção; no resto do tempo, a seção lista os vídeos do canal. Você a conecta uma única vez, com um Client ID e um Client Secret do console de desenvolvedores da Twitch. Ela é gratuita para os apps Content: cada seção conta como uma das extensões incluídas no seu plano.O público está na Twitch. Em setembro de 2026, os espectadores assistiram a 1,51 bilhão de horas de lives na plataforma, com uma média de 2,1 milhões de pessoas assistindo a qualquer momento, segundo o TwitchTracker. Veja como a extensão funciona para uma criadora que faz live toda terça-feira às 20h.

  4 min de leitura

Transforme os seus documentos em respostas com GoodBarber Chatbot

Numa app, publicar um documento útil é apenas uma parte do trabalho. As pessoas também precisam de encontrar a informação certa no momento de agir. Um ficheiro com um nome claro ajuda quem consulta uma biblioteca, mas o leitor pode ter uma pergunta mais imediata.A comunicação interna é apenas uma das aplicações possíveis. A mesma abordagem pode apoiar recursos educativos, guias para membros de uma organização, referências técnicas ou outros documentos úteis partilhados numa app. No nosso exemplo, um colega está a preparar uma visita a um cliente e precisa de saber:Que despesas de viagem exigem aprovação prévia?Adicionámos os documentos às fontes do GoodBarber Chatbot para que os ficheiros que já mantém atualizados possam alimentar estas conversas. A escolha dos documentos é sua. Os utilizadores fazem perguntas pelas suas próprias palavras. O assistente procura as passagens relevantes e utiliza-as para construir uma resposta.A pergunta torna-se uma forma de entrar na política de deslocações. O colaborador pode partir da decisão que precisa de tomar, mesmo sem conhecer o título do documento que a explica.