生成AI活用

claude_desktop_config.json の場所と書き方|Claude Desktop の MCP 設定

ENHANCED編集部更新 約12分で読めます

claude_desktop_config.json は、Claude Desktop にローカルの MCP サーバーを登録する設定ファイルです。 場所は macOS が ~/Library/Application Support/Claude/claude_desktop_config.json、Windows が %APPDATA%\Claude\claude_desktop_config.json、Linux(ベータ版)が ~/.config/Claude/claude_desktop_config.json で、Claude のメニューの「Settings…」→「Developer」→「Edit Config」から開けます。

ただし今は、MCP サーバーを 1 つのファイルにまとめた Desktop Extensions(.mcpb) を「Settings」→「Desktop app」の「Extensions」から入れる方法もあり、多くの場合はこちらのほうが簡単です。この記事では、両方の方法を公式の手順に沿って解説します。

この記事は 2026年10月に、Anthropic と MCP の公式ドキュメントをもとに全面的に書き直し、2026年11月2日に最新の公式ドキュメントで内容を確かめ直しました(拡張機能の画面の場所、Linux 版の設定ファイルの場所、接続の確かめ方などを更新)。

MCP・AIエージェント開発

社内のツールやデータと AI をつなぐ仕組みを作ります

エンハンスドは、MCP などで社内のシステムやデータと AI をつなぎ、情報の収集・判断・操作までを任せられる AI エージェントを、業務に合わせて設計・開発しています。

AIエージェント開発を相談する

MCP とは?

MCP(Model Context Protocol)は、AI のアプリと外部のツールやデータをつなぐための共通の仕組みです。Claude Desktop は MCP サーバーを通じて、パソコンの中のファイルや、各種のサービスを扱えるようになります。

MCP サーバーを Claude Desktop に入れる方法は、次の 2 つです。

方法 向いている人 必要なもの
Desktop Extensions(.mcpb) まず手軽に使いたい人 Claude Desktop だけ(Node.js も同梱)
claude_desktop_config.json を編集 拡張機能として配られていないサーバーを使いたい人、細かく設定したい人 サーバーによって Node.js などが要る

方法 1:Desktop Extensions(.mcpb)で入れる

Desktop Extensions は、MCP サーバーとそれが必要とするものを 1 つのファイルにまとめたパッケージです。設定ファイルを手で書かずに入れられます。

  1. Claude Desktop の「Settings」→「Desktop app」を開き、「Extensions」の横の「Manage」を押す(以前の画面では「Settings」→「Extensions」)
  2. 「Browse extensions」から、Anthropic が確認した拡張機能を選んで「Install」を押す
  3. 手元の .mcpb ファイルを入れるときは、「Advanced settings」の「Extension Developer」にある「Install Extension…」から選ぶ(ファイルをダブルクリックしても入れられます)
  4. API キーなど、拡張機能が求める設定を画面で入力する。入れた拡張機能は、会話の中で自動で使えるようになります

ポイントは次の 3 つです。

  • 拡張子は .mcpb:最初は .dxt でしたが、2025年9月から .mcpb(MCP Bundle)に変わりました。以前の .dxt も引き続き使えます
  • Node.js のインストールは不要:Claude Desktop に同梱の Node.js で動きます
  • API キーなどは OS のキーチェーンに保存:拡張機能が「機密」と指定した値は、OS の安全な保存場所(macOS のキーチェーンや Windows の資格情報マネージャー)に暗号化して保存されます

会社の Team・Enterprise プランでは、オーナーが公開の拡張機能の利用を許可・禁止したり、社内向けの拡張機能を配ったりできます。会社のパソコンで「Browse extensions」が出ないときは、管理者の設定を確かめてください。

方法 2:claude_desktop_config.json を編集する

ファイルの場所

OS 場所
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json
Linux(ベータ版) ~/.config/Claude/claude_desktop_config.json

Claude Desktop の Linux 版は 2026年11月時点でベータ版で、Ubuntu 22.04 LTS 以降と Debian 12 以降に対応しています。

開き方

Claude のメニューから「Settings…」→「Developer」を開き、「Edit Config」を押します。ファイルがまだ無いときは、ここで作られます。

書き方

mcpServers の中に、サーバーごとに「名前」「起動するコマンド(command)」「引数(args)」を書きます。たとえば、公式の Filesystem サーバーで、デスクトップとダウンロードのフォルダを扱えるようにする例です(macOS の場合)。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

Windows では、フォルダを "C:\\Users\\username\\Desktop" のように書きます(\ は \\ と 2 つ重ねます)。username は自分のユーザー名に置き換えてください。フォルダは相対パスではなく、/Users/... や C:\\... から始まる絶対パスで書きます。

API キーなどをサーバーに渡すときは、サーバーの説明に従って env に書きます。

{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": ["-y", "<サーバーのパッケージ名>"],
      "env": {
        "EXAMPLE_API_KEY": "<あなたのキー>"
      }
    }
  }
}

この設定ファイルに書いた値は、暗号化されずにそのまま保存されます。 権限を絞ったキーを使い、ファイルを人に渡さないようにしましょう。

npx で動かすサーバーには Node.js が要ります。入っていなければ、公式サイトから LTS 版を入れてください。

保存したら、Claude Desktop を完全に終了して起動し直す

設定は起動するときに読み込まれます。ウィンドウを閉じるだけでなく、アプリを終了してから起動し直してください。

つながったかを確かめる

入力欄の左下の「+」(Add files, connectors, and more)を押し、「Connectors」→「Manage connectors」を開いて、一覧からサーバー(例では「filesystem」)を選ぶと、使えるツールが確かめられます。Claude がツールを使うときは、実行の前にあなたの許可を求めます。

公式の MCP サーバーを選ぶときの注意

MCP の公式リポジトリ(modelcontextprotocol/servers)にある参考実装は、2026年11月時点で Everything・Fetch・Filesystem・Git・Memory・Sequential Thinking・Time の 7 つです。これらは MCP の機能を示すための「参考実装」で、本番での利用にそのまま向くとはされていない点にも注意してください。

以前は GitHub・Google Drive・Slack・PostgreSQL・Brave Search・Puppeteer などのサーバーも公式リポジトリにありましたが、2025年5月にアーカイブ(保守終了)され、別のリポジトリ(servers-archived)に移されました。今も npm から入れられるものがありますが、保守もセキュリティの保証もありません。

  • GitHub は、GitHub 公式の github-mcp-server を使います(リモートの https://api.githubcopilot.com/mcp/ につなぐ方法と、Docker で動かす方法があります)
  • Brave Search は、Brave 公式の @brave/brave-search-mcp-server に置き換わっています
  • ほかのサービスも、そのサービスの提供元が出している MCP サーバーがあれば、そちらを選ぶのが安全です

うまく動かないとき

  • JSON の書き方を確かめる:JSON にはコメント(//)を書けません。最後の項目のあとのカンマも、エラーの原因になります
  • パスを確かめる:設定に書いたフォルダが実在し、絶対パスになっているかを確かめます
  • ログを見る:macOS は ~/Library/Logs/Claude、Windows は %APPDATA%\Claude\logs、Linux は ~/.config/Claude/logs に、mcp.log と、サーバーごとの mcp-server-<名前>.log があります
  • サーバーを手で動かしてみる:ターミナルで、設定と同じコマンド(例:npx -y @modelcontextprotocol/server-filesystem <フォルダ>)を実行し、エラーが出ないかを見ます
  • Windows で ENOENT のエラーが出る:ログに ${APPDATA} を含むパスのエラーが出ているときは、そのサーバーの env に "APPDATA": "C:\\Users\\<ユーザー名>\\AppData\\Roaming\\" のように、展開したあとの値を足してください。それでも npx が失敗するときは、npm がグローバルに入っているか(%APPDATA%\npm があるか)を確かめます
  • npx が見つからない:Node.js が入っていないか、入れたあとに Claude Desktop を起動し直していません
  • Desktop Extensions で入れたものが動かない:「Settings」→「Desktop app」→「Extensions」で、拡張機能が有効か、必要な設定(API キーなど)が入っているかを確かめます。同じ画面の「Local MCP servers」で、つながり具合とログも見られます。ツールが出てこないときは、Claude Desktop を起動し直します

安全に使うために

  • 信頼できる提供元のサーバーだけを入れる(MCP サーバーは、あなたのパソコンの上で動くプログラムです)
  • Filesystem サーバーには、必要なフォルダだけを渡す
  • API キーやトークンは、必要な権限だけに絞ったものを使う
  • 設定ファイルに書いたキーは平文で残るので、手軽に入れられるなら Desktop Extensions を使う(機密の値はキーチェーンに保存されます)

会社で MCP を使い、社内の資料を AI に扱わせるなら、どのデータを渡してよいかと、答えの根拠をどう示すかを先に決めておくと安全です。社内の規程やマニュアルを AI に答えさせる仕組みは「社内の資料をAIに答えさせるには?社内ナレッジ検索(RAG)の仕組みと進め方」で解説しています。

よくある質問

claude_desktop_config.json が見つかりません

まだ作られていないことがあります。Claude のメニューの「Settings…」→「Developer」→「Edit Config」を押すと作られて開きます。

Desktop Extensions と設定ファイル、どちらを使えばよいですか?

使いたいサーバーが拡張機能として配られていれば、Desktop Extensions が簡単です。配られていないサーバーを使うときや、引数を細かく指定したいときは、設定ファイルを編集します。

.dxt ファイルは使えますか?

使えます。2025年9月に拡張子が .mcpb に変わりましたが、以前の .dxt も引き続き動きます。

設定を変えたのに反映されません

Claude Desktop を完全に終了して、起動し直してください。設定は起動するときに読み込まれます。

MCP・AIエージェント開発

MCP の活用を、業務の仕組みに

エンハンスドは、MCP などで社内のシステムやデータと AI をつなぎ、情報の収集・判断・操作までを任せられる AI エージェントを、業務に合わせて設計・開発しています。

AIエージェント開発を相談する

まとめ

  • claude_desktop_config.json は、macOS は ~/Library/Application Support/Claude/、Windows は %APPDATA%\Claude\、Linux(ベータ版)は ~/.config/Claude/ にある
  • 「Settings…」→「Developer」→「Edit Config」で開け、mcpServers にサーバーを書く
  • 手軽に入れるなら Desktop Extensions(.mcpb)を「Settings」→「Desktop app」→「Extensions」から
  • 提供が終わったサーバーではなく、今も保守されているサーバーや提供元の公式のサーバーを選ぶ

MCP で AI を社内のデータやシステムとつなぎ、業務を任せる仕組みを作りたい場合は、エンハンスドの AIエージェント開発 でご相談いただけます。

あわせて読みたい

参考資料

次に読む

この記事に関わるエンハンスドの事業

AI活用・無料相談

社内の AI 活用を、仕事で使える形にしませんか

一般職から営業・エンジニア・経営層まで、職種に合わせた実践型の AI 研修で、生成 AI を「知る」から仕事で「使える」へ。組織全体の活用と定着を支援します。

  • 職種・役割に合わせた AI 活用研修
  • 業務に合わせた使い方のご提案
  • 導入から社内定着まで伴走
AI 活用研修を相談する

ご相談は何度でも無料です。まずはお気軽にお問い合わせください。

← 記事一覧に戻る