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

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

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

TeamおよびEnterpriseプランのオーナーおよびプライマリオーナーは、組織設定 > プラグインで組織プラグインを管理できます。

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


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

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

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

  1. 組織設定 > プラグインに移動します。

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

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

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

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

  1. 組織設定 > プラグインに移動します。

  2. Knowledge Workを見つけます。

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

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

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


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

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

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

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

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

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

  1. 組織設定 > プラグインに移動します。

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

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

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

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

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

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

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

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

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

リポジトリを準備する

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

GitHubシンクマーケットプレイスは、Claude Codeよりもmarketplace.jsonsourceタイプのセットが限定されています。マーケットプレイスリポジトリ内のプラグインフォルダへの相対パス(たとえば、"source": "./plugins/my-plugin")は完全にサポートされており、最も簡単なオプションです。githuburl、およびgit-subdirソースタイプもサポートされています。npmarchive、およびcommandソースタイプはサポートされていません。

プラグインソースは2つの場合にプライベートにできます。マーケットプレイスリポジトリのオーナーを共有するgithub.comソース(組織シンクがClaude GitHub Appを通じてフェッチする)、または組織のGitHub Enterpriseホスト上のソース(そのリポジトリにインストールされた組織のGitHub Enterprise Appを使用)。その他のすべてのソースは認証情報なしでフェッチされるため、別のオーナーの下のgithub.comリポジトリと他のホスト(GitLabやBitbucketなど)のリポジトリはパブリックである必要があります。

プラグインコードが上記の基準を満たさないプライベートリポジトリに存在する場合は、それらのプラグインフォルダをマーケットプレイスリポジトリにコピーし、各プラグインのソースを相対パスに変更します(gitサブツリーまたはファイルをベンダーするCIステップが機能します)。

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

追加リソース:

リポジトリを接続する

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

  2. 組織設定 > プラグインに移動します。

  3. 「プラグインを追加」をクリックし、ソースとして「GitHub」を選択します。

  4. owner/repo 形式でリポジトリを入力してください(例:acme-corp/claude-plugins)。

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

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

同期の仕組み

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

自動同期を有効にすると、接続されたリポジトリに webhook が作成されます。トグルをオンにするユーザーは、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. 変更は各メンバーの次のセッションまたはプラグイン更新時に有効になります。

メンバーが経験すること

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

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


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

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

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

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

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

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

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

  1. 組織設定 > プラグインで、マーケットプレイスに移動します。

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

  3. カスタムアクセス列で、「グループを追加」をクリックします。

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

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

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

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

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

注:これはグループ支出制限の解決方法とは異なります。支出制限は、マルチグループ支出制限設定に応じて、より高いまたはより低いグループ値を適用します。プラグインアクセスは最も許容的な値を適用します。ここでのグループは、セキュリティ境界として機能するのではなく、ツールが必要なチームのアクセスを有効にすることを目的としているためです。プラグインをハードブロックする必要がある場合は、その組織全体の設定を「利用不可」に設定し、アクセス権を持つべきグループにのみアクセス権を付与します。

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

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

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

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


プラグインの更新と削除

手動マーケットプレイス

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

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

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

変更を接続されたリポジトリにプッシュしてから、組織設定 > プラグインに移動し、マーケットプレイスを見つけて「更新」をクリックして同期をトリガーします。各同期はすべてのプラグインをリポジトリの現在の状態に置き換えます。所有者がマーケットプレイスの「自動同期」を有効にしている場合、プラグインバージョンバンプを含むプルリクエストがリポジトリのデフォルトブランチにマージされるたびに同期も実行されます。

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


制限

制限

最大プラグイン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ソース)を使用しており、組織の同期がそれを取得できません。プライベートソースは2つの場合にのみ機能します:github.comリポジトリがマーケットプレイスリポジトリの所有者を共有している場合、または組織のGitHub EnterpriseホストのリポジトリにGitHub Enterprise Appがインストールされている場合です。

その他のプライベートソースの場合は、プラグインフォルダをマーケットプレイスリポジトリに移動し、各エントリのsourceを相対パスに変更してください(例:"./plugins/my-plugin")。その後、プッシュして再同期してください。または、組織設定 > プラグイン > プラグインを追加 > ファイルをアップロードを使用して影響を受けたプラグインを個別にアップロードし、「既存のマーケットプレイスに追加」を選択してください。メンバーの独自のカスタマイズメニューを通じてアップロードされたプラグインはそのメンバーのみにインストールされ、組織全体に配布されません。

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

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

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

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

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

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

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

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

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