組織向けのClaude Coworkプラグインを管理する

プラグインマーケットプレイスを使用すると、TeamおよびEnterpriseプランの所有者は、Claude Coworkを通じて組織内のすべてのユーザーに厳選されたプラグインを配布できます。マーケットプレイスを作成し、プラグインを追加して、チームメンバーが見たり使用したりできるプラグインを正確に制御します。

要件: プラグインマーケットプレイスを使用する前に、組織に対してCoworkとSkillsの両方を有効にする必要があります。

マーケットプレイスにプラグインを追加する方法は2つあります:

両方のアプローチを並行して使用できます。たとえば、コアプラグイン用のGitHub同期マーケットプレイスと、アドホックツール用の別の手動マーケットプレイスです。

既存のプラグインと同じ名前のプラグインをアップロードすると、前のバージョンが自動的に上書きされます。最初に古いバージョンを削除する必要はありません。

GitHubシンクを使用すると、リポジトリ内のコードとしてプラグインを管理できます。変更をプッシュすると、同期をトリガーしてマーケットプレイスを更新できます。手動または自動で実行できます。

リポジトリはプライベートまたは内部である必要があります。パブリックリポジトリは組織マーケットプレイスでは許可されていません。カスタムGitHub Enterprise Serverインスタンスでホストされているリポジトリはサポートされていません。リポジトリはgithub.comでホストされている必要があります。

GitHubシンクマーケットプレイスは、Claude Code CLIよりもmarketplace.json内のsourceタイプの限定的なセットをサポートしています。接続されたリポジトリ内のプラグインフォルダへの相対パス(例:"source": "./plugins/my-plugin")は完全にサポートされています。github、url、およびgit-subdirソースタイプは、ターゲットリポジトリがパブリックの場合のみサポートされます。npmおよびpipソースタイプはサポートされていません。プラグインコードが別のプライベートリポジトリにある場合は、それらのプラグインフォルダをマーケットプレイスリポジトリにコピー(gitサブモジュール、gitサブツリー、またはCIステップが機能します)し、相対パスで参照してください。

プラグイン構造とフォーマットの詳細については、プラグインリファレンスドキュメントを参照してください。

その他のリソース:

個人用GitHubトークンが検証されてアクセスを確認してから、Coworkは同期操作にGitHub Appインストールトークンを使用します。

リポジトリが見つかりませんか? Claude GitHubアプリがそのリポジトリにインストールされていることを確認してください。

リポジトリを接続すると、初期同期が自動的に実行されます。その後、組織のオーナーは組織設定 > プラグインに移動し、マーケットプレイスの右上隅のメニューボタンをクリックして、「自動同期」をオンに切り替えることで、マーケットプレイスごとに継続的な自動更新をオプトインできます:

GitHubマーケットプレイスは、PRがそのリポジトリにマージされるたびに自動同期されます。マーケットプレイスの「更新」をクリックして、同期を手動でトリガーすることもできます。

同期中、Coworkはリポジトリの最新コミットを最後に同期されたコミットと比較します。何も変更されていない場合、同期はスキップされます。変更がある場合、Coworkはマニフェストを読み取り、各プラグインを検証し、マーケットプレイス内のすべてのプラグインをリポジトリの現在の状態に置き換えます。同期にはプラグインの数に応じて最大30分かかる場合があります。

マーケットプレイスにプラグインが含まれたら、インストール設定を使用して配布方法を制御します。各プラグインについて、4つのオプションのいずれかを設定できます:

メンバーはCoworkのプラグインを閲覧モーダルを通じて利用可能なプラグインを閲覧します。自動インストールされたプラグインはインストール済みリストに自動的に表示されます。利用可能なプラグインはセルフサービスインストール用にカタログに表示されます。

メンバーは組織が管理するプラグインを編集できないため、共有ツールへの競合する変更を防ぐことができます。

エンタープライズ管理者は、特定のグループに対してプラグインの組織全体のインストール設定をオーバーライドできます。たとえば、Engineeringグループに対してプラグインを自動インストールし、Legalグループが自分でインストールできるようにし、他のすべてのグループから非表示にすることができます。

マーケットプレイス内の各プラグインには、組織全体のインストール設定（デフォルトでインストール、インストール可能、必須、または利用不可）があります。デフォルトでは、すべてのグループがその組織全体の設定を継承します。

プラグインのグループレベルオーバーライドを設定すると、そのグループのメンバーに対して組織全体の設定が置き換わります。解決順序は、グループ設定、組織全体の設定、マーケットプレイスのデフォルトです。

手動で作成されたグループとIDプロバイダーからSCIMプロビジョニングされたグループの両方がグループピッカーに表示され、同じように機能します。

メンバーが同じプラグインに対して異なる設定を持つ2つ以上のグループに属している場合、最も許容的な設定が適用されます。最も許容的から最も制限的な順序は、必須 > デフォルトでインストール > インストール可能 > 利用不可です。

たとえば、グループAがプラグインを「利用不可」に設定し、グループBが「デフォルトでインストール」に設定している場合、両方のグループに属するメンバーはプラグインがデフォルトでインストールされた状態になります。

グループが削除された場合（たとえば、IDプロバイダーから削除された場合）、オーバーライドは管理者UIに残りますが、孤立したものとしてフラグが付けられます。削除されたグループに属する人がいないため、メンバーに影響を与えず、カスタムアクセスバッジにカウントされません。プラグインのカスタムアクセス設定から孤立したオーバーライドをクリアできます。

はい。グループレベルのオーバーライドはGitHub接続マーケットプレイスを再同期するときに保持されます。プラグイン自体がマーケットプレイスから削除された場合にのみ削除されます。

プラグインを更新するには、同じプラグイン名で新しいZIPファイルをアップロードします。新しいバージョンが既存のバージョンを自動的に上書きします。プラグイン名は一意の識別子です。legalは常にlegalを置き換えます。

プラグインを削除するには、組織設定 > プラグインのマーケットプレイスから削除します。

変更を接続されたリポジトリにプッシュしてから、組織設定 > プラグインに移動し、マーケットプレイスを見つけて「更新」をクリックして同期をトリガーします。各同期はすべてのプラグインをリポジトリの現在の状態に置き換えます。所有者がGitHub同期マーケットプレイスの「自動同期」を有効にしている場合、リポジトリへの変更をプッシュした後、これが自動的に行われることに注意してください。

プラグインを削除するには、リポジトリから削除して同期をトリガーします。

プラグイン名は小文字の単語をハイフンで区切る必要があります（例：deployment-tools、Deployment Toolsではなく）。以下のマーケットプレイス名は予約されており、使用できません：

公式Anthropicマーケットプレイスになりすましている名前もブロックされます。

一般的な原因：ファイルが50 MBを超えている、有効なZIPファイルではない、またはマーケットプレイスが100プラグインの上限に達しています。ファイルサイズと形式を確認し、容量に達している場合は未使用のプラグインを削除してください。

マーケットプレイス設定でプラグインのインストール設定を確認してください。利用不可に設定されている場合、メンバーには表示されません。また、Coworkとスキルの両方が組織で有効になっていることを確認してください。

変更は各メンバーの次のセッションまたはプラグイン更新時に反映されます。更新がまだ表示されない場合は、マーケットプレイスでプラグインバージョンを確認して、アップロードが成功したことを確認してください。

リポジトリ内の1つ以上のプラグインの形式が正しくない可能性があります。形式の問題を修正し、更新をGitHubにプッシュして、同期を再度トリガーしてください。プラグイン構造の要件については、プラグインリファレンスドキュメントを参照してください。

marketplace.json内の1つ以上のプラグインエントリが、接続されたリポジトリの外部を指すsource（github、url、またはgit-subdirソース）を使用しており、ターゲットリポジトリがプライベートです。組織の同期は現在、公開リポジトリからのみ外部ソースを取得できます。プラグインフォルダをマーケットプレイスリポジトリに移動し、各エントリのsourceを相対パスに変更してください（例："./plugins/my-plugin"）。その後、プッシュして再同期してください。または、影響を受けたプラグインをカスタマイズ > プラグインを追加 > プラグインを作成 > プラグインをアップロード経由で個別にアップロードしてください。

失敗したGitHub同期により、プラグインがマーケットプレイスから一時的に削除される可能性があります。根本的な問題を修正し、正常に再同期してから、インストール設定が正しく設定されていることを確認してください。リセットされている可能性があります。

Cowork GitHub Appがそのリポジトリにインストールされていることを確認してください。個人用GitHubトークンが最初にアクセスを確認するために確認されますが、同期自体はGitHub Appインストールトークンを使用します。