Claude DesktopのMCP設定をワンクリックで完了【JSON手作業不要・2026年最新】

MCPとは何か

MCP（Model Context Protocol）は、Anthropicが策定したオープンな通信規格です。Claude DesktopやClaude Codeから、GitHub・ファイルシステム・データベース・Slack・Notionなど外部ツールに直接アクセスできるようになります。

従来のAIチャットは「テキストを送って返答をもらう」だけでしたが、MCPを使えばClaudeが実際に外部システムを操作・参照できます。例えばGitHub MCPを入れればリポジトリを読んでコードレビューでき、Filesystem MCPを入れればローカルファイルを直接編集できます。

ワンクリックインストールの使い方

MCPプロバイダーが「インストールリンク」を公開している場合、ブラウザのリンクをクリックするだけでClaude Desktopに設定が反映されます。

手順

1. MCPプロバイダーが公開しているインストールページにアクセス
2. 「Add to Claude Desktop」または「Claude Desktopに追加」ボタンをクリック
3. ブラウザが claude:// スキームのURLを開く許可を求めるので「許可」を選択
4. Claude Desktopが起動して確認ダイアログが表示される
5. 「インストール」をクリックして完了

インストール後はClaude Desktopを完全に再起動することで新しいMCPが有効になります。

ワンクリック対応の主なMCP

従来のJSON手動設定方法

ワンクリック非対応のMCPや、細かいパラメータを調整したい場合はJSON設定ファイルを直接編集します。

設定ファイルの場所

設定ファイルの書き方

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents"
      ]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "BSAxxxxxxxxxxx"
      }
    }
  }
}

mcpServers の各キー（github、filesystem など）はClaude Desktop内での識別名です。好きな名前をつけられます。

設定後の確認

JSON編集後は必ずClaude Desktopを完全に終了してから再起動してください。タスクトレイ・メニューバーのアイコンから「Quit」を選んで完全終了するのがポイントです。

起動後、チャット画面の入力欄左下に🔧アイコンが表示されれば、MCPが正常に読み込まれています。

よくあるエラーと解決法

エラー1：MCPが接続できない（Connection failed）

原因: コマンドが見つからない（npx が入っていない等）

解決: Node.jsをインストールして npx --version で動作確認。

node --version  # v18以上推奨
npx --version

エラー2：JSON構文エラー（Syntax Error）

原因: カンマの付け忘れ、引用符のミスなど

解決: JSONの検証サイト（jsonlint.com等）にペーストして確認。Claude Desktopはエラーがあると起動時にダイアログを表示します。

// NG: 最後の要素にカンマ
{
  "mcpServers": {
    "github": { ... },  ← このカンマが余分
  }
}

// OK: 最後の要素にカンマなし
{
  "mcpServers": {
    "github": { ... }
  }
}

エラー3：APIキーが無効（Authentication failed）

原因: 環境変数のキー名ミス、またはキーの権限不足

解決: MCPのドキュメントで必要な権限スコープを確認。GitHubであれば repo、read:org スコープが必要なことが多いです。

エラー4：MCP起動はするが使えない（Tool not available）

原因: MCPサーバーのプロセス起動に時間がかかっている

解決: 初回は数秒〜数十秒かかります。Claude Desktopを開いてから30秒待ってから試してください。

Claude CodeでのMCP設定

Claude DesktopとClaude CodeではMCPの設定方法が異なります。

グローバル設定（全プロジェクト共通）

claude mcp add github \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxx \
  -- npx -y @modelcontextprotocol/server-github

プロジェクト単位の設定

プロジェクトディレクトリで以下を実行すると .claude/settings.json に記録されます：

cd /path/to/project
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem .

登録済みMCPの確認

claude mcp list

どのMCPから始めるべきか

コーディング作業が多い場合: GitHub MCPとFilesystem MCPから始めるのが最も費用対効果が高いです。リポジトリのコードを読ませながらレビューや実装の相談ができます。

情報収集・調査が多い場合: Brave Search MCPで最新情報をリアルタイム参照できるようにするのが有効です。

ドキュメント・メモ管理が多い場合: Notion MCPやObsidian MCP（コミュニティ製）で、ナレッジベースをClaudeから直接参照・更新できます。

あわせて読みたい

• Claude Code初心者向け：MCPサーバーで外部データ連携を実現する
• Claude CodeでJira調査を自動化する。MCPサーバーでツール連携を実現
• MCPサーバーをPythonで作る2026年版：本番運用の実践ガイド