A menudo, el mayor obstáculo para iniciar una comunidad es «hacerla tuya».
Quieres que tu fuente, tu estilo y tu identidad coincidan con tu marca.
En esta publicación me gustaría cubrir lo que se puede lograr de manera bastante sencilla con:
- Discourse MCP - GitHub - discourse/discourse-mcp: MCP client for Discourse sites · GitHub
- Una prueba Pro o Business de Discourse
- Una suscripción a Open AI Codex
Elegí Codex aquí, ya que el recién lanzado GPT-6 Astra es un artista visual increíblemente talentoso. Kimi K3 y Fable también son bastante fuertes en este departamento, pero para esta demostración estoy usando Astra.
Paso 1 - Generar clave de API
Dirígete a: your.site/admin/api/keys/new
Genera una clave de API global.
Nota de seguridad: guarda esta clave con cuidado, considera revocarla una vez que el trabajo esté hecho, ya que proporciona acceso ilimitado al sitio.
Paso 2 - Agregar Discourse MCP
En este tutorial estoy usando codex:
edita: ~/.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"}]',
]
(nota: Codex no te permite elegir qué MCP están habilitados o deshabilitados, todo lo que esté en la configuración se habilitará. Puedes colocar enabled = false para deshabilitar temporalmente un MCP)
Una nota sobre las herramientas: El Discourse MCP admite más de 140 herramientas, esta configuración las hace todas disponibles. Los entornos modernos como Claude y Codex pueden manejarlo sin problemas, sin embargo, muchos entornos pueden tener dificultades con una cantidad de herramientas tan alta; por ejemplo, Grok build requerirá filtrado)
Una vez que agregues Discourse MCP, asegúrate de confirmar que tu agente puede acceder a él:
Paso 3 - Dar a tu agente las herramientas que necesita para hacer el trabajo
Un agente rendirá significativamente mejor si tiene:
- Ojos, la capacidad de ver su trabajo. (playwright MCP, computer use, etc)
- Contexto, el Discourse MCP ayuda, pero también lo hace el código fuente de Discourse
- Generación de imágenes - por si necesitas activos, etc.
La aplicación de ChatGPT tiene un navegador integrado, asegúrate de que lo use. Asegúrate de clonar el código base de discourse/discourse y iniciar tu agente desde el directorio de Discourse.
Nada de esto es obligatorio, pero tenerlo resultará en resultados significativamente mejores.
Paso 4 - Dar a tu agente inteligencia y una instrucción clara
En este caso, dado que quiero ver resultados muy buenos, opté por GPT-6 Astra XHIGH.
A continuación, escribí una breve instrucción con mi IA sobre lo que quería (Un tema de comunidad estilo The New Yorker)
Brief creado por IA
Construye The Salon, un tema de Discourse pulido que demuestre cómo un cliente puede transformar radicalmente la identidad de Discourse. La referencia creativa es The New Yorker: una institución editorial cuyos lectores participan en la conversación. Crea una identidad original, no una réplica: sin logotipos prestados ni tipografías propietarias sin licencia. Usa marfil cálido (#F7F4ED), tinta casi negra (#20201E), rojo editorial contenido (#B52B32), reglas finas, espacios en blanco generosos, titulares serif expresivos, texto de cuerpo serif legible y metadatos sans-serif compactos. Las ilustraciones monocromáticas deben añadir ingenio y carácter. Tienes libertad creativa para buscar, descargar o generar los activos que la demo necesite: fuentes, ilustraciones, fotografía, avatares e iconos, utilizando material con licencia adecuada y manteniendo la atribución donde sea necesario. Evita tarjetas SaaS genéricas, pergamino falso y desorden decorativo. Apunta a una revista literaria contemporánea con una comunidad viva dentro de ella, no a un foro estándar con colores diferentes.
Se te autoriza explícitamente para poblar la instancia de demostración con las categorías, temas, respuestas, perfiles de contribuyentes ficticios y contenido de apoyo necesarios para hacer la experiencia convincente. Preserva el contenido real existente y mantén la actividad ficticia claramente identificable como datos de demostración. Crea cinco departamentos editoriales—The Commons, Arts & Letters, City Life, Science & Ideas, Table Talk—con descripciones e ilustraciones distintivas. Construye un fuerte masthead de THE SALON, una discusión principal curada, titulares secundarios y una sección de conversaciones más recientes. Siembra discusiones variadas y reflexivas como «¿Cuándo se convirtió cada afición en un side hustle?» y «¿Qué cambiaría realmente tu opinión?», con publicaciones iniciales convincentes, desacuerdos sustanciales, respuestas cortas, citas e imágenes bien elegidas. Poblá suficiente contenido para demostrar densidad, desplazamiento y navegación; no uses relleno repetitivo ni dejes pantallas importantes vacías. Cada titular debe abrir un tema real, y la actividad, las cantidades de respuestas y los estados no leídos deben permanecer visibles. Lleva la identidad a través de las listas de categorías, las páginas de temas, la búsqueda y el compositor: las publicaciones iniciales deben sentirse como ensayos bellamente tipografiados, mientras que las respuestas permanecen como conversaciones compactas y usables. El móvil debe convertirse en una experiencia tranquila de una sola columna, y el modo oscuro debe sentirse igualmente deliberado.
Inspecciona la versión de Discourse objetivo y las APIs de tema soportadas antes de elegir detalles de implementación. Prefiere un tema mantenible y componentes de tema enfocados; evita parches al núcleo, plugins innecesarios, manipulación frágil del DOM y funcionalidad inventada. Haz que la curaduría editorial sea explícita y configurable. Trabaja de forma autónoma en decisiones de diseño, activos y puestas en escena reversibles, en lugar de pedir aprobación por cada detalle; establece el lenguaje visual con una página de inicio representativa y una página de tema poblada, luego termina las superficies de apoyo. Entrega un tema instalable, los componentes requeridos, una configuración reproducible del contenido de demostración, la procedencia de los activos e instrucciones de instalación concisas. Verifica el resultado en una instancia real de Discourse en escritorio y móvil, incluyendo navegación por teclado, contraste, estados no leídos, búsqueda, citación y composición. Captura la misma comunidad poblada antes y después de aplicar el tema para que la transformación sea innegable. El estándar es una demostración lista para el cliente: no un mockup, no solo una hermosa página de inicio, sino una comunidad coherente y funcional con una sensación de lugar completamente diferente.
- consulta el código fuente de Discourse según sea necesario
- https://figment123.discourse.group/ es un sitio de demostración, puedes hacer lo que quieras con él, mira los resultados a medida que avanzas, habilita el tema
- crea temas según sea necesario
Paso 5 - ¡Se ve genial!
Una hora y diez minutos después, Astra Xhigh ha terminado.
Un hermoso tema inspirado en New Yorker.
El tema no es perfecto, tiene casos límite, recomendaría un Paso 6 de refinamiento, donde pegues las áreas donde el diseño está desviado y el agente lo corrija. Pero como punto de partida es absolutamente asombroso que podamos hacer esto hoy. No era posible hace un año.
Ejemplo de refinamiento en tiempo real: