# Claude を Treasure AI Studio に接続する

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

## 接続の設定の流れ

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

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


OAuth エンドポイントを作成できるのはアカウント管理者だけです。それ以外のメンバーは、管理者がすでに作成したエンドポイントに接続します。接続する各利用者は、同じアカウントの Treasure AI Studio アカウントを持ち、使いたい作業フォルダにアクセスできる必要があります。Claude では、**Customize → Connectors** に **Add custom connector** が表示されるアカウントが必要です。表示されない場合は、Claude のプランと、Claude での組織の設定を確認してください。

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

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

1. Claude で左下のアカウントメニューを開き、**Settings** を選択します。
2. **Customize**、**Connectors**、**Yours** の順に選択します。
3. **+ Add** を選択し、**Add custom connector** を選択します。


1. *Treasure AI CDP* のような名前を入力し、手順 1 でコピーした接続 URL を貼り付けます。**Continue** を選択します。


1. Claude が検出した設定のままにします。**Authentication** は **Sign in now**、**OAuth client** は **Register automatically** です。**Request headers** は空のままにし、トークンは追加しないでください。**Add** を選択します。


1. コネクタのページに、まだ接続されていないことが表示されます。**Connect** を選択します。ブラウザが Treasure AI Studio を開きます。


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


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

1. **Customize → Connectors → Yours** を確認します。コネクタが、種類 **Web**、**Custom** のラベル、**Status** 列のチェックマーク付きで表示されます。


## 手順 3: ツールの権限を確認する

**Customize → Connectors → Yours** からコネクタを開きます。**Tool permissions** には、Studio の 6 つのツールが 2 つのグループに分かれて表示されます。**Read-only tools** が 3 つ、**Write/delete tools** が 3 つです。どちらのグループも **Needs approval** に設定されているため、Claude はツールを使う前に確認を求めます。この画面には、**Auto** モードでは自動チェックによって、**Needs approval** のツールでも Claude が確認なしで使う場合があると説明されています。リクエストを 1 件ずつ自分で承認したい場合は、**Manual** モードを使ってください。

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

1. 新しいチャットを開始します。プロンプトの横の **+** を選択し、**Connectors** を選択して、コネクタのトグルがオンになっていることを確認します。


1. *Use Treasure AI CDP to list the Studio work folders I can access. Do not run Actions or change anything.* のような、Studio が必要な依頼を送ります。
2. Claude がツールの使用を求めてきたら、ツール名と説明を確認し、**Decline**、**Always allow**、**Allow once** のいずれかを選びます。**Always allow** を選ぶ前に、Studio でそのアクションが何をするかを確認してください。


Claude がツールを使わずに答えた場合は、そのチャットでコネクタがオンになっているかを確認し、Studio が必要な具体的な依頼を送ってください。コネクタでできることを一般的に説明するだけの回答では、Claude が Studio に到達したことは確認できません。

## Studio で実行される内容

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

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

## 接続を止める

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

- **全員を止める（Studio）。** エンドポイントの **有効 / 無効** のスイッチをオフにします。オンに戻すまで、Claude からのリクエストは拒否されます。
- **1 人を止める（Studio）。** その人をアカウントから外すか、関係する作業フォルダへのアクセス権を外します。
- **切断する（Claude）。** 本人が **Customize → Connectors → Yours** でコネクタを開き、**Disconnect** を選択します。


Claude から再度ログインを求められたら、目的のアカウントとエンドポイントで Studio の同意を完了してください。認可が何度も失敗する場合は、コネクタを切断してから **Connect** を選択し、もう一度認可します。

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

| 症状  | 原因と対処  |
|  --- | --- |
| 同意画面に *「要求された MCP リソースに対応する OAuth エンドポイントを持つ、利用可能なアカウントがありません。」* と表示される | URL が OAuth エンドポイントの接続 URL ではないか、利用できるアカウントがこのエンドポイントに対応していません。接続方式が **OAuth（接続した利用者本人）** のエンドポイントを作成または選択し、その接続 URL を Claude に貼り付けてください。それ以外の場合は、アカウント管理者に確認してください |
| コネクタを追加したが、まだ接続されていないと表示される | コネクタの追加と認可は別の手順です。コネクタを開いて **Connect** を選択し、Studio の同意を完了してください |
| **Needs approval** のツールが確認なしで実行される | Claude が **Auto** モードになっています。リクエストを 1 件ずつ承認するには **Manual** モードに切り替えてください |
| 同意画面に想定外のアカウントやリソースが表示される | **拒否**を選択し、アカウントと接続 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)、[Gemini](/products/headless/gemini)、[Databricks Genie One](/products/headless/databricks-genie-one)。