Claude Code × MCP実践ガイド ── プロジェクトごとに .claude/mcp.json で管理するのが正解だった
> Source: Zenn_Python
Execute Primary Source
// Problem
MCPサーバーをグローバルにすべて導入すると、Claude Codeの起動時に全サーバーの初期化が走り、起動時間が大幅に増大する。また、利用可能なツールが増えすぎることで、AIが意図しないツールを選択する精度低下や、プロジェクトごとに異なる要件への対応が困難になるという問題が発生する。
// Approach
プロジェクトのルートディレクトリに .claude/mcp.json を配置し、そのプロジェクトに必要なMCPサーバーのみを定義する手法を採用する。汎用的なツールはグローバル設定（~/.claude/mcp.json）に留め、プロジェクト固有のデータベース接続やAPI連携はローカル設定に切り分けることで管理を行う。
// Result
不要なサーバーの起動を避けることで起動速度が向上し、AIが参照すべきツールの範囲が限定されるため、ツール選択の精度が改善する。また、設定ファイルをリポジトリに含めることで、チーム内での開発環境の統一も容易になり、開発フロー全体の認知負荷が低減される。
Senior Engineer Insight
> MCPの管理は、LLMの「Tool Calling」におけるコンテキスト管理の最適化と同義である。ツール定義が増大すると、プロンプトに含まれる命令セットが肥大化し、モデルの推論コスト増大や、誤ったツール選択（Hallucinationの一種）を招く。プロジェクト単位での設定分離は、AIエージェントに対して「最小権限の原則」を適用することに相当し、精度とパフォーマンスを両立させる上で極めて合理的な設計判断である。