利用できる環境
場所
- Settings › Integrations › Plugins。
- Settings › Machines のマシン詳細にあるプラグインの入口からは、そのデバイスが選択された状態で同じページが開きます。
主な概念
プラグインライブラリはワークスペースごとに分かれています。クラウドのスイッチと各デバイスのスイッチは独立しています。デバイスで項目をオフにしても、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 をインポートする
- Add to library で MCP を選択し、追加先を Cloud shared にします。
- JSON ファイルを選択またはドラッグします(
mcpServers形式と、単一サーバーのurl/command設定に対応しています)。 - プレビューで、サーバーの名前と URL または起動コマンドを確認します。
- Import N items をクリックします。インポートした項目はデフォルトで無効です。必要に応じて一覧から有効にします。
インポートに失敗した場合は、ダイアログに理由(無効な JSON や不完全な URL など)が表示されます。説明に従ってファイルを修正し、再度インポートします。
MCP サーバーを追加または編集する
Add to library で MCP を選択し、左下の Configure MCP manually をクリックします。既存のサーバーを編集するには、Cloud shared で MCP の詳細を開き、Edit configuration をクリックします。編集時は、左下の Delete でサーバーを削除します。 まず Name を入力し(編集時は変更できません)、次に Type を選択します。
環境変数、トークン、ヘッダーの値にはプレーンテキストを指定できません。指定できるのは Secrets & variables の変数名のみで、入力欄にはワークスペースに既に存在するシークレット名が候補として表示されます。手動で追加した MCP サーバーはデフォルトで有効です。
デバイスから同期する
デバイスに既にインストールされているプラグイン、Skills、MCP サーバーをワークスペースにアップロードし、クラウドのセッションでも使用できるようにします。スキャンとアップロードは、そのデバイスのデスクトップアプリでのみ行えます。- デスクトップアプリで、ツールバーの Sync from device をクリックします。
- Source device のデフォルトはこのデバイスです。Scan device をクリックします。
- スキャンが終わったら、同期する項目を選択します(デフォルトではどれも選択されておらず、選択しなかった項目はこのデバイスにのみ残ります)。
- 必要に応じてバージョンの競合、hooks、シークレットに対応します(下記を参照)。
- Sync selected をクリックします。完了すると、クラウドのセッションは次のターンで項目を読み込みます。デバイス上のインストールとスイッチは変更されません。
選択できない項目
バージョンの競合と 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 の変数のみです。