04 MCPサーバー — 外部ツールの統合

MCPとは

MCP（Model Context Protocol） は、Claude Codeから外部ツールを利用するための仕組み。

Claude Code
  │
  ├─ brave-search MCP ──→ Brave検索API ──→ Web検索結果
  ├─ github MCP ────────→ GitHub API ──→ PR・Issue・ファイル
  ├─ playwright MCP ────→ Chromium ──────→ ブラウザ操作
  ├─ context7 MCP ──────→ Docs API ─────→ ライブラリドキュメント
  ├─ discord MCP ───────→ Discord API ──→ メッセージ送受信
  ├─ mermaid MCP ───────→ Mermaid API ──→ 図表生成
  ├─ exa MCP ───────────→ Exa API ──────→ セマンティック検索
  ├─ minimax MCP ───────→ MiniMax API ──→ テキスト処理（コスト削減）
  ├─ minimax-official ──→ MiniMax API ──→ 画像・音楽・動画生成
  ├─ minimax-video ─────→ MiniMax API ──→ 動画生成（従量課金）
  ├─ 4_5v_mcp ──────────→ 画像分析AI ───→ 画像診断・UI模写
  └─ web_reader ────────→ URL取得 ──────→ WebページMarkdown化

MCPサーバーを追加すると、Claude Codeがそのサーバーのツールを使えるようになる。各ツールはコンテキストを消費するため、必要なものだけを維持する。

現在の構成（13サーバー・126ツール）

MCPサーバー数が多いため、4つのカテゴリに整理しています。目的のサーバーを探す場合は📑 目次からジャンプしてください。

📑 サーバー一覧（目次）

• 🤖 LLM・生成AI系（4サーバー） — minimax / minimax-official / minimax-video / gemini
• 🔍 検索・情報取得系（4サーバー） — brave-search / exa / context7 / web_reader
• 🛠️ 開発・自動化系（4サーバー） — github（無効化）/ playwright / discord / mermaid
• 📊 画像分析系（1サーバー） — 4_5v_mcp

🤖 LLM・生成AI系（4サーバー）

minimax（自作テキスト処理 / 17ツール / ~1kトークン）

LLM委譲用MCPサーバー（自作・MiniMax-M3使用）。環境によって役割が異なる。

使いどころ: 要約・フォーマット変換・テストデータ生成・メール文面・キーワード抽出など大量処理タスク。

minimax-official（公式 / 画像・音楽・動画・10ツール）

MiniMax公式MCPサーバー。画像・音楽・動画・音声などのメディア生成機能を提供する。自作の minimax（テキスト処理特化）とは別サーバー。

使いどころ: 「〇〇の動画を生成して」「画像を作って」「BGMを生成して」など、メディア生成タスク全般。 出力先: ~/minimax-output/（WSL内）に自動保存される。

minimax-video（公式 / 動画生成専用・従量課金）

MiniMax公式MCPサーバー（動画生成専用・従量 Cash$ アカウント）。minimax-official と同じバイナリ（公式パッケージ minimax-mcp）だが、APIキー（従量課金アカウント）と出力先を分離した別サーバー。official（無料枠）と使い分けることで、動画生成を大量利用しても無料枠を消費しない。

使いどころ: 動画生成を大量に行いたい場合。official の無料枠とは課金体系が独立しているため、動画専用に従量アカウントを分けて運用する。

minimax系のセットアップ（公式2サーバー）

同一の minimax-mcp バイナリを2本起動し、環境変数でAPIキーとアカウントを切り替えてコスト分離する構成。

使い分けのポイント: 同一バイナリのため generate_video 等が両サーバーに生える。動画生成時は必ず mcp__minimax-video__generate_video を使う（minimax-official は Token Plan の動画 quota が枯渇するため）。

• サーバー登録は claude mcp add -s user で ~/.claude.json（userスコープ）へ。settings.json の mcpServers は読まれないので注意（2026-06-15検証済み・下記トラブルシューティング「2層問題」参照）。

  claude mcp add minimax-video -s user -- bash ~/.claude/scripts/mcp/start-minimax-video-mcp.sh
  

• 起動スクリプト: ~/.claude/scripts/mcp/start-minimax-official-mcp.sh / start-minimax-video-mcp.sh
• 鍵管理: ~/.secrets.env の MINIMAX_API_KEY（無料枠）/ MINIMAX_API_KEY_VIDEO（従量）

注意: MCP接続は起動時確立のため、設定変更後は Claude Code の再起動が必要。

gemini（自作 / レビュー第2オピニオン / 1ツール）

Gemini（無料枠）をコードレビュー・デバッグの第2オピニオンとして呼び出す自作MCPサーバー。GLM/Sonnetとは異なるモデルの視点でコードのバグ・論理エラー・境界ケースを指摘させる用途。

使いどころ: GLM自身のレビューで不安がある時・設計判断を別モデルの視点で検証したい時。「このコードをGeminiにレビューして」等。GLM/Sonnetとは異なるモデルの目を通すことで、見落としを拾う。

セットアップ:

• サーバー登録は claude mcp add -s user で ~/.claude.json（userスコープ）へ。settings.json の mcpServers は読まれない（minimax系と同じ注意点・上記「2層問題」参照）。

  claude mcp add gemini -s user -- bash ~/.claude/scripts/mcp/start-gemini-mcp.sh
  

• 鍵管理: ~/.secrets.env の GEMINI_API_KEY（launcher が source するため env ブロック不要）
• 認証の落とし穴: Gemini REST API は x-goog-api-key ヘッダー（or ?key=）が必須。欠けると 403 Forbidden。

🔍 検索・情報取得系（4サーバー）

brave-search（6ツール / ~5.5kトークン）

Web検索に関する各種機能。

使いどころ: 最新情報の調査、エラーの検索、技術記事の検索

exa（3ツール / ~1.5kトークン）

セマンティックWeb検索。

使いどころ: 技術記事の深掘り調査、コード検索

context7（2ツール / ~1.2kトークン）

ライブラリの公式ドキュメント検索。

使いどころ: ライブラリの最新API確認、使用方法の調査

web_reader（1ツール / ~0.5kトークン）

URL内容取得。

使いどころ: Webページ内容の取得、ドキュメント読み込み

🛠️ 開発・自動化系（4サーバー）

github（41ツール / ~9.6kトークン・無効化）

最もツール数が多いサーバー。GitHub上のあらゆる操作が可能。

使いどころ: PR作成、Issue管理、コード検索、リポジトリ操作

playwright（25ツール / ~4.7kトークン）

ブラウザの自動操作。

使いどころ: Webアプリのテスト、UI確認、スクレイピング

discord（5ツール / ~0.6kトークン）

Discordとの連携。

使いどころ: Discord経由での通知、メッセージ監視

mermaid（4ツール / ~0.4kトークン）

図表の生成。

使いどころ: フローチャート、シーケンス図、クラス図の生成

📊 画像分析系（1サーバー）

4_5v_mcp（画像分析 / ~0.8kトークン）

AI画像分析。

使いどころ: スクリーンショット診断、UI模写、図解理解

環境別の対応（WSL CLI / Windows Desktop）

一部のMCPサーバーは実行環境によって役割・有無が異なる：

glm（Windows Desktop版用 / WSL CLI版では不要・自作 / ~1kトークン）

LLM委譲用MCPサーバー（自作・GLM-5.2/Z.AI API）。WSL CLI版では不要のため「現在の構成（実態12サーバー）」には含まれない。Windows Desktop版でのみ有効。

使いどころ: Windows Desktop版でコード生成・レビュー・説明など開発全般の処理をGLMに委譲したい場合。 注意（Windows Desktop版）: ZAI APIキーが設定されていないと接続不可。 注意（WSL CLI版）: glm-rate-proxyが起動していないと接続不可（ただし実際には呼び出す必要がない）。→ 13_glm-rate-proxy

zernio（導入済み・現在未接続 / ホストMCP / 280+ツール）

SNS自動投稿MCP。Instagram/TikTok/X/Facebook/YouTube等15プラットフォーム対応。導入済み・投稿テスト済みだが、現在は未接続（必要時に再有効化）。

使いどころ: TikTok/Instagram等への自動投稿、SNS分析、投稿スケジュール管理

料金: 最初2アカウント無料 → 3つ目以降 $6/月

セットアップ: 公式プラグイン方式で導入（手動の url + headers + env 設定は非推奨 — ${VAR} 変数展開が動作しない場合あり）

/plugin marketplace add zernio-dev/zernio-claude-plugin
/plugin install zernio@zernio
# APIキー入力 → システムキーチェーンに保存

投稿テスト結果（2026-06-13）: 4プラットフォーム（Discord / Instagram / TikTok / YouTube）の下書き投稿・クロス投稿・一覧取得・削除まで全て正常動作を確認。即時投稿（publish_now=True）も利用可能。

セキュリティ: APIキーの管理

全MCPサーバーは ~/.secrets.env からAPIキーを読み込むラッパースクリプト経由で起動する。settings.jsonにAPIキーを直接記載しない。

settings.json
  └ command: "bash ~/.claude/scripts/mcp/start-<name>.sh"
       │
start-<name>.sh
  └ source ~/.secrets.env   ← APIキーはここから読み込む
  └ exec <本体スクリプト>

コンテキスト消費のトレードオフ

• GitHubが最も重い（41ツール = 全MCPの約3割）
• 以前は9サーバー（~35kトークン）だったが、使用頻度分析で最適化後、exa・画像分析・web_readerを追加
• クイックリファレンス: ガイドサイト - MCPサーバーカタログ

サーバーの追加・削除

追加

claude mcp add <サーバー名> -- <コマンド>

削除

claude mcp remove <サーバー名>

確認

claude mcp list

注意: settings.json だけでなく ~/.claude.json の両方から削除する必要がある場合がある（2ファイル問題）。

トラブルシューティング: 「設定したのに接続されない」（Windows Desktop版）

Windows Desktop版（特にMicrosoft Store版 / サンドボックス化されたインストール）でMCPサーバーを追加しても一向に接続されない場合、編集すべき設定ファイルを間違えている可能性が高い。候補は3つある：

1. C:\Users\<user>\.claude\settings.json — CLI/共通設定用
2. C:\Users\<user>\AppData\Roaming\Claude\claude_desktop_config.json — 通常版チャットアプリ用
3. C:\Users\<user>\AppData\Local\Packages\<Claudeのパッケージフォルダ>\LocalCache\Roaming\Claude\claude_desktop_config.json — サンドボックス化パッケージキャッシュ内（Microsoft Store版で実際に使われるのはここ）

判別方法: 既に動いている他のMCPサーバーのエントリの args（wsl -d Ubuntu -- bash <path> のようなコマンド形式）が、UI上の接続ログ（/mcp → サーバー詳細）に表示される実際の起動コマンドと一致しているファイルが「本物」。3つの候補に同名・類似のサーバーエントリがあっても、起動コマンドが実際のログと食い違っていれば、それは使われていない古いコピーである。

詳細な調査の経緯: 01_DECISIONS/claude-code/2026-06-07_minimax-official-MCP接続トラブル解決と動画生成成功.md

トラブルシューティング: 「設定ファイルの2層問題」（WSL CLI版）

WSL CLI版でMCPサーバーが Connection closed (-32000) になる場合、settings.json と .claude.json の両方にMCP定義があるか確認する。

どちらが使われているか: /mcp → サーバー選択 → 詳細画面の「Config location」で確認。

よくある原因:

診断コマンド:

# 両ファイルのMCP定義を確認（env値は非表示）
python3 -c "
import json
for path in ['.claude/settings.json', '.claude.json']:
    s = json.load(open(path))
    for name, cfg in s.get('mcpServers', {}).items():
        display = {k: v for k, v in cfg.items() if k != 'env'}
        print(f'{path} → {name}: {display}')
"

詳細: 01_DECISIONS/claude-code/2026-06-11_MCP設定2層問題と接続トラブル修正.md

MCPをスクリプトに置き換える（コンテキスト節約）

MCPサーバーは便利だが、常時起動するだけでコンテキストを消費する。 定型操作に限れば gh コマンドや curl（webhook）で代替でき、MCPを切れる。

判断基準：

• 「Claudeに話しかけながら操作したい」→ MCP を使う
• 「スクリプトで定型的に実行したい」→ gh コマンド / curl に置き換えてMCPを切る

→ GitHub の基本概念・gh コマンドの詳細は GitHub 基礎ガイド を参照

MCPツール使い分けガイド

詳細な使い分け基準は別ドキュメントを参照:

💡 やさしい補足（初心者向け）

• 「MCP」= Claudeに後付けする能力: 標準ではできない「Web検索」「GitHub操作」「ブラウザ操作」等を追加できる仕組み
• 追加しすぎると高くつく: 使っていなくても、追加した能力の「説明書」を毎回読み込むので毎回料金がかかる。使わないものは外すのが節約
• 公式と自作がある: 検索等の汎用なものは公式、特注なものは自作可能
• 迷ったら: よく使う機能だけ残す。不要なサーバーは思い切って外すのが一番の節約