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

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

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

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

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


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

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

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

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

  2. 「プラグインを追加」をクリックします。

  3. 「Anthropicソースを参照」を選択します。

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

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

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

  2. Knowledge Workを見つけます。

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

  4. 「削除」を選択します。

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


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

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

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

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

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

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

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

  2. 「プラグインを追加」をクリックし、ソースとして「ファイルをアップロード」を選択します。

  3. これが初めてマーケットプレイスを設定する場合、「新しいマーケットプレイスにアップロード」が自動選択されます。後でプラグインをアップロードするときに「既存のマーケットプレイスに追加」を選択できます。

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

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

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

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

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

GitHub同期マーケットプレイスを設定する

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

リポジトリを準備する

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

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. 「プラグインを追加」をクリックし、ソースとして「GitHub」を選択します。

  4. owner/repo形式でリポジトリを入力します(たとえば、acme-corp/claude-plugins)。

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

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

同期の仕組み

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

自動同期を有効にすると、接続されたリポジトリにウェブフックが作成されます。トグルをオンにするユーザーは、GitHub上のそのリポジトリに対する管理者レベルのアクセス権を持つ必要があります。これは、Claude GitHub Appのインストールとは別の個人用GitHub接続を通じて確認されます。管理者アクセス権がない場合、Appが正しくインストールされており手動更新が機能していても、ページに「Cannot access repository. Ensure the repository exists and the Claude GitHub App is installed,」と表示されます。

Claude GitHub AppのWebhooks (Read & Write)権限もインストール時に承認される必要があります。この権限が導入される前に作成されたインストールでは、GitHubがリポジトリまたは組織の管理者が承認する必要のある「Claude is requesting updated permissions」プロンプトを表示します。

有効にすると、プラグインバージョンバンプを含むプルリクエストがリポジトリのデフォルトブランチにマージされたときに自動同期が実行されます。デフォルトブランチへの直接プッシュは同期をトリガーしません。マーケットプレイスの「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」をクリックして同期をトリガーします。各同期により、すべてのプラグインがリポジトリの現在の状態に置き換わります。所有者がマーケットプレイスの「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とSkillsの両方が組織で有効になっていることを確認してください。

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

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

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

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

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

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

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

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

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

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

"自動同期"をオンにするときに"リポジトリにアクセスできません"

手動更新は機能するが、"自動同期"をオンにすると"リポジトリにアクセスできません。リポジトリが存在し、Claude GitHubアプリがインストールされていることを確認してください。"と表示される場合、考えられる原因は2つあります:

  • リポジトリへの管理者アクセス権がありません。自動同期をオンにするとウェブフックが作成されます。これには、個人用GitHub接続を通じてリポジトリへの管理者レベルのアクセスが必要です。リポジトリ管理者にトグルを有効にするよう依頼するか、GitHub アクセスをアップグレードしてもらってください。

  • Claude GitHubアプリのWebhooks権限が承認されていません。古いインストールでは、GitHubが"Claudeが更新された権限をリクエストしています"というプロンプトを表示します。リポジトリまたは組織の管理者が、インストール上のWebhooks(読み取り&書き込み)権限を承認する必要があります。

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