自社 Plugin Marketplace を立ち上げる（運用編）

コース構成

このコースで学ぶこと

1. 01

   なぜ自社 Marketplace が必要か

   個別 Plugin を社員に配布するのは限界がある。中央配布で更新通知・管理を自動化することで、運用負荷を激減できる。Plugin の基本概念や Marketplace の仕組みは別コースに譲り、本コースは“社内に実際に立ち上げて回す”運用に集中する。

   弊社固有の Skill / MCP / Hook が増えてくると、社員に配布する方法が悩みになります：Slack で URL を貼る・README で説明する・git pull させる、どれも更新通知ができません。

   自社 Marketplace を立ち上げれば、`claude plugin marketplace add` の 1 コマンドで全社員が弊社製プラグインにアクセス可能に。更新も自動配信されます。

   • 1 つの Github Repo で全プラグインを管理
   • marketplace.json で一覧を定義
   • 社員は claude plugin install でいつでも追加
   • 更新は自動通知

   概念から学ぶ：プラグイン体系と Marketplace 入門

   理解度チェック

   1. Q1.自社 Marketplace を立てると、Slack で URL を貼る方式と比べて何が一番改善する？

      Aプラグインのコード行数が減るBプラグインの“配布”だけでなく“更新通知”まで仕組み化できるCClaude のレスポンスが速くなるDプラグインに有料化機能が付く
   Marketplace Repo の構造
2. 02

   Marketplace Repo の構造

   Github にプライベート Repo を 1 個作る。

   text

   company-cc-marketplace/
   ├─ marketplace.json     # マーケットプレイス定義
   ├─ README.md
   └─ plugins/
      ├─ company-forms/    # 申請書類 Skill 集
      │  ├─ plugin.json
      │  ├─ skills/
      │  │  ├─ biz-trip/
      │  │  ├─ expense/
      │  │  └─ ...
      │  └─ README.md
      ├─ pii-redact/        # PII 検閲 Hook
      └─ company-mcp/       # 社内 MCP

   理解度チェック

   1. Q1.自社 Marketplace の Repo 構造として正しいのは？

      Aプラグインごとに別 Repo を作る（管理は分散させる）B1 つの Repo に `marketplace.json` と `plugins/` 配下で全プラグインをまとめるCGitHub 以外のクラウドストレージに ZIP で置くDClaude が自動生成する隠しディレクトリに置く
   なぜ自社 Marketplace が必要かmarketplace.json の書き方
3. 03

   marketplace.json の書き方

   プラグイン一覧 + メタデータ。シンプルな JSON。

   json

   {
     "name": "Company Internal Marketplace",
     "description": "弊社内製の Claude Code Plugin",
     "version": "1.0.0",
     "plugins": [
       {
         "name": "company-forms",
         "description": "申請書類 Skill 集（出張・経費・備品・有給・在宅）",
         "version": "0.1.0",
         "path": "plugins/company-forms",
         "tags": ["forms", "admin", "all-employees"]
       },
       {
         "name": "pii-redact",
         "description": "プロンプト送信前に PII を検出・警告するセキュリティ Hook",
         "version": "0.2.0",
         "path": "plugins/pii-redact",
         "tags": ["security", "required"]
       }
     ]
   }

   理解度チェック

   1. Q1.marketplace.json のプラグイン定義に `tags` を付ける利点は？

      Aプラグインの実行速度が速くなるB`security` `required` などのタグで絞り込み検索・必須プラグインの管理がしやすいCAnthropic Console に自動で課金プランが切り替わるDGitHub の Star 数が表示される
   Marketplace Repo の構造社内配布の手順
4. 04

   社内配布の手順

   新入社員へのオンボーディングに組み込む。

   bash

   # 社員側の手順（1 回だけ実行）
   claude plugin marketplace add https://github.com/myorg/company-cc-marketplace
   
   # 必須プラグインをインストール
   claude plugin install company-forms pii-redact
   
   # 確認
   claude plugin list

   理解度チェック

   1. Q1.新入社員が初日から弊社プラグイン環境で動けるようにする最短手段は？

      ASlack に手順書 URL を貼るBmanaged-settings で必須プラグインを強制 install させるC全員に GitHub の Repo URL を口頭で伝えるDプラグインを毎回手動コピーしてもらう
   marketplace.json の書き方運用：バージョン管理と更新通知
5. 05

   運用：バージョン管理と更新通知

   プラグイン更新時の周知方法を最初に決めておく。

   手を動かす

   0 / 5

   • marketplace.json を semver で管理
   • プラグイン更新時は GitHub Release で告知
   • 破壊的変更時は major bump + Slack 告知
   • 月次の社内 Tech ニュースで更新まとめ
   • 1 年に 1 回、各プラグインの利用状況をログから分析

   理解度チェック

   1. Q1.社内 Marketplace の破壊的変更を出すときの正しい運用は？

      Apatch 番号を上げてサイレント配布するBmajor を上げて Slack で告知し、移行手順を Release Notes に書くCmarketplace.json の URL を差し替えて気付かれないようにするDプラグインを丸ごと削除して再インストールさせる
   社内配布の手順