Kubit

Kubit MCP サーバー

データウェアハウスネイティブの分析と会話型 AI の融合

Kubit の機能を余すところなく、AI ワークフローに直接取り込めます。複雑な構文は必要ありません。自然言語でデータウェアハウスにクエリを実行し、分析して、データを探索できます。

---

Kubit MCP とは？

Kubit MCP（Model Context Protocol）サーバーは、チームが分析プラットフォームを利用する方法を変革します。AI アシスタントを Kubit に接続すると、次のことができます。

• スキーマを探索 - イベント、プロパティ、ディメンションを自然言語で見つける
• レポートを生成 - 会話を通じて分析クエリを作成する
• データをエクスポート - 詳細な分析用に生データを CSV 形式で取得する
• コンテンツを検索 - 既存のレポートやダッシュボードをすぐに見つける
• 質問する - クエリ構文を習得せずにインサイトを得る

ベータ版に関するお知らせ

このサーバーは現在も積極的に開発中です。プラットフォームの改善を続けているため、バグ、パフォーマンスの問題、またはレート制限に遭遇することがあります。

---

クイックスタート

必要なもの

要件	説明
Kubit アカウント	Kubit 組織への有効なアクセス権
AI クライアント	MCP 対応ツール（Claude、Cursor など）
権限	Kubit ワークスペースでのスキーマアクセス権

接続手順

Kubit MCP サーバーのセットアップは簡単です。

1. MCP サーバーを AI クライアントの設定に追加します
2. サーバー URL を使用します：https://mcp.kubit.ai/mcp
3. プロンプトが表示されたら、OAuth 認証を完了します
4. 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

1. 初期化 - getUserContext を呼び出して、利用可能なスキーマを確認します
2. 探索 - getSchema を使って、イベントとプロパティを把握します
3. 検索 - searchKubit で既存の分析を確認します
4. 作成 - カスタムクエリで新しいレポートを生成します
5. エクスポート - 外部で分析する場合は、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 のウェブインターフェースでスキーマへのアクセスを確認してください
• getSchema を使って、利用可能なイベントとプロパティを確認してください

---

サポートとリソース

ドキュメント
docs.kubit.ai - プラットフォームの包括的なドキュメント

カスタマーサクセス
サポートが必要な場合は、Kubit のカスタマーサクセスチームにお問い合わせください

Kubit について
kubit.ai - ウェアハウスネイティブ分析の詳細はこちら

MCP プロトコル
modelcontextprotocol.io - Model Context Protocol の詳細はこちら