Claude Codeの拡張3層構造——Skills・MCP・プラグインマーケットプレイスの使い分け

2026年9月25日

Claude Codeを拡張する仕組みは「Skills」「MCPサーバー」「プラグイン」の3層に分かれており、それぞれ役割が異なる。本稿では各仕組みの位置づけと、SKILL.mdの最小構成、MCPサーバーの接続スコープ、プラグインマーケットプレイスでの配布方法までを、公式ドキュメントの記述にもとづいて整理する。

拡張の3層構造を整理する

Claude Codeを自分の作業に合わせて拡張する方法は、大きく3つある。混同されがちだが、それぞれ担う役割が異なる。

Skills（SKILL.md）：特定のタスクを実行する手順書。フォルダに1つのSKILL.mdファイルを置くだけで動く、もっとも軽量な拡張。
MCPサーバー：GitHub・Slack・Sentryなど外部サービスとの接続そのもの。Claudeに新しいツール（関数）を渡す仕組み。
プラグイン：Skills・エージェント・hooks・MCPサーバーをひとまとめにして配布できるパッケージ。公式マーケットプレイスや社内マーケットプレイス経由でチーム全員に一括インストールできる。

個人の作業を自動化したいだけならSkills、外部サービスと連携したいならMCP、チームに配って標準化したいならプラグイン、というのが基本の使い分けになる。

Skillsを自作する——SKILL.mdの最小構成

スキルは.claude/skills/<skill-name>/SKILL.mdというファイル1つで成立する。YAMLフロントマターと、その後のMarkdown本文の2部構成だ。

---
name: summarize-changes
description: コミット前の変更内容を要約し、リスクをフラグする
---

## 現在の変更内容
!`git diff HEAD`

## 指示
上記の変更を2〜3点の箇条書きで要約し、エラーハンドリング不足や
ハードコード値など気になるリスクを指摘してください。

行頭の!`コマンド`という記法は、スキル実行前にシェルコマンドを走らせてその出力をプロンプトに埋め込む機能で、Claudeが実際のdiffやログを見ながら作業できるようになる。

主なフロントマターのフィールドは次のとおり。

フィールド	役割
`description`	Claudeが自動実行するかどうかの判断材料になる（上限1,536文字）
`disable-model-invocation`	`true`にすると、ユーザーが`/`コマンドで手動実行したときのみ動く（副作用のある操作向け）
`allowed-tools`	事前承認するツールをスペース区切りで指定（例: `Bash(git *)`）
`context: fork`	サブエージェントとして独立した会話で実行する
`arguments`	名前付き引数を定義し、本文中で`$0`や`$branch`として参照できる

スキルの置き場所には優先順位があり、Enterprise（管理設定）＞ Personal（~/.claude/skills/）＞ Project（.claude/skills/）の順で上位が勝つ。ゼロから書くのが面倒なら、Claude Code同梱のskill-creatorスキルに「◯◯用のスキルを作って」と頼めば、ヒアリングしながらSKILL.mdの雛形を書いてくれる。

MCPサーバーをつなぐ——スコープの使い分け

外部サービスと連携したい場合はclaude mcp addコマンドでMCPサーバーを登録する。ポイントはスコープの指定だ。

スコープ	コマンド例	共有範囲
local（既定）	`claude mcp add ...`	自分だけ・このプロジェクトのみ（`~/.claude.json`）
user	`claude mcp add --scope user ...`	自分の全プロジェクトで共通（`~/.claude.json`）
project	`claude mcp add --scope project ...`	チーム全員と共有（`.mcp.json`をgit管理）

個人用のAPIキーが絡むサーバーはuserスコープ、チームで同じ接続設定を使い回したい場合はprojectスコープで.mcp.jsonをリポジトリにコミットする、という使い分けが基本になる。

プラグインとマーケットプレイスで配布する

SkillsとMCPサーバーの組み合わせを個人の設定に留めず、チームやコミュニティに配りたい場合はプラグインにする。まずマーケットプレイス（カタログ）を追加し、そこから個別にインストールする2段階の流れだ。

# 公式以外のマーケットプレイスを追加
/plugin marketplace add anthropics/claude-code

# カタログから個別にインストール
/plugin install commit-commands@claude-code-plugins

公式マーケットプレイス（claude-plugins-official）はClaude Codeの初回起動時に自動で追加され、/plugin install github@claude-plugins-officialのように名前を指定するだけで使える。公式カタログに含まれる主なプラグインは次のとおり。

カテゴリ	プラグイン例
外部サービス連携（MCP同梱）	github・gitlab・slack・notion・figma・sentry など
コード解析（LSP）	typescript-lsp・rust-analyzer-lsp・pyright-lsp など
開発ワークフロー	commit-commands（コミット/PR作成）・pr-review-toolkit（レビュー用エージェント）
セキュリティ	security-guidance（変更ごとに脆弱性をレビュー）