# Databricks Genie One を Treasure AI Studio に接続する

Treasure AI Studio を Databricks に外部 MCP サービスとして登録すると、ビジネスユーザーが Genie One のチャットから Studio のエージェントやアクションを実行できます。Genie One は、ビジネスユーザー向けの Databricks の画面です。リクエストは、Studio にログインした本人の作業フォルダ、権限、費用で実行されます。このページでは、Treasure AI Studio と Databricks で行う設定と、Genie One からの使い方を説明します。ビジネスユーザーがすでに Databricks で仕事をしていて、ツールを切り替えずにオーディエンスの情報や Studio のアクションの結果を得たいときに使ってください。

このガイドは Genie One を対象としています。Genie Code の CLI を接続する場合は、[Databricks Genie Code を Treasure AI に接続する](/getting-started/ai/databricks-genie-code)を参照してください。Treasure AI Studio を使わずに、CDP API を通じて親セグメント、セグメント、ジャーニーについての読み取り専用の質問に Genie Agent で答える場合は、[Databricks Genie AgentsをTreasure AI CDPに接続する](/getting-started/ai/databricks-genie-agents)を参照してください。

## 接続の設定の流れ

接続の設定は、2 つの場所で、3 種類の人が行います。

| 担当  | 場所  | 行うこと  |
|  --- | --- | --- |
| **Studio のアカウント管理者** | Treasure AI Studio の **設定 → エージェントチャネル** | OAuth エンドポイントを 1 つ作成し、その接続 URL をコピーする |
| **MCP を登録する Databricks のユーザー** | Databricks の **Unity Gateway → MCPs** | 接続 URL を MCP サービスとして登録し、アクセス権を付与する |
| **Genie One を使う各利用者** | Databricks の Genie One | MCP サービスをチャットに追加し、Studio にログインして、アクセスを許可する |


Databricks は OAuth クライアントとして Treasure AI Studio に自身を登録します（動的クライアント登録）。そのため、Databricks に Studio のトークンや Treasure AI の API キーを入力する必要はありません。各利用者は、自分のアカウントで Studio にログインします。また、各利用者は、エンドポイントと同じ Studio アカウントの Treasure AI Studio アカウントを持ち、使いたい作業フォルダにアクセスできる必要があります。

## 前提条件

- **Treasure AI Studio** では、OAuth エンドポイントを作成するアカウント管理者が必要です。OAuth エンドポイントを作成できるのはアカウント管理者だけです。
- **Databricks** では、MCP を登録する人に次のものが必要です。これらの要件は、Databricks のガイド [External MCP servers](https://docs.databricks.com/aws/en/ai-gateway/register-mcp-service) に基づきます。
  - Model Serving に対応したリージョンにある、Unity Catalog が有効なワークスペースと、**Workspace access** の権限付与（entitlement）
  - MCP サービスを置くカタログとスキーマに対する `USE CATALOG` と `USE SCHEMA`、スキーマに対する `CREATE SERVICE`
  - スキーマに対する `CREATE CONNECTION`
- Databricks のワークスペースから Studio の Agent Gateway（たとえば `agent-gateway.us01.treasure.ai`）への**ネットワーク接続**。ワークスペースで外向きの通信を制限している場合は、[MCP networking](https://docs.databricks.com/aws/en/agents/mcp-tools/networking) を参照してください。


## 手順 1: Studio で OAuth エンドポイントを作成する

アカウント管理者が OAuth エンドポイントを 1 つ作成します。接続するすべての利用者は、そのエンドポイントの接続 URL を使います。作成の全体は [OAuth 方式の MCP エンドポイント](/products/ai-studio/agent-channels/mcp-oauth#oauth-%E3%82%A8%E3%83%B3%E3%83%89%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88%E3%82%92%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B)を参照してください。

1. **設定 → エージェントチャネル**を開き、**MCP エンドポイント**セクションの**新規 MCP エンドポイント**を選択します。
2. **接続方式**で**OAuth（接続した利用者本人）**を選択します。
3. **エンドポイント名**に *Studio MCP OAuth* のような名前を入力します。任意で**コメント**を追加します。
4. **エンドポイントを作成**を選択します。
5. **OAuth エンドポイントを作成しました**の画面で、**接続 URL** の横にある**コピー**を選択します。


接続 URL の形式は `https://<アカウントの Agent Gateway>/v1/mcp/<エンドポイント ID>` です。US01 サイトの場合は `https://agent-gateway.us01.treasure.ai/v1/mcp/<エンドポイント ID>` のようになります。エンドポイントの詳細ページには、ステータスとして**有効**が表示されます。接続 URL は、接続を設定する人に渡してください。このガイドでは、エンドポイント専用の接続 URL を使います。共通 MCP URL も代わりに使えます。詳しくは[共通 MCP URL](/products/ai-studio/agent-channels/mcp-oauth#%E5%85%B1%E9%80%9A-mcp-url)を参照してください。

## 手順 2: Databricks に Treasure AI Studio を登録する

MCP を登録する Databricks のユーザーが一度だけ行います。登録すると、Unity Catalog に MCP サービスと、その裏で使われる HTTP 接続が作成されます。このページのスクリーンショットは英語表示の画面なので、Databricks の画面のラベルは英語のまま記載しています。

1. Databricks のワークスペースで **Unity Gateway** を開き、**MCPs** を選択して、**+ MCP** を選択します。**Connect an existing MCP server** を選びます。
2. **Server URL** に、手順 1 でコピーした接続 URL を貼り付けます。
3. **Location** で、`workspace.default` のようなカタログとスキーマを選び、`treasure_ai_studio` のような **Service name** を入力します。名前は作成後に変更できません。
4. **Authentication** で **OAuth (automatic, DCR)** を選択します。この方式では、各利用者が自分のアカウントでログインし、Databricks が OAuth アプリを自動で登録します。


1. **Sign in** を選択します。ブラウザが Treasure AI Studio を開きます。Studio からログインを求められたら、ログインします。
2. **MCP アクセスを許可**の画面で、上部に表示されるコールバック先のホストが `oregon.cloud.databricks.com` のような Databricks のホストで、アプリケーション名が **Databricks** であることを確認します。要求された MCP リソース（手順 1 の接続 URL）とアカウントも確認し、**アクセスを許可**を選択します。


要求される権限は `mcp` で、作業フォルダ・アクション一覧・実行結果の参照、アクションの実行、チャットの開始・継続です。詳しくは [MCP の権限](/products/ai-studio/agent-channels/mcp-oauth#mcp-%E3%81%AE%E6%A8%A9%E9%99%90)を参照してください。

1. **Tools** で公開するツールを選び、**Create MCP Service** を選択します。Treasure AI Studio は 6 つのツールを提供します。一部だけを公開する場合は、[Choose available tools](https://docs.databricks.com/aws/en/ai-gateway/govern-mcp-service#select-tools) を参照してください。


MCP サービスのページに、ステータスとして **Active** が表示され、6 つのツールが一覧表示されます。Databricks は、`list_work_folders`、`list_actions`、`get_chat_result` に **Read-only**、`run_action`、`start_chat`、`continue_chat` に **Destructive** のラベルを付けます。各ツールの動作は[ツール](/products/ai-studio/agent-channels/mcp-clients#%E3%83%84%E3%83%BC%E3%83%AB)を参照してください。

## 手順 3: MCP サービスへのアクセス権を付与する

Genie One から MCP サービスを使う人には、MCP サービスに対する `EXECUTE`、カタログに対する `USE CATALOG`、スキーマに対する `USE SCHEMA`、ワークスペースへの割り当てが必要です。MCP サービスの権限を管理できる ID で付与してください。これらの要件は、Databricks のガイド [Share an MCP](https://docs.databricks.com/aws/en/ai-gateway/govern-mcp-service) に基づきます。

1. **Unity Gateway** で **MCPs** を選択し、MCP サービスを開いて、**Permissions** タブを開きます。
2. **Grant** を選択し、グループを選び、**EXECUTE** を選択して、**Grant** を選択します。
3. **Catalog Explorer** で、グループにカタログの `USE CATALOG` とスキーマの `USE SCHEMA` を付与します。


MCP サービスを使う人に `USE CONNECTION` は不要です。この権限は MCP サービスのツールの選択範囲を超えて接続を直接使えるようにするため、MCP サービスを管理する人だけに付与してください。Genie One のチャットは、**Consumer access** の権限付与を持つ人が使えます。**Consumer access** だけを持つ人が MCP サービスにログインできるようにするには、Databricks の [MCP API and SDK reference](https://docs.databricks.com/aws/en/ai-gateway/mcp-service-reference) に従い、`account users` グループに権限を付与してください。

## 手順 4: Genie One から Treasure AI Studio を使う

各利用者が MCP サービスを Genie One のチャットに追加し、初回に Studio にログインします。

1. MCP サービスを Genie One に追加します。次のどちらかの入口を使います。
  - **Unity Gateway** の MCP サービスのページで、**Get started** の **Genie** を選択し、**Genie One** を選択してから、**Add to Genie One** を選択します。
  - Genie One のホームページで、検索バーの左下にある **+** アイコンを選択し、**Connectors**、**Browse connectors** の順に選択して、MCP サービスを選択します。
2. Genie One からログインを求められたら、Treasure AI Studio にログインし、**MCP アクセスを許可**で**アクセスを許可**を選択します。
3. *List the Studio work folders I can access* のような、Studio が必要な依頼を送ります。


Genie One は、呼び出したツールをチャットに表示します。たとえば **Completed: List work folders** のように表示されます。ツールが実行されない場合は、Databricks のガイド [Connect Genie One to external applications with MCP](https://docs.databricks.com/aws/en/genie-one/external-sources) にあるとおり、依頼の中で接続先を明示してください。

## Studio で実行される内容

各リクエストは、Studio にログインした本人として実行されます。MCP サービスを登録した人ではなく、本人の作業フォルダ、権限、費用が使われます。Studio は、リクエストのたびに承認を求めません。チャットを開始・継続するリクエストは、Studio の通常のチャットとして本人のチャット一覧に表示されます。チャットが実行された作業フォルダの名前が表示され、本人の作業フォルダのファイルを変更できます。詳しくは[チャットは本人の通常の Studio チャット](/products/ai-studio/agent-channels/mcp-oauth#%E3%83%81%E3%83%A3%E3%83%83%E3%83%88%E3%81%AF%E6%9C%AC%E4%BA%BA%E3%81%AE%E9%80%9A%E5%B8%B8%E3%81%AE-studio-%E3%83%81%E3%83%A3%E3%83%83%E3%83%88)で説明しています。

Databricks は、Unity Gateway を通じて各ツールの呼び出しを管理します。呼び出しのたびに MCP サービスに対する `EXECUTE` を持っているかを確認し、利用状況をシステムテーブルに記録します。MCP サービスに対する `MANAGE` を持つ管理者は、使えるツールを絞り込んだり、サービスポリシーを適用したりできます。詳しくは [Govern an MCP](https://docs.databricks.com/aws/en/ai-gateway/govern-mcp-service) を参照してください。

## 接続を止める

接続は、全員について、または 1 人だけ止められます。

- **全員を止める（Studio）。** エンドポイントの **有効 / 無効** のスイッチをオフにします。オンに戻すまで、Databricks からのリクエストは拒否されます。
- **1 人を止める（Studio）。** その人をアカウントから外すか、関係する作業フォルダへのアクセス権を外します。
- **1 人を止める（Databricks）。** その人の MCP サービスに対する `EXECUTE` を外します。本人も、MCP サービスのページ、または Genie One の **Connectors → Browse connectors** で **Revoke credentials** を選択すると、自分の Studio へのログインを取り消せます。
- **MCP サービスを削除する（Databricks）。** MCP サービスを削除します。詳しくは [Update or delete an MCP](https://docs.databricks.com/aws/en/ai-gateway/govern-mcp-service#manage-service) を参照してください。


## トラブルシューティング

| 症状  | 原因と対処  |
|  --- | --- |
| 同意画面に *「要求された MCP リソースに対応する OAuth エンドポイントを持つ、利用可能なアカウントがありません。」* と表示される | 利用できるアカウントが、このエンドポイントに対応していません。エンドポイントが削除されているか、アカウントのメンバーではないか、**Server URL** の URL がエンドポイントの接続 URL ではない可能性があります。手順 2 の URL を確認するか、アカウント管理者に確認してください |
| 同意画面に、エンドポイントが停止中、または利用できない状態と表示される | エンドポイントが無効になっています。アカウント管理者が **有効 / 無効** のスイッチを有効に戻します |
| Genie One に MCP サービスが表示されない | MCP サービスに対する `EXECUTE`、または親のカタログとスキーマに対する `USE CATALOG` や `USE SCHEMA` がありません。手順 3 のとおり付与してください |
| `403` と `mcp_disabled` でリクエストが拒否される | エンドポイントが無効になっています。アカウント管理者が有効に戻します |
| 接続後のその他のエラー | [OAuth 方式の MCP エンドポイント](/products/ai-studio/agent-channels/mcp-oauth#%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0)のトラブルシューティングの表を参照してください |


## 次のステップ

- [OAuth 方式の MCP エンドポイント](/products/ai-studio/agent-channels/mcp-oauth): 権限、共通 MCP URL、アクセスの止め方。
- [MCP クライアントを接続する](/products/ai-studio/agent-channels/mcp-clients): 6 つのツールと、その結果の読み方。
- [エージェントチャネルのチャットが到達できる範囲](/products/ai-studio/agent-channels/channel-chats): これらのチャットで変更できる範囲と、できない範囲。
- [Headless](/products/headless): 他の AI ツールを Treasure AI Studio に接続する概要。
- ほかの Headless ガイド: [ChatGPT](/products/headless/chatgpt)、[Claude](/products/headless/claude-web)、[Gemini](/products/headless/gemini)。