Claude Code AgentへSkillsとMCPを組み合わせる方法

【結論】解決策 / 実行コマンド

SkillsとMCPは別機能です。

SkillはSKILL.mdに手順・知識・スクリプトをまとめる仕組みで、MCPはDB、GitHub、ブラウザなど外部システムへ接続するプロトコルです。

# ターミナルで実行：プロジェクト用Skillを作成
mkdir -p .claude/skills/research-then-implement
# ターミナルで実行：Skill定義を保存
cat > .claude/skills/research-then-implement/SKILL.md <<'EOF'
---
name: research-then-implement
description: 公式情報を調べてから最小差分で実装する
---
1. 参照元と日付を示す。
2. 実装前に変更計画を提示する。
3. 承認後に対象ファイルだけ変更する。
4. テスト結果を報告する。
EOF
# ターミナルで実行：MCP一覧を確認
claude mcp list

具体的な手順・設定方法

1. 再利用する作業手順は.claude/skills/へ保存します。

2. 外部ツールは提供元と権限を確認してclaude mcp addで登録します。

3. サブエージェントへ必要なSkill名とMCP利用条件を明示します。

実践プロンプト / 活用テクニック

# 起動後のセッション内で入力
research-then-implement Skillを使って公式仕様を確認してください。
外部MCPを使う場合は、最初に使用するツールと取得対象を説明してください。
調査結果を示した後、承認するまでコードを変更しないでください。

注意点・よくあるエラーと対処法

claude_mcp.jsonは現行の標準プロジェクト設定名ではなく、共有MCP設定は通常.mcp.jsonです。

APIキーをMCP設定へ直接書き込まず、環境変数または秘密管理を使用してください。

大量のMCPを有効化すると権限面とツール選択が複雑になるため、用途ごとに最小構成へ絞ってください。