Claude Code × MCPサーバー活用ガイド — 外部ツールと繋がる力

Claude Codeはファイル操作やコマンド実行だけでなく、GitHub、データベース、Slack、Sentryなど外部のツールやサービスとも連携できることをご存知ですか？

それを実現するのが「MCP（Model Context Protocol）」です。MCPサーバーを接続するだけで、Claudeが外部ツールをまるで自分の手足のように使えるようになります。

MCPの仕組み

MCPの基本構造はシンプルです。「MCPクライアント」（Claude Code）が「MCPサーバー」（各種ツール）に接続し、サーバーが提供する「ツール」をClaudeが呼び出します。

┌─────────────┐     MCP Protocol      ┌─────────────┐
│ Claude Code │ ◄──────────────────► │ MCPサーバー  │
│ (クライアント) │                      │ (GitHub等)   │
└─────────────┘                      └──────┬──────┘
                                            │
                                     ┌──────▼──────┐
                                     │  外部サービス │
                                     │ (API/DB等)   │
                                     └─────────────┘

MCPサーバーは3つの機能を提供できます。

• ツール（Tools）: Claudeが呼び出せるアクション。例：GitHub PRの作成、データベースクエリの実行
• リソース（Resources）: @mentionsで参照できるデータ。例：GitHubイシュー、DBスキーマ
• プロンプト（Prompts）: 事前定義されたコマンド。/mcp__サーバー名__コマンド名で実行

MCPサーバーの追加方法

MCPサーバーの追加はCLIコマンド一発です。

HTTPサーバーの追加（クラウドサービス向け）

# GitHub MCPサーバーを追加
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Sentry（エラー監視）を追加
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 認証ヘッダー付きで追加
claude mcp add --transport http stripe https://mcp.stripe.com/mcp \
  --header "Authorization: Bearer $STRIPE_API_KEY"

Stdioサーバーの追加（ローカルツール向け）

# PostgreSQLデータベース接続
claude mcp add --transport stdio db \
  --env DATABASE_URL="postgresql://user:pass@localhost/mydb" \
  -- npx -y @bytebase/dbhub

# Puppeteer（ブラウザ自動操作）
claude mcp add --transport stdio browser \
  -- npx -y @modelcontextprotocol/server-puppeteer

# カスタムPythonサーバー
claude mcp add --transport stdio custom \
  -- python /path/to/my-server.py

設定ファイルに直接記述する方法

CLIの代わりに、設定ファイルに直接JSONを記述することもできます。

// .mcp.json（プロジェクトルートに配置、チームで共有可能）
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub"],
      "env": {
        "DATABASE_URL": "${DB_URL}"
      }
    }
  }
}

設定ファイルの場所と優先順位

MCP設定は4つのレベルで管理されます。

# マネージド設定（企業管理、最高優先度）
/etc/claude-code/managed-mcp.json          # Linux
C:\Program Files\ClaudeCode\managed-mcp.json  # Windows

# プロジェクト設定（チーム共有、gitコミット可能）
.mcp.json

# ユーザー設定（個人用、全プロジェクト共通）
~/.claude.json

# ローカル設定（個人用、プロジェクト固有）
~/.claude.json 内のプロジェクト別セクション

人気のMCPサーバー

2026年4月現在、5,000を超えるコミュニティMCPサーバーが公開されています。ここでは特に有用なサーバーを紹介します。

開発ツール系

# GitHub — PR、イシュー、コードレビュー
claude mcp add --transport http github \
  https://api.githubcopilot.com/mcp/

# Sentry — エラー監視、スタックトレース分析
claude mcp add --transport http sentry \
  https://mcp.sentry.dev/mcp

データベース系

# PostgreSQL / MySQL — データベースクエリ、スキーマ確認
claude mcp add --transport stdio db \
  --env DATABASE_URL="postgresql://user:pass@localhost/mydb" \
  -- npx -y @bytebase/dbhub

データベースMCPサーバーを使えば、「先月の売上トップ10の商品を教えて」といった自然言語でSQLクエリを実行できます。読み取り専用のアカウントで接続すれば安全です。

ブラウザ自動操作

# Puppeteer — ブラウザ操作、スクリーンショット
claude mcp add --transport stdio browser \
  -- npx -y @modelcontextprotocol/server-puppeteer

コミュニケーション系

# Notion — データベース、ページ管理
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Slack — チャンネル参照、メッセージ送信
# （Slackの公式MCPエンドポイントは問い合わせが必要）

MCPサーバーの管理

MCPサーバーの日常的な管理に使うコマンドを紹介します。

# サーバー一覧の確認
claude mcp list

# 特定サーバーの詳細
claude mcp get github

# サーバーの削除
claude mcp remove github

# Claude Desktopから設定をインポート
claude mcp add-from-claude-desktop

# JSON形式で直接追加
claude mcp add-json myserver '{"type":"http","url":"https://api.example.com/mcp"}'

# プロジェクトのMCP承認をリセット
claude mcp reset-project-choices

/mcp コマンド

Claude Codeのセッション内で/mcpと入力すると、接続中のMCPサーバーの管理画面が開きます。

# Claude Codeのプロンプトで
> /mcp

ここから以下の操作ができます。

• 接続中のサーバー一覧の確認
• OAuth認証の実行（ブラウザが開く）
• 認証トークンのクリア
• 利用可能なツールの確認

MCPツールサーチ — コンテキストの節約術

MCPサーバーを複数接続すると、全てのツール定義がClaudeのコンテキストを消費します。50以上のツールで約77,000トークンにもなることがあります。

この問題を解決するのが「ツールサーチ」です。2026年からデフォルトで有効になっています。

セキュリティの注意点

MCPサーバーは外部との通信を行うため、セキュリティは特に重要です。

守るべきルール

• 信頼できるサーバーのみ追加: 公式リポジトリや著名な開発者のサーバーを選ぶ
• APIキーをファイルに直書きしない: ${VAR}で環境変数を参照する
• .mcp.jsonをレビューしてから実行: gitからpullした他人の.mcp.jsonは中身を確認する
• データベースは読み取り専用で接続: 書き込み権限のあるアカウントは避ける
• 不要なサーバーは削除: claude mcp removeで定期的に整理する

パーミッションによるアクセス制御

settings.jsonでMCPツールの使用を許可・拒否できます。

// .claude/settings.json
{
  "permissions": {
    "allow": [
      "MCP(github *)",
      "MCP(sentry *)"
    ],
    "deny": [
      "MCP(curl *)",
      "MCP(fetch external-api.com)"
    ]
  }
}

MCP・Hooks・Skillsの使い分け

Claude Codeには拡張機能が3つあります。それぞれの役割を整理しましょう。

まとめ

MCPサーバーは、Claude Codeを「閉じたコーディングツール」から「あらゆるサービスと連携する自動化ハブ」へと変える強力な仕組みです。

• USBのような共通規格: GitHubからデータベースまで、MCPで統一的に接続
• コマンド一発で追加: claude mcp addで簡単セットアップ
• 5,000以上のサーバー: 開発ツール、DB、コミュニケーション、監視など豊富なエコシステム
• ツールサーチで95%節約: 大量のツールを接続してもコンテキストを圧迫しない
• Hooks・Skillsと組み合わせ: 3つの拡張機能で開発ワークフロー全体を自動化

まずはclaude mcp add --transport http github https://api.githubcopilot.com/mcp/でGitHub MCPを試してみてください。「こんなことまでClaude Codeでできるのか」という新しい体験が待っています。