# プラグインマーケットプレイス

プラグインマーケットプレイスを使用すると、新しいスキルで Treasure AI Studio を拡張できます。マーケットプレイスでは、次のことができます。

- **任意の公開スキルマーケットプレイスをインストールする** — GitHub でホストされる公開プラグインカタログを登録します。
- **プラグインを個別に有効化/無効化する** — 各プラグインを自分用にオン/オフできます。
- **デフォルトを維持または解除する** — Treasure AI のプラグインは初期状態で有効になっており、任意のプラグインを無効化できます。
- **マーケットプレイスを追加できるユーザーを制限する** — 管理者は、マーケットプレイスの登録を管理者のみに制限できます。


**マーケットプレイス**はプラグインのカタログであり、**プラグイン**は 1 つ以上のスキルをまとめたものです。プラグインを有効化すると、ローカルでのセットアップなしに AI に新しいドメインの専門知識が追加されます。

プラグインとスキルの違い
**プラグイン**はインストールして切り替える単位であり、**スキル**は AI がタスクに適用する個々の指示パッケージです。1 つのプラグインで複数のスキルを提供できます。たとえば、プリインストールされた **tdx-skills** プラグインは、`segment`、`journey`、`trino` などの Treasure AI スキルを提供します。スキルとは何か、AI がそれをどのように適用するかについては、[スキルとマーケットプレイス](/ja/products/ai-studio/skills/skills) および [サポートされているスキルカタログ](/ja/products/ai-studio/skills/skills-catalog) を参照してください。

## 目的

プラグインマーケットプレイスとは何か、マーケットプレイスの登録方法、プラグインのインストールと有効化の方法、そしてアカウント管理者が組織のマーケットプレイスアクセスをどのように管理するかを理解します。

## 前提条件

- Treasure AI Studio にサインインしている（[はじめに](/ja/products/ai-studio/getting-started)）
- スキルの仕組みを理解している（[スキルとマーケットプレイス](/ja/products/ai-studio/skills/skills)）
- カスタムマーケットプレイスを登録するための公開 GitHub リポジトリ URL（任意）
- 組織全体のマーケットプレイスとポリシーを管理するためのアカウント管理者権限（任意）


## マーケットプレイスの仕組み

マーケットプレイスは、ルートに `.claude-plugin/marketplace.json` カタログファイルを含む GitHub 上の公開 Git リポジトリです。このファイルにはマーケットプレイス名と提供するプラグインが宣言されています。マーケットプレイスを登録すると、Studio がカタログを読み取り、インストールできるようにプラグインを一覧表示します。

プラグインは `plugin-name@marketplace-name` の形式で参照されます（例: `tdx-skills@td-skills`）。プラグインをインストールまたは有効化すると、そのスキルがチャットセッションで利用可能になり、無効化すると削除されます。これらはお使いのマシン上で実行されるものではありません。有効化されたプラグインは AI セッションの開始時に解決され、そのスキルが AI のコンテキストに読み込まれます。

変更は新しいセッションに適用されます
プラグインの有効化または無効化は、次にチャットを開始したときに反映されます。プラグインの選択はセッション開始時に解決されるため、すでに開いている会話には影響しません。

マーケットプレイスの更新
マーケットプレイスのプラグインは、マーケットプレイスを最初に登録した時点で取得されます。現在のリリースでは、その後 GitHub リポジトリ側で公開された更新は自動的には同期されず、最初に取得したバージョンが引き続き使用されます。アプリ内に更新（再取得）操作はありません。

GitHub へのネットワークアクセスが必要です
マーケットプレイスとそのプラグインは GitHub から取得されるため、Studio が `github.com` に接続できる必要があります。組織でネットワークポリシーにより外部への通信を制限している場合は、（まだ許可されていなければ）`github.com` を許可リストに追加してください。指定するホストは `github.com` そのものであり、`*.github.com` のような **ワイルドカードではありません**。許可されていないと、マーケットプレイスの登録やプラグインの読み込みが失敗します。

## 場所

マーケットプレイスは、Web と Desktop の **[設定] → [マーケットプレイス]** にあります。

- **マーケットプレイス** — 自分用のビューで、マーケットプレイスを登録し、プラグインの設定を管理します。
- **マーケットプレイス（管理者）** — アカウント管理者のみに表示され、組織全体のマーケットプレイスとデフォルトプラグインを管理します。


[マーケットプレイス] タブが選択された設定パネル。anthropic-agent-skills と td-skills のマーケットプレイスが展開され、プラグインごとのコントロールが表示されている
Mobile
マーケットプレイスの管理インターフェースは Web と Desktop でのみ利用できます。Web または Desktop で有効化したプラグインは、Mobile を含むすべてのプラットフォームのセッションに適用されます。

## マーケットプレイスの種類

マーケットプレイスは提供元ごとにグループ化され、それぞれにバッジが付きます。

| バッジ | 種類 | 管理者 |
|  --- | --- | --- |
| **プリインストール** | Studio に同梱されるシステムマーケットプレイス | Treasure AI が管理 — 削除できません |
| **管理者** | 組織全体に登録されたマーケットプレイス | アカウント管理者が追加・管理 |
| **マイ** | 自分で登録したマーケットプレイス | 自分で管理 — 自由に登録・削除できます |


### プリインストール済みマーケットプレイス

すべてのアカウントには **td-skills** マーケットプレイスがプリインストールされており、**tdx-skills** プラグインがデフォルトで有効になっています。これにより、SQL、CDP、ワークフロー、AI エージェント、CLI 操作向けのコアとなる Treasure AI スキルが提供されます。

無料アカウントには、さらに **td-plg-skills** マーケットプレイスと、デフォルトで有効になっている **treasure-ai-experience** プラグインが付属します。

プリインストール済みマーケットプレイスはシステムによって管理されており、削除できません。

## マーケットプレイスの登録

アカウントポリシーがユーザーによるマーケットプレイスの登録を許可している場合、自分の GitHub ホスト型カタログを追加できます。

1. **[設定] → [マーケットプレイス]** を開きます。
2. **[マーケットプレイスを登録]** をクリックします。
3. ダイアログで、マーケットプレイスの GitHub リポジトリ URL を入力します。
4. **[登録]** をクリックします。


GitHub リポジトリ URL のフィールドと [キャンセル]・[登録] ボタンを備えた [マーケットプレイスを登録] ダイアログ
Studio はリポジトリの `.claude-plugin/marketplace.json` を取得し、そこからマーケットプレイス名を読み取り、**マイ** バッジの下のリストにマーケットプレイスを追加します。その後、プラグインがインストール可能な状態で表示されます。

要件
- URL は `.git` で終わる**公開** GitHub HTTPS リポジトリである必要があります（例: `https://github.com/owner/repo.git`）。
- リポジトリのルートに有効な `.claude-plugin/marketplace.json` が含まれている必要があります。ファイルが存在しない、リポジトリが非公開である、または JSON が不正な場合、登録は失敗します。
- マーケットプレイス名とプラグイン名は、小文字、数字、ハイフンのみである必要があります。
- 同じマーケットプレイス URL を 2 回登録することはできません。


自分で登録したマーケットプレイスを削除すると、そのすべてのプラグインもリストから削除されます。

信頼できるマーケットプレイスのみを登録してください
マーケットプレイスのプラグインはスキル（AI の振る舞いを形作る指示）を提供します。公開マーケットプレイスを登録することは、サードパーティの指示をセッション内で実行することを意味し、間接的なプロンプトインジェクションや悪意のある指示による影響のリスクを伴います。信頼でき、内容を確認済みのソースのマーケットプレイスのみを登録してください。

## プラグインのインストールと管理

マーケットプレイスグループを展開すると、そのプラグインが表示されます。各プラグインには、名前、説明、スキル数（カタログに含まれる場合）が表示されます。プラグインの制御方法は、プラグインが属するマーケットプレイスによって異なります。

### 自分のマーケットプレイスのプラグイン

自分で登録したマーケットプレイス（**マイ** グループ）のプラグインには、シンプルなオン/オフトグルがあります。

- **オン** — プラグインのスキルがセッションで利用可能になります。
- **オフ** — プラグインはリストに残りますが、スキルは読み込まれません。


マイ バッジが付いたユーザー登録のマーケットプレイス。プラグインがシンプルなオン/オフのトグルスイッチで表示されている
### プリインストール済みおよび管理者マーケットプレイスのプラグイン

**プリインストール** および **管理者** マーケットプレイスのプラグインでは、組織のデフォルトに従うか上書きするかを選べる 3 状態のコントロールが使用されます。

| 状態 | 意味 |
|  --- | --- |
| **デフォルト** | このプラグインについて管理者の設定に従います。管理者がデフォルトで有効化している場合は、有効のままになります。 |
| **オン** | デフォルトに関係なく、自分用にプラグインを明示的に有効化します。 |
| **オフ** | デフォルトで有効になっている場合でも、自分用にプラグインを明示的に無効化します。 |


プラグインを **デフォルト** に戻すと、自分の上書き設定が削除され、管理者の設定が復元されます。

プリインストール済みマーケットプレイスのプラグインで、デフォルト / オン / オフの 3 状態コントロールが展開されている
## 管理者向けコントロール

アカウント管理者は、設定の管理者向け **[マーケットプレイス]** タブから、組織全体のマーケットプレイスとプラグインを管理します。

### 組織全体のマーケットプレイスとデフォルトプラグインの登録

管理者は次のことができます。

- **アカウント全体にマーケットプレイスを登録する** — すべてのユーザーに **管理者** バッジの下で表示されます。
- **デフォルトプラグインを有効化する** — すべてのユーザーに対してプラグインをデフォルトで有効にします。ユーザーには **デフォルト** として表示され、自分用に上書きできます（アカウントポリシーで制限されていない場合）。


組織の [マーケットプレイス] タブで、マーケットプレイスが展開され、プラグインごとの有効化/無効化トグルが表示されている
### マーケットプレイスを追加できるユーザーの管理

アカウントレベルの **プラグインポリシー** は、ユーザーが自分のマーケットプレイスを登録できるかどうかを制御します。

| ポリシー | 効果 |
|  --- | --- |
| **ユーザーによるマーケットプレイス登録を許可**（open） | ユーザーは自分の GitHub ホスト型マーケットプレイスを登録し、自分のプラグイン設定を管理できます。これがデフォルトです。 |
| **管理者のみ**（admin_only） | 管理者が登録したマーケットプレイスのみが利用可能になります。ユーザーはマーケットプレイスを登録したりプラグイン設定を変更したりできず、個人用の **[マーケットプレイス]** タブは非表示になります。 |


これは、管理者向け [マーケットプレイス] タブの **[ユーザーによるマーケットプレイス登録を許可]** スイッチで切り替えます。

[ユーザーによるマーケットプレイス登録を許可] トグルと [マーケットプレイスを登録] ボタンを備えたマーケットプレイス管理パネル
ガバナンスのための制御
**管理者のみ** はセキュリティとガバナンスのための制御でもあります。ユーザーが未検証のサードパーティスキルを環境に持ち込むことを防ぎます。厳格なセキュリティまたはコンプライアンス要件のある組織では、ポリシーを **管理者のみ** に設定し、管理者が確認したマーケットプレイスのみを利用可能にすることを検討してください。

プラグインの解決方法
セッションが開始されると、Studio は自分に適用されるマーケットプレイスと有効なプラグインを組み合わせます。**open** ポリシーでは、これは管理者が定義したプラグインと自分が有効化したプラグインの和集合から、明示的に **オフ** にしたものを除いたものになります。**管理者のみ** では、管理者が定義したプラグインのみが適用されます。

## 確認

このガイドを読むことで、次のことができるようになります。

- [ ] マーケットプレイス、プラグイン、スキルの違いを説明できる
- [ ] Web または Desktop の設定で [マーケットプレイス] タブを見つけられる
- [ ] 公開 GitHub ホスト型マーケットプレイスを登録できる（ポリシーで許可されている場合）
- [ ] プラグインを有効化/無効化し、管理者が管理するプラグインで デフォルト/オン/オフ の状態を使用できる
- [ ] 管理者として、組織全体のマーケットプレイスを登録し、ユーザー登録ポリシーを設定できる


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

| 問題 | 解決策 |
|  --- | --- |
| 登録がカタログエラーで失敗する | リポジトリが公開されていること、URL が `.git` で終わっていること、リポジトリのルートに有効な `.claude-plugin/marketplace.json` が存在することを確認してください。 |
| ネットワークポリシー環境下で登録やプラグインの読み込みが失敗する | Studio はマーケットプレイスとプラグインを GitHub から取得します。組織のネットワークポリシーで、正確なホスト `github.com`（`*.github.com` のようなワイルドカードではない）への外部アクセスが許可されていることを確認してください。 |
| **[マーケットプレイスを登録]** ボタンがない | アカウントポリシーが **管理者のみ** に設定されています。管理者にマーケットプレイスの登録を依頼するか、ユーザーによるマーケットプレイス登録を許可してもらってください。 |
| 新しいプラグインのスキルが利用できない | 新しいチャットを開始してください。プラグインはセッション開始時に解決されるため、既存の会話には影響しません。 |
| プラグインを無効化しても元に戻ってしまう | そのプラグインはアカウントレベルでデフォルトで有効になっています。管理者の設定を上書きするには、状態を（**デフォルト** ではなく）**オフ** に設定してください。 |
| [マーケットプレイス] タブが表示されない | マーケットプレイスのインターフェースは Web と Desktop のみで、Mobile では利用できません。 |


## 次のステップ

- [スキルとマーケットプレイス](/ja/products/ai-studio/skills/skills) — スキルの仕組みと AI がそれをどのように適用するかを学ぶ
- [サポートされているスキルカタログ](/ja/products/ai-studio/skills/skills-catalog) — プリインストール済みプラグインが提供するすべてのスキルのリファレンス
- [コアコンセプト](/ja/products/ai-studio/concepts) — 事前選択されたスキルのデフォルトでプロジェクトを設定する
- [セキュリティと権限](/ja/products/ai-studio/security) — Studio でのアクセス制御の仕組み