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

組織向けCoworkプラグインの管理

今日アップデートされました

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

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

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

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

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

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

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


手動マーケットプレイスをセットアップする

  1. Claude Desktop を開き、Organization settings > Plugins に移動します。

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

  3. 初めてマーケットプレイスをセットアップする場合、[Upload to a new marketplace] が自動的に選択されます。

    1. 今後プラグインをアップロードする際に、[Add to an existing marketplace] を選択できるようになります。

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

  5. ファイルをドラッグするか、アップロードプロンプトをクリックしてファイルを選択します。

    1. 注: ファイルは 50 MB 以下の有効な .zip である必要があります。

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

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

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


GitHub 同期マーケットプレイスをセットアップする

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

リポジトリを準備する

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

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

その他のリソース:

リポジトリを接続する

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

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

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

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

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

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

同期の仕組み

リポジトリを接続すると、初期同期が自動的に実行されます。その後、Organization settings > Plugins のマーケットプレイスで [Check for updates] をクリックして、手動で同期をトリガーできます。

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

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


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

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

設定

機能

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

自動インストール

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

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

利用可能

プラグインカタログにリストされています

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

利用不可

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

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

設定を行う

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

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

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

メンバーの体験

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

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


プラグインを更新および削除する

手動マーケットプレイス

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

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

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

接続されたリポジトリに変更をプッシュし、Organization settings > Plugins に移動して、マーケットプレイスを見つけて [Check for updates] をクリックして同期をトリガーします。各同期はすべてのプラグインをリポジトリの現在の状態に置き換えます。

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


制限

制限

最大プラグイン 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 マーケットプレイスになりすまそうとする名前もブロックされています。


手動アップロードと GitHub 同期のどちらかを選択する

シナリオ

推奨アプローチ

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

GitHub 同期

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

GitHub 同期

自動更新の伝播が必要です

GitHub 同期

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

GitHub 同期

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

手動アップロード

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

手動アップロード

GitHub アクセスのない環境

手動アップロード

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

手動アップロード


トラブルシューティング

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

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

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

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

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

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

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

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

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

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

接続時に GitHub リポジトリが見つからない

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

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