ターミナルで動作する強力なAIエージェント「Claude Code」を使っていると、標準機能だけでなく、自分自身のファイルシステムやローカルツールを扱わせたくなることがありますよね。そんな時に非常に役立つ技術がModel Context Protocol(MCP)です。ローカルMCPサーバーを連携させることで、ターミナル環境に最適化された強力なカスタムアシスタントを構築できます。

設定方法は思ったよりもずっと簡単です。複雑な設定ファイルをいじる必要はなく、ターミナルでコマンドを1行入力するだけで、ローカルファイルシステム制御用のMCPサーバーをすぐに登録できます。

# 로컬 디렉터리를 탐색하는 파일 시스템 MCP 서버 추가
claude mcp add fs -- npx -y @modelcontextprotocol/server-filesystem /path/to/folder

このように追加した設定は~/.claude/settings.jsonに保存され、ユーザー単位で一括管理されます。もしチームプロジェクト単位で同じMCPサーバーを共有したい場合は、Gitリポジトリ内に.claude/settings.jsonファイルをコミットして共有することも可能です。接続状態が不安定な場合や、正しく連携されているか確認したい場合は、Claude Codeセッション内で/mcpコマンドを入力してみるか、実行時にclaude --mcp-debugオプションを付けることで簡単にデバッグできます。

1つコツとして、最近セキュリティが強化されたため、信頼できないリポジトリから取得したプロジェクトレベルのMCPサーバーは、ワークスペースの信頼（Workspace Trust）の承認を行うまで一時停止状態で待機します。ターミナル環境はシステム権限を直接扱える分、実行前に信頼できるサーバー構成かどうかを軽く確認する習慣を身につけることをおすすめします！