04 MCPModel Context Protocol（エムシーピー）の略。AIに外部ツール（検索・GitHub・データベース等）を繋ぐための共通接続規格。USBのような「差せば繋がる」仕組みでAIの能力を拡張するサーバー — 外部ツールの統合

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トークンAIにとっての「文字数」のようなもの。AIは文章をトークンという小片に区切って処理する。課金や入力上限（コンテキストウィンドウ）はこの単位で数えられる）

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

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

MiniMax-M3 の context_window 設定（2026-07-12追加）

MINIMAX M3は1Mトークン対応だが minimax-mcp-server.py に CONTEXT_WINDOW 設定が存在しない場合、llm-status.sh が正しい context_window を認識できない。ステータスライン（/tmp/llm-last-used.txt）への書き込みを 🟠 MiniMax-M3|ctx:1000000 に変更することで1M認識を実現する。

MINIMAX_KEY = _load_key()
MINIMAX_URL = 'https://api.minimax.io/anthropic/v1/messages'
MODEL = 'MiniMax-M3'
CONTEXT_WINDOW = 1_000_000

トリガー: minimax-mcp-server.py 起動時・コンテキスト%表示

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

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

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

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

MiniMax公式MCPサーバー（動画生成専用・従量 Cash$ アカウント）。minimax-official と同じバイナリ（公式パッケージ配布・インストール可能な形にまとめたソフトウェアの単位。Pythonではpipで入れる部品のこと minimax-mcp）だが、APIApplication Programming Interface（エーピーアイ）の略。あるプログラムの機能を、別のプログラムから呼び出せるようにした「窓口」キー（従量課金アカウント）と出力先を分離した別サーバー。official（無料枠）と使い分けることで、動画生成を大量利用しても無料枠を消費しない。

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

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

同一の minimax-mcp バイナリを2本起動し、環境変数プログラムの外側（OS側）で設定する値の入れ物。プログラムを書き換えずに設定を切り替えられる。APIキー等の秘密の値はソースコードに直書きせずここに入れるのが安全な定石で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。
• Windows Desktop版の場合: 2026-07-06実測時点では~/.claude/settings.jsonを編集しても反映されなかった（実際に読まれていたのはAppData\Local\Packages\<Claudeのパッケージフォルダ>\LocalCache\Roaming\Claude\claude_desktop_config.json＝サンドボックス化パッケージキャッシュ一度得た結果を取っておいて、次回は同じ計算をせず使い回す仕組み。速くなるが、元のデータが変わった時の更新忘れに注意内、command: "wsl", args: ["-d", "Ubuntu", "--", "bash", "/home/<USER>/.claude/scripts/mcp/start-gemini-mcp.sh"]の形式）。⚠️ただしこれは2026-05時点の調査では別ファイルが有効に見えていた実績もあり、アプリ更新で今後また変わりうるため「ここが正解」と決め打ちしない。追加・変更のたびに下記「トラブルシューティング」節の確認手順で都度検証すること。事例は01_DECISIONS/claude-code/2026-07-06_Windows-Desktop版Gemini-MCP真因確定-MSIXconfig特定.md参照。

🔍 検索・情報取得系（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.3/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/月

セットアップ: 公式プラグイン本体に後から差し込んで機能を足す追加部品。Claude Codeにもプラグイン機構がある方式で導入（手動の url + headers + env 設定は非推奨 — ${VAR} 変数展開$HOME のように変数名が書かれた場所を、実際の値に置き換えることが動作しない場合あり）

/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キーを読み込むラッパース文字で書かれたデータを、プログラムが扱える構造に変換すること。JSONパース＝JSON文字列→データ構造クリプト経由で起動する。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 — サンドボックス化パッケージキャッシュ内（2026-06・2026-07の2回の実測ではMicrosoft Store版で使われるのはここだった）

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

最も手軽な確認手順は、設定画面（設定 → 開発者 → ローカルMCPサーバー）で「設定を編集」ボタンを押し、開いたエクスプローラーが指すファイルパスをそのまま使うこと（2026-07-06のgemini追加でこの手順に気づくまで、無関係な古いclaude_desktop_config.jsonを編集し続けて2回再起動しても直らない、という事故を繰り返した）。

詳細な調査の経緯: 01_DECISIONS/claude-code/2026-06-07_minimax-official-MCP接続トラブル解決と動画生成成功.md（初出・minimax-official）、01_DECISIONS/claude-code/2026-07-06_Windows-Desktop版Gemini-MCP真因確定-MSIXconfig特定.md（再発・gemini・「設定を編集」ボタンでの特定手順を確立）

トラブルシューティング: 「設定ファイルの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（webhookClaude Codeの特定のタイミング（ツール実行前後・セッション開始時等）で自動処理を差し込む仕組み。「保存前にチェック」「終了時に記録」等を機械的に強制できる）で代替でき、MCPを切れる。

判断基準：

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

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

MCPサーバーのユニットテスト（gemini / glm / MiniMax）

自作MCPサーバー3本（gemini-mcp-server.py / glm-mcp-server.py / minimax-mcp-server.py）には 常駐サーバーの契約を固定するユニットテスト が併設されている（2026-08-18 gemini版に倣って glm / MiniMax版を追加）。これらは urllib をモックテスト用の「偽物」。本物の代わりに決まった値を返すようにして、テスト対象だけを確実に検査できるようにするし実API不要 で、glm MCP / MiniMax MCP に依存するスキルClaude Codeで「特定の作業手順」をパッケージ化したもの。SKILL.mdに手順を書いておくと、対応する場面でAIがその手順を読み込んで従う。経験を再利用する仕組みが全滅しないよう契約（関数一連の処理をまとめて名前を付けたもの。呼び出すたびに同じ処理が実行される。プログラムの基本単位名・引数コマンドや関数に渡す補足の指定。ls -la の -la の部分のように、動作を細かく指示する値・戻り値の型）を担保する。

使いどころ: 自作MCPのサーバー実装を改修した時の回帰検知、.secrets.env のキー追加で _load_key の探索経路が変わった時の確認（01_DECISIONS/claude-code/2026-08-22__load_secret本番経路Windows側で鍵を読めない の修正と同種の検証基盤）。

MCPツール使い分けガイド

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

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

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