Designing a Website for Humans and AI

说明与用途

构建了一个统一的网站，使用组件化 CMS、Ghost‑Contentful 工作流、HubSpot 表单、Markdown、OpenAPI、OAuth 和 MCP，服务于高管、开发者、内容团队和 AI 助手。

问题

CrewAI needed a single website that served executives, developers, content teams, and AI assistants without compromising usability for any group.

结果

The site now serves diverse human and AI consumers with a unified, structured content architecture, automated publishing, centralized forms, and multiple machine‑readable discovery surfaces.

工作流

• 1. Design component library in Figma
• 2. Map components to Contentful content models
• 3. Build GraphQL/TypeScript renderer
• 4. Set up Ghost → Contentful automated transfer
• 5. Centralize HubSpot forms with Zod validation
• 6. Expose Markdown routes
• 7. Publish OpenAPI, OAuth, MCP, and WebMCP endpoints
• 8. Provide discovery surfaces (llms.txt, openapi.json, etc.)

证据

The project included 7 dedicated discovery surfaces for AI systems, a Contentful based content architecture, an automated publishing pipeline from Ghost to Contentful, centralized HubSpot form infrastructure, Markdown content delivery, OpenAPI documentation, OAuth discovery, and a Model Context Protocol (MCP) implementation.

来源

When an article is published in Ghost, an automated workflow converts it into a draft in Contentful.

来源