MCP Server

🚀 Kubit MCP Server

仓库原生分析与对话式人工智能的完美结合

将Kubit的强大功能直接融入您的人工智能工作流程。通过自然语言查询、分析和探索您的数据仓库，无需复杂的语法。

🚀 快速开始

所需条件

连接步骤

设置Kubit MCP服务器非常简单：

1. 将MCP服务器添加到您的AI客户端配置中。
2. 使用服务器URL：https://mcp.kubit.ai/mcp。
3. 在提示时完成OAuth身份验证。
4. 开始查询您的Kubit数据。

⚠️ 重要提示

请查看您的AI客户端文档，获取具体的MCP服务器设置说明。

身份验证与访问

服务器使用OAuth 2.0进行身份验证，并遵循您现有的Kubit权限。您只能看到已有权限访问的模式中的数据，无需额外权限。

✨ 主要特性

Kubit MCP（模型上下文协议）服务器改变了团队与分析平台的交互方式。通过将您的AI助手连接到Kubit，您可以：

• 探索模式 - 以自然语言发现事件、属性和维度。
• 生成报告 - 通过对话创建分析查询。
• 导出数据 - 以CSV格式提取原始数据进行深入分析。
• 搜索内容 - 立即找到现有的报告和仪表板。
• 提出问题 - 无需学习查询语法即可获取见解。

⚠️ 重要提示

此服务器正在积极开发中。在我们持续改进平台的过程中，您可能会遇到错误、性能问题或速率限制。

📚 详细文档

工具与功能

您的AI助手可以使用五个强大的工具：

示例对话

了解用户行为

"显示上一季度移动应用注册的转化漏斗"
"高级用户最常用的功能有哪些？"
"用户留存率逐月有何变化？"

产品性能

"本周流量最大的事件有哪些？"
"显示过去30天的用户参与趋势"
"比较不同流量来源的转化率"

数据发现

"移动应用模式中有哪些可用的事件和属性？"
"显示结账事件的所有自定义属性"
"我可以使用哪些维度进行用户细分？"

典型工作流程

大多数分析会话的流程如下：

初始化 → 探索 → 搜索 → 创建 → 导出

1. 初始化 - 调用getUserContext查看可用的模式。
2. 探索 - 使用getSchema了解事件和属性。
3. 搜索 - 使用searchKubit检查现有的分析。
4. 创建 - 使用自定义查询生成新报告。
5. 导出 - 提取getRawData进行外部分析。

使用最佳实践

构建有效提示

• 具体明确：在问题中包含时间范围、事件和细分。

- "显示用户"
+ "显示上个月在美国注册的活跃用户"

• 提供上下文：解释您试图了解的内容。

- "转化率是多少？"
+ "参与了功能X的用户从免费试用转为付费的转化率是多少？"

• 引用模式：在处理多个数据源时使用模式名称。

- "显示注册事件"
+ "在移动事件模式中，显示注册事件"

• 分解问题：复杂的分析拆分成多个聚焦的问题效果更好。

- "显示所有渠道的用户行为、留存率和转化率的所有信息"
+ 先问 "按渠道显示用户留存率" 然后再跟进

性能优化

• 先使用searchKubit - 在创建新报告之前利用现有的分析。
• 指定日期范围 - 缩小时间窗口可提高查询性能。
• 有选择地导出 - 仅在需要详细的外部分析时使用getRawData。

安全与合规

故障排除

常见问题及解决方案

• 身份验证失败：验证您的Kubit凭证和组织名称。
• 没有可用的模式：检查您在Kubit中是否至少有权限访问一个模式。
• 连接错误：确认您使用的是正确的服务器URL：https://mcp.kubit.ai/mcp。
• 报告生成问题：使用getSchema验证您引用的模式和事件是否存在。

需要帮助？

• 先使用简单的查询测试以验证您的连接。
• 通过Kubit网页界面检查模式访问权限。
• 使用getSchema确认可用的事件和属性。

📄 许可证

文档中未提及相关内容，故跳过该章节。

📖 支持与资源

• 文档：docs.kubit.ai - 完整的平台文档。
• 客户成功：联系您的Kubit客户成功团队获取帮助。
• 关于Kubit：kubit.ai - 了解更多关于仓库原生分析的信息。
• MCP协议：modelcontextprotocol.io - 探索模型上下文协议。