# Gemini を Treasure AI Studio に接続する

Treasure AI Studio を Web 版 Gemini にカスタムの接続済みアプリとして追加すると、Gemini のチャットから Studio のエージェントやアクションを実行できます。リクエストは、接続した本人の作業フォルダ、権限、費用で実行されます。このページでは、Treasure AI Studio と Gemini で行う設定と、リクエストを送ったときの流れを説明します。すでに Gemini で仕事をしていて、ツールを切り替えずにオーディエンスの情報や Studio のアクションの結果を得たいときに使ってください。

## 接続の設定の流れ

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

| 担当  | 場所  | 行うこと  |
|  --- | --- | --- |
| **アカウント管理者** | Treasure AI Studio の **設定 → エージェントチャネル** | OAuth エンドポイントを 1 つ作成し、その接続 URL をコピーする |
| **Gemini を使う各利用者** | Gemini の **Connected apps** | 接続 URL を Gemini に追加し、Studio にログインして、アクセスを許可する |


OAuth エンドポイントを作成できるのはアカウント管理者だけです。それ以外のメンバーは、管理者がすでに作成したエンドポイントに接続します。接続する各利用者は、同じアカウントの Treasure AI Studio アカウントを持ち、使いたい作業フォルダにアクセスできる必要があります。Gemini では、**Connected apps** ページに **+ Custom** が表示される Google アカウントが必要です。この項目は、Google アカウントの種類、提供状況、管理者のポリシーによって表示されないことがあります。**+ Custom** が表示されなくても、Studio のエンドポイントに問題があるとは限りません。

接続する前に、Gemini が共有する内容を確認してください。[Gemini とのデータ共有](#gemini-%E3%81%A8%E3%81%AE%E3%83%87%E3%83%BC%E3%82%BF%E5%85%B1%E6%9C%89)では、接続時の注意書きの内容を説明しています。

## 手順 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: Gemini に Treasure AI Studio を追加する

各利用者が Gemini で行います。このページのスクリーンショットは英語表示の画面なので、Gemini の画面のラベルは英語のまま記載しています。

1. Gemini で設定メニューを開き、**Personal Intelligence** を選択します。メニューの場所は、Google アカウントや Gemini の画面によって異なることがあります。同じページは **Customise → Connectors** からも開けます。


1. **Connected apps** を選択します。


1. **Connected apps** で **+ Custom** を選択します。


1. **Connect to an MCP server** で、手順 1 でコピーした接続 URL を **MCP server URL** に貼り付けます。URL は `https://` で始まる必要があります。**Next** を選択します。


1. **Connect this MCP server** で、URL と Google アカウントが目的のものであることを確認します。注意書きを読み、**I understand and accept the security and privacy risks of connecting this custom app** を選択して、**Connect** を選択します。


1. **Link your Google Account and [Custom] Treasure account** で、Google が行えることを確認し、注意書きを最後までスクロールして、同意する場合は **Agree and continue** を選択します。ブラウザが Treasure AI Studio を開きます。


1. Studio からログインを求められたら、ログインします。**MCP アクセスを許可**の画面で、上部に表示されるコールバック先のホストが `oauth-redirect.googleusercontent.com`、アプリケーション名が **Google** であることを確認します。要求された MCP リソース（手順 1 の接続 URL）とアカウントも確認し、**アクセスを許可**を選択します。


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

1. **Save your custom app** で、*Treasure AI CDP* のような名前を入力します。**Available actions** に Studio の 6 つのツールが表示されていることを確認し、**Connect** を選択します。


1. **Connected apps** を確認します。アプリが **Custom apps** に表示されます。


## 手順 3: アプリのアクションを確認する

**Custom apps** からアプリを開きます。**App actions** には、Studio の 6 つのツールと、それぞれを使う前に Gemini が確認を求める頻度が表示されます。依頼のたびに Gemini が確認を求めるように、**Always ask** のままにしてください。このページには、アプリの MCP URL と **Disconnect** ボタンも表示されます。

## 手順 4: Gemini から依頼を送る

1. チャットで使うアプリを選択します。次のどちらかの方法を使います。
  - アプリのページで **...** メニューを開き、**Use now** を選択します。
  - プロンプト欄に `@Treasure` と入力し、**Connectors** からアプリを選択します。


1. *List the Studio work folders I can access. Do not run Actions or change anything.* のような、Studio が必要な依頼を送ります。
2. Gemini がツールの使用の許可を求めてきたら、表示されたツールを確認し、その依頼だけを許可する場合は **Allow once** を選びます。オーディエンスの一覧など、より大きな依頼では、Gemini が `start_chat` を使って Studio のエージェントに依頼を渡すことがあります。


Gemini がツールを使わずに答えた場合は、チャットでアプリを選択し、Studio が必要な具体的な依頼を送ってください。アプリでできることを一般的に説明するだけの回答では、Gemini が Studio に到達したことは確認できません。

## Studio で実行される内容

各リクエストは、接続した本人として実行されます。本人の作業フォルダ、権限、費用が使われます。Studio は、リクエストのたびに承認を求めません。この流れで表示される確認は、Studio の確認ではなく、手順 4 で表示される Gemini の確認です。

チャットを開始・継続するリクエストは、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)で説明しています。`run_action` は保存済みの Studio のアクションを実行するため、許可する前に目的と想定される結果を確認してください。

## Gemini とのデータ共有

手順 2 の **Connect this MCP server** の注意書きには、カスタムアプリと連携するために、Gemini が MCP サーバーのツールを実行し、MCP サーバーのデータを取得・管理し、データを MCP サーバーと共有すると書かれています。Gemini は、スキル、タスク、ログインしているウェブサイトなど、Gemini がアクセスできる情報を共有することがあり、設定によっては Google アカウントのデータに合わせて調整されることがある、とも書かれています。また、Gemini をほかの接続済みアプリやサービスと一緒に使う場合、この MCP サーバーから取得したデータがそれらと共有されることがある、とも書かれています。

接続する前に、Gemini のこれらの設定を確認してください。アプリに共有したくないデータを含むチャットは送らないでください。

## 接続を止める

接続は、1 人だけ、または全員について止められます。Studio で止めると Studio 側でリクエストが拒否され、Gemini で切断すると Gemini がこの接続を使わなくなります。

- **全員を止める（Studio）。** エンドポイントの **有効 / 無効** のスイッチをオフにします。オンに戻すまで、Gemini からのリクエストは拒否されます。
- **1 人を止める（Studio）。** その人をアカウントから外すか、関係する作業フォルダへのアクセス権を外します。
- **切断する（Gemini）。** 本人がアプリのページを開き、**Disconnect** を選択します。アプリを削除するには、**...** メニューを開いて **Delete** を選択します。


Gemini のセッションが切れたりアクセスが取り消されたりした場合は、次にアプリを使うときに Gemini が Studio の同意をもう一度求めます。認可が何度も失敗する場合は、アプリを切断し、現在の接続 URL で接続し直してください。

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

| 症状  | 原因と対処  |
|  --- | --- |
| 同意画面に *「要求された MCP リソースに対応する OAuth エンドポイントを持つ、利用可能なアカウントがありません。」* と表示される | URL が OAuth エンドポイントの接続 URL ではないか、利用できるアカウントがこのエンドポイントに対応していません。接続方式が **OAuth（接続した利用者本人）** のエンドポイントを作成または選択し、その接続 URL を Gemini に貼り付けてください。それ以外の場合は、アカウント管理者に確認してください |
| 設定メニューに **Connected apps** が表示されない | **Personal Intelligence → Connected apps**、または **Customise → Connectors** を確認してください |
| **+ Custom** が表示されない | この項目は、Google アカウントの種類、提供状況、管理者のポリシーによって異なります。Google の管理者に確認してください |
| 同意画面に想定外のアカウントやリソースが表示される | **拒否**を選択し、Google アカウントと接続 URL を確認してから、もう一度接続してください |
| `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)、[Databricks Genie One](/products/headless/databricks-genie-one)。