Kubit MCP Server
官方将Kubit引入你的AI工作
文档
Kubit MCP 服务器
仓库原生分析与对话式 AI 的融合
将 Kubit 的全部能力直接引入您的 AI 工作流。通过自然语言查询、分析和探索您的数据仓库——无需复杂的语法。
什么是 Kubit MCP？
Kubit MCP（模型上下文协议）服务器改变了团队与数据分析平台交互的方式。通过将您的 AI 助手连接到 Kubit，您可以：
- 探索模式 - 用自然语言发现事件、属性和维度
- 生成报告 - 通过对话创建分析查询
- 导出数据 - 以 CSV 格式提取原始数据进行深度分析
- 搜索内容 - 即时查找现有报告和仪表板
- 提问 - 无需学习查询语法即可获取洞察
测试版提示
此服务器正在积极开发中。随着我们不断改进平台，您可能会遇到错误、性能问题或速率限制。
快速入门
准备工作
| 要求 | 说明 |
|---|---|
| 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 权限。您只能看到已有权限访问的模式中的数据——无需额外权限。
工具与能力
您的 AI 助手可以使用五个强大的工具：
| 工具 | 用途 |
|---|---|
getUserContext | 初始化会话并获取可用模式 |
getSchema | 详细探索事件、属性和维度 |
createReport | 生成并执行分析查询 |
getRawData | 从现有报告导出 CSV 数据 |
searchKubit | 在整个组织中查找报告和仪表板 |
对话示例
理解用户行为
"Show me conversion funnel for mobile app sign-ups in the last quarter"
"What are the most popular features used by premium users?"
"How has user retention changed month-over-month?"
产品性能
"What are the top events by volume this week?"
"Show me user engagement trends for the last 30 days"
"Compare conversion rates across different traffic sources"
数据发现
"What events and properties are available in the mobile app schema?"
"Show me all custom properties for the checkout event"
"What dimensions can I use for user segmentation?"
典型工作流程
以下是大多数分析会话的流程：
Initialize → Explore → Search → Create → Export
- 初始化 - 调用
getUserContext查看可用模式 - 探索 - 使用
getSchema了解事件和属性 - 搜索 - 检查
searchKubit查找现有分析 - 创建 - 使用自定义查询生成新报告
- 导出 - 提取
getRawData进行外部分析
最佳实践
编写有效的提示
具体明确
在问题中包含时间范围、事件和细分。
- "Show me users"
+ "Show me active users in the US who signed up last month"
提供上下文
说明您想要了解的内容。
- "What's the conversion rate?"
+ "What's the conversion rate from free trial to paid for users who engaged with feature X?"
引用模式
在使用多个数据源时使用模式名称。
- "Show me sign-up events"
+ "In the mobile_events schema, show me sign-up events"
分解问题
将复杂分析拆分为多个聚焦的问题会更有效。
- "Show me everything about user behavior across all channels with retention and conversion"
+ Start with "Show me user retention by channel" then follow up
性能优化
- 优先使用
searchKubit- 在创建新报告之前利用现有分析 - 指定日期范围 - 缩小时间窗口可提高查询性能
- 有选择地导出 - 仅在需要详细外部分析时使用
getRawData
安全与合规
| 考虑因素 | 含义 |
|---|---|
| 权限模型 | 您只能访问被授权查看的模式 |
| AI 处理 | 第三方 AI 模型将处理您的查询数据 |
| 政策审查 | 确认您的组织允许 AI 辅助数据分析 |
故障排除
常见问题与解决方案
认证失败
验证您的 Kubit 凭据和组织名称
无可用模式
检查您是否在 Kubit 中至少拥有一个模式的访问权限
连接错误
确认您使用的是正确的服务器 URL：https://mcp.kubit.ai/mcp
报告生成问题
使用 getSchema 验证您引用的事件和模式是否存在
需要帮助？
- 先用简单查询测试以验证连接
- 通过 Kubit Web 界面检查模式访问权限
- 使用
getSchema确认可用的事件和属性
支持与资源
文档
docs.kubit.ai - 完整的平台文档
客户成功
联系您的 Kubit 客户成功团队获取帮助
关于 Kubit
kubit.ai - 了解更多关于仓库原生分析的信息
MCP 协议
modelcontextprotocol.io - 探索模型上下文协议