メインコンテンツへスキップ
プラグイン、MCP、Skills は Agent ができることを拡張します。プラグインにはコマンドや hooks を含めることができます。MCP サーバーは Agent を外部ツールに接続します。Skill は Agent 向けに書かれた一連の指示です。3 つとも Settings › Integrations › Plugins で管理し、クラウドのセッションは開始時に有効な項目を読み込みます。 サードパーティのアカウントへのサインインが必要なサービス(GitHub、Gmail、Notion など)はここでは管理しません。これらは コネクタ で認可します。

利用できる環境

場所

  • 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 をインポートする

  1. Add to library で MCP を選択し、追加先を Cloud shared にします。
  2. JSON ファイルを選択またはドラッグします(mcpServers 形式と、単一サーバーの url / command 設定に対応しています)。
  3. プレビューで、サーバーの名前と URL または起動コマンドを確認します。
  4. 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 サーバーをワークスペースにアップロードし、クラウドのセッションでも使用できるようにします。スキャンとアップロードは、そのデバイスのデスクトップアプリでのみ行えます。
  1. デスクトップアプリで、ツールバーの Sync from device をクリックします。
  2. Source device のデフォルトはこのデバイスです。Scan device をクリックします。
  3. スキャンが終わったら、同期する項目を選択します(デフォルトではどれも選択されておらず、選択しなかった項目はこのデバイスにのみ残ります)。
  4. 必要に応じてバージョンの競合、hooks、シークレットに対応します(下記を参照)。
  5. Sync selected をクリックします。完了すると、クラウドのセッションは次のターンで項目を読み込みます。デバイス上のインストールとスイッチは変更されません。
一部の項目の同期に失敗した場合は、結果に項目ごとの理由が表示されます。Retry incomplete をクリックすると、失敗した項目のみ再試行します。

選択できない項目

バージョンの競合と 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 からデバイスをスキャンできないのはなぜですか?

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

関連ページ