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

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

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

TeamおよびEnterpriseプランのオーナーおよびプライマリオーナーは、Organization settings > Plugins & skillsで組織のプラグインを管理できます。Enterpriseプランでは、組織のライブラリを管理する権限を持つカスタムロールを持つメンバーも管理できます。

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

これらのコントロールのリファレンスバージョンについては、Claude CodeドキュメントのManage plugins for your organizationを参照してください。

注: 組織のSkillsをオフにすると、スキルとプラグインのClaude Codeへの同期も停止し、既に同期されたものが削除されます。Coworkをオフにしても、Claude Codeへの同期には影響しません。スキルとプラグインをClaudeに保持しながら、同期のみを停止するには、Claude Codeの管理設定でsyncClaudeAiSkillsとsyncClaudeAiPluginsをfalseに設定します。Claude Code管理者セットアップの詳細をご覧ください。

注: マーケットプレイスは、オーナーが組織にプラグインを配布する方法です。ユーザーは、自分で作成したプラグインを特定の同僚またはグループと共有したり、組織のライブラリに公開するために提出したりすることもできます。共有と公開は、Organization settings > Plugins & skillsの「Policy」タブの設定で制御され、プラグイン提出は「Requests」タブで確認されます。Claudeでプラグインを使用する方法とユーザーがスキルとプラグインを組織に公開できるようにする方法の詳細をご覧ください。


組織内の内容を確認する

「Inventory」タブには、ユーザーが自分用に作成したものを含む、組織が管理するすべてのスキルとプラグインが一覧表示されます。スキルとプラグインは同じページに表示されるようになったため、設定を切り替える必要がなくなりました。

各項目について、テーブルはそのソース、バージョン、機能、対象ユーザー、および過去30日間に使用した人数を表示します。

項目を検索するには、名前で検索するか、フィルターを使用します:

  • ソース: 組織、Organization library、または特定のマーケットプレイス

  • 対象ユーザー: 項目を使用できるユーザー

  • タイプ: スキルまたはプラグイン

組織が管理するスキルはOrganization libraryの下に表示されます。プラグインマーケットプレイスはMarketplacesタブで管理します。

項目に対して操作を実行するには、その行の末尾にあるメニューボタンをクリックします。詳細とファイルを表示し、バージョン履歴を確認し、デフォルトおよびグループアクセスを変更できます。

ユーザーが作成したスキルとプラグインについては、Inventoryタブはメタデータと共有ステータスを表示します。ファイル自体は表示されません。

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

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

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

  1. Organization settings > Plugins & skillsに移動し、「Marketplaces」タブをクリックします。

  2. 「Add」をクリックし、「Add marketplace」を選択します。

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

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

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

  1. Organization settings > Plugins & skillsに移動し、「Marketplaces」タブをクリックします。

  2. Knowledge Workを検索します。

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

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

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


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

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

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

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

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

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

  1. 「Add」をクリックし、「Upload a plugin」を選択します。

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

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

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

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

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

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

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

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

リポジトリを準備する

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

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

プラグインソースは3つの場合にプライベートにできます:

  • Claude GitHub Appを通じて組織同期が取得するマーケットプレイスリポジトリのオーナーを共有するgithub.comソース。

  • 組織のGitHub Enterpriseホスト上のソースで、そのリポジトリにインストールされた組織のGitHub Enterprise Appを備えています。

  • マーケットプレイスリポジトリと同じGitLabホスト上のURLまたはgit-subdirソース。gitlab.comでは、ソースもマーケットプレイスリポジトリと同じトップレベルグループまたはユーザー名前空間の下にある必要があります。

その他すべてのソースは認証情報なしで取得されるため、github.com、gitlab.com、またはbitbucket.org上のパブリックリポジトリである必要があります。他のホスト上のソースは拒否されます。

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

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

その他のリソース:

リポジトリを接続

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

  2. 組織設定 > プラグインとスキルに移動し、「マーケットプレイス」タブをクリックします。

  3. 「プラグインを追加」をクリックし、「GitHubから同期」を選択します。

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

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

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

同期の仕組み

リポジトリを接続すると、初期同期が自動的に実行されます。GitHub作成フローでは、デフォルトで有効になっている「自動同期」をオフにすることもできます。有効にすると、プルリクエストがマーケットプレイスが追跡するブランチにマージされるか、誰かがそのブランチに直接プッシュするときに同期が実行されます。

自動同期をオンまたはオフにする人は、GitHub上のそのリポジトリに対する管理者レベルのアクセス権を持つ必要があります。これは、Claude GitHub Appインストールとは別の個人用GitHub接続を通じてチェックされます。管理者アクセスがない場合、Appが正しくインストールされていて手動更新が機能していても、ページに「リポジトリにアクセスできません。リポジトリが存在し、Claude GitHub Appがインストールされていることを確認してください」と表示されます。

Claude GitHub AppのWebhooks(読み取りと書き込み)権限もインストールで承認される必要があります。この権限が導入される前に作成されたインストールでは、GitHubはリポジトリまたは組織の管理者が承認する必要がある「Claudeが更新された権限をリクエストしています」プロンプトを表示します。

有効にすると、GitHubリポジトリの自動同期は、プラグインバージョンバンプを含むプルリクエストがリポジトリのデフォルトブランチにマージされるときに実行されます。デフォルトブランチへの直接プッシュは同期をトリガーしません。マーケットプレイスの「再同期」をクリックして、いつでも手動で同期をトリガーできます。

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

重要:同期が失敗した場合、メンバーは各プラグインの最後に同期されたバージョンを保持します。失敗メッセージを確認し、リポジトリを修正して、再同期してください。

GitLab同期マーケットプレイスを設定

gitlab.comまたは自己管理GitLabインスタンス上のリポジトリから組織マーケットプレイスを同期できます。サポートされているプラグインソースタイプとプライベートにできるソースについては、上記のリポジトリを準備を参照してください。

GitLabサポートはベータ版で、プラグインマーケットプレイス同期のみに適用されます。Web上のClaude Codeはまだgitlabリポジトリをサポートしていません。

開始する前に

  • ロール。GitLab設定を追加するには、オーナーまたはプライマリオーナーロールが必要です。

  • プロジェクトの可視性。gitlab.comでは、マーケットプレイスプロジェクトはプライベートまたは内部である必要があります。自己管理インスタンスでは、任意の可視性が機能します。

  • アクセストークン。Claudeがマーケットプレイスプロジェクトと同じホスト上のプラグインソースプロジェクトを読み取るためのGitLabアクセストークンを作成します。個人、グループ、プロジェクトアクセストークンはすべて機能します。トークンのユーザーは、これらのプロジェクトで少なくともレポーターロールが必要です。

    • レガシー(スコープ付き)トークン:少なくともread_apiスコープ。

    • きめ細かい個人用アクセストークン:プロジェクト:読み取り、ブランチ:読み取り、リポジトリ:読み取り権限。

    • オプション、自動Webhook設定用(ステップ3):マーケットプレイスプロジェクトのメンテナーロールとapiスコープ(レガシー)またはWebhook:作成と削除権限(きめ細かい)。これらがない場合は、手動でWebhookを1回追加します(ステップ4)。

  • 自己管理インスタンスのみ。

    • インスタンスのホスト名はパブリックIPアドレスに解決される必要があり、インスタンスはAnthropicのアウトバウンドIPアドレスからのHTTPS接続を受け入れる必要があります。

    • プライベート認証局がTLS証明書を発行した場合は、CA証明書(PEM)を準備してください。

    • 自動同期のWebhook配信はインスタンスからapi.anthropic.comに送信されるため、インスタンスはそのホストへのアウトバウンドHTTPSリクエストを実行できる必要があります。

ステップ1:GitLab設定を追加

GitLab設定を追加するには:

  1. 組織設定 > Claude Codeに移動します。

  2. 自己ホスト型インフラストラクチャの下でGitLabを見つけ、「設定を追加」をクリックします。

  3. 表示名、ホスト名(gitlab.comまたはgitlab.example.comなどのインスタンスのホスト名)、アクセストークン、およびプライベートCAを持つ自己管理インスタンスの場合はCA証明書を入力します。

  4. 「設定を追加」をクリックします。Claudeは接続テストをすぐに実行し、GitLab接続テストダイアログに結果を表示します。

  5. (オプション)トークンがマーケットプレイスプロジェクトを読み取れることを確認するには、そのパス(例:platform/claude-plugins)をプロジェクトパスの下に入力し、「同期アクセスをテスト」をクリックします。

設定のメニューから接続をテストを使用して、いつでもテストを再実行できます。ホスト名は後で変更できません。変更された場合は、設定を削除して新しい設定を追加してください。

ステップ2:マーケットプレイスを追加

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

  1. 組織設定 > プラグイン & スキルに移動して、「マーケットプレイス」タブをクリックします。

  2. 「追加」をクリックして、「GitLab から同期」を選択します。

  3. GitLab リポジトリ URL にプロジェクトの HTTPS URL を入力します。例:https://gitlab.example.com/platform/claude-plugins。ネストされたサブグループ内のプロジェクトも機能します。

  4. プッシュが同期をトリガーするようにしたい場合は、自動同期をオンのままにしておきます(ステップ 3 を参照)。

  5. マーケットプレイスに含まれるプラグインのデフォルトアクセスを選択します。

  6. 「作成」をクリックします。

Claude はプロジェクトのデフォルトブランチを読み込み、マーケットプレイスファイルを検証してからマーケットプレイスを作成します。マーケットプレイスはプロジェクトパスに基づいて名前が付けられます。

ステップ 3: 自動同期

自動同期がオンの場合、プロジェクトのデフォルトブランチへのすべてのプッシュは、GitLab プロジェクトの webhook を通じて同期をトリガーします。トークンが webhook を管理できる場合(開始する前にを参照)、Claude が webhook を作成するため、他に何もする必要はありません。

後でマーケットプレイスのメニューから自動同期をオンまたはオフにできます。オンにすると、同じ方法で webhook がセットアップされます。

ステップ 4: Claude が webhook を作成できない場合

トークンが webhook を管理できない場合、Claude は画面にGitLab で webhook セットアップを完了というメッセージを表示し、Webhook URL とトークンを表示します。トークンは 1 回だけ表示されるため、メッセージを閉じる前にこのステップを完了してください。

  1. GitLab プロジェクトで、設定 > Webhook を開き、メッセージの URL を使用して新しい webhook を追加します。

  2. トークンをフィールドに貼り付けます。

    1. メッセージにシークレットトークンが表示されている場合は、GitLab の「シークレットトークン」フィールドに貼り付けます。

    2. メッセージに署名トークンが表示されている場合(gitlab.com およびセルフマネージド版 19.1 以降)、GitLab で「署名トークンを生成」を選択し、生成された値を Claude のものに置き換えます。

  3. プッシュイベントを有効にして保存します。

  4. (オプション)GitLab の新しい webhook でテスト > プッシュイベントを使用し、HTTP 200 を返すことを確認します。

トークンを紛失した場合は、マーケットプレイスのメニューからwebhook を設定を開き、「webhook を削除」をクリックしてから「webhook を有効にする」をクリックして新しいものを取得します。古いトークンは機能しなくなります。

手動アップロードとリポジトリ同期のどちらかを選択

シナリオ

推奨アプローチ

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

GitHub または GitLab 同期

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

GitHub または GitLab 同期

自動更新の伝播が必要

GitHub または GitLab 同期

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

手動アップロード

エンジニア以外のチームが構築したプラグイン

手動アップロード

GitHub または GitLab にアクセスできない環境

手動アップロード

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

手動アップロード


プラグイン配布を制御

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

設定

機能

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

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

すべての組織メンバーに対してプラグインを事前インストール

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

インストール可能

発見タブにリスト表示

ユーザーは発見タブで表示され、自分で追加できます。

利用不可

完全に非表示

ユーザーはプラグインを表示または追加できません。ステージングまたは非推奨プラグインに便利です。

必須

すべての組織メンバーのプラグインを事前インストールし、削除オプションなしで提供

プラグインはメンバーのリストに操作なしで表示され、「このプラグインは組織により必須です。」とマークされます。ユーザーはオフにしたり削除したりできません。また、メンバーのアカウントプラグインを同期するClaude Codeセッションでも有効なままです。

重要: 「デフォルトでインストール」または「必須」に設定されたプラグインは、Claudeアカウントでサインインするユーザーに対してClaude Codeにもインストールされます。Claude Codeでは、プラグインのフック、サブエージェント、MCPサーバーはユーザーのコンピュータで実行され、「必須」プラグインはそこで無効にできません。プラグインを「必須」に設定する前に、そのフックを確認してください。Claude Codeドキュメントの同期されたプラグインについて詳しく学んでください。

設定を変更

  1. 組織設定 > プラグイン & スキルで「インベントリ」タブをクリックします。

  2. プラグインを見つけて、その行の末尾にあるメニューボタンをクリックします。

  3. 「デフォルトアクセス」をクリックし、インストールの下からオプションを選択します。

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

メンバーが体験すること

メンバーはカスタマイズ > プラグインの発見タブで利用可能なプラグインを閲覧します。「デフォルトでインストール」または「必須」に設定したプラグインは自動的にリストに表示されます。「インストール可能」に設定したプラグインはメンバーが自分で追加できるように発見に表示されます。

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


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

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

グループレベルのプラグインアクセスはエンタープライズプランで利用可能です。同じ組織設定 > プラグイン & スキルページで設定します。これには、オーナーまたは組織のライブラリ管理を含むカスタムロールが必要です。

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

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

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

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

  1. 組織設定 > プラグイン & スキルで「インベントリ」タブをクリックします。

  2. カスタマイズするプラグインを見つけて、その行の末尾にあるメニューボタンをクリックします。

  3. 「グループアクセス...」をクリックします。

  4. インストール対象の横にある「グループを追加」をクリックします。

  5. グループを選択し、上記のインストール設定の1つを選択します。

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

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

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

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

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

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

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

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

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


ユーザーが追加できるマーケットプレイスを制限

オーナーまたはプライマリオーナーは、許可リスト、ブロックリスト、またはその両方を使用して、組織内のユーザーが追加できるプラグインマーケットプレイスを制限できます。これらのリストはClaude Code管理設定で設定しますが、ClaudeおよびClaude Coworkにも適用されます。

許可リストまたはブロックリストを設定するには:

  1. 組織設定 > Claude Codeに移動します。

  2. 管理設定を見つけます。

  3. 「管理」をクリックします。

  4. JSONにstrictKnownMarketplaces(許可リスト)、blockedMarketplaces(ブロックリスト)、またはその両方を追加します。

  5. 「設定を追加」または「設定を更新」をクリックします。

GitHubの組織名をGitHubに表示されているとおりに正確に入力してください。許可リストのマッチングは大文字と小文字を区別します。ソースが両方のリストにある場合、ブロックされます。

リストが設定されると、Claude、Claude Desktop、またはCoworkでGitリポジトリからマーケットプレイスを追加するたびに、Claudeはそれらをチェックします。これは、ユーザーがカスタマイズでプラグインマーケットプレイスを自分で追加する場合と、組織設定 > プラグイン & スキルで組織全体に追加されるマーケットプレイスをカバーします。Claudeは、リストが許可していないリポジトリを拒否します。ただし、Anthropic製のマーケットプレイスは除きます。

以下の点に注意してください:

  • 組織設定でリストを設定します。コンピュータに展開されたmanaged-settings.jsonファイルまたはMDMポリシーは、そのコンピュータ上のClaude Codeにのみ適用されます。

  • 既存のマーケットプレイスは再チェックされません。リストを設定する前に追加されたマーケットプレイスは、誰かが削除するまで残ります。

  • アップロードされたプラグインはチェックされません。ユーザーがプラグインファイルをアップロードするのを防ぐには、組織設定 > プラグイン & スキルの「ポリシー」タブでユーザー作成スキルをオフにします。

リストが受け入れるすべてのソースタイプについては、Claude Codeドキュメントのユーザーがインストールできるものを制限を参照してください。


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

手動マーケットプレイス

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

プラグインを削除するには、Organization settings > Plugins & skillsのマーケットプレイスから削除し、「Inventory」タブで削除します。

GitHubと同期されたマーケットプレイス

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

GitLabと同期されたマーケットプレイスについては、Set up a GitLab-synced marketplaceを参照してください。

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


制限

制限

値

注記

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

200 MB

クライアント側とサーバー側の両方で実施

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

1000

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

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

1000

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

プラグイン名の最大長

64文字

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

同期タイムアウト

30分

同期操作あたり

同期されたリポジトリの可視性

github.comおよびgitlab.comではプライベートまたは内部のみ

github.com、GitHub Enterprise Server、gitlab.com、または自己管理GitLabインスタンスでホストされています。GitLabホスト(gitlab.comを含む)には、Organization settings > Claude CodeのGitLab設定が必要です。
​
パブリックリポジトリはサポートされていません。


命名規則

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

  • claude-code-marketplace

  • claude-code-plugins

  • claude-plugins-official

  • anthropic-marketplace

  • anthropic-plugins

  • agent-skills

  • life-sciences

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

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


トラブルシューティング

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

一般的な原因:ファイルが200 MBを超えている、有効なZIPファイルではない、またはマーケットプレイスが1000プラグインの制限に達しています。ファイルサイズと形式を確認し、容量に達している場合は未使用のプラグインを削除してください。スキルとプラグインスキャンがオンの場合、プラグインが悪意のあるコンテンツとしてフラグされたため、拒否される可能性もあります。理由を確認し、問題を修正してプラグインを再度アップロードしてください。

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

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

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

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

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

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

同期が「External plugin source type is not supported. Supported types: git-subdir, github, url」で失敗するか、プラグインが「Repository not found on gitlab.com. Check the URL and make sure the repository is public.」でスキップされます。

marketplace.json内の1つ以上のプラグインエントリが、接続されたリポジトリの外部を指すsource(github、url、またはgit-subdirソース)を使用しており、組織の同期がそれを取得できません。プライベートソースは3つの場合にのみ機能します:github.comリポジトリがマーケットプレイスリポジトリの所有者を共有している、GitHub Enterpriseホスト上のリポジトリにGitHub Enterprise Appがインストールされている、またはマーケットプレイスリポジトリと同じGitLabホスト上のurlまたはgit-subdir ソース(gitlab.comでは、同じトップレベルグループまたはユーザー名前空間の下)。

その他のプライベートソースの場合は、プラグインフォルダをマーケットプレイスリポジトリに移動し、各エントリのsourceを相対パス(例:"./plugins/my-plugin")に変更してからプッシュして再同期します。または、組織設定 > プラグイン & スキルから影響を受けるプラグインを個別にアップロードします。「追加」をクリックし、「プラグインをアップロード」を選択して、「既存のマーケットプレイスに追加」を選択します。メンバーの独自のカスタマイズメニューからアップロードされたプラグインはそのメンバーのみにインストールされ、組織全体には配布されませんが、共有がオンになっている場合、メンバーは特定の同僚またはグループとプラグインを共有できます。

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

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

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

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

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

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

マーケットプレイスを追加する際に「組織用のGitLabインスタンスがまだ構成されていません。Claude Code設定で追加してから、ここに戻ってください」

GitLabでマーケットプレイスを追加する際にこのメッセージが表示される場合は、GitLab構成を最初に追加していることを確認してください。GitLab同期マーケットプレイスのセットアップのステップ1:GitLab構成を追加するを参照してください。

「このURLは構成されたGitLabインスタンス上にありません」

URLのホスト名が構成されたGitLabホスト名と完全に一致していることを確認してください。

gitlab.comプロジェクトの追加が「マーケットプレイスの作成に失敗しました。もう一度試してください。」で失敗する

プロジェクトの可視性がプライベートまたは内部であることを確認してください。パブリックgitlab.comプロジェクトは組織マーケットプレイスとして使用できません。

接続テストがReach hostで失敗する(例:「ホスト名を解決できませんでした」、「接続が拒否されました」、または「GitLabが時間内に応答しませんでした」)、またはセルフマネージドインスタンスでマーケットプレイスを追加するとジェネリックエラーで失敗する

インスタンスがパブリックインターネットからHTTPS経由で到達可能であり、AnthropicのアウトバウンドIPアドレスがファイアウォール経由で許可されていることを確認してください。「セキュアな接続を確立できませんでした」は通常、CA証明書が不足しているか間違っていることを意味します。

「…への認証に失敗しました」または「アクセスが拒否されました」で始まるエラー

トークンの有効期限が切れているか、取り消されているか、GitLab同期マーケットプレイスのセットアップの開始する前にセクションに記載されているスコープまたはロールが不足しています。新しいトークンを作成し、構成に貼り付けます(編集 > アクセストークン)。

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