MCP（Model Context Protocol）

MCP (Model Context Protocol) は、AI に「手足」を与える仕組みです。Claude Code に MCP サーバーを追加することで、GitHub 操作やデータベース接続など様々な外部サービスと連携できるようになります。

MCP とは

身近な例えで理解する

スマートフォンの「アプリ」をイメージしてください。

スマホは本体だけでも電話やカメラが使えますが、アプリをインストールすると地図、決済、SNS など様々なことができるようになります。同じように、Claude Code も MCP サーバーを追加することで、GitHub 操作やデータベース接続など様々な外部サービスと連携できるようになります。

さらに、1つのアプリが iPhone でも Android でも使えるように、1つの MCP サーバーは Claude でも ChatGPT でも Copilot でも使えます。これが「標準プロトコル」であることの大きなメリットです。

MCP がない場合とある場合

仕組み

MCP は3つの登場人物で成り立っています。

MCP サーバーが AI に提供するもの

接続方式

.mcp.json の設定方法

MCP サーバーの設定はプロジェクトルートの .mcp.json に定義します。Claude Code はプロジェクトルート直下の .mcp.json のみを認識するため、このファイルは移動できません。

基本構造

{
  "mcpServers": {
    "サーバー名": {
      "type": "stdio",
      "command": "コマンドの絶対パス",
      "args": ["引数1", "引数2"],
      "env": {}
    }
  }
}

スターターキットに含まれる設定例

{
  "mcpServers": {
    "serena": {
      "type": "stdio",
      "command": "/home/sasao020211/.local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/oraios/serena",
        "serena",
        "start-mcp-server",
        "--context",
        "ide-assistant",
        "--project",
        "."
      ],
      "env": {}
    },
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--yes",
        "@upstash/context7-mcp"
      ],
      "env": {}
    }
  }
}

導入済み MCP サーバー

1. Serena（セマンティックコード解析）

機能:

• セマンティックなコード解析・検索
• シンボルレベルでのコード編集
• 複数言語対応
• IDE ライクなコードナビゲーション

前提条件のインストール:

# uv のインストール（Linux/macOS）
curl -LsSf https://astral.sh/uv/install.sh | sh

# インストール確認
uvx --version

2. Context7（リアルタイムドキュメント取得）

機能:

• 最新のライブラリ・フレームワークのドキュメントをリアルタイム取得
• バージョン固有のコード例を提供
• Claude の知識カットオフを補完し、最新の API 仕様に基づいたコード生成を支援

使い方: プロンプトに use context7 を含めると、Claude が最新ドキュメントを取得してからコードを生成します。

FastAPI で非同期エンドポイントを作成して use context7

MCP サーバーの追加方法

新しい MCP サーバーを追加する場合は、.mcp.json を直接編集するか、CLI で追加します。

CLI で追加する場合

# HTTP サーバーの追加（プロジェクトスコープ）
claude mcp add --transport http --scope project <name> <url>

# stdio サーバーの追加
claude mcp add --transport stdio --scope project <name> -- <command> <args...>

設定例: stdio 方式

{
  "mcpServers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--yes",
        "@modelcontextprotocol/server-filesystem",
        "/home/user/project"
      ],
      "env": {}
    }
  }
}

設定例: HTTP 方式

{
  "mcpServers": {
    "remote-api": {
      "type": "http",
      "url": "https://api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MCP_API_TOKEN}"
      }
    }
  }
}

接続確認とトラブルシューティング

# MCP サーバーの接続状態を確認
claude mcp list

世の中の主要な MCP サーバー

公式リファレンスサーバー

github.com/modelcontextprotocol/servers で提供されている公式実装です。

エンタープライズ・主要プラットフォーム

データベース

オブザーバビリティ・監視

開発・DevOps ツール

プロダクティビティ・連携

統合プラットフォーム

セキュリティ上の注意点

参考リンク