ClaudeのMCP設定入門｜DesktopとCodeで設定ファイルはどこに書くか

ClaudeでMCPを使ってみたい。そう思って調べ始めたものの、Claude DesktopとClaude Codeのどちらを使っているかで手順が分かれていて、自分がどこを読めばいいのか迷った人は少なくないはずです。MCP（Model Context Protocol＝AIと外部ツールをつなぐ共通規格）の説明は規格そのものの話に寄りがちで、「結局どの設定ファイルに何を書けばいいか」だけを知りたいときには回り道になります。

この記事では、Claude DesktopとClaude Codeそれぞれの設定手順を、設定ファイルの場所から反映確認までひとつの流れで示します。MCPの通信方式や規格の深掘りはMCPガイドに委ね、ここでは「どの製品を使っていて、どこに書くか」に絞ります。

Claude Codeのインストールがまだ済んでいない場合は、先にClaude Codeのインストールを済ませてください。Cursorですでに MCP を設定した人は、Claudeとは製品が違うため設定ファイルの場所も書き方も別物です。手順はCursorのMCP設定入門にまとめてあるので、本記事では扱いません。

今日の結論

• Claude の MCP 設定は「Desktop か Code かを決める → 設定ファイルに書く → 再起動して確認する」の3手順から始めます。まず自分がどちらの製品を使うかで手順が分かれます。
• Claude Desktop は設定ファイルに MCP サーバーを記述する方式が中心です。Claude Code はコマンドで追加する経路が中心になります。
• 設定値のうち API キーやトークン類は実値の扱いに注意が必要です。本記事の記入例はすべてプレースホルダで示しています。実値は公式の案内に沿って安全に設定してください。
• 反映されないときは、パス・書式・再起動の3点から見直すと原因を絞りやすくなります。
• MCP の仕組みや規格を理解したいときは MCPガイド へ、Cursor 側の設定は CursorのMCP設定入門 へ進んでください。本記事は Claude 側の設定手順に絞ります。

まず Desktop か Code かを決める（設定場所が違う）

Claudeという名前は同じでも、Claude Desktop（チャット画面のGUIアプリ）とClaude Code（ターミナルで動くCLIツール）はMCPの設定場所も書き方も別です。まずはどちらを使っているかを確認してください。

普段Claudeとチャット形式でやり取りしていて、そこにMCPサーバーの機能を足したいなら Claude Desktop 側の設定になります。ターミナルから claude コマンドでコーディング作業を進めている場合は Claude Code 側です。両方使う場合は、それぞれで個別に設定が必要になります。片方に追加したMCPサーバーが、もう片方に自動で反映されるわけではありません。

Anthropicの公式ヘルプとClaude Code の MCP 手順でも、Desktop の claude_desktop_config.json 経由の設定と Code 経由の設定は、別の仕組みとして説明されています。次の章から、それぞれの手順を分けて見ていきます。

Claude Desktop の MCP 設定（設定ファイルの場所と書き方）

Claude DesktopでMCPサーバーを使うには、claude_desktop_config.json という設定ファイルにサーバー情報を書き込みます。ファイルの場所はOSによって異なり、執筆時点（2026-08-28）に確認した範囲では次のとおりです。

Claude Desktopの対応OSは執筆時点ではmacOSとWindowsが中心です。ファイルを直接探す代わりに、アプリ内の「設定」から Developer 系の項目を開き、設定ファイルを編集するメニューを選ぶと、ファイルが存在しない場合は自動で作成されます。メニューの名称は執筆時点のバージョンのものです。UIの表記はアップデートで変わることがあるため、見当たらない場合はアプリ内の表記に沿って探してください。

最小の記入例は次のようになります。

{
  "mcpServers": {
    "example-server": {
      "command": "npx",
      "args": ["-y", "@example/mcp-server"],
      "env": {
        "API_KEY": "<APIキー>"
      }
    }
  }
}

command と args にはサーバーを起動するコマンドを、env には必要な環境変数をプレースホルダで書きます。ここに実際のAPIキーやトークンをそのまま貼り付けるのは避けてください。値の安全な管理は公式の案内に従うのが確実です。

保存したら、次の手順で反映を確認します。

1. Claude Desktopをいったん完全に終了する
2. 再度起動する
3. チャット画面のツール一覧やサーバー一覧に、追加したサーバー名が表示されているか確認する

設定ファイルはアプリの起動時に読み込まれると案内されており、開いたままでは変更が反映されません。これが再起動を挟む理由です。

なお、Anthropicの公式ヘルプでは、Desktop Extensions（.mcpb という拡張機能形式）による1クリックインストールも案内されています。執筆時点で確認した範囲では、公式ヘルプはこちらの方法を先に紹介しています。JSONを直接編集する方法は、拡張機能ディレクトリに無いサーバーを使うときや、細かい設定を自分で調整したいときに向いています。目的に応じて選んでください。

設定手順の詳細は、同じ公式ヘルプの Getting Started with Local MCP Servers on Claude Desktop にまとまっています。

Claude Code の MCP 設定（追加と確認の手順）

Claude Codeの場合、設定ファイルを直接開く場面は少なく、ターミナルから claude mcp add コマンドでサーバーを追加するのが基本の経路です。実行すると、該当の設定ファイルに自動で書き込まれます。

URLで提供されているサーバーを追加する例は次のとおりです。

claude mcp add --transport http example-server https://example.com/mcp

ローカルで動くサーバーを追加する場合は、起動コマンドをそのまま指定します。

claude mcp add example-server -- npx -y @example/mcp-server

--transport http を付けない場合は、ローカルプロセスとして起動する方式になります。認証が必要なサーバーではトークンの指定が必要になる場合がありますが、実値はコマンド履歴や設定ファイルに残るため、共有端末での扱いには注意してください。

追加したサーバーが接続できているかは、次のコマンドで確認します。

claude mcp list

一覧に接続済みを示す表示が出ていれば反映されています。設定の保存先はスコープと呼ばれる単位で分かれており、何も指定せずに追加した場合は自分と現在のプロジェクトだけに閉じたスコープになります。これが既定の挙動です。チームで共有したいときや、すべてのプロジェクトで使いたいときは、コマンドのオプションでスコープを切り替えられます。

Claude DesktopとClaude Codeは設定ファイルが別であるため、どちらか一方で追加したサーバーがもう一方に現れることはありません。両方で同じサーバーを使いたい場合は、それぞれで追加してください。

手順の全体は、Anthropic公式ドキュメントの Connect to MCP servers にまとまっています。

反映されないときの見直し3点（パス・書式・再起動）

設定を保存しても反映されないときは、次の 3系統（パス・書式・再起動）から見直すと原因を絞りやすくなります。

書式エラーが起きると、そのサーバーだけでなく設定ファイル全体が読み込まれなくなることがあります。JSONが構文単位でまとめて解釈される仕組みのため、1か所の閉じ忘れが全体に影響するのがこの現象の理由です。エラーメッセージの文言は環境やバージョンによって変わるため、表示された内容をそのまま検索するか、公式ドキュメントのトラブルシューティング項目と照らし合わせるのが近道です。

次に読む（仕組みは MCP の地図へ・Cursor 側・Hub）

MCPの仕組みやプロトコルそのものを詳しく知りたい場合は、MCPガイドで規格側の解説を確認できます。

Cursor側でMCPを設定したい場合や、Claudeとの違いが気になる場合は、CursorのMCP設定入門へ進んでください。製品が違うため、設定ファイルの場所も書き方も本記事とは別物です。

Claude Codeが初めての場合は、Claude Codeの始め方でインストールから最初の一歩までを確認できます。

Claude DesktopのMCP設定をより丁寧に扱う記事は準備中です。公開までは、本記事とMCPガイドの内容を参考にしてください。

Claude開発者シリーズ全体の読む順は、Hub記事のClaude Code ガイドにまとめてあります。

本記事の内容は執筆時点（2026-08-28）の情報に基づきます。Claude Desktop／Claude Code の MCP 対応範囲・設定ファイルの場所・仕様は変更される可能性があります。サードパーティ製 MCP サーバーの安全性・動作は保証できません。重要な判断は公式ドキュメントで確認してください。