Skip to content
Last updated

AIエージェント向けスタートガイド

Treasure Dataのドキュメントとプラットフォームは、Claude Codeやその他のMCP対応AIツールからModel Context Protocol(MCP)を通じてアクセスできます。これにより、AIアシスタントがドキュメントにアクセスし、Treasure Data環境と直接やり取りすることが可能になります。

メリット

  • リアルタイムドキュメントアクセス: AIアシスタントがTreasure Dataの製品や機能に関する正確でコンテキストに沿ったヘルプを提供します。
  • プラットフォーム操作: AIアシスタントがデータベースのクエリ、セグメントの管理、ワークフローの実行などを行えます。
  • 動的なAPIガイダンス: AIアシスタントがユーザーのニーズに基づいてAPIリファレンスの内容を抽出し、説明できます。

Ask AI(ドキュメントアシスタント)

Treasure Dataドキュメントサイトには、製品、機能、APIに関する質問にドキュメントから直接回答できるAIアシスタントが組み込まれています。

使い方

  1. ドキュメントページの右下にある Ask AI ボタンをクリックします。
  2. 自然言語で質問を入力します。
  3. AIアシスタントがドキュメントを検索し、ソースリンク付きで関連する回答を提供します。

上部ナビゲーションバーの Search モーダルからもAsk AIにアクセスできます。

質問できる内容

AIアシスタントはすべてのドキュメントコンテンツをインデックス化して検索します:

  • 製品ガイド: すべてのTreasure Data製品の完全なドキュメント
  • APIリファレンス: OpenAPI仕様とエンドポイントの詳細
  • Integrationガイド: データソースとデスティネーションのセットアップ手順
  • ベストプラクティス: 実装パターンと推奨事項

質問例

Parent Segmentはどのように設定しますか?
Integration Hubで利用可能なIntegrationは何ですか?
Real-Time ID Stitchingはどのように機能しますか?
TrinoとHiveの違いは何ですか?
カスタマージャーニーはどのように作成しますか?

AIアシスタントは最新のドキュメントコンテンツに基づいて回答を提供し、詳細については関連ページへのリンクを表示します。


MCPサーバー

開発者やAIツール向けに、Treasure Dataは用途に応じて2つのMCPサーバーを提供しています:

MCPサーバー用途できること
TD Docs MCPドキュメント検索Treasure Dataの製品や機能について質問する
tdx MCPプラットフォーム操作データベースのクエリ、セグメントの管理、ワークフローの実行など

TD Docs MCPサーバー

TD Docs MCPサーバーを使用して、ドキュメントを探索し、APIを検出できます。

サーバーは次のURLで登録されています: https://docs.treasuredata.com/mcp

利用可能なツール

ドキュメントツール

ツールパラメータ説明
list-apisname?: string利用可能なAPIとそのコンテキストおよび目的をリストします。
get-endpointsname: string特定のAPIのすべてのエンドポイントとその説明を返します。
get-endpoint-infoname: string, path: string, method: stringパラメータ、セキュリティ、例を含む特定のエンドポイントの包括的な情報を返します。
get-security-schemesname: string特定のAPIのセキュリティスキームを取得します。
get-full-api-descriptionname: string完全なOpenAPI記述を返します。

検索ツール

ツールパラメータ説明
searchquery: stringドキュメントを検索し、クエリに関連するコンテンツを返します。

MCPサーバーの使用方法

MCPをサポートする任意のAIツール(Cursor、Claude Code、VS Codeなど)をTD Docs MCPサーバーに接続できます。

  1. MCPサーバーURLをコピーします: https://docs.treasuredata.com/mcp
  2. 以下の手順に従ってツールに追加します。

接続後、ツールはTreasure DataのドキュメントとAPIリファレンスにアクセスできるようになります。

CursorをMCPサーバーに接続する

  1. Cursorでコマンドパレットを開きます。
    • macOS: Command + Shift + P
    • Windows/Linux: Ctrl + Shift + P
  2. コマンドパレットに「Open MCP settings」と入力します。
  3. 「Add custom MCP」を選択します。

Cursorが mcp.json ファイルを開きます。

MCPサーバーの設定

  1. mcp.json にサーバー設定を追加します:
{
  "mcpServers": {
    "td-docs": {
      "url": "https://docs.treasuredata.com/mcp"
    }
  }
}
  1. mcp.json ファイルを保存します。
  2. MCP設定に戻り、接続を確認します。

接続後、Cursorは利用可能なツールのリストを表示します。

Cursor接続のテスト

Cursorチャット(Agentモード)で、MCPツールをトリガーする質問をします:

Real-Time ID Stitchingはどのように設定しますか?

tdx MCPサーバー

tdx CLIは、AIツールがTreasure Data環境と直接やり取りできるMCPサーバーを提供します。

セットアップ

まず、tdxをインストールして認証します:

# tdxをインストール
npm install -g @treasuredata/tdx

# 認証
tdx auth setup

利用可能なツール

ツールパラメータ説明
tdx_runargs: string[]任意のtdx CLIコマンドを実行します。JSON出力を返します。
tdx_searchquery: string, category?: string実行したい内容に基づいて関連するtdxコマンドを検索します。

tdx_searchのカテゴリ: Data, CDP, AI, Context, Utilities

MCPサーバーの使用方法

Cursorをtdx MCPサーバーに接続する

  1. Cursorでコマンドパレットを開きます(Command + Shift + P または Ctrl + Shift + P)。
  2. 「Open MCP settings」と入力し、「Add custom MCP」を選択します。

MCPサーバーの設定

mcp.json にtdxサーバー設定を追加します:

{
  "mcpServers": {
    "tdx": {
      "command": "tdx",
      "args": ["mcp"]
    }
  }
}

グローバルインストールなし(npxを使用):

{
  "mcpServers": {
    "tdx": {
      "command": "npx",
      "args": ["@treasuredata/tdx", "mcp"]
    }
  }
}

特定のプロファイルを使用する場合:

{
  "mcpServers": {
    "tdx": {
      "command": "tdx",
      "args": ["mcp"],
      "env": {
        "TDX_PROFILE": "my-profile"
      }
    }
  }
}

会話例

設定後、次のような会話ができます:

> Treasure Dataで利用可能なデータベースは何ですか?

AIはtdx_runを使用します(args: ["databases"])

> mydbのusersテーブルのスキーマを表示してください

AIはtdx_runを使用します(args: ["describe", "mydb.users"])

> 注文数でトップ10のユーザーを見つけるクエリを実行してください

AIはtdx_runを使用します(args: ["query", "SELECT user_id, COUNT(*) as orders
  FROM mydb.orders GROUP BY user_id ORDER BY orders DESC LIMIT 10"])

> 過去30日間に購入したユーザーのセグメントを作成してください

AIはtdx_searchでセグメントコマンドを検索し、その後tdx_runでセグメントを作成します

tdx claude: オールインワンセットアップ

Treasure Dataのお客様にとって、最も簡単な始め方は tdx claude を使用することです。以下の機能を提供します:

  • TD LLM Proxy統合: 既存のAI Suite クレジットを使用
  • 事前設定済みTD Skills: SQL、ワークフロー、CDP操作の強化された機能
  • ドキュメント検索: TDドキュメントへの組み込みアクセス

クイックスタート

# tdxとClaude Codeをインストール
npm install -g @treasuredata/tdx
curl -fsSL https://claude.ai/install.sh | bash

# Treasure Dataで認証
tdx auth setup

# TD統合でClaude Codeを起動
tdx claude

会話例

tdx claude 経由でClaude Code内で:

> SnowflakeからTDへのデータ取り込みはどのように設定しますか?

> mydb.user_eventsデータを分析してください

> S3から定期的にデータをインポートするワークフローを作成してください

> 売上トップの顧客を見つけるSQLクエリを作成してください

> 過去30日間に購入した顧客のユーザーセグメントを構築してください

TD Skills: AI支援の強化

TD Skillsは、Treasure Dataワークフロー向けのAI支援を強化する、事前構築されたClaude Codeプラグインです:

スキルカテゴリ支援内容
SQL SkillsTrino/Hive構文、TD固有の関数、クエリ最適化
Workflow SkillsDigdagワークフロー、スケジューリング、dbt統合
tdx Skillsセグメント、ジャーニー、アクティベーション、AIエージェント

すべてのTD Skillsは tdx claude を使用する際に自動的に利用可能です。


関連情報