Databox MCP

公式

Databox MCPを使用してデータと対話し、エージェント型分析、自動データ取り込み、リアルタイムの会話型分析を実現。単なるチャートではなく、プロアクティブな推奨事項と即時のBI回答を得られます。

Databox MCPで何ができますか?

  • データに関する自然言語での質問ask_genie を使用して、データセットから計算された回答を取得します。フォローアップのために会話スレッドを設定することも可能です。
  • 経時的なメトリクス値の取得load_metric_data を呼び出して、特定のメトリクスを日付範囲で取得します。ディメンションで分割したり、時間単位/日単位/週単位/月単位で集計することもできます。
  • 利用可能なメトリクスとデータソースの確認 — クエリを実行する前に、list_metricslist_data_sources を使用して、アカウントに既に接続されているものを確認します。
  • カスタムデータを Databox にプッシュcreate_data_sourcecreate_dataset でデータソースとデータセットを作成し、ingest_data でレコードを読み込みます。
  • 取り込み履歴の確認get_dataset_ingestionsget_ingestion を使用して、過去のデータ読み込みのレコード数と詳細を確認します。
  • 相対日付を正確に解決 — 他のツールに日付を渡す前に、get_current_datetime を呼び出して「先月」などのフレーズを基準にします。

ドキュメント

Databox MCP

どこでもデータと会話。

Databox MCPは、ビジネスデータをAIアシスタントに接続するModel Context Protocolサーバーです。平易な英語で指標について質問できます。SQLも、ダッシュボード構築も、データエクスポートも不要です。

Databox MCP Compatible

概要

Databox MCPは、Claude、Cursor、n8n、Gemini CLIなどのAIツールが、会話形式でDataboxデータにアクセスし分析することを可能にします。ビジネス指標との関わり方を変革します。ダッシュボードを操作する代わりに、質問するだけで即座に回答が得られます。

主な利点:

  • 自然言語でデータをクエリ
  • 130以上の既存Databox統合に対応
  • Databoxユーザーに追加コストなし
  • 60秒未満でセットアップ完了

対応AIクライアント

クライアント状況
Claude Desktop対応
Claude Web対応
Cursor対応
n8n対応
Gemini CLI対応
すべてのMCP互換ツール対応

クイックセットアップ

Claude Desktop

claude_desktop_config.jsonに以下を追加:

{
  "mcpServers": {
    "databox": {
      "type": "http",
      "url": "https://mcp.databox.com/mcp"
    }
  }
}

Claude Web / Claude Desktop App

  1. 設定コネクタに移動
  2. カスタムコネクタを追加をクリック
  3. リモートサーバーURLを入力: https://mcp.databox.com/mcp
  4. 認証フローを完了

Cursor

CursorのMCP設定でDatabox MCPサーバーをURL https://mcp.databox.com/mcp で追加します。

n8n

https://mcp.databox.com/mcp を指すHTTP Requestノードを使用し、そこからワークフローを構築します。

利用可能なツール

Databox MCPは、データを操作するための15のツールを公開しています:

アカウント管理

list_accounts

認証されたユーザーがアクセス可能なすべてのDataboxアカウントを一覧表示します。

パラメータなし。


データソース

list_data_sources

特定のアカウントのすべてのデータソースを一覧表示します。

パラメータ必須説明
account_idstringはいアカウントの一意識別子

create_data_source

データセットを整理するための新しいデータソースコンテナを作成します。

パラメータ必須説明
namestringはいデータソースの人間が読める名前
account_idstringいいえ対象アカウントID。デフォルトはAPIキーに関連付けられたアカウント

delete_data_source

データソースとそれに関連するすべてのデータセットを完全に削除します。元に戻せません。

パラメータ必須説明
data_source_idstringはい削除するデータソースの一意識別子

list_data_source_datasets

特定のデータソースに属するすべてのデータセットを一覧表示します。

パラメータ必須説明
data_source_idstringはいデータソースの一意識別子

データセット

create_dataset

オプションのスキーマを使用して、データソース内に新しいデータセットを作成します。

パラメータ必須説明
data_source_idstringはい親データソースのID
namestringはいデータセットの人間が読める名前
columnsstring (JSON)いいえJSON配列としてのカラムスキーマ。各カラムは name (string) と data_type ("string""number"、または "datetime") を持つ
primary_keysstring (JSON)いいえ複合キーとして使用するカラム名のJSON配列 (例: '["id"]')

ingest_data

既存のデータセットにデータレコードをプッシュします。

パラメータ必須説明
dataset_idstringはい対象データセットの一意識別子 (UUID)
datastring (JSON)はいレコードのJSON配列。各レコードはカラム名をキーとするオブジェクト

get_dataset_ingestions

特定のデータセットの取り込み履歴を取得します。

パラメータ必須説明
dataset_idstringはいデータセットの一意識別子 (UUID)

get_ingestion

特定の取り込みイベントの詳細情報 (レコード数やデータセットメトリクスを含む) を取得します。

パラメータ必須説明
dataset_idstringはいデータセットの一意識別子 (UUID)
ingestion_idstringはい取り込みイベントの一意識別子 (UUID)

delete_dataset

データセットとそのすべてのデータを完全に削除します。元に戻せません。

パラメータ必須説明
dataset_idstringはい削除するデータセットの一意識別子 (UUID)

list_merged_datasets

特定のアカウントのすべての統合データセットを一覧表示します。統合データセットは複数のソースからのデータを結合します。

パラメータ必須説明
account_idstringはいアカウントの一意識別子

メトリクス

list_metrics

データソース (Google Analytics、Stripeなど) で利用可能なすべてのメトリクスを一覧表示します。

パラメータ必須説明
data_source_idintegerはいメトリクスを一覧表示するデータソースID

load_metric_data

日付範囲にわたるメトリクスのデータを、オプションのディメンションと時系列粒度で読み込みます。

パラメータ必須説明
data_source_idintegerはいメトリクスのデータソースID
metric_keystringはい短いメトリクスキー (例: "GoogleAnalytics4@sessions")
start_datestringはい開始日 (YYYY-MM-DD 形式)
end_datestringはい終了日 (YYYY-MM-DD 形式)
dimensionstringいいえ内訳に使用するディメンションキー (例: "source")
granulation_time_unitintegerいいえ時系列の時間単位: 1=時間, 2=日, 3=週, 4=月
is_whole_rangebooleanいいえtrue (デフォルト) の場合、単一の集計値を返す。granulation_time_unit が指定されると自動的に false に設定される
record_limitintegerいいえ返すディメンション値レコードの最大数

AI駆動分析

ask_genie

Genie AIを活用し、自然言語でデータをクエリします。Genieはデータに対して実際のクエリを実行し、LLMの近似値ではなく計算結果を返します。フォローアップ質問のための会話スレッドをサポートします。

パラメータ必須説明
dataset_idstringはい分析するデータセットの一意識別子 (UUID)
questionstringはいデータに関する自然言語の質問
thread_idstringいいえ会話を続けるための前回の応答からのスレッドID

ユーティリティ

get_current_datetime

現在の日付と時刻を取得します。他のツールを呼び出す前に、「先月」や「昨日」などの相対的な日付表現を解決するために使用します。

パラメータ必須説明
timezonestringいいえタイムゾーン名 (例: "UTC""America/New_York")。デフォルトはUTC

仕組み

Databox MCPは、正確で信頼性の高い回答を保証するために3層アーキテクチャを使用します:

  1. データプラットフォーム – スキーマ、型、検証を備えた構造化データセット
  2. 分析クエリエンジン – 実際のクエリ (集計、結合、フィルタ) を実行
  3. セマンティックレイヤー – ビジネス定義とメトリクス関係を理解

AIが直接計算に触れることはありません。AIがクエリを定式化し、エンジンがそれを実行し、AIが結果を要約します。これにより、統計的な近似値ではなく、実際の計算結果が得られます。

認証

Databox MCPは安全な認証を使用します:

  • ユーザー認可のためのOAuth 2.0
  • 安全なセッションのためのJWTトークン検証
  • プログラムによるアクセスのためのAPIキー認証

データは既存のガバナンス基準に従ってDataboxアカウント内に保持されます。AIアクセスは明示的に付与されたデータ権限に制限されます。

セキュリティ

  • 暗号化された接続 (HTTPS)
  • スコープベースの認可
  • 監査証跡と取り込み履歴
  • ベンダーロックインなし (ユニバーサルMCP標準)
  • アカウントごとのデータ分離

ユースケース

アドホック分析

「先週のコンバージョン率は前週と比較してどうでしたか?」

クロスソースインサイト

「Google広告の広告費とStripeの収益を組み合わせてROASを計算してください」

トレンド検出

「今四半期で最も返金率が高い製品カテゴリはどれですか?」

自動アラート

「3日間のコンバージョン率が2%を下回ったらアラートを出してください」

データクレンジング

乱雑なCSVエクスポートをプッシュし、Databoxに日付、形式、スキーマを自動的に正規化させます

直接メトリクスクエリ

「過去30日間のGoogle Analyticsセッションをトラフィックソース別に表示してください」

時系列分析

「1月の日次ページビューを週次集計で読み込んでください」

ディメンション内訳

「Stripeの収益上位10カ国はどこですか?」

リソース

サポート

質問やサポートについては:


Databoxによって構築 — すべてのビジネス指標を一か所で追跡。