AI News HubLIVE
サイト内リライト2 分で読了

MCPサーバーをClaude(Claude DesktopおよびClaude Code)に接続する方法

この記事では、MCP(Model Context Protocol)サーバーをClaude DesktopとClaude Codeに接続する方法を詳しく説明します。Claudeが外部ツール、ファイル、データベースなどと連携できるようになります。デスクトップ版の2つの設定方法(ワンクリック拡張機能とJSON設定)とClaude CodeのCLIコマンド設定をカバーし、一般的なエラー修正や推奨サーバーも紹介します。

ソースAnalytics Vidhya著者: Sree Vamsi

MCP(Model Context Protocol)は、Anthropicが開発した汎用コネクタレイヤーで、AIモデルと外部ツールの統合における「N×M問題」を解決します。MCPを使用すると、外部ツールごとに1つのMCPサーバーを構築するだけで、Claude Desktop、Claude Code、CursorなどMCP互換のAIクライアントが即座に利用できます。この記事では、MCPサーバーをClaude DesktopとClaude Codeに接続する方法をステップバイステップで解説します。

MCPの仕組み

MCPアーキテクチャは3つのコンポーネントで構成されます:ホスト(Claude DesktopなどのAIアプリ)、クライアント(プロトコル通信を担当)、サーバー(ツールやリソースを提供)。ユーザーが外部ツールを必要とするリクエストを送ると、Claudeはクライアントを介してMCPサーバーにJSON-RPCリクエストを送信し、サーバーが処理してデータを返します。この流れは1秒未満で完了します。

Claude DesktopでのMCP設定

Claude Desktopでは2つのインストール方法があります。

方法1:デスクトップ拡張機能(ワンクリックインストール) 2026年初めに導入されたデスクトップ拡張機能(.mcpbファイル)はJSON編集不要です。チャット入力欄の左下にある「+」ボタンをクリックし、「Connectors」を選択、目的のサーバーを見つけてインストールし、Claude Desktopを再起動するだけです。

方法2:JSON設定(フルコントロール) 設定ファイルはclaude_desktop_config.jsonで、場所はOSとインストール方法によって異なります:

  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows(.exeインストール):%APPDATA%\Claude\claude_desktop_config.json
  • Windows(MSIXインストール):%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

ファイルが見つからない場合は、Claude Desktopの「Settings」→「Developer」→「Edit Config」で作成できます。Windowsではパス内のバックスラッシュをエスケープする必要があります。

設定ファイルの基本構造:mcpServersキーの下にサーバーエントリを追加します。各エントリにはcommand(通常npx)、args(引数)、env(環境変数)を含めます。ファイルシステムサーバーは認証不要、GitHubサーバーは個人アクセストークン、Brave SearchはAPIキーが必要です。

Claude CodeでのMCP設定

Claude CodeではCLIコマンドclaude mcp addでサーバーを追加します。ローカルサーバーは--transport stdio、ホストサーバーは--transport httpを使用します。例えばPostgreSQLを追加する場合:

claude mcp add --transport stdio project-db -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost:5432/mydb

設定範囲はローカル(デフォルト)、プロジェクト(.mcp.json、チーム共有)、ユーザー(グローバル)の3つがあります。

推奨サーバーと一般的な問題 まずはファイルシステム、GitHub、Brave Searchなどのサーバーをインストールすることをお勧めします。よくあるエラーとしては、パスの誤り、権限不足、APIキーの無効などがあります。設定を確認して正しく構成してください。