メインコンテンツにスキップ

組織のプラグインを管理する

プラグインマーケットプレイスを使用すると、TeamおよびEnterpriseプランの所有者は、厳選されたプラグインを組織内のすべてのユーザーに配布できます。マーケットプレイスを作成し、プラグインを追加して、チームメンバーが表示および使用できるプラグインを正確に制御します。配布するプラグインは、チャット(ウェブおよびClaude DesktopのChatタブ)とClaude Coworkの両方に表示されます。

TeamおよびEnterpriseプランの所有者とプライマリ所有者は、Organization settings > Pluginsで組織プラグインを管理できます。

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


Anthropic構築マーケットプレイスを使用する

Anthropicは、法務や財務など、さまざまな機能向けの組み込みプラグインマーケットプレイスを提供しています。Knowledge Workマーケットプレイスはデフォルトで組織に追加されます。

Anthropic構築マーケットプレイスを追加するには:

  1. Organization settings > Pluginsに移動します。

  2. 「Add plugins」をクリックします。

  3. 「Browse Anthropic sources」を選択します。

  4. 組織内のすべてのユーザーに表示させたいものごとに「Add」をクリックします。

Knowledge Workマーケットプレイスがチームに関連していない場合は削除するには:

  1. Organization settings > Pluginsに移動します。

  2. Knowledge Workを見つけます。

  3. 右上隅のメニューボタンをクリックします。

  4. 「Remove」を選択します。

Anthropic構築マーケットプレイスは、基盤となるリポジトリスラッグの代わりに、「Knowledge Work」などの読みやすい名前を表示します。


独自のマーケットプレイスを作成する

Anthropic構築マーケットプレイスを超えて、独自のマーケットプレイスを作成できます。作成したマーケットプレイスにプラグインを追加する方法は2つあります:

  • 手動アップロード: 管理UIを通じて個別のプラグインZIPファイルをアップロードします。迅速な反復、単発ツール、またはGitHubをプラグイン開発に使用していないチームに最適です。

  • GitHubシンク: プライベートGitHubリポジトリを接続すると、Coworkが自動的にそこからプラグインを同期します。複数の開発者がプラグインで協力している場合、またはバージョン管理された更新が必要な場合に最適です。

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

手動マーケットプレイスを設定する

  1. Organization settings > Pluginsに移動します。

  2. 「Add plugins」をクリックし、ソースとして「Upload a file」を選択します。

  3. これが初めてマーケットプレイスを設定する場合、「Upload to a new marketplace」が自動選択されます。後でプラグインをアップロードするときに「Add to an existing marketplace」を選択できます。

  4. マーケットプレイスの名前を入力します。

  5. ファイルをドラッグするか、アップロードプロンプトをクリックしてファイルを選択します。ファイルは50 MB未満の有効な.zipである必要があります。

  6. 追加したい各プラグインについて繰り返します。

  7. 「Upload」をクリックして、プラグインを新しいマーケットプレイスに追加します。

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

GitHubシンクマーケットプレイスを設定する

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

リポジトリを準備する

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

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

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

その他のリソース:

リポジトリを接続する

  1. 組織に対してCoworkとSkillsの両方が有効になっていることを確認します。

  2. Organization settings > Pluginsに移動します。

  3. 「Add plugin」をクリックし、ソースとして「GitHub」を選択します。

  4. owner/repo形式でリポジトリを入力します(例:acme-corp/claude-plugins)。

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

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

同期の仕組み

リポジトリを接続すると、初期同期が自動的に実行されます。その後、組織の所有者は Organization settings > PluginsLibraries の下)に移動し、マーケットプレイスの右上隅のメニューボタンをクリックして、「Sync automatically」をオンにすることで、マーケットプレイスごとに継続的な自動更新をオプトインできます:

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

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

重要: 同期に失敗した場合、プラグインがチームメンバーから一時的に削除される可能性があります。この場合は、失敗メッセージを確認し、リポジトリの問題を修正し、更新をプッシュして、同期を再度トリガーしてください。同期が成功したら、インストール設定が正しく設定されたままであることを確認してください。失敗中にリセットされている可能性があります。

手動アップロードと GitHub 同期の選択

シナリオ

推奨アプローチ

プラグインはバージョン管理と CI/CD で保守されている

GitHub 同期

複数の開発者がプラグインで協力している

GitHub 同期

自動更新の伝播が必要である

GitHub 同期

マーケットプレイスに 100 個以上のプラグインが必要である

GitHub 同期

迅速なプロトタイピングまたは単発ツール

手動アップロード

エンジニアリング以外のチームによって構築されたプラグイン

手動アップロード

GitHub アクセスのない環境

手動アップロード

同期されたリポジトリに追加する前にプラグインをテストする

手動アップロード


プラグイン配布を制御する

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

設定

機能

メンバーに表示される内容

デフォルトでインストール済み

すべての組織メンバーに自動的にインストールされます

プラグインはメンバーのインストール済みリストに操作なしで表示されます。メンバーは必要に応じてアンインストールできます。

インストール可能

プラグインカタログに表示されます

メンバーはプラグインを閲覧するときにそれを見ることができ、自分でインストールできます。

利用不可

カタログから完全に非表示

メンバーはプラグインを見たりインストールしたりできません。ステージングまたは非推奨プラグインに便利です。

必須

削除オプションなしで、すべての組織メンバーに自動的にインストールされます

プラグインはメンバーのインストール済みリストに操作なしで表示され、無効化またはアンインストールできません。

設定を設定する

  1. Organization settings > Plugins で、マーケットプレイスに移動します。

  2. 各プラグインのインストール設定を選択します。

  3. 変更は各メンバーの次のセッションまたはプラグイン更新時に有効になります。

メンバーが経験すること

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

メンバーは組織が管理するプラグインを編集できません。これにより、共有ツールへの競合する変更が防止されます。


グループ別にプラグインアクセスをカスタマイズする

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

グループレベルのプラグインアクセスは Enterprise プランで利用可能で、管理者以上が設定できます。

グループオーバーライドの仕組み

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

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

グループのプラグインアクセスを設定する

  1. Organization settings > Plugins でマーケットプレイスに移動します。

  2. カスタマイズするプラグインを見つけます。

  3. Custom access 列で「Add groups」をクリックします。

  4. グループを選択し、上記のインストール設定のいずれかを選択します。

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

メンバーが複数のグループに属している場合

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

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

注:これはグループ支出制限の解決方法と逆です。支出制限は予算管理として機能するため、デフォルトで最も制限的な値を適用します。プラグインアクセスは、グループがツールが必要なチームのアクセスを有効にするためのものであり、セキュリティ境界として機能するためではないため、最も許可的な値を適用します。プラグインをハードブロックする必要がある場合は、組織全体の設定を「利用不可」に設定し、アクセスが必要なグループにのみアクセスを許可してください。

グループが削除された場合

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

マーケットプレイスの再同期後、グループ設定は保持されますか?

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


プラグインの更新と削除

手動マーケットプレイス

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

プラグインを削除するには、Organization settings > Plugins のマーケットプレイスから削除します。

GitHub 同期マーケットプレイス

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

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


制限

制限

プラグイン ZIP の最大サイズ(アップロード)

50 MB

クライアント側とサーバー側の両方で適用

マーケットプレイスあたりの最大プラグイン数(手動)

100

マーケットプレイスあたり

マーケットプレイスあたりの最大プラグイン数(GitHub 同期)

500

マーケットプレイスあたり

プラグイン名の最大長

64 文字

ハイフンで区切られた小文字の単語を使用する必要があります

同期タイムアウト

30 分

同期操作あたり

GitHub リポジトリの可視性

プライベートまたは内部のみ

github.com でホストされている必要があります。パブリックリポジトリと GitHub Enterprise Server インスタンスはサポートされていません。


命名規則

プラグイン名はハイフンで区切られた小文字の単語を使用する必要があります(たとえば、deployment-toolsDeployment Tools ではなく)。次のマーケットプレイス名は予約されており、使用できません:

  • claude-code-marketplace

  • claude-code-plugins

  • claude-plugins-official

  • anthropic-marketplace

  • anthropic-plugins

  • agent-skills

  • life-sciences

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

注: プラグイン作成者はdisplayNameを設定して、プラグインのスラッグの代わりにカタログに読みやすい名前を表示させることができます。作成者が設定しない場合、プラグインはそのスラッグを表示します(例:deployment-tools)。


トラブルシューティング

アップロードが拒否されました

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

メンバーにプラグインが表示されない

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

更新されたプラグインがメンバーに反映されない

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

GitHubの同期がコンテンツエラーで失敗する

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

同期が「外部プラグインソースはまだサポートされていません」で失敗するか、プラグインが「github.comでリポジトリが見つかりません。URLを確認し、リポジトリが公開されていることを確認してください。」でスキップされます。

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

同期失敗後にプラグインが消えた

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

接続時にGitHubリポジトリが表示されない

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

こちらの回答で解決しましたか?