Plugy

basics

MCPセットアップ完全ガイド（Claude Desktop / Cursor 両対応）

· Plugy編集部

シェア

はじめに

MCPとは、ClaudeなどのAIとGitHub・Notion・Slack等の外部ツールをつなぐための標準規格です。MCPサーバーを導入することで、Claudeへの自然言語の指示だけでこれらのツールを操作できるようになります。

MCPの概念から知りたい方は先に「MCPとは？」をご覧ください。

このガイドでは、MCPサーバーをClaude DesktopまたはCursorに追加する具体的な手順を解説します。

前提条件

以下のいずれかがインストールされていること：

加えて、多くのMCPサーバーは以下が必要です：

  • Node.js 18以上（node -v で確認）

Node.jsが入っていない場合は nodejs.org からLTS版をインストールしてください。

Claude Desktopでの設定方法

1. 設定ファイルの場所を確認

Claude Desktopの設定ファイルは以下の場所にあります：

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

ファイルが存在しない場合は新規作成してください。

2. 設定ファイルを開く

macOS（ターミナルを使う場合）:

open -e "~/Library/Application Support/Claude/claude_desktop_config.json"

Windows（コマンドプロンプトを使う場合）:

notepad %APPDATA%\Claude\claude_desktop_config.json

Visual Studio CodeやCursorで開いても問題ありません。

3. MCPサーバーの設定を追記

ファイルが空の場合は以下の内容をそのまま貼り付けてください（GitHub MCPを例として使用）：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

すでに別のMCPサーバーが設定されている場合は、mcpServers オブジェクトの中に追記します：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-xxxxxxxxxxxx"
      }
    }
  }
}

⚠️ JSONは最後の要素に ,（カンマ）が付いているとエラーになります。注意してください。

4. Claude Desktopを完全に再起動

設定ファイルを保存後、Claude Desktopを完全に終了してから再起動してください（タスクトレイ・メニューバーからも終了）。

5. 動作確認

Claude Desktopを再起動後、チャットで以下のように聞いてみましょう：

利用可能なツールを教えて

接続されたMCPサーバーのツール一覧が表示されれば成功です。

Cursorでの設定方法

1. 設定画面を開く

Cursorのメニューから Cursor → Settings（設定） を開き、検索ボックスに「MCP」と入力します。

または、コマンドパレット（Cmd+Shift+P / Ctrl+Shift+P）から "Open MCP Settings" を選択します。

2. 設定ファイルを編集

Cursorの設定ファイルは以下の場所にあります：

macOS:

~/.cursor/mcp.json

Windows:

%USERPROFILE%\.cursor\mcp.json

Claude Desktopと同じJSON形式で設定を追記します：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

3. Cursorを再起動して確認

設定保存後、Cursorを再起動します。Agentモードのチャットで以下を試してください：

利用可能なMCPツールを確認して

設定が反映されない場合のチェックリスト

JSON構文エラーの確認

よくあるミス：

  • 最後の要素の末尾に , が残っている
  • " が全角になっている（日本語IMEに注意）
  • { } [ ] の対応がズレている

確認方法：設定ファイルの内容を JSONLint に貼り付けて検証する。

完全な終了・再起動

Claude Desktopはタスクトレイ・メニューバーに常駐しています。完全に終了してから再起動してください。

APIキーの確認

  • トークンに余分なスペースや改行が含まれていないか確認
  • APIキーの権限スコープが不足していないか確認（各MCPページのドキュメントを参照）

Node.jsのバージョン確認

node -v

v18.0.0 以上であることを確認してください。古い場合は nodejs.org からアップデートしてください。

次のステップ

設定が完了したら、Plugyで紹介しているMCPサーバーをどんどん試してみましょう。特に需要の高い以下のMCPがおすすめです：

  • GitHub MCP — Issue・PR・コードレビューをAIに依頼
  • Notion MCP — ドキュメント・データベースをAIが操作
  • Slack MCP — チャンネルへの投稿・情報収集をAIが代行
  • Google Calendar MCP — スケジュール管理をAIに委ねる

複数のMCPを組み合わせた活用方法は、ガイド記事一覧もあわせてご覧ください。