Claude Desktop MCP ガイド：拡張機能・設定ファイル・コネクター

Claude Desktop に MCP サーバーを追加する 3 つの方法

Claude Desktop が MCP サーバーに接続する方法は 3 つあります。デスクトップ拡張機能（Settings → Extensions からワンクリックでインストールする .mcpb バンドル）、claude_desktop_config.json ファイル（手動で設定するローカル stdio サーバー）、そしてカスタムコネクター（Customize → Connectors で URL を指定して追加するリモート MCP サーバー）です。拡張機能があればそれを使い、それ以外のローカルサーバーは設定ファイル、ホスト型サーバーはコネクターを使いましょう。

このガイドは、Anthropic のローカル MCP サーバーのヘルプ記事、カスタムコネクターのドキュメント、MCP プロジェクトの Claude Desktop チュートリアルと照合しています。まずサーバーを探したい場合は MCP サーバーディレクトリをご覧ください。

どの方法を使うべきか？

実際の違いはこうです。拡張機能と設定ファイルはサーバーをあなたのマシン上でユーザー権限のまま動かすので、ローカルのファイルやアプリにアクセスできます。コネクターはインターネット上のサーバーを呼び出し、同じコネクターを Web 版の Claude でも使えます。

方法 1：デスクトップ拡張機能（.mcpb）

デスクトップ拡張機能は、マニフェスト付きの単一ファイルにパッケージされたローカル MCP サーバーです。この形式は当初 DXT（.dxt ファイル）と呼ばれていましたが、プロジェクトは MCPB（MCP Bundles）に改名され、新しいバンドルは .mcpb 拡張子を使います。

ディレクトリからインストール：

1. Settings を開き、Extensions に進みます。
2. Browse extensions をクリックし、Anthropic がレビュー済みの拡張機能を選びます。
3. Install をクリックし、API キーなど必要な設定を入力します。

.mcpb ファイルからインストール： Settings → Extensions を開いてファイルをページにドラッグします。プレビューが表示されたら Install をクリックして確定します。Anthropic のヘルプセンターでは、Advanced settings を開き、Extension Developer セクションの Install Extension... から選ぶ方法も紹介されています。

拡張機能がいちばん手軽な理由：

• Claude Desktop には Node.js ランタイムが組み込まれているので、Node を別途インストールする必要がありません。Python やバイナリのサーバーにも対応しています。
• 機密として指定されたフィールド（API キー）は OS のセキュアストアに保存されます。macOS ではキーチェーン、Windows では資格情報マネージャーです。
• ディレクトリの拡張機能は自動更新されます。個別に配布された .mcpb ファイルは、更新時に手動で再インストールが必要です。

Team と Enterprise プランでは、Owner が公開拡張機能を許可リストで制限したりブロックしたり、独自の拡張機能をアップロードしたりできます。設定に Extensions が表示されない場合は、組織で無効化されています。

自分でバンドルを作るには、CLI をインストールしてサーバーのフォルダーで 2 つのコマンドを実行します。

npm install -g @anthropic-ai/mcpb
mcpb init   # creates manifest.json
mcpb pack   # builds the .mcpb file

方法 2：claude_desktop_config.json

拡張機能がないサーバーは、設定ファイルを直接編集します。

claude_desktop_config.json はどこにある？

自分で探す必要はありません。システムのメニューバーで Claude メニュー（チャットウィンドウ内の設定ではありません）を開き、Settings... を選び、Developer タブで Edit Config をクリックします。ファイルがなければ作成され、そのまま開きます。

サーバーを追加する

各サーバーは mcpServers の下に command、args、任意の env で記述します。次の例は、2 つのフォルダーへのアクセスを許可して Filesystem MCP サーバーを起動します。

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

Windows ではパスにエスケープしたバックスラッシュを使います（例："C:\\Users\\username\\Desktop"）。サーバーがアクセスできるのは args に列挙したディレクトリだけなので、必要最小限にしましょう。

サーバーと API キーを追加する

filesystem の隣にキーを追加していきます。シークレットは env に入れます。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop"
      ]
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    },
    "my-api": {
      "command": "npx",
      "args": ["-y", "some-mcp-package"],
      "env": {
        "API_KEY": "your-key-here"
      }
    }
  }
}

2 つ目のエントリーは Memory MCP サーバーで、Claude がチャットをまたいで書き込めるローカルのナレッジグラフです。拡張機能と違い、このファイルのキーは平文で保存されるので、同期や共有はしないでください。

再起動して確認する

Claude Desktop を完全に終了し（ウィンドウを閉じるだけではなく）、もう一度起動します。アプリは起動時にしか設定を読み込みません。次に、入力欄の左下にある + ボタン（「Add files, connectors, and more」）をクリックし、Connectors にカーソルを合わせて Manage connectors をクリックします。サーバーがツールとともに一覧に表示されれば成功です。Claude は各ツールを実行する前に承認を求めます。

方法 3：リモートサーバーをカスタムコネクターとして追加する

ホスト型の MCP サーバー（Notion、Linear、Sentry、自前のデプロイなど）は、設定ファイルではなく URL で追加します。

1. Customize → Connectors を開きます。
2. Add custom connector をクリックします。
3. サーバーの URL を入力します。例えば Notion MCP サーバーなら https://mcp.notion.com/mcp です。
4. 必要に応じて Advanced settings で OAuth のクライアント ID とシークレットを入力し、Add をクリックします。
5. Connect をクリックし、サーバーの OAuth ページでサインインします。

Anthropic のドキュメントからの補足：

• カスタムコネクターは Free、Pro、Max、Team、Enterprise プランで使えます。Free プランでは 1 つまでです。
• Team と Enterprise プランでは、Owner が Organization settings → Connectors でコネクターを追加し、メンバーは Connect をクリックします。
• /sse で終わる URL は旧来の SSE トランスポートを選択します。それ以外は Streamable HTTP です。
• コネクターを追加した後は認証設定を変更できません。削除して追加し直してください。
• + メニューの Connectors でチャットごとにコネクターをオン・オフでき、コネクターの設定で個別のツールをブロックできます。

接続は Anthropic のサーバーから行われるため、URL はインターネットから到達可能でなければならず、localhost は使えません。ローカルクライアントとしか通信できないホスト型サーバーを使いたい場合は、コミュニティ製の mcp-remote ブリッジを使って、設定ファイルにローカルの stdio エントリーとして追加できます。

{
  "mcpServers": {
    "remote-example": {
      "command": "npx",
      "args": ["mcp-remote", "https://remote.mcp.server/mcp"]
    }
  }
}

サインインの仕組みは MCP 認証ガイド、ホスト型サーバー全般についてはリモート MCP サーバーガイドをご覧ください。

ログ：Claude Desktop が MCP エラーを書き出す場所

• mcp.log には MCP 接続全般の状況と失敗が記録されます。
• mcp-server-SERVERNAME.log には各サーバーの stderr 出力が保存されます（多くの stdio サーバーはエラー以外もすべてここに出力します）。

macOS でリアルタイムに追うには：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Windows では type "%APPDATA%\Claude\logs\mcp*.log" で最近のログを表示できます。拡張機能の場合は、設定でデバッグログを有効にし、Extensions パネルでその拡張機能のログを確認します。

Claude Desktop MCP のトラブルシューティング

ログだけで分からない場合は、同じサーバーを MCP Inspector に接続してみましょう。そこで動けば問題は Claude の設定に、動かなければサーバー側にあります。

Claude Code で設定を再利用する

Claude Desktop でサーバーを設定済みなら、macOS と WSL では Claude Code が claude mcp add-from-claude-desktop でそれを取り込めます。詳しくは Claude Code MCP ガイドをご覧ください。

次のステップ

• MCP サーバーディレクトリからサーバーを選びましょう。最初によく入れられるのは Filesystem、GitHub、Notion です。
• サーバーに書き込み権限を与える前に、MCP セキュリティのベストプラクティスを読んでおきましょう。
• 自分のサーバーを公開したいなら、MCP サーバーの作り方から始めましょう。