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

# プラグイン

> スキル、サブエージェント、MCP サーバー、フックのバンドルをマーケットプレイスからインストールする

プラグインは[スキル](/ja/ctor/reference/skills)、[サブエージェント](/ja/ctor/reference/sub-agents)、[MCP サーバー](/ja/ctor/reference/mcp)、[フック](/ja/ctor/reference/hooks)をバンドルし、マーケットプレイスからまとめてインストールできるようにします。CTOR のプラグインシステムは Claude Code のプラグインエコシステムと互換性があります。

## プラグインパネル

サイドバーの **Plugins**（プラグイン）をクリックしてパネルを開きます。この 1 つのボタンが、以前は分かれていた **Skills**、**Sub-Agents**、**MCP** ボタンを置き換えます。

パネルには 4 つのタブがあります：

* **プラグイン** — マーケットプレイスを閲覧し、プラグインをインストールする
* **スキル** — 以前のスキルパネルのすべての機能（[スキル](/ja/ctor/reference/skills)を参照）
* **エージェント** — 以前のサブエージェントパネルのすべての機能（[サブエージェント](/ja/ctor/reference/sub-agents)を参照）
* **MCP** — 以前の MCP パネルのすべての機能（[MCP サーバー](/ja/ctor/reference/mcp)を参照）

スキル、エージェント、MCP タブは、置き換えたパネルの管理機能をすべて保持しています。

## マーケットプレイスの追加

マーケットプレイスは、1 つ以上のプラグインを一覧する GitHub リポジトリ、またはローカルフォルダです。追加するまで、**プラグイン**タブは空の状態（マーケットプレイスがありません）を表示します。

**プラグイン**タブで、入力欄に GitHub リポジトリを入力して**追加**をクリックします。受け付ける形式：

* `owner/repo`
* `owner/repo@ref` — `ref` はブランチ、タグ、またはコミット SHA
* 任意の `github.com` URL

代わりにディスクからマーケットプレイスを追加するには、フォルダボタンをクリックしてローカルフォルダを選択します。

各マーケットプレイスは独自のセクションとして表示され、そのプラグインを一覧します。ローカルソースには**ローカル**バッジが表示され、ビルトインマーケットプレイス（後述）には**ビルトイン**バッジが表示されます。セクションには 2 つのアクションがあります：

* **更新** — 一覧を再取得し、プラグインの更新を確認する
* **削除** — マーケットプレイスを削除する。インライン確認（このマーケットプレイスを削除しますか？インストール済みプラグインは残ります。）が表示される — ビルトインマーケットプレイスにはこのアクションはない

### GitHub トークン認証

**プラグイン**タブ上部で **GitHub トークン**を設定すると、GitHub の匿名レート制限が緩和され、そのトークンで読み取れるプライベートリポジトリを追加できるようになります。保存すると、マスクされた形式（例：`••••1a2b`）で表示されます — 変更するには**編集**、削除するには**クリア**をクリックします。

追加する各 GitHub マーケットプレイスは、リポジトリの入力欄の横で認証方法を選べます：

| 認証     | 動作                                   |
| ------ | ------------------------------------ |
| **全体** | 保存済みの GitHub トークンを使用する（デフォルト）        |
| **個別** | このマーケットプレイス専用の別トークンを使用する — 追加前に設定が必要 |
| **なし** | トークンを使用しない — 公開リポジトリのみ               |

マーケットプレイスの認証モードは、そのセクションのヘッダーに\*\*認証: {mode}\*\*バッジとして表示されます。

<Warning>
  トークンは暗号化されずに、平文でローカルに保存されます。マーケットプレイスに必要なリポジトリのみにスコープを絞ったトークンを使用してください。
</Warning>

### マニフェスト形式

CTOR は次の順序でマーケットプレイスのマニフェストを読み込みます：

1. `.bricks-plugin/marketplace.json`
2. `.claude-plugin/marketplace.json`

両方が存在する場合は `.bricks-plugin` 形式が優先されます。`plugin.json` のみを含むリポジトリは、単一プラグインのマーケットプレイスとして扱われます。

### ビルトインマーケットプレイス

CTOR には 1 つのマーケットプレイスがビルトインされています — **bricks-ctor-agent-skills**（`mybigday/bricks-ctor-agent-skills`）。常に登録済みで設定は不要、起動時と 1 日 1 回自動的に更新されます。GitHub に接続できない場合は、最後にキャッシュした内容を保持します。

ここには BRICKS チームの公式 plugin が収録されており、**App Templates**（`app-templates`）もその 1 つです — 既存のアプリケーションを再利用可能なプロンプトテンプレートに変換し、デザイン、状態、データフローを捉えた短い要件リストとして、再構築やリミックスに使えます。マーケットプレイスから提供されるため、これらの plugin は app のリリースなしで更新できます。

そのセクションは強調表示のパネルとして、マーケットプレイス一覧の一番下に固定表示され、**ビルトイン**バッジが付きます（ホバーするとヒントが表示されます）。**削除**アクションはなく、名前も予約されています — `bricks-ctor-agent-skills` という名前のマーケットプレイスを他のソースから追加または置き換えようとすると、「この名前はビルトインマーケットプレイスのものです。置き換えや削除はできません。」と表示されて失敗します。

## プラグインカード

各プラグインは、名前、バージョン、説明に加えて、内容とインストール場所を要約するバッジを持つカードとして表示されます：

* **インストールスコープ** — **グローバル**、**このプロジェクト**、または **N 個のプロジェクト**
* **MCP ×N** — プラグインがバンドルする MCP サーバーの数
* **Hooks** — プラグインがフックを定義しているときに表示される。有効化するまで **Hooks（未承認）** と表示される

カードのアクション：

| アクション        | 説明                                |
| ------------ | --------------------------------- |
| **インストール**   | プラグインをインストールする（インストールダイアログを開く）    |
| **管理**       | インストール済みのスキル選択を変更する               |
| **更新**       | マーケットプレイスに新しいバージョンがあるときに利用可能      |
| **アンインストール** | 現在のスコープからプラグインを削除する（もう一度クリックして確認） |
| **すべて削除**    | すべてのスコープからプラグインを削除する              |

## プラグインのインストール

**インストール**をクリックすると、**{name} をインストール**ダイアログが開きます。ダイアログは信頼に関する注意から始まります。

<Warning>
  スキルはエージェントに指示を与え、プロジェクトのファイルを読み取れます。信頼できるリポジトリのプラグインのみインストールしてください。
</Warning>

注意の下には、インストールする項目を選べるよう、プラグインが提供するすべての内容が一覧表示されます：

* **スキル**はオプトインのチェックボックスで、**Select all** / **Select none** が使えます。対象スコープに同名のスキルが既に存在する場合、そのスキルには**上書き**バッジが表示されます。名前が組み込みスキルと衝突するスキルには**予約済みの名前**バッジが表示され、スキップされます。
* **エージェント**はスキルと並んで一覧表示されます。
* **MCP サーバー**はサーバーごとに明示的な同意が必要で、「MCP サーバーはローカルプロセスを実行します」という注意の下に表示されます。各サーバーは解決済みの正確なコマンドラインを表示し、デフォルトではチェックされていません。
* **フック**は 1 回の明示的な同意が必要で、「フックはエージェントイベント時にローカルコマンドを実行します」という注意の下に表示されます。\*\*フックを有効化（N）\*\*をクリックすると、同意する前にすべてのイベント、マッチャー、コマンドを確認できます。

CTOR がまだサポートしていないコンポーネントは\*\*未対応（無視されます）\*\*として一覧されます。これには現在スラッシュコマンドが含まれます。

インストールボタンには現在の選択数が表示されます。例：**インストール（3）**。

### インストールスコープ

**このプロジェクト | グローバル**のセグメントコントロールで対象スコープを選びます：

* **グローバル**インストールはすべてのプロジェクトとメインチャットに適用されます。スキルは `~/.bricks-project-desktop/skills/` に配置されます。
* **プロジェクト**インストールは開いているプロジェクトのみに適用されます。スキルは `.bricks/skills/` に配置されます。

プラグインがインストールしたスキルは、**スキル**タブに**プラグイン: {plugin}** バッジ付きで表示されます。プラグインがインストールしたエージェントは**エージェント**タブに表示されます（バッジは付きません）。

## 更新と安全性

* プラグインの MCP サーバーはマシンローカルのレジストリに保存されます。プロジェクトの `.mcp.json` に書き込まれることは決してありません。
* MCP の承認はコマンドに紐付けられます。更新後にコマンドが変わった場合は、再承認が必要です。
* 更新は変更されていないプラグインファイルを置き換えますが、あなたが編集したスキルやエージェントを上書きすることは決してありません — 編集した版が保持されます。アンインストール時も同様です。
* 更新はインストール時に選んだスキルのみを再展開します。更新で新たに追加されたスキルをオプトインするには、再インストールが必要です。

## MCP のスコープと継承

**MCP** タブには独自の**このプロジェクト | グローバル**の切り替えがあります。

* **グローバル**はメインワークスペースの `.mcp.json` を編集し、「メインワークスペース — 全プロジェクトに継承されます」と表示されます。
* プロジェクトは自身のサーバーの下にグローバルサーバーを継承します。プロジェクトのエントリが名前で優先されるため、全体の優先順位はプラグイン \< 継承 \< プロジェクトとなります。
* 各プロジェクトには**グローバル MCP サーバーを継承**トグルがあります。
* 継承されたサーバーには**グローバル**バッジ、プラグインのサーバーには**プラグイン**バッジが表示されます。

サーバーの設定と管理の方法については、[MCP サーバー](/ja/ctor/reference/mcp)を参照してください。

## Claude Code 互換性

既存の Claude Code プラグインやマーケットプレイスは、CTOR でそのまま動作します：

* CTOR は `.claude-plugin/` マニフェストを読み込みます。
* MCP とフックのコマンド内の `${CLAUDE_PLUGIN_ROOT}`（および `${BRICKS_PLUGIN_ROOT}`）を解決します。
* 有効化されるのはスキル、エージェント、MCP サーバー、フックのみです。その他の Claude Code コンポーネントタイプは無視されます。

## エラーメッセージ

インストーラーは、マーケットプレイスやプラグインを追加できないときに明確なエラーを報告します。これには以下が含まれます：

* 無効なリポジトリ指定
* リポジトリが見つからない、またはトークンで読み取れないプライベートリポジトリ
* GitHub のレート制限
* ダウンロードまたは展開の失敗
* 欠落または無効なマニフェスト — 素のスキルリポジトリは代わりに**スキル**タブからインストールできます
* サポートされていないソースタイプ