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


## Treasure Docs MCPサーバー

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

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

### 利用可能なツール

#### ドキュメントツール

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


#### 検索ツール

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


### MCPサーバーの使用方法

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

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


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

Cursor
#### 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` にサーバー設定を追加します:



```json
{
  "mcpServers": {
    "td-docs": {
      "url": "https://docs.treasuredata.com/mcp"
    }
  }
}
```

1. `mcp.json` ファイルを保存します。
2. MCP設定に戻り、接続を確認します。


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

#### Cursor接続のテスト

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


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

Claude Code
#### Claude CodeをMCPサーバーに接続する

1. 次のコマンドを実行します:



```bash
claude mcp add td-docs https://docs.treasuredata.com/mcp --transport http
```

1. Claude Code CLIで `/mcp` と入力して接続を確認します。
2. Claude Codeが利用可能なツールの説明とパラメータを表示します。


#### Claude Code接続のテスト

Claude Code CLIで、MCPツールを使用する質問をします:


```
Parent Segmentを作成するためのベストプラクティスは何ですか？
```

VS Code
#### VS CodeをMCPサーバーに接続する

1. VS Codeでコマンドパレットを開きます。
  - macOS: `Command + Shift + P`
  - Windows/Linux: `Ctrl + Shift + P`
2. コマンドパレットに「MCP: Add Server」と入力します。
3. リモートMCPサーバーに接続するために「HTTP」を選択します。
4. MCPサーバーURLを入力します: `https://docs.treasuredata.com/mcp`
5. 接続の名前を入力します（例: `td-docs`）。


#### VS Code接続のテスト

AgentモードでChat with AIを開き、ツールアイコンを選択します。
MCP接続が利用可能なツールのリストとともに表示されていることを確認します。

AIにMCPツールを使用するクエリを実行するよう依頼します:


```
Personalization APIのAPI仕様を表示してください
```

## tdx MCPサーバー

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

### セットアップ

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


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

# 認証
tdx auth setup
```

### 利用可能なツール

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


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

### MCPサーバーの使用方法

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

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


#### MCPサーバーの設定

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


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

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


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

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


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

Claude Desktop
#### Claude Desktopをtdx MCPサーバーに接続する

Claude Desktop設定ファイルを開きます:
tdxサーバー設定を追加します:


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

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


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

Windsurf
#### Windsurfをtdx MCPサーバーに接続する

`~/.windsurf/mcp.json` にあるWindsurf MCP設定ファイルを開きます。

tdxサーバー設定を追加します:


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

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


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

### 会話例

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


```
> 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 クレジット](https://www.treasuredata.com/terms/ai-suite-credits-definition/)を使用
- **事前設定済みTD Skills**: SQL、ワークフロー、CDP操作の強化された機能
- **ドキュメント検索**: TDドキュメントへの組み込みアクセス


### クイックスタート


```bash
# 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-code/guide/td-skills)は、Treasure ワークフロー向けのAI支援を強化する、事前構築されたClaude Codeプラグインです:

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


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

## 関連情報

- [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) - MCPについて詳しく学ぶ
- [tdx CLIドキュメント](/treasure-code/) - 完全なtdxリファレンス
- [tdx MCPコマンド](/treasure-code/commands/mcp) - 詳細なMCPサーバードキュメント
- [tdx claudeコマンド](/treasure-code/commands/claude) - Claude Code統合ガイド
- [TD Skills](/treasure-code/guide/td-skills) - Treasure Data向けの事前構築AIスキル
- [製品ドキュメント](/products) - すべてのTreasure Data製品を閲覧