【結論】必須なのは外部MCPではなく、検証可能な業務Skill
すべてのプロジェクトにFilesystem MCPやDatabase MCPを追加する必要はありません。
Claude Codeは標準で作業ディレクトリのファイル操作とシェル実行を行えるため、同じ機能のMCPを重ねると権限とコンテキストが増えます。
最初に作るべきSkillは、プロジェクト固有のテスト、レビュー、リリース前確認など、繰り返し実行し結果を検証できる手順です。
mkdir -p .claude/skills/quality-gate
cat > .claude/skills/quality-gate/SKILL.md <<'EOF'
---
name: quality-gate
description: 変更後の品質確認を実行する
---
1. pnpm lintを実行する。
2. pnpm testを実行する。
3. git diff --checkを実行する。
4. 失敗時は原因だけを報告する。
EOF
具体的な手順・設定方法
実際に人間が使っているコマンドをSkillへ記載します。
破壊的操作や公開操作はSkillから外し、明示的な承認が必要な別手順にします。
/quality-gateを小さな差分で試し、CI結果と一致するか確認します。
claude
/quality-gate
実践プロンプト / 活用テクニック
Skillは手順の自動化であり、外部データが必要な場合だけMCPを追加します。
quality-gate Skillを実行してください。
失敗したコマンドがある場合はファイルを変更せず、コマンド、終了コード、最初の原因だけを報告してください。
全成功時は実行結果の要約だけを返してください。
注意点・よくあるエラーと対処法
Skillに「成功するまで修正」と書くと無制限のAgentループになり得るため、試行回数を制限します。
MCPサーバーを接続する場合は、読み取り専用資格情報と最小スコープを使用します。
Skillが発火しすぎる場合は説明を狭め、必要ならユーザー起動専用に設定します。