Claude CodeでMCPを使いこなす完全ガイド：設定から活用まで

Claude CodeでMCPを使うと、何が変わるのか

• 課題管理（JIRAのissueを読んで実装、GitHubのPRを作成）
• 監視・分析（Sentryのエラーログを確認、SentryとStatsigを横断して分析）
• データベース操作（PostgreSQLに直接クエリを実行）
• デザイン連携（FigmaのデザインをSlackから取得してコードに反映）
• ワークフロー自動化（Gmailで特定ユーザーへの招待メールを下書き作成）
• 外部イベントへの反応（Telegramのメッセージ、CI結果、Webhookへの自動応答）

MCPの「スコープ」概念を理解する

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

MCPサーバーを追加する3つの方法

# Option 1: リモートHTTPサーバー（推奨）
claude mcp add --transport http <名前> <URL>

# 例: Notionに接続
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Bearerトークン付き
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# Option 2: リモートSSEサーバー（非推奨・廃止予定）
# 可能であればHTTPに移行を推奨
claude mcp add --transport sse <名前> <URL>

# Option 3: ローカルstdioサーバー（ローカルプロセスとして動く）
claude mcp add [オプション] <名前> -- <コマンド> [引数...]

# 例: Airtableサーバーを追加
claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \
  -- npx -y airtable-mcp-server

# Windows環境でのstdioサーバー追加例
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

設定を管理するコマンド一覧

# 設定済みのサーバー一覧
claude mcp list

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

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

# Claude Code起動中にサーバーの状態確認
/mcp

MCP Tool Searchでコンテキスト問題を解決する

従来の問題:

• セッション開始時に全MCPツールの定義がコンテキストに読み込まれる
• MCPサーバーを増やすほどコンテキストが圧迫される
• 長い対話ほど使えるコンテキストが減っていく

Tool Search導入後:

• セッション開始時はツール名だけ読み込む（定義は遅延ロード）
• Claudeが必要なタイミングで検索して該当ツールだけコンテキストに入れる
• MCPサーバーをいくら増やしても初期コンテキスト消費はほぼゼロ

実践：人気のMCPサーバーを追加してみる

Sentry（エラー監視）との連携

# Sentryを追加
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# OAuth認証
/mcp

認証後はこういった指示が自然言語で出せるようになります。

直近24時間の主要エラーを確認して
エラーID abc123 のスタックトレースを見せて
どのデプロイでこの新しいエラーが発生し始めたか調べて

GitHub（コードレビュー・Issue管理）との連携

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

# OAuth認証
/mcp

PR #456をレビューして改善点を提案して
今見つけたバグ用のissueを作成して
自分にアサインされているPR一覧を表示して

PostgreSQLデータベースとの連携

# PostgreSQLを追加（読み取り専用ユーザーを推奨）
claude mcp add --transport stdio db -- npx @bytebase/dbhub@latest --transport stdio --dsn "postgresql://readonly:[email protected]:5432/analytics"

今月の総売上は？
ordersテーブルのスキーマを表示して
90日間購入がないユーザーを抽出して

リモートMCPサーバーの認証を設定する

1. サーバーを追加: claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
2. セッション内で /mcp を実行
3. ブラウザが開くのでログイン
4. 認証トークンは自動で保存・更新される

# コールバックポートを固定して追加
claude mcp add --transport http \
  --callback-port 8080 \
  my-server https://mcp.example.com/mcp

claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

Claude CodeをMCPサーバーとして使う

# Claude CodeをstdioのMCPサーバーとして起動
claude mcp serve

Claude Desktopで使う場合は claude_desktop_config.json にこう書きます。

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

# フルパスを調べるコマンド
which claude

調べたパスを設定に使います。

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "/full/path/to/claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

Claude.aiのMCPサーバーをClaude Codeで使う

Claude Codeで /mcp を実行すると、claude.aiから来たサーバーはその旨が表示されます。

# claude.ai MCPサーバーを無効化する場合
ENABLE_CLAUDEAI_MCP_SERVERS=false claude

Claude Desktopから設定をインポートする

claude mcp add-from-claude-desktop

JSON設定でMCPサーバーを追加する

# 基本構文
claude mcp add-json <名前> '<JSON設定>'

# HTTPサーバーの例
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# stdioサーバーの例
claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

# OAuth付きHTTPサーバー
claude mcp add-json my-server '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' --client-secret

MCP出力の上限と大量データの扱い

# MCP出力上限を50,000トークンに設定
export MAX_MCP_OUTPUT_TOKENS=50000
claude

# 起動タイムアウトを10秒に設定
MCP_TIMEOUT=10000 claude

「MCPはコンテキストを食いすぎる」問題の現在地

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "/opt/bin/get-mcp-auth-headers.sh"
    }
  }
}

動的なツール更新とチャンネル機能

チームやエンタープライズでのMCP管理

Option 1: 排他的制御（managed-mcp.json）

• IT管理者が設定したMCPサーバーのみ使用可能
• ユーザーが自分でMCPを追加することを禁止できる

Option 2: ポリシーベース制御（allowlist/denylist）

• allowedMcpServers: 使用を許可するサーバーのリスト
• deniedMcpServers: 使用を禁止するサーバーのリスト
• ユーザーによる追加は可能だが、許可リストのものだけ動く

人気MCPサーバー詳解：開発現場でよく使われる連携パターン

ブラウザ・Webスクレイピング系

# Brave Search MCPを追加（APIキーが必要）
claude mcp add --transport stdio brave-search \
  --env BRAVE_API_KEY=your-api-key \
  -- npx -y @modelcontextprotocol/server-brave-search

Figma・デザイン系

AWS・クラウドインフラ系

# AWS Documentation MCPを追加
claude mcp add aws-documentation-mcp-server uvx "awslabs.aws-documentation-mcp-server@latest"

Context7：ドキュメント最新情報を取得する

# Context7 MCPを追加
claude mcp add --transport http context7 https://mcp.context7.com/mcp

Sequential Thinking MCP：複雑な問題に段階的に取り組む

ローカルMCPの設定ファイルを直接書く

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    }
  }
}

{
  "mcpServers": {
    "github_work": {
      "command": "docker",
      "args": ["-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_WORK_TOKEN}"
      }
    },
    "github_personal": {
      "command": "docker",
      "args": ["-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_TOKEN}"
      }
    }
  }
}

Remote MCPを自作する

Dify経由（ノーコード）:

• DifyのワークフローをそのままリモートMCP化
• コードを書かずに既存のDifyフローを公開できる
• 素早くPoCを作るときに有効

Cloudflare Workers（コードあり）:

• より柔軟で複雑な処理が可能
• HTTP/SSEのリモートMCPサーバーを作れる
• 本番環境での運用に向く

MCPサーバーが動かないときのトラブルシューティング

よくある問題と対処法

問題1: サーバーが接続されない（Connection closed）

# 設定確認
claude mcp list
claude mcp get <サーバー名>

原因として多いのは:

• Windowsでnpx使用時に cmd /c が抜けている
• claude コマンドのフルパスが通っていない（Claude CodeをMCPサーバー化する場合）
• 環境変数が設定されていない

問題2: MCPが認識されているが使えない

/mcp コマンドでサーバーの状態が Connected になっているか確認します。認証が必要なサーバーは Authenticate の選択肢が出ます。

問題3: 出力が大きすぎて警告が出る

# 出力上限を増やす
export MAX_MCP_OUTPUT_TOKENS=50000
claude

10,000トークンを超えるとClaude Codeが警告を出します。データベースの大量クエリや詳細なレポートを扱う場合は上限を調整してください。

問題4: .mcp.json の環境変数が展開されない

環境変数が未設定の場合、デフォルト値のない ${VAR} の展開に失敗してClaude Codeが設定ファイルのパースに失敗します。.zshrc や .bashrc でシェルに環境変数を設定してから起動するのが確実です。

問題5: project scopeのMCPサーバーが承認を求める

project scope（.mcp.json）のサーバーは、セキュリティの観点からClaude Codeが初回起動時に承認を求めます。承認の選択をリセットしたい場合は:

claude mcp reset-project-choices

まとめ

• スコープを正しく選ぶ: チーム共有はproject（.mcp.json）、個人設定はlocal/user、APIキーはgitに上げない
• Transport方式を選ぶ: クラウドサービスはHTTP（推奨）、ローカルツールはstdio
• Tool Searchを活かす: デフォルトで有効、コンテキスト消費を抑えつつ多くのMCPサーバーを使える

---

出典

• Connect Claude Code to tools via MCP - Anthropic公式ドキュメント