DT ツール・運用 Claude Code MCP設定

Claude CodeでMCPを設定する完全ガイド - 開発効率を10倍向上させる実践手順

Claude CodeでMCP (Model Context Protocol)を設定し、ファイルシステム、Git、データベースと連携する完全手順を詳しく解説。実際の設定例とトラブルシューティングまで含む実践的なガイドです。

約5分で読めます
技術記事
実践的

この記事のポイント

Claude CodeでMCP (Model Context Protocol)を設定し、ファイルシステム、Git、データベースと連携する完全手順を詳しく解説。実際の設定例とトラブルシューティングまで含む実践的なガイドです。

この記事では、実践的なアプローチで技術的な課題を解決する方法を詳しく解説します。具体的なコード例とともに、ベストプラクティスを学ぶことができます。

要約

本記事では、Claude CodeでMCP (Model Context Protocol)を設定し、開発効率を飛躍的に向上させる完全手順を解説します。MCPを適切に設定することで、Claudeがファイルシステム、Git、データベースなどと直接連携でき、手動作業を大幅に削減できます。

読者が得られる知識:

  • Claude CodeでのMCP設定手順
  • 実際の設定ファイル例とベストプラクティス
  • 主要MCPツールの導入方法
  • トラブルシューティングとパフォーマンス最適化

想定読者レベル: 初級〜中級 所要時間: 15分

目次

  1. Claude CodeとMCPの基礎知識

  2. 環境準備と前提条件

  3. 基本的なMCP設定手順

  4. 主要MCPツールの設定

  5. 実践的な使用例

  6. トラブルシューティング

  7. まとめ

Claude CodeとMCPの基礎知識

MCPが解決する課題

従来のClaude利用では、以下のような制限がありました：

従来の課題:

  • ファイル内容を手動でコピー＆ペーストする必要
  • 複数ファイルの内容を一度に処理できない
  • リアルタイムなファイル変更に対応できない
  • Git履歴やデータベース情報にアクセスできない

MCPによる解決:

# 従来：手動でファイル内容をコピー
$ cat src/components/Button.tsx
# 内容をClaude Codeにペースト

# MCP使用時：Claudeが直接ファイルを読み取り
Claude Code: "src/components/Button.tsxの内容を確認します..."
# 自動的にファイル内容を取得・分析

Claude Codeでの利点

Claude CodeでMCPを使用することで、以下の利点があります：

  1. シームレスな統合: Claude Codeのインターフェース内で直接操作
  2. 高度な分析: 複数ファイルを横断した分析が可能
  3. 自動化: 繰り返し作業の完全自動化
  4. リアルタイム更新: ファイル変更の即座な反映

環境準備と前提条件

必要な環境

MCPを使用するために以下の環境が必要です：

システム要件:

  • Node.js 18.0.0 以上
  • npm または yarn
  • Git（Gitツール使用時）
  • PostgreSQL（DBツール使用時）

権限要件:

  • ファイルシステムへの読み書き権限
  • ネットワークアクセス権限（API連携時）

Claude Codeのインストール

まず、Claude Codeが最新版であることを確認してください：

# Claude Codeのバージョン確認
claude-code --version

# 最新版への更新
npm install -g @anthropic/claude-code@latest

基本的なMCP設定手順

設定ファイルの作成

Claude CodeでMCPを使用するには、設定ファイルを作成する必要があります。

1. 設定ディレクトリの作成

# macOS/Linux
mkdir -p ~/.config/claude-code

# Windows
mkdir %APPDATA%\claude-code

2. 設定ファイルの作成

# macOS/Linux
touch ~/.config/claude-code/claude_desktop_config.json

# Windows
touch %APPDATA%\claude-code\claude_desktop_config.json

基本的な設定例

最初の設定ファイル例：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/projects"],
      "env": {}
    }
  }
}

設定項目の説明:

  • mcpServers: MCPサーバーの定義
  • command: 実行するコマンド
  • args: コマンドの引数
  • env: 環境変数

主要MCPツールの設定

ファイルシステム連携

最も基本的で重要なMCPツールです。

インストール

npm install -g @modelcontextprotocol/server-filesystem

設定例

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/projects"],
      "env": {
        "FILESYSTEM_ALLOWED_PATHS": "/Users/username/projects,/tmp",
        "FILESYSTEM_READONLY": "false"
      }
    }
  }
}

セキュリティ設定

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
      "env": {
        "FILESYSTEM_ALLOWED_PATHS": "/safe/project/path",
        "FILESYSTEM_READONLY": "true",
        "FILESYSTEM_IGNORE_PATTERNS": "node_modules,.git,.env"
      }
    }
  }
}

Git統合

Gitリポジトリとの連携を実現します。

インストール

npm install -g @modelcontextprotocol/server-git

設定例

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-git", "--repository", "/Users/username/projects/my-repo"],
      "env": {
        "GIT_PYTHON_REFRESH": "warn"
      }
    }
  }
}

複数リポジトリ対応

{
  "mcpServers": {
    "git-main": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-git", "--repository", "/Users/username/projects/main-app"],
      "env": {}
    },
    "git-api": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-git", "--repository", "/Users/username/projects/api-server"],
      "env": {}
    }
  }
}

データベース接続

PostgreSQLとの連携例です。

インストール

npm install -g @modelcontextprotocol/server-postgres

設定例

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://username:password@localhost:5432/database_name"
      }
    }
  }
}

セキュアな設定

環境変数ファイルを使用：

# .env ファイル作成
echo "POSTGRES_CONNECTION_STRING=postgresql://user:pass@localhost:5432/db" > ~/.config/claude-code/.env
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "${POSTGRES_CONNECTION_STRING}"
      }
    }
  }
}

実践的な使用例

コードレビューの自動化

MCPを使用したコードレビューの例：

設定

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/projects"],
      "env": {}
    },
    "git": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-git", "--repository", "/Users/username/projects/my-app"],
      "env": {}
    }
  }
}

使用例

ユーザー: "最新のコミットをレビューしてください"

Claude Code: 
1. Gitから最新のコミット情報を取得
2. 変更されたファイルを特定
3. ファイルシステムから現在の内容を読み取り
4. 変更内容を分析してフィードバックを提供

ドキュメント生成

プロジェクト全体のドキュメント自動生成：

プロンプト例

"src/componentsディレクトリ内のすべてのTypeScriptファイルを分析し、
各コンポーネントのプロップス、使用例、説明を含むAPIドキュメントを
docs/components.mdとして生成してください"

実行結果

Claude Codeが以下を自動実行：

  1. src/components内のファイル一覧取得
  2. 各ファイルの内容読み取り
  3. TypeScript型情報の抽出
  4. マークダウン形式のドキュメント生成
  5. docs/components.mdへの書き込み

トラブルシューティング

よくある問題と解決法

1. MCPサーバーが起動しない

症状:

Error: Could not start MCP server

解決法:

# Node.jsバージョン確認
node --version  # 18.0.0以上が必要

# MCPパッケージの再インストール
npm uninstall -g @modelcontextprotocol/server-filesystem
npm install -g @modelcontextprotocol/server-filesystem

# 設定ファイルの構文確認
cat ~/.config/claude-code/claude_desktop_config.json | jq .

2. ファイルアクセス権限エラー

症状:

Permission denied: Cannot access file

解決法:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
      "env": {
        "FILESYSTEM_ALLOWED_PATHS": "/absolute/path/to/project",
        "FILESYSTEM_FOLLOW_SYMLINKS": "false"
      }
    }
  }
}

3. データベース接続エラー

症状:

Database connection failed

解決法:

# 接続テスト
psql -h localhost -U username -d database_name -c "SELECT 1;"

# 設定確認
echo $POSTGRES_CONNECTION_STRING

パフォーマンス最適化

1. ファイルシステムアクセスの最適化

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
      "env": {
        "FILESYSTEM_ALLOWED_PATHS": "/specific/project/path",
        "FILESYSTEM_IGNORE_PATTERNS": "node_modules,.git,dist,build,*.log",
        "FILESYSTEM_MAX_FILE_SIZE": "1048576"
      }
    }
  }
}

2. Git操作の最適化

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-git", "--repository", "/path/to/repo"],
      "env": {
        "GIT_MAX_DIFF_SIZE": "10000",
        "GIT_SHALLOW_CLONE": "true"
      }
    }
  }
}

3. データベースクエリの最適化

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://user:pass@localhost:5432/db",
        "POSTGRES_MAX_ROWS": "1000",
        "POSTGRES_QUERY_TIMEOUT": "30000"
      }
    }
  }
}

まとめ

Claude CodeでMCPを設定することで、開発効率を大幅に向上させることができます。本記事で紹介した設定手順を参考に、段階的にMCPツールを導入してください。

重要なポイント:

  1. セキュリティ優先: ファイルアクセス権限とデータベース接続情報を適切に管理
  2. 段階的導入: まずファイルシステムから始めて、必要に応じて他のツールを追加
  3. パフォーマンス監視: リソース使用量を定期的にチェック
  4. 設定の最適化: プロジェクトの要件に合わせて設定をカスタマイズ

次のステップ:

  • 基本的なファイルシステム連携から開始
  • Git統合でバージョン管理を効率化
  • 必要に応じてデータベース連携を追加
  • 独自のMCPサーバー開発を検討

推奨リソース:

MCPを活用して、より効率的で生産性の高い開発環境を構築しましょう。

関連記事