Agent skills・MCP servers・rules filesの違いと選び方
Agent skills、MCP servers、rules filesの違いを、読み込み時期とトークンコストで比較します。6週間有効な手順、変化するデータ、常時必要な事実の選び方が分かります。
Agent skills、MCP servers、rules files の違い:簡潔な答え
Agent skills、MCP servers、rules files は、いずれもコーディングエージェントに知識を与えます。知識の用途に応じて選択してください。MCP(model context protocol)は、次に参照したときに内容が変わる可能性があるデータに適しています。skill は、今日文書化しても 6 週間後に正しいままである手順に適しています。rules file は、すべてのセッションで必ず守る必要がある少数の事実に適しています。
この選択にはコストがあり、そのコストはコンテキストです。エージェントが必要としない指示に使うトークンは、エージェントが読み取るコードに使えません。また、リクエストごとにコンテキスト全体が再送されるため、そのトークンには毎回費用が発生します。したがって、重要なのは、どの仕組みでその作業を実行できるかではありません。多くの場合、3 つすべてで実行できます。重要なのは、使われないまま置かれている間のコストが最も低い仕組みはどれかという点です。
使用前に把握しておくべきコスト
3 つは異なるタイミングで読み込まれます。この違いが、動作上の差を生みます。
無条件の rules ファイルは、除外しない限り、関連性に関係なく毎回のセッション開始時に読み込まれます。Claude Code は各会話の開始時に startup CLAUDE.md ファイルを読み込み、コードブロック外にあるブロックレベルの HTML コメントを除去してから内容を注入します。また、4 MiB を超えるファイルはスキップします。claudeMdExcludes を使うと、管理対象の policy ファイルを除き、ファイルを除外することもできます。ドキュメントでは、1 ファイルあたり 200 行未満を推奨しています。ファイルが長いほどコンテキストを消費し、内容に従われにくくなるためです。この 2 つの影響は同じ方向に働きます。そのため、900 行の rules ファイルは役に立たないどころか、悪影響になります。
skill は 2 段階で読み込まれます。起動時には、各 SKILL.md の frontmatter にある description 行だけがコンテキストに入ります。モデルは skill の存在と、おおよその適用場面を把握できます。本体は skill が呼び出されたときに読み込まれます。そのため、400 行のリファレンス文書でも、必要になるまでコストはほとんど発生しません。
以前は MCP server が最も高コストでした。しかし、現在よく見かける比較の多くは古くなっています。現在の Claude Code では、tool search がデフォルトで有効です。セッション開始時に読み込まれるのは tool 名と server の instructions フィールドだけです。完全な JSON (JavaScript object notation) スキーマは、Claude が検索するまで遅延されます。server を追加しても、開始時に数千 token を消費することはありません。ただし、コストがゼロになるわけではありません。また、tool search を無効にした構成では、すべてのコストが開始時に発生します。
このグラフのデータ
[
{
"label": "Rules file, 200 lines",
"at_startup": "2,500",
"after_use": "2,500"
},
{
"label": "Skill, 12 KB body",
"at_startup": 40,
"after_use": "3,000"
},
{
"label": "MCP server, tool search on",
"at_startup": 500,
"after_use": "3,200"
},
{
"label": "MCP server, tool search off",
"at_startup": "4,500",
"after_use": "4,500"
}
]これらは推定値であり、実際のマシンで測定した値ではありません。各仕組みが読み込むテキスト量から、1 token あたりおよそ 4 文字として算出しています。200 行の rules ファイルは約 10 KB の markdown、skill の description は約 160 文字、12 個の tool を公開する server は約 18 KB のスキーマと 2 KB の instructions ブロックを持つ計算です。Claude Code は、server の instructions フィールドと、起動時に読み込む各 tool の description を、デフォルトでは 4,096 文字で切り詰めます。tool search 経由で読み込む tool description の上限は 16,384 文字です。v2.1.296 より前は短い方の上限が 2,048 文字でした。CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH を設定すると、両方の上限を置き換えられます。一部の Anthropic がホストする MCP server では、この変数を設定しても instructions と description が完全な状態で Claude に届きます。そのため、これらの上限は常に適用される上限ではありません。次のセクションでは、実際の値を自分で確認する方法を説明します。
最初の 2 行は一緒に確認してください。rules ファイルは、誰も必要としなかったセッションでも 2,500 token を消費します。skill は同じセッションで 40 token を消費し、10 回に 1 回、呼び出されたセッションでは 3,000 token を消費します。最後の 2 行は同じ server を 2 回示したものです。tool search を有効にした場合と無効にした場合で、それぞれ 500 token と 4,500 token が発生します。この差が、MCP のコンテキスト肥大化に関する古い説明が今も広まっている理由です。
2026 年 10 月時点で、Claude Code は Claude Opus 4、Sonnet 4、Haiku 4.5 以降のモデルで tool search を使用します。また、Google Cloud の Agent Platform では、Opus 4.5、Sonnet 4.5、Haiku 4.5 以降のモデルで使用します。以前のモデルと、Azure 上でホストされる Microsoft Foundry のデプロイでは、設定内容に関係なく、すべての MCP tool が開始時に読み込まれます。ANTHROPIC_BASE_URL を LLM gateway に向ける場合、v2.1.304 以降では tool search がデフォルトで有効です。それより前のバージョンでは、明示的に有効化しない限り無効でした。v2.1.305 以降、Claude Code は 400 または 422 の後に、tool search を使わずに gateway request を再試行できます。その再試行が成功すると、tool は開始時に読み込まれます。ENABLE_TOOL_SEARCH で動作を制御できます。false はすべてのスキーマを開始時に読み込みます。true は、未設定の場合と同じモデルおよびデプロイのフォールバックを使用してスキーマの読み込みを遅延します。auto は、tool 定義の合計がコンテキストウィンドウの 10% 未満である間は開始時に読み込み、そのしきい値に達すると tool search を有効にしたままにします。その後、合計が 10% 未満に戻っても変更されません。"alwaysLoad": true を設定した server は、ENABLE_TOOL_SEARCH の設定に関係なく、tool を開始時に読み込みます。
# Load schemas up front only if they fit in 5% of the window
ENABLE_TOOL_SEARCH=auto:5 claude判断の決め手は、呼び出すたびにデータが変わるかどうかです。
まずこの点を確認してください。これだけで、選択肢を1つ除外できます。エージェントが次に参照したときに内容が変わっている可能性のある情報を読み書きする必要があるなら、サーバーが必要です。Issue tracker、データベース、監視ダッシュボード、独自の内部 API(application programming interface)などが該当します。記録しておいても役に立ちません。別の人がレコードを編集した時点で、記録した内容は古くなるためです。独自のコードベースもこの一覧に含まれます。コミットのたびに構成が変わるためです。そのため、構成をファイルに記述して古くさせるのではなく、MCP 経由でリポジトリを解析したマップをエージェントに提供するという考え方になります。
誰も保守しなくても6週間後に正しいままであるなら、skill が適しています。リリースチェックリスト、移行手順、エラーレスポンスの形式、このリポジトリでテストを記述する方法などです。skill は git 内のファイルです。ポートもプロセスもありません。誤った内容になること以外に障害要因はなく、その誤りはコードレビューで検出できます。
まだ考えていない作業にも適用する必要がある1つの事実なら、rules ファイルに記述します。Run make lint before committing. Never push to main. Handlers live in src/api/handlers/. 1行に1つ記述してください。項目が手順に発展した時点で、それは事実ではなく手順になっています。そのため、skill に移す必要があります。
ルールファイルで十分な場合
ルールファイルは、広い範囲から具体的な範囲へ向かって複数の場所から読み込まれます。管理対象のポリシーファイル、個人用の ~/.claude/CLAUDE.md、プロジェクトの ./CLAUDE.md または ./.claude/CLAUDE.md、そして gitignore 対象の ./CLAUDE.local.md です。検出されたファイルは上書きされず、連結されます。作業ディレクトリに近いファイルほど後に読み込まれます。
v2.1.277 以降、Claude Code は AGENTS.md も読み込みます。ただしデフォルトでは、作業ディレクトリまたはその上位に CLAUDE.md、.claude/CLAUDE.md、CLAUDE.local.md が存在しない場合に限られます。リポジトリに両方がある場合、Claude は CLAUDE.md ファイルだけを読み込みます。そのため、内容が分岐する2つのコピーを管理しないでください。
ln -s AGENTS.md CLAUDE.md成功時、シンボリックリンクは何も出力しません。セッションを開始して /context all を実行し、Memory files の下に CLAUDE.md が表示されることを確認します。そこに表示されない場合、エージェントはそのファイルを一度も認識していません。表現を変更しても解決しません。Claude 固有の行も追加する場合は、代わりに import 形式を使用し、import の下に記述します。
@AGENTS.md
## Claude Code
Use plan mode for changes under `src/billing/`.ここには注意点があります。@path の import ではコンテキストを節約できません。import されたファイルは展開され、参照元のファイルとともに起動時に読み込まれます。読み込みは最大4段階までです。600行のルールファイルを6つの import に分割しても、人間にとって整理しやすくなるだけで、トークンコストはまったく変わりません。AGENTS.md と人間向けの対応ファイルに関する規則 は、配置を決める前に読む価値があります。
コストを削減できるのは、paths フィールドを指定した .claude/rules/ です。paths frontmatter を持つルールファイルは、エージェントがパターンのいずれかに一致するファイルを操作するときだけ読み込まれます。
---
paths:
- "src/api/**/*.ts"
---
# API rules
- Every endpoint validates its input.
- Use the standard error response shape.paths フィールドのないルールは、.claude/CLAUDE.md と同じ優先度で起動時に読み込まれます。そのため、実用的な構成は、短い無条件ルールと、特定のディレクトリ内だけで必要になる内容に指定した paths リストの組み合わせです。
スキルが必要なとき
スキルとは、内部に SKILL.md を含むディレクトリのことです。個人用スキルは ~/.claude/skills/<name>/SKILL.md に配置され、マシン上のすべてのプロジェクトに適用されます。プロジェクト固有のスキルは .claude/skills/<name>/SKILL.md に配置され、リポジトリと共に移動します。また、他のファイルと同様にプルリクエストでレビュー可能です。
mkdir -p ~/.claude/skills/summarize-changes---
name: summarize-changes
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---
Run `git status` and `git diff` against the merge base.
Group the changes by intent, not by file.
Call out anything touching auth, migrations or deletions.description は、スキルが実行される前にコンテキストに読み込まれるファイル内の唯一の部分であり、2つの役割を担っています。スキルの内容を定義し、いつ実行すべきかを指定します。「デプロイを支援する」といった説明では、モデルはリクエストと照合する手がかりを得られません。その結果、スキルは実行されず、スキルが機能していないと判断することになります。
ディレクトリ名がコマンド名になります。上記の例では /summarize-changes というコマンドになります。個人用スキルやプロジェクトスキルにおいて、ディレクトリ名とは異なる frontmatter の name を設定すると、/ メニューに表示されるコマンド名を変更できます。ただし、その名前が他のコマンドですでに使用されている場合は除きます。なお、ディレクトリ名によるスキルの呼び出しは引き続き可能です。
スキルが呼び出されると、レンダリングされたコンテンツは単一のメッセージとして会話に入り、セッションの残りの期間中そこに留まります。Claude Code は、その後のターンでファイルを再読み込みしません。一度限りの手順ではなく、恒久的な指示を記述してください。また、その時点からすべての行がリクエストごとのコストとして累積されるため、本文は簡潔に保つ必要があります。自動圧縮後、Claude Code は各スキルの最新の呼び出しを再付与します。各スキルの最初の 5,000 トークンが、合計 25,000 トークンの予算内で保持されます。1つのセッションで複数の大きなスキルを呼び出すと、最も古いものから完全に削除されます。これが、長い会話の後にスキルが機能しなくなったように見える理由です。再度呼び出せば、再び有効になります。手順の多いスキルは、このトレードオフを具体的に示しています。the unlazy skill and its Depth Tree method は、作業が早期に完了したと判断するエージェントを防ぐために、ゲートと計画ファイルに対してコンテキストを消費します。同じ手順を複数のコードベースに適用する場合は、ファイルをコピーするのではなく、share one skill across several repositories を行ってください。
MCP サーバーが必要になる場合
追加は 1 つのコマンドで行え、トランスポートによって構成が決まります。
# Remote HTTP server
claude mcp add --transport http notion https://mcp.notion.com/mcp
# Remote HTTP server behind a bearer token
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
# Local stdio server: everything after -- is passed through untouched
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
-- npx -y airtable-mcp-server-- が重要です。stdio サーバーでは、Claude Code 自身のオプションとサーバーを起動するコマンドラインを分離します。省略すると、サーバー向けの --port 8080 が claude mcp add のオプションとして解析され、拒否されます。
claude mcp list
claude mcp get notionclaude mcp add は Added ... の行で確認を返しますが、これは設定がディスクに書き込まれたことしか示しません。実際の状態を確認するコマンドは claude mcp list です。各サーバーの横に、✔ Connected、! Needs authentication、✘ Failed to connect のいずれかのヘルスステータスが表示されます。失敗ステータスは Claude Code がそのサーバーに到達できなかったことを示し、一覧表示コマンド自体が失敗したことを示すものではありません。セッション内では、/mcp でサーバーごとの同じ情報に加えてツール数も確認できます。
MCP サーバーへの各呼び出しは独立しており、必要な情報をすべて保持します。これが、MCP サーバーが以前のリクエストを記憶しない理由です。これは、その影響を受け入れる必要がある設計上の選択です。保持する価値のある状態は、データベースやファイルなど、サーバーの背後に保存する必要があります。そして、その保存先は新たに運用する対象になります。
MCP サーバーは実行する必要があるプロセスです
ベンダー比較で省かれているコストがあります。skill はファイルです。MCP サーバーはどこかで実行されるソフトウェアであり、その実行場所が VPS(virtual private server)なら、可用性を維持する責任は自分にあります。
stdio サーバーは低コストなケースです。Claude Code はセッション開始時に子プロセスとして起動し、セッション終了時に終了します。監視も、独自のスケジュールでのパッチ適用も必要ありません。リモート HTTP サーバーは長時間稼働するサービスであり、他の長時間稼働するサービスと同じ要件があります。まず、専用ユーザーが必要です。以下の unit が実行する mcp ユーザーを作成し、サーバーのディレクトリを割り当てます。
sudo useradd --system --home-dir /srv/notes-mcp --shell /usr/sbin/nologin mcp
sudo chown -R mcp:mcp /srv/notes-mcp[Unit]
Description=Notes MCP server
After=network-online.target
Wants=network-online.target
[Service]
User=mcp
WorkingDirectory=/srv/notes-mcp
ExecStart=/usr/bin/node /srv/notes-mcp/dist/server.js
Environment=PORT=8931
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
PrivateTmp=true
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable --now notes-mcp
systemctl is-active notes-mcp
journalctl -u notes-mcp -n 50 --no-pagersystemctl is-active は active を出力するはずです。failed が出力された場合は、journal に原因が記録されています。初回起動では、環境変数の未設定か、別のプロセスによるポートの使用が原因であることがほとんどです。ここで Restart=on-failure は必須です。MCP サーバーがクラッシュしても、自動的には通知されないためです。エージェントから課題管理システムを読み取れないと報告されて、初めて気付くことになります。
プロセスを 127.0.0.1 にバインドし、その前段に TLS(transport layer security)対応のリバースプロキシを配置します。データベースに接続でき、認証なしで公開ポートに応答する MCP サーバーは、公開してしまったデータベースと同じです。VPS で MCP サーバーを実行するでは、プロキシ、証明書、ファイアウォールの設定を適切に説明しています。
次に、継続的に発生する作業を正確に見積もります。このサービスは、接続するエージェントとは無関係の独自のスケジュールでセキュリティ更新を適用します。OAuth トークンは期限切れになり、都合の悪いタイミングで claude mcp list が ! Needs authentication の出力を開始します。認証情報は設定ファイルまたは Authorization ヘッダーに保存されるため、他の Secret と同じように管理する必要があります。これはそれ自体が1つの大きなテーマです。AI エージェントの手が届かない場所で Secret を管理するを参照してください。skill には、これらの作業は一切ありません。
構築する前に、代替手段と比較してください。提案するサーバーの背後にあるデータが約1四半期に1回しか変わらないなら、エージェントに参照先と各フィールドの意味を伝える skill のほうが、稼働を維持し続ける必要があるサービスより低コストです。
自分のコンテキストコストを測定する方法
推測をやめ、セッション内で /context all を実行します。現在の内訳として、システムプロンプト、メモリファイル、ツール、MCP サーバーと、それぞれのトークン量が表示されます。
2 つの点を確認します。Memory files で、想定しているすべてのルールファイルが一覧にあることを確認します。ファイルがない場合、エージェントからは見えません。そのため、指示が無視されるときは、まずファイルの欠落を除外します。ファイルが一覧にあり、それでもルールが適用されない場合、原因は別の場所にあります。その場合は、同じ行を書き直す前に、エージェントが認識できる指示を通り過ぎる理由を確認します。次に、サーバーのコストを確認します。月に 2 回しか使わないサーバーが一覧の中で大きな割合を占めている場合は、/mcp で無効にし、必要なセッションで再度有効にします。どちらの場合も設定は保持されます。
アカウントで discovery cache が有効な場合、以前に使用したリモートサーバーに cached 2h ago · connects on first use · 5 tools のようなステータスが表示されることがあります。これは、Claude Code が起動時に接続せず、前回のセッションからツール一覧を読み込んだことを示します。ツールが最初に呼び出された時点で接続されます。最初のメッセージからツールを利用できるため、修正は不要です。段階的なロールアウトで有効化されていない限り、キャッシュはデフォルトで無効です。すべてのサーバーを起動時に接続させるには MCP_DISCOVERY_CACHE=0 を設定し、キャッシュを有効にするには 1 を設定します。全体像については、Claude Code のコンテキストウィンドウを管理する方法で圧縮後も保持される内容を確認できます。また、これらのトークンに実際にかかるコストでは、数値を金額に換算して説明しています。
なぜスキルがトリガーされないのですか?
一般的な原因は description です。これはスキルが実行される前のコンテキストにおいて唯一のテキストであるため、状況が明示されていないと一致するものがありません。「ユーザーが変更内容を尋ねたとき、コミットメッセージを求めたとき、または diff のレビューを依頼したときに使用する」といったように、トリガーを文章に記述してください。曖昧な説明はエラーを出さずに失敗するため、原因の特定が困難になります。
2つ目の原因はフロントマターのタイプミスであり、Claude Code ではこれも通知されません。フィールド名はハイフンを含めて完全に一致させる必要があり、Claude Code は認識できないフィールドをエラー報告なしに無視します。警告が表示されるのは、スキルをパッケージ化して claude.ai または Skills API にアップロードしたときのみです。これらは許可されたフィールド以外を完全に拒否するためです。
Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name3つ目は場所の問題です。プロジェクトスキルは、作業ディレクトリおよびリポジトリルートまでのすべての親ディレクトリにある .claude/skills/ から読み込まれます。起動した場所よりも深い階層にあるサブディレクトリ内のスキルは、起動時には読み込まれません。それらのスキルは、エージェントがそのサブディレクトリ内のファイルを初めて読み込むか編集した時点で表示されるため、それまではオートコンプリートに現れず、名前で呼び出すこともできません。
このサイレントな失敗の MCP における同等の事象は、url を持ち type を持たない .mcp.json エントリです。Claude Code は type を持たないエントリを stdio サーバーとして読み込むため、そのエントリをスキップし、以下のように報告します。
MCP server "notes" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry3 つすべてを組み合わせる
これらの仕組みは、同じ場所を奪い合うものではありません。うまく機能する構成では、それぞれを低コストで使える場所に配置します。ルールファイルには、どこでも当てはまる少数の行だけを記載します。Skills には手順を記載し、必要な場合にだけ読み込みます。内容を事前に予測できないシステムには、1 台の MCP server、場合によっては 2 台を接続します。前者の仕組みについてまだ理解を深めている段階であれば、agent skill とは何かで形式を詳しく説明しています。
どこに配置すべきかについての議論の多くは、1 つのテストで判断できます。それを削除して、新しいセッションを開始し、agent にタスクを与えます。agent の動作が単に遅くなっただけなら、それは skill に記載すべき内容でした。agent が確信を持って誤った回答をするなら、それはルールファイルに記載すべき内容でした。agent が情報をまったく取得できないなら、server が必要でした。その場合は、その server を稼働し続けるための計画も必要になります。
FAQ
スキルを記述するべきですか、それとも MCP server を構築するべきですか?
情報が呼び出しごとに変化するかどうかで判断します。Issue tracker、データベース、ダッシュボードなど、他のユーザーが編集できる最新の状態をエージェントが読み取る必要がある場合は、MCP server が必要です。記録が変更された時点で、書き留めた内容が古くなるためです。6 週間後でも正しい回答を一度書いておけるなら、スキルを記述します。スキルは git 内のファイルであり、実行するプロセス、公開するポート、適用するパッチスケジュールがありません。そのため、可能な場合はスキルのほうが低コストです。
MCP server でもコンテキストウィンドウを使い切りますか?
以前より大幅に少なくなっています。現在の Claude Code では Tool search がデフォルトで有効です。そのため、セッション開始時に読み込まれるのはツール名と server の instructions フィールドだけで、完全な schema は Claude が検索したときに取得されます。ANTHROPIC_BASE_URL で設定した LLM gateway の背後にあるセッションも、v2.1.304 以降ではこの対象です。ENABLE_TOOL_SEARCH=false を使用している場合、server に "alwaysLoad": true を設定している場合、Claude Opus 4 および Sonnet 4 より古いモデル(Google Cloud の Agent Platform では 4.5 世代より古いモデル)を使用している場合、または Azure でホストされた Microsoft Foundry deployment では、起動時に完全な schema が読み込まれます。/context all を実行して該当する状況を確認してください。古い比較記事の数値は、起動時の読み込みを前提としているためです。
Claude Code は AGENTS.md を読み込みますか?
はい。v2.1.277 以降で対応しています。ただしデフォルトでは、作業ディレクトリまたはその上位ディレクトリに CLAUDE.md、.claude/CLAUDE.md、CLAUDE.local.md のいずれもない場合に限られます。リポジトリに両方がある場合、Claude は CLAUDE.md ファイルだけを読み込みます。そのため、2 つのコピーを保持せず、一方からもう一方を参照してください。通常の symlink には ln -s AGENTS.md CLAUDE.md を実行します。または、CLAUDE.md の先頭行に @AGENTS.md を記述し、その下に Claude 固有の指示を追加します。その後、セッションを開始して /context all を実行し、CLAUDE.md が Memory files の下に表示されることを確認します。
セッションの途中でスキルの効果がなくなったのはなぜですか?
通常は自動コンパクションが原因です。会話が要約されると、Claude Code は各スキルの直近の呼び出しを再アタッチします。各スキルの先頭 5,000 tokens を保持し、すべてのスキルで合計 25,000 tokens の予算に収めます。この予算は、直近に呼び出したスキルから順に使用されます。そのため、大きなスキルを複数呼び出していると、古いスキルは完全に除外されます。スキルをもう一度呼び出すと、完全な内容を復元できます。
長い rules file がすべてのセッションで読み込まれないようにするにはどうすればよいですか?
たまにしか必要にならない部分を、frontmatter に paths フィールドを持つ .claude/rules/ ファイルへ移動します。各ファイルは、エージェントが一致するファイルにアクセスした場合にだけ読み込まれます。ファイルを @path imports に分割しても効果はありません。import されたファイルは展開され、参照元のファイルとともに起動時に読み込まれるためです。複数の手順で構成される処理は、常時参照する事実ではなくスキルにしてください。スキル本文は呼び出すまでコストが発生しないためです。