金大哥 - mcp-server MCP 详情

article

README

🚀 Kubit MCP Server

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

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

🚀 快速开始

所需条件

| 要求 | 描述 | |-------------|-------------| | Kubit账户 | 拥有Kubit组织的有效访问权限 | | AI客户端 | 兼容MCP的工具（如Claude、Cursor等） | | 权限 | 在您的Kubit工作区中具有模式访问权限 |

连接步骤

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

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

⚠️ 重要提示

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

身份验证与访问

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

✨ 主要特性

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

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

⚠️ 重要提示

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

📚 详细文档

工具与功能

您的AI助手可以使用五个强大的工具： | 工具 | 用途 | |------|---------| | getUserContext | 初始化会话并检索可用的模式 | | getSchema | 详细探索事件、属性和维度 | | createReport | 生成并执行分析查询 | | getRawData | 从现有报告中导出CSV数据 | | searchKubit | 在您的组织中查找报告和仪表板 |

示例对话

了解用户行为

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

产品性能

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

数据发现

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

典型工作流程

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

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

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

使用最佳实践

构建有效提示

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

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

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

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

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

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

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

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

性能优化

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

安全与合规

| 考虑因素 | 含义 | |---------------|---------------| | 权限模型 | 您只能访问有权限查看的模式 | | AI处理 | 第三方AI模型将处理您的查询数据 | | 政策审查 | 确认您的组织允许使用AI辅助数据分析 |

故障排除

常见问题及解决方案

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

需要帮助？

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

📄 许可证

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

📖 支持与资源

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

mcp-server