用途：这是一份 PostHog 工程手册，指导如何把 PostHog 产品端点暴露为 MCP 工具，供智能体调用。
主要能力与流程：先用脚手架命令生成初始 YAML：pnpm --filter=@posthog/mcp run scaffold-yaml -- --product your_product --output ../../products/your_product/mcp/tools.yaml，再启用工具、配置 scopes、注解与描述，然后运行 hogli build:openapi 生成处理器与 schema。接口变更后用 --sync-all 同步。
设计约束：工具应是原子 CRUD 能力，名称用 kebab-case、52 字符以内，格式为 domain-action；feature 用 snake_case 且与产品目录名一致。CI 用 pnpm --filter=@posthog/mcp lint-tool-names 校验。
前置要求：Django 序列化器需有显式字段类型与 help_text，普通 ViewSet 方法需 @extend_schema，查询参数需 @validated_request。生成的工具 schema 出错通常要改后端。
其它：YAML 可放 products/<product>/mcp/.yaml 或 services/mcp/definitions/.yaml；每个 list/get 端点应配 HogQL 系统表并含 team_id 列；支持 mcp_version 1（全 CRUD）与 2（SQL 优先）；可用 feature_flag 控制工具暴露。限制：缺失功能、收费、价格与具体使用效果暂未提供。