Claude Pluginとは？Cowork・Claude Codeで使えるプラグインの仕組みと作り方

Claude Plugin（クロードプラグイン）とは、Anthropicが提供する拡張機能の配布単位で、Claude CodeとCowork modeの両方で共通利用できる仕組みである。MCP（Model Context Protocol）サーバー、スキル（Skill）、カスタムスラッシュコマンドなどの機能を.pluginファイルにまとめ、ワンクリックでClaudeに追加できる。これにより、組織や個人が独自のツール連携・ワークフローを簡単に共有・再利用できる環境が整う。

たとえば、社内のSlack・GitHub・Notionを横断して操作するMCPサーバーと、社内固有のコーディング規約を定めたスキルをまとめた「社内エンジニア向けプラグイン」を作れば、全社員のClaudeに同じ機能を配布できる。プラグインマーケットプレイスを介して公開すれば、世界中の開発者にも提供可能だ。

Claude Pluginとは

Claude Pluginは、Anthropicが2025年後半に発表した拡張機能のパッケージ規格である。ざっくり言えば「Claudeに独自機能を追加するためのインストール可能な箱」と考えると理解しやすい。従来のAIアプリでは、新しいツール連携を追加するたびに設定ファイルを手書きで編集したり、個別にMCPサーバーを登録する必要があった。プラグインはこれらをひとまとめにして、Chromeブラウザの拡張機能のように「インストールする」だけで使えるようにした仕組みだ。

身近な例えでいえば、プラグインはスマホアプリのストアにおけるアプリのようなものだ。App Storeでゲームアプリをインストールすると、グラフィック・サウンド・ロジックが一括で端末に入ってすぐ遊べるようになる。同様にClaude Pluginをインストールすると、その中に含まれるMCPサーバー・スキル・コマンドがClaude環境に一括で追加され、すぐにAIワークフローで使えるようになる。ここが重要なポイントです。

Claude Pluginの読み方

Claude Pluginの仕組み

Claude Pluginは、ZIP形式のアーカイブを.pluginという拡張子で配布する規格である。内部には、プラグインの名前・バージョン・依存関係などを記述したマニフェストファイル（plugin.json）と、実際の機能を提供する複数のディレクトリが含まれる。実務では、以下の3つの要素がバンドルできることを覚えておきたい。

内部構造

一般的なプラグインのディレクトリ構成は次のようになる。これは実際にClaude Codeがプラグインをロードする際の標準レイアウトだ。

my-plugin.plugin/
├── plugin.json          # マニフェストファイル
├── mcp/
│   └── my-mcp-server.json  # MCPサーバー定義
├── skills/
│   └── my-skill/
│       └── SKILL.md     # スキルのトリガーと手順
└── commands/
    └── my-command.md    # カスタムスラッシュコマンド

読み込みの流れ

ユーザーが/plugin install my-pluginとコマンドを実行するか、管理画面からインストールを指示すると、Claudeは次の順番でプラグインを展開する。まずマニフェストを読み、依存関係とパーミッションを確認する。次にMCPサーバーを登録し、設定ファイルに追記する。最後にスキルをスキル一覧に追加し、スラッシュコマンドをコマンドパレットに登録する。重要ですので覚えておいてください。

Claude Pluginの使い方・実例

ここでは、実際にプラグインを作ってインストールするまでの最小例を紹介する。以下はGitHub API経由でIssueを取得する簡易プラグインの例である。

plugin.jsonの例

{
  "name": "github-issue-helper",
  "version": "1.0.0",
  "description": "GitHub IssueをClaudeから操作するプラグイン",
  "author": "example@company.com",
  "mcp_servers": [
    {
      "name": "github",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  ],
  "skills": ["issue-triage"],
  "commands": ["triage-issues"]
}

インストール手順

# Claude Code でのインストール
claude plugin install ./my-plugin.plugin

# 有効化確認
claude plugin list

# プラグイン内のコマンド実行
/triage-issues owner/repo

Coworkでインストールする場合は、アプリ内のプラグインマーケットプレイスから検索して「インストール」ボタンをクリックするだけでよい。実務では、まず小さなプラグインから試して動作を確認するのが注意したいポイントです。

Claude Pluginのメリット・デメリット

メリット

• 配布が簡単: 単一の.pluginファイルで全機能を配布できる。ZIPを解凍する手間もない。
• Claude CodeとCoworkで共通: 同じプラグインが両環境で動作するため、開発者と非エンジニアの両方に同じワークフローを提供できる。
• マーケットプレイス対応: プラグインマーケットプレイスを通じて公開・発見・評価ができる。
• バージョン管理: マニフェストでバージョン指定ができるため、組織内で一貫したバージョンを展開しやすい。
• 権限の一元管理: MCPサーバーごとの権限設定をプラグイン側で統一できる。

デメリット

• セキュリティリスク: 信頼できない配布元のプラグインをインストールすると、認証情報漏洩や意図しない外部通信のリスクがある。
• 依存関係の管理が必要: MCPサーバーが外部ランタイム（Node.js、Python等）に依存する場合、利用環境に整える必要がある。
• 標準機能との衝突: 複数プラグインで同名のスラッシュコマンドを定義すると競合する。

Claude PluginとMCPの違い

両者は密接に関連するが、レイヤーが異なる。プラグインはMCPを含む配布単位であり、MCPはプロトコルそのものだ。

実務では、MCPサーバーを作ってからプラグインとしてラップして配布、という流れが一般的だ。この順序を覚えておき、設計時に混同しないようにしたい。

よくある誤解

誤解1: プラグインはClaude Codeでしか動かない

これは誤りだ。Claude PluginはCoworkでも動作する。ただし一部のCLI専用機能（ターミナル直接操作等）はClaude Code限定になる場合がある。

誤解2: プラグイン＝単なるMCPサーバー

MCPサーバーはプラグインの構成要素のひとつにすぎない。スキルやカスタムコマンドを含まず、MCPサーバーだけを直接登録することも可能だが、配布の利便性を考えるとプラグインにまとめる方が推奨される。

誤解3: プラグインはAnthropicの審査が必須

ローカルインストールやプライベート配布の場合、審査は不要だ。ただしAnthropic公式のプラグインマーケットプレイスに掲載する場合はガイドラインに沿ったレビューがある。社内配布や個人利用なら自由に作って共有できる。

誤解4: プラグインを入れると必ず全機能が有効になる

インストール＝有効化とは限らない。多くの環境では明示的に有効化する必要がある。また、プラグインごとにオン/オフを切り替えられるので、使わない機能を個別に無効化することも可能だ。

実務での活用シーン

実務での代表的な活用例を挙げる。まず社内エンジニア向けプラグインとして、GitHub・Jira・Slackを統合し、社内のコーディング規約を反映したスキルを配布するケースがある。次にマーケティング部門向けプラグインでは、Google Analytics・Search Console・広告プラットフォームへの接続と、レポート作成スキルを組み合わせる。

さらに業界特化プラグインとして、医療機関向けのHL7 FHIR連携、法律事務所向けの判例データベース連携などがある。Vertical SaaSのような形でプラグインをビジネス化する動きも増えている。実務ではプラグインを作る前に、誰がどんなタスクで困っているかを明確にすることが重要です。

よくある質問（FAQ）

Q1. プラグインを作るのに必要なスキルは？

A. 最小限ならJSON編集とMarkdown記述だけで作れる。MCPサーバーを自作する場合はNode.jsまたはPythonの知識が必要だ。既存のMCPサーバーを使うだけなら、設定ファイルを書くだけで完成する。

Q2. プラグインのセキュリティはどう確保する？

A. 信頼できる配布元からのみインストールし、マニフェストのpermissions欄を必ず確認する。機密情報を扱うMCPサーバーは、環境変数で認証情報を渡す設計にすること。

Q3. プラグインの配布方法は？

A. 方法は複数ある。（1）.pluginファイルを直接共有、（2）GitHubなどでリポジトリ公開、（3）Anthropic公式マーケットプレイスへの掲載、（4）組織内プライベートマーケットプレイスの運用。

Q4. プラグインは無料？有料のものもある？

A. 無料プラグインが多いが、有料配布も可能だ。マーケットプレイスでは将来的に有料モデルが導入される予定とされている。社内配布では無料の場合が大半である。

Q5. プラグインのアップデート方法は？

A. claude plugin update <name>コマンドを実行するか、管理画面で「更新」を押す。マニフェストのバージョン番号をセマンティックバージョニングで管理することが推奨される。

まとめ

• Claude Pluginは、MCPサーバー・スキル・カスタムコマンドを一括配布する拡張機能パッケージ。
• Claude CodeとCoworkの両方で動作し、マーケットプレイスを通じた発見・共有が可能。
• 配布単位は.pluginファイル（ZIPベース）で、plugin.jsonマニフェストで構成を定義する。
• MCPはプロトコル、プラグインは配布単位という役割の違いを押さえておくこと。
• セキュリティ面では信頼できる配布元からインストールし、権限を確認することが重要。
• 業界特化プラグインや社内配布など、ビジネス応用の可能性が広がっている。
• 最小構成なら設定ファイルの編集だけで作れるため、初心者でも挑戦しやすい。

参考文献・出典