> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Bricks

> Connect AI Remote MCP サービスにより、Agent Bricks はリアルタイムでデータを安全に読み取り、操作できます。

## 前提条件

Agent Bricks を Connect AI と連携させる前に、まずデータソースを Connect AI アカウントに接続する必要があります。詳細については、[ソース](/ja/Sources) を参照してください。

## CData Connect AI で OAuth アプリを作成する

Agent Bricks は OAuth 2.0 を使用して、CData Connect AI MCP サーバーに対してユーザーを認証します。これには、CData Connect AI アカウントに OAuth アプリが必要です。

OAuth アプリには Databricks ワークスペースのホストから組み立てるコールバック URL が必要です。以下の手順では、この URL を組み立て、アプリ作成時に入力する方法を説明します。

<Steps>
  <Step>
    Connect AI の右上隅にある歯車アイコンをクリックして **Settings** を開きます。
  </Step>

  <Step>
    **OAuth Apps** に移動し、**+ Create App** をクリックします。**Create OAuth App** ダイアログが表示されます。
  </Step>

  <Step>
    以下の設定を入力します：

    * **Name**—わかりやすい名前（例：*AgentBricksOAuth*）を入力します。
    * **Application Type**—**Web Application** を選択します。
    * **Callback URL**—以下の手順に従ってコールバック URL を作成します。

    <Steps>
      <Step>
        ブラウザで Databricks ワークスペースを開き、アドレスバーからホスト（`https://` から次の `/` までのすべて）をコピーします。例：`adb-5555555555555555.5.azuredatabricks.net`。（AWS ワークスペースは `dbc-xxxxxxxx-xxxx.cloud.databricks.com`、GCP は `xxxx.gcp.databricks.com` のような形式です。）
      </Step>

      <Step>
        そのホストに `/login/oauth/http.html` を追加します。上記の例を使用する場合、**Callback URL** として次の値を入力します： *[https://adb-5555555555555555.5.azuredatabricks.net/login/oauth/http.html](https://adb-5555555555555555.5.azuredatabricks.net/login/oauth/http.html)* 。
      </Step>

      <Step>
        この値を Connect AI の OAuth アプリの **Callback URL** フィールドに貼り付けます。

        <Frame>
          <img src="https://mintcdn.com/cdata/wMSjCV4YNIlqvY-S/ja/images/databricks_client_create_oauth.png?fit=max&auto=format&n=wMSjCV4YNIlqvY-S&q=85&s=d0f00fd490c157b3b0658fdce736c0fb" alt="CData Connect AI で OAuth アプリを作成する" width="880" height="772" data-path="ja/images/databricks_client_create_oauth.png" />
        </Frame>
      </Step>
    </Steps>
  </Step>

  <Step>
    **Confirm** をクリックします。CData Connect AI が OAuth アプリを作成し、クライアントアプリケーション用の **Client ID** と **Client Secret** を生成します。

    <Frame>
      <img src="https://mintcdn.com/cdata/wMSjCV4YNIlqvY-S/ja/images/databricks_client_oauth_app.png?fit=max&auto=format&n=wMSjCV4YNIlqvY-S&q=85&s=e024f00e6a47fd4f5dadc5939364878e" alt="OAuth アプリの Client ID と Client Secret" width="1309" height="600" data-path="ja/images/databricks_client_oauth_app.png" />
    </Frame>
  </Step>

  <Step>
    **Client ID** と **Client Secret** の両方をコピーします。次のセクションで必要になります。
  </Step>
</Steps>

## Databricks で MCP サーバーコネクションを作成する

<Steps>
  <Step>
    Databricks にログインして **Databricks Marketplace** に移動します。
  </Step>

  <Step>
    検索バーに *Connect AI* と入力し、**CData Connect AI: Managed MCP Platform for Enterprise Databricks Agents** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/7DF1MfpsbSJFCdvb/ja/images/databricks_client_mcp_install.png?fit=max&auto=format&n=7DF1MfpsbSJFCdvb&q=85&s=70e29d42009b04ef74d6251b10f35dd7" alt="MCP プラットフォームをインストールする" width="1907" height="986" data-path="ja/images/databricks_client_mcp_install.png" />
    </Frame>
  </Step>

  <Step>
    **Install** をクリックします。ダイアログが表示されます。

    <Frame>
      <img src="https://mintcdn.com/cdata/7DF1MfpsbSJFCdvb/ja/images/databricks_client_mcp_dialog.png?fit=max&auto=format&n=7DF1MfpsbSJFCdvb&q=85&s=bb131604053cea71742e8a40fe4e1d4a" alt="MCP プラットフォームのインストールダイアログ" width="638" height="1003" data-path="ja/images/databricks_client_mcp_dialog.png" />
    </Frame>
  </Step>

  <Step>
    アプリの **Connection name**（例：**QueryMCP**）を入力します。
  </Step>

  <Step>
    **Host** と **Base path** は事前に入力されています。
  </Step>

  <Step>
    前のセクションで OAuth アプリからコピーした **Client ID** と **Client Secret** を入力します。
  </Step>

  <Step>
    利用規約に同意するチェックボックスを選択し、**Install** をクリックします。
  </Step>
</Steps>

## Databricks でエージェントを作成する

<Steps>
  <Step>
    **Agents** タブで **Create Agent** をクリックします。
  </Step>

  <Step>
    **Supervisor Agent** を選択します。
  </Step>

  <Step>
    **Create Supervisor Agent** ダイアログで、以下の情報を入力します：

    * **Name**—エージェントの名前を入力します。
    * **Description**—エージェントの説明を入力します。
    * **Configure Agents**：
      * **Type**—**External MCP Server** を選択します。
      * **Unity Catalog connection**—前の手順で作成した MCP コネクションを選択します。
      * **Describe the content**—MCP コネクションの説明を入力します。

    <Frame>
      <img src="https://mintcdn.com/cdata/wMSjCV4YNIlqvY-S/ja/images/databricks_client_create_agent.png?fit=max&auto=format&n=wMSjCV4YNIlqvY-S&q=85&s=7d07c907b3649730c2b402a1d9bb7912" alt="エージェントを作成する" width="1251" height="734" data-path="ja/images/databricks_client_create_agent.png" />
    </Frame>
  </Step>

  <Step>
    **Create Agent** をクリックします。
  </Step>
</Steps>

## エージェントをテストする

<Steps>
  <Step>
    エージェントのページで **Open in Playground** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/wMSjCV4YNIlqvY-S/ja/images/databricks_client_playground.png?fit=max&auto=format&n=wMSjCV4YNIlqvY-S&q=85&s=26983a9e7c59ccd7eb63f3c912b1a35a" alt="Open in playground" width="1558" height="736" data-path="ja/images/databricks_client_playground.png" />
    </Frame>
  </Step>

  <Step>
    これで、Supervisor Agent を介して Connect AI MCP サーバー経由で接続されたデータをクエリできるようになりました。

    <Frame>
      <img src="https://mintcdn.com/cdata/wMSjCV4YNIlqvY-S/ja/images/databricks_client_playground2.png?fit=max&auto=format&n=wMSjCV4YNIlqvY-S&q=85&s=14d4548723edbd48c617caa5a9560833" alt="エージェントプレイグラウンド" width="1244" height="587" data-path="ja/images/databricks_client_playground2.png" />
    </Frame>
  </Step>
</Steps>