Kubit MCP Server
公式KubitをAIワークフローに統合 - 自然言語でデータウェアハウスをクエリ
ドキュメント
Kubit MCPサーバー
ウェアハウスネイティブな分析と会話型AIの融合
Kubitの全機能をAIワークフローに直接統合。自然言語でデータウェアハウスをクエリ、分析、探索—複雑な構文は不要です。
Kubit MCPとは？
Kubit MCP（Model Context Protocol）サーバーは、チームの分析プラットフォームとの対話方法を変革します。AIアシスタントをKubitに接続することで、以下が可能になります：
- スキーマの探索 - 自然言語でイベント、プロパティ、ディメンションを発見
- レポートの生成 - 会話を通じて分析クエリを作成
- データのエクスポート - 詳細分析のためにCSV形式で生データを取得
- コンテンツの検索 - 既存のレポートやダッシュボードを即座に検索
- 質問する - クエリ構文を学習せずにインサイトを得る
ベータ版に関する注意事項
このサーバーは活発に開発中です。プラットフォームの改善を続ける中で、バグ、パフォーマンスの問題、またはレート制限に遭遇する可能性があります。
クイックスタート
必要なもの
| 要件 | 説明 |
|---|---|
| Kubitアカウント | Kubit組織へのアクティブなアクセス権 |
| AIクライアント | MCP互換ツール（Claude、Cursorなど） |
| 権限 | Kubitワークスペースでのスキーマアクセス権 |
接続手順
Kubit MCPサーバーのセットアップは簡単です：
- AIクライアント設定にMCPサーバーを追加
- サーバーURLを使用:
https://mcp.kubit.ai/mcp - プロンプトが表示されたらOAuth認証を完了
- Kubitデータのクエリを開始
注意: 具体的なMCPサーバー設定手順については、AIクライアントのドキュメントを確認してください。
認証とアクセス
サーバーはOAuth 2.0認証を使用し、既存のKubit権限を尊重します。既にアクセス権を持つスキーマのデータのみが表示され、追加の権限は必要ありません。
ツールと機能
AIアシスタントは5つの強力なツールにアクセスできます：
| ツール | 目的 |
|---|---|
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で少なくとも1つのスキーマにアクセスできることを確認してください
接続エラー
正しいサーバーURLを使用していることを確認してください: https://mcp.kubit.ai/mcp
レポート生成の問題
getSchema を使用して、参照しているスキーマとイベントが存在することを確認してください
ヘルプが必要ですか？
- まず簡単なクエリでテストして接続を確認
- Kubit Webインターフェースでスキーマアクセスを確認
getSchemaを使用して利用可能なイベントとプロパティを確認
サポートとリソース
ドキュメント
docs.kubit.ai - 完全なプラットフォームドキュメント
カスタマーサクセス
Kubitのカスタマーサクセスチームにお問い合わせください
Kubitについて
kubit.ai - ウェアハウスネイティブ分析の詳細
MCPプロトコル
modelcontextprotocol.io - Model Context Protocolを探る