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

# プラグイン、MCP、Skills：管理、インポート、デバイスからの同期

> Settings › Integrations › Plugins でプラグイン、MCP サーバー、Skills をまとめて管理します。Cloud shared と Device only、MCP JSON のインポート、MCP サーバーの手動追加、デバイスからの同期について説明します。

**プラグイン**、**MCP**、**Skills** は Agent ができることを拡張します。プラグインにはコマンドや hooks を含めることができます。MCP サーバーは Agent を外部ツールに接続します。Skill は Agent 向けに書かれた一連の指示です。3 つとも **Settings › Integrations › Plugins** で管理し、クラウドのセッションは開始時に有効な項目を読み込みます。

サードパーティのアカウントへのサインインが必要なサービス（GitHub、Gmail、Notion など）はここでは管理しません。これらは [コネクタ](https://docs.aihubmix.com/jp/cloud/integrations/connectors.md) で認可します。

## 利用できる環境

| プラットフォーム | 対応状況 | 備考 |
| - | - | - |
| デスクトップアプリ | 対応 | **This device** をスキャンしてワークスペースに同期できます |
| Web アプリ / モバイル Web | 対応 | 各デバイスのインベントリを確認できますが、スキャンと同期はそのデバイスのアプリで行う必要があります |

## 場所

* **Settings › Integrations › Plugins**。
* **Settings › Machines** のマシン詳細にあるプラグインの入口からは、そのデバイスが選択された状態で同じページが開きます。

## 主な概念

| 概念 | 説明 |
| - | - |
| Cloud shared | ワークスペースにアップロードされた項目です。有効にすると、このワークスペースのすべてのクラウドのセッションで使用できます |
| Device only | 1 台のデバイスにインストールされ、ワークスペースにアップロードされていない項目です。そのデバイスで実行されるセッションでのみ使用できます |
| Location | ツールバー左側のドロップダウンです。**Cloud shared** のインベントリとデバイスのインベントリを切り替えます。クラウドサーバーもデバイスとして一覧に表示されます |

プラグインライブラリはワークスペースごとに分かれています。クラウドのスイッチと各デバイスのスイッチは独立しています。デバイスで項目をオフにしても、Cloud shared にある同名の項目には影響せず、その逆も同様です。

## 一覧

ページのツールバーには、**Location**、検索、**Add**、**Sync from device** があります。その下に、**All**、**Plugins**、**Skills**、**MCP** のタブごとに項目が一覧表示されます。各項目には、名前、スコープ（**Cloud shared** または **Device only**）、バージョン、ソース、有効化スイッチが表示されます。hooks を含むプラグインには **Includes hooks** と表示されます。

* スイッチは、その後に開始するセッションにのみ影響します。クラウドのセッションは次のターンで新しい設定を読み込みます。
* デバイスのスイッチは、そのデバイスのアプリでのみ変更できます。それ以外の場所では読み取り専用です。

## 詳細

名前をクリックすると詳細が開き、説明、利用できる場所、ソースを確認できます。

* Cloud shared の項目では、**Stop sharing** をクリックします。新しいクラウドのセッションはその項目を読み込まなくなり、デバイス上のインストールとローカルのスイッチはそのまま残ります。MCP の項目には **Edit configuration** もあります。
* デバイスの項目では、**Sync to workspace** をクリックすると、この項目が選択された状態で **Sync from device** が開きます。

## 追加とインポート

ツールバーの **Add** をクリックすると、**Add to library** が開きます。現在対応しているのは、**Cloud shared への MCP サーバーの追加**のみです（JSON のインポートまたは手動設定）。プラグインと Skills のファイルインポート、およびデバイスへの追加は近日対応予定です。

### MCP JSON をインポートする

1. **Add to library** で **MCP** を選択し、追加先を Cloud shared にします。
2. JSON ファイルを選択またはドラッグします（`mcpServers` 形式と、単一サーバーの `url` / `command` 設定に対応しています）。
3. プレビューで、サーバーの名前と URL または起動コマンドを確認します。
4. **Import N items** をクリックします。インポートした項目はデフォルトで無効です。必要に応じて一覧から有効にします。

| 制限 | 値 |
| - | - |
| 単一ファイル | 最大 10 MB |
| 1 回に選択できるファイル数 | 最大 20 ファイル |
| 1 回のインポートのサーバー数 | 最大 64 サーバー |
| 名前 | 英字、数字、ピリオド、ハイフン、アンダースコアのみ、最大 64 文字。同名の既存項目は上書きされません |
| シークレット | 設定にプレーンテキストのシークレットを含めることはできません。先にシークレットを **Secrets & variables** に保存し、設定内の値を `${VARIABLE_NAME}` に変更してください |
| ローカルの設定 | ローカル環境（デバイス上のパス、localhost など）に依存する設定は Cloud shared にインポートできません |

インポートに失敗した場合は、ダイアログに理由（無効な JSON や不完全な URL など）が表示されます。説明に従ってファイルを修正し、再度インポートします。

## MCP サーバーを追加または編集する

**Add to library** で **MCP** を選択し、左下の **Configure MCP manually** をクリックします。既存のサーバーを編集するには、Cloud shared で MCP の詳細を開き、**Edit configuration** をクリックします。編集時は、左下の **Delete** でサーバーを削除します。

まず **Name** を入力し（編集時は変更できません）、次に **Type** を選択します。

| 種類 | 入力する内容 |
| - | - |
| STDIO（プロジェクトのクラウド環境で起動するプロセス） | **Start command**（例：`npx`）、**Arguments**（1 行に 1 つ）、**Environment variables** |
| Streamable HTTP（リモートサーバーに直接接続） | **URL**（http\:// または https\:// で始まる）。任意で **Bearer token variable** と **Headers** |

環境変数、トークン、ヘッダーの値にはプレーンテキストを指定できません。指定できるのは **Secrets & variables** の変数名のみで、入力欄にはワークスペースに既に存在するシークレット名が候補として表示されます。手動で追加した MCP サーバーはデフォルトで有効です。

## デバイスから同期する

デバイスに既にインストールされているプラグイン、Skills、MCP サーバーをワークスペースにアップロードし、クラウドのセッションでも使用できるようにします。**スキャンとアップロードは、そのデバイスのデスクトップアプリでのみ行えます。**

1. デスクトップアプリで、ツールバーの **Sync from device** をクリックします。
2. **Source device** のデフォルトはこのデバイスです。**Scan device** をクリックします。
3. スキャンが終わったら、同期する項目を選択します（デフォルトではどれも選択されておらず、選択しなかった項目はこのデバイスにのみ残ります）。
4. 必要に応じてバージョンの競合、hooks、シークレットに対応します（下記を参照）。
5. **Sync selected** をクリックします。完了すると、クラウドのセッションは次のターンで項目を読み込みます。デバイス上のインストールとスイッチは変更されません。

一部の項目の同期に失敗した場合は、結果に項目ごとの理由が表示されます。**Retry incomplete** をクリックすると、失敗した項目のみ再試行します。

### 選択できない項目

| ラベル | 対処 |
| - | - |
| Already shared | クラウドに同じバージョンが既にあります。同期は不要です |
| Uses a local path | リモートからアクセスできる設定に変更してから同期します |
| Secret reference required | **Use secret reference** をクリックし、ワークスペースのシークレットを選択します（利用できるシークレットがない場合は **Add workspace secret** をクリック）。次に、このデバイス上で設定内のプレーンテキストを変数の参照に変更してから同期します。プレーンテキストのシークレットはアップロードされません |

### バージョンの競合と hooks

* 選択した項目について、クラウドに既に別のバージョンがある場合は、**Keep cloud version**（デフォルト。この項目はアップロードされません）または **Use device version**（クラウドの古いバージョンを置き換えます）のいずれかを選択します。
* 選択したプラグインに hooks（ツール呼び出しの前後にコマンドを自動実行できます）が含まれる場合、同期するには **Allow selected plugin hooks to run in cloud tasks** にチェックを入れる必要があります。

## 注意事項と制限

* 初回リリースで提供するのは、個人のワークスペース単位のプラグインライブラリのみです。プラグインマーケットはありません。
* 現在直接追加できるのは Cloud shared の MCP サーバーのみです。プラグインと Skills は **Sync from device** でアップロードできます。
* MCP の設定にプレーンテキストのシークレットを含めることはできません。参照できるのは **Secrets & variables** の変数のみです。

## よくある質問

### "Cloud shared" と "Device only" の違いは何ですか？

Cloud shared の項目はワークスペースにアップロードされ、すべてのクラウドのセッションで使用できます。Device only の項目はそのデバイスに残り、そのデバイスで実行されるセッションでのみ使用できます。

### インポートした項目が反映されないのはなぜですか？

インポートした MCP サーバーはデフォルトで無効です。一覧でスイッチをオンにしてください。クラウドのスイッチはセッションの次のターンで読み込まれます。

### MCP サーバーをクラウドに同期できないのはなぜですか？

デバイス上のローカルパス（または localhost）に依存しているか、設定にプレーンテキストのシークレットが含まれています。前者の場合は、リモートからアクセスできる設定に変更します。後者の場合は、**Use secret reference** を使い、デバイス上で設定を変数の参照に変更してから同期します。

### Web からデバイスをスキャンできないのはなぜですか？

スキャンはデバイス自体のファイルを読み取るため、そのデバイスのデスクトップアプリでのみ行えます。

## 関連ページ

* [コネクタ](https://docs.aihubmix.com/jp/cloud/integrations/connectors.md)
* [ワークスペース設定](https://docs.aihubmix.com/jp/cloud/settings/workspace.md)
* [クラウドサーバーの概要](https://docs.aihubmix.com/jp/cloud/cloud-host/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.