この付録は、第1章「MCPを30分で体験する」の補足資料です。環境構築でつまずいた場合や、より詳しい情報が必要な場合にご参照ください。

環境別トラブルシューティング

よくある問題と解決方法

🆘 困ったときは

このセクションで解決しない場合は：

1. エラーメッセージをそのままコピーして検索
2. ChatGPTやClaudeに質問（エラー内容を貼り付け）
3. 公式ドキュメントを確認
4. コミュニティフォーラムで質問

Python関連

❌ 問題: python: command not found ✅ 解決策:

• Windows: Pythonインストール時に「Add Python to PATH」を選択し、再インストール
• Mac/Linux: python3コマンドを試すか、上記のパッケージマネージャーでインストール

❌ 問題: pip: command not found ✅ 解決策:

# Mac/Linuxpython3 -m ensurepip --upgrade# Windowspython -m ensurepip --upgrade

Node.js関連

❌ 問題: node: command not found ✅ 解決策:

• 公式サイト（nodejs.org）から最新LTS版をダウンロードしてインストール
• Mac: brew install node
• Linux: sudo apt install nodejs npm (Ubuntu/Debian)

Claude Desktop設定関連

❌ 問題: MCPサーバーが認識されない ✅ 解決策:

1. パス区切り文字を確認（Windows: \\\\, Mac/Linux: /）
2. JSON構文エラーを確認（カンマ、括弧の対応）
3. Claude Desktopを完全に終了（ファイル→終了）してから再起動

❌ 問題: ファイルが見つからないエラー ✅ 解決策:

1. プロジェクトフォルダが正しい場所にあるか確認
2. ファイル名の大文字・小文字を確認（Linuxは区別する）
3. 絶対パスでの記述を試す

文字エンコーディング関連

❌ 問題: 日本語ファイル名が文字化けする ✅ 解決策:

• Windows: システムロケールをUTF-8に設定
• ターミナル/コマンドプロンプトのエンコーディングをUTF-8に変更
• ファイル作成時にUTF-8を明示的に指定

プラットフォーム別推奨設定

Windows

• ターミナル: PowerShell または Windows Terminal
• エンコーディング: UTF-8
• パス記法: C:\\\\MCP_Learning 形式