用途：为 MCP 服务器提供产品分析。团队发布 MCP 服务器后，用 @posthog/mcp（TypeScript）或 posthog.mcp（Python，随 posthog 包发布）SDK 包装，工具调用、智能体意图与失败会以 $mcp_* 事件进入 PostHog，可查询、制图、告警和聚类，并有专用仪表盘。它关注意图（如“想找流失群组”），不替代 LLM 分析/可观测性（生成轨迹、提示词与响应、token 成本）。
主要能力：事件包括 $mcp_tool_call（主）、$mcp_tools_list、$mcp_initialize、$mcp_missing_capability、$mcp_resource_read、$mcp_prompt_get、$identify、$exception 等，全部落在共享 ClickHouse events 表。提供专用分析技能（exploring-mcp-tool-usage、-tool-quality、-sessions、-intent-clusters、improving-mcp-tools）与类型化工具（posthog:query-mcp-tool-stats、-daily-stats、-failures、-failure-occurrences、-descriptions、-neighbors、-sample-intents、-top-users、query-mcp-harness-breakdown 及会话与意图聚类工具）。harness 是调用客户端标签（Claude Code、Cursor、ChatGPT 等），查询时解析，无存储列。
使用方式：先调用 posthog:metric-list 查找 mcp_tool_call_fail_pct，再用 posthog:data-catalog-metric-run 运行受治理指标；需要工具、harness 或时间细分时再用上述技能与工具，并标注为非规范。手写 HogQL 时须通过 EFFECTIVE_TOOL_SQL 解析有效工具名，失败用 $mcp_is_error/$mcp_error_type/$mcp_error_status 而非 $exception，时间分桶需标记进行中区间。
限制：产品处于 beta，整体受 mcp-analytics 早期访问标志与 RBAC 资源控制；会话列表默认 7 天窗口并缓存 30 秒；无状态规范下 $session_id 仅在启用 enableConversationId 时稳定；意图聚类受 MAX_SNAPSHOT_CLUSTERS 与 MAX_QUERY_ROWS 限制；无 SQL 模板文件，均为类型化查询运行器。