Muitas vezes, o maior obstáculo para começar uma comunidade é “torná-la sua”.
Você quer que sua fonte, seu estilo e sua identidade estejam alinhados à sua marca.
Neste post, gostaria de abordar o que pode ser alcançado de forma bastante direta com:
- Discourse MCP - GitHub - discourse/discourse-mcp: MCP client for Discourse sites · GitHub
- Uma avaliação Pro ou Business do Discourse
- Uma assinatura do Open AI Codex
Escolhi o Codex aqui, pois o recém-lançado GPT-6 Astra é um artista visual incrivelmente talentoso. O Kimi K3 e o Fable também são bastante fortes nesse departamento, mas para esta demonstração estou usando o Astra.
Passo 1 - Gerar chave de API
Acesse: your.site/admin/api/keys/new
Gere uma chave de API global.
Nota de segurança: mantenha esta chave em local seguro e considere revogá-la quando o trabalho estiver concluído, pois ela fornece acesso irrestrito ao site.
Passo 2 - Adicionar o Discourse MCP
Neste tutorial, estou usando o codex:
edite: ~/.codex/config.toml
[mcp_servers.discourse]
command = "npx"
args = [
"-y",
"@discourse/mcp@latest",
"--toolsets",
"all",
"--allow-writes",
"--site",
"https://figment123.discourse.group",
"--auth_pairs",
'[{"site":"YOUR_SITE","api_key":"YOUR_API_KEY","api_username":"system"}]',
]
(observação: o Codex não permite escolher quais MCPs estão habilitados ou desabilitados; tudo o que estiver na configuração será habilitado. Você pode adicionar enabled = false para desabilitar um MCP temporariamente)
Uma nota sobre ferramentas: O Discourse MCP suporta mais de 140 ferramentas, e esta configuração as torna todas disponíveis. Ambientes modernos, como Claude e Codex, lidam com isso sem problemas. No entanto, muitos ambientes podem ter dificuldade com uma contagem de ferramentas tão alta — por exemplo, o Grok build exigirá filtragem.
Depois de adicionar o Discourse MCP, certifique-se de confirmar que seu agente pode acessá-lo:
Passo 3 - Fornecer ao seu agente as ferramentas de que ele precisa para fazer o trabalho
Um agente terá um desempenho significativamente melhor se tiver:
- Olhos, a capacidade de ver seu trabalho. (playwright MCP, computer use, etc.)
- Contexto, o Discourse MCP ajuda, mas o código-fonte do Discourse também.
- Geração de imagens - caso você precise de recursos visuais, etc.
O aplicativo ChatGPT possui um navegador integrado; certifique-se de que ele o utilize. Certifique-se de clonar o repositório discourse/discourse e iniciar seu agente a partir do diretório do Discourse.
Nada disso é obrigatório, mas ter isso resultará em resultados significativamente melhores.
Passo 4 - Dar ao seu agente inteligência e um briefing claro
Neste caso, como quero ver resultados muito bons, optei pelo GPT-6 Astra XHIGH.
Em seguida, escrevi um pequeno briefing com minha IA sobre o que eu queria (um tema de comunidade inspirado no The New Yorker)
Briefing criado por IA
Construa The Salon, um tema polido para o Discourse que demonstre como um cliente pode transformar radicalmente a identidade do Discourse. A referência criativa é The New Yorker: uma instituição editorial cujos leitores participam da conversa. Crie uma identidade original, não uma réplica — sem logotipos emprestados ou tipografias proprietárias sem licença. Use marfim quente (#F7F4ED), tinta quase preta (#20201E), vermelho editorial contido (#B52B32), linhas finas, espaços em branco generosos, manchetes serifadas expressivas, texto de corpo serifado legível e metadados sans-serif compactos. Ilustrações em monocromia devem adicionar humor e personalidade. Você tem liberdade criativa para buscar, baixar ou gerar quaisquer recursos necessários para a demonstração — fontes, ilustrações, fotografia, avatares e ícones — usando material com licença apropriada e mantendo a atribuição onde necessário. Evite cartões SaaS genéricos, pergaminho falso e bagunça decorativa. O objetivo é uma revista literária contemporânea com uma comunidade viva dentro dela, não um fórum padrão com cores diferentes.
Você está explicitamente autorizado a configurar a instância de demonstração com as categorias, tópicos, respostas, perfis de contribuidores fictícios e conteúdo de apoio necessários para tornar a experiência convincente. Preserve o conteúdo real existente e mantenha a atividade fictícia claramente identificável como dados de demonstração. Crie cinco departamentos editoriais — The Commons, Arts & Letters, City Life, Science & Ideas, Table Talk — com descrições e ilustrações distintas. Construa uma forte cabeçalho THE SALON, uma discussão principal curada, manchetes secundárias e uma seção de conversas mais recentes. Popule com discussões pensadas e variadas, como “Quando é que todo hobby se tornou um bico?” e “O que realmente mudaria sua opinião?”, com posts de abertura convincentes, discordâncias substanciais, respostas curtas, citações e imagens bem escolhidas. Popule com conteúdo suficiente para demonstrar densidade, rolagem e navegação; não use preenchimento repetitivo nem deixe telas importantes vazias. Cada manchete deve abrir um tópico real, e a atividade, contagens de respostas e estados não lidos devem permanecer visíveis. Carregue a identidade através das listas de categorias, páginas de tópicos, busca e compositor: os posts de abertura devem parecer ensaios lindamente diagramados, enquanto as respostas permanecem conversas compactas e utilizáveis. O modo móvel deve se tornar uma experiência calma de coluna única, e o modo escuro deve parecer igualmente intencional.
Inspecione a versão do Discourse de destino e as APIs de tema suportadas antes de escolher os detalhes de implementação. Prefira um tema mantível e componentes de tema focados; evite patches no núcleo, plugins desnecessários, manipulação frágil de DOM e funcionalidades inventadas. Torne a curadoria editorial explícita e configurável. Trabalhe de forma autônoma em decisões de design, recursos e configuração reversíveis, em vez de pedir aprovação para cada detalhe; estabeleça a linguagem visual com uma página inicial representativa e uma página de tópico populada, e depois finalize as superfícies de apoio. Entregue um tema instalável, os componentes necessários, uma configuração reproduzível do conteúdo de demonstração, a procedência dos recursos e instruções de instalação concisas. Verifique o resultado em uma instância real do Discourse em desktop e móvel, incluindo navegação por teclado, contraste, estados não lidos, busca, citação e composição. Capture a mesma comunidade configurada antes e depois de aplicar o tema para que a transformação seja inegável. O padrão é uma demonstração pronta para o cliente — não um mockup, não apenas uma página inicial bonita, mas uma comunidade coerente e funcional com uma sensação de lugar completamente diferente.
- consulte o código-fonte do Discourse conforme necessário
- https://figment123.discourse.group/ é um site de demonstração, você pode fazer o que quiser com ele, veja os resultados ao longo do caminho, habilite o tema
- crie tópicos conforme necessário
Passo 5 - Ficou ótimo!
Uma hora e dez minutos depois, o Astra Xhigh terminou.
Um tema inspirado no New Yorker encantador.
O tema não é perfeito, tem casos extremos, eu recomendaria um Passo 6 de refinamento, onde você cola as áreas em que o design está desalinhado e o agente corrige. Mas como ponto de partida, é absolutamente incrível que possamos fazer isso hoje. Não era possível há um ano.
Exemplo de refinamento em tempo real: