Cursor MCP 完全ガイド：AI を外部ツールに接続する設定方法

Cursor でコードを書いていると、こんな悩みがありませんか。AI にプロジェクト関連の作業を頼むたびに、プロジェクト構造、DB テーブル設計、API 仕様を一から説明しなければならない——まるで毎回「補習」をしている気分です。

AI は賢いですが、DB の中身は「見えない」し、ファイルシステム上に何があるかも把握できません。API を直接呼び出すこともできません。毎回手動で情報をコピー＆ペーストするのは、効率が悪いですよね。

MCP（Model Context Protocol）が、この問題をすっきり解決してくれます。一言で言えば、AI が外部ツールやデータソースに接続するための標準プロトコル。設定さえ済ませれば、AI が自分で DB を調べ、ファイルを読み、API を呼び出せるようになります。

MCP とは？

簡単な例え

MCP を一言で説明するなら、AI に USB-C 端子を取り付けるようなものです。

以前はデバイスごとに充電ポートが違いました。iPhone は Lightning、Android は Micro-USB、ノート PC はまた別の規格——本当に面倒でした。USB-C が登場して、1 つの端子ですべて解決しました。

MCP も同じ発想です。Anthropic が開発したオープンプロトコルで、AI が外部ツールに接続するための標準インターフェースを提供します。この標準があるおかげで、AI アプリごとに統合機能をゼロから作る必要がなくなりました。

なぜ MCP が必要なのか

MCP 登場以前、AI を DB に接続したければ、各 AI アプリが独自の仕組みを開発する必要がありました。Cursor が一式、Claude Desktop が別の一式、他のツールもまた別——開発者は車輪の再発明を強いられ、メンテナンスコストも高く、ツール間の互換性もありませんでした。

MCP はこの状況を変えました。「一度書けば、どこでも使える」という理念です。開発者は MCP 標準に従って DB コネクタを 1 つ作れば、MCP 対応の AI アプリすべてで使えます。効率が上がり、重複作業も避けられます。

MCP vs 従来のプラグイン

「従来のプラグインや拡張機能と何が違うの？」と思うかもしれません。

かなり違います。従来のプラグインはアプリ層の機能拡張——ブラウザの広告ブロック、VSCode のテーマなど。MCP は AI モデル層の能力拡張です。

決定的な違いはここ：AI がいつツールを呼び出すかを自律的に判断できる。あなたが明示的に指示しなくていい。

例えば Cursor に「このユーザーの DB 上の注文履歴を見て」と言ったとします。MCP を設定していれば、AI は自動的に以下を理解し実行します。

1. DB に接続する
2. ユーザーテーブルからユーザー ID を探す
3. 注文テーブルから関連する注文を探す
4. 結果を整理して提示する

「DB を検索して」「SQL を実行して」と指示する必要はありません。AI が自分で何をすべきか判断します。

コアアーキテクチャ

技術的な視点では、MCP のアーキテクチャは明快です。

• MCP Host：使う AI アプリ（Cursor、Claude Desktop など）
• MCP Client：Host と Server 間の接続を管理
• MCP Server：外部サービス（DB、API、ファイルシステムなど）をラップ
• 通信プロトコル：標準の JSON-RPC インターフェース

積み木のように、各パーツが役割を果たします。使いたい MCP Server を設定するだけで、残りは AI が処理してくれます。

MCP で何ができる？

概念の次は、具体的な機能を見ていきましょう。以下は私が実際に試した活用シーンです。

データベースアクセス

この機能には本当に助けられています。

例えば EC サイトのプロジェクトで、DB にユーザー、商品、注文テーブルがあるとします。以前なら「あるユーザーの直近 1 ヶ月の注文」を AI にクエリコードを書かせようとすると、次の手順が必要でした。

1. テーブル定義をコピーして AI に渡す
2. テーブル間のリレーションを説る
3. 取得したいフィールドを指定する

MySQL MCP Server を設定した今では、「ユーザー ID 123 の直近 1 ヶ月の注文を調べて」と言うだけ。AI は自動的に：

• DB に接続
• テーブル構造を解析
• 正確な SQL を生成
• クエリを実行
• 結果を必要な形式に整形

生成される SQL は実際のテーブル構造に基づいており、架空のサンプルコードではありません。

Alibaba Cloud - 開発者向けクラウドの第一候補、Lighthouse サーバー15%OFF、プロジェクトの迅速な立ち上げを支援

15%割引を入手 →広告

ファイルシステム操作

私は主にコード整理に使っています。

例えば、サードパーティライブラリを多用しているプロジェクトで、時間が経つと使われていない import 文が溜まってきます。手動で 1 つずつチェックするのは骨が折れます。

ファイルシステム MCP Server を設定すれば、Cursor にこう言えます。「プロジェクト全体をスキャンして、使われていない import をすべて見つけて削除して」。AI は自動的に：

• プロジェクトディレクトリを走査
• 各ファイルの import 文を解析
• 実際に使われていないかチェック
• ファイルを修正して削除

リファクタリングの際に特に便利です。

API 統合

MCP の API 統合サポートは非常に充実しています。すでに多くの主要サービスの MCP Server があります。

GitHub MCP

GitHub をよく使うなら、これはとても便利です。設定すれば、AI に直接以下を依頼できます。

• Issue の確認：「バグとしてマークされている未解決 Issue はある？」
• PR 作成：「このブランチの変更で PR を作って」
• ブランチ管理：「新しい feature ブランチを作って」

Slack MCP

チーム通知の自動化に使っています。例えば：

• 「#dev チャンネルに、新バージョンがリリースされたことを通知して」
• 「最近チャンネル内で私宛のメンションがあったか確認して」

Google Workspace MCP

Gmail、Google Docs、Sheets、Drive、Calendar をカバーします。Google エコシステムに依存しているなら、大幅な時間短縮になります。

例：「昨日のデータ分析結果を Google Sheets にまとめて」「明日のカレンダーを確認して」。

ブラウザ自動化

Chrome DevTools MCP は非常に興味深いツールです。

AI がブラウザと直接対話できるようになります。例えば：

• 特定の Web ページを開く
• ページの DOM 構造を読み取る
• JavaScript を実行する
• ページのパフォーマンスを分析する

私は自動テストやパフォーマンス分析に使っています。「トップページを開いて、ファーストビューの読み込み時間を分析し、どのリソースが遅いか調べて」といった依頼です。

Web コンテンツ取得

Fetch Server は Web ページのコンテンツ抽出に特化しています。

Web の内容を AI が読みやすい形式に変換してくれるのが特徴です。ある記事の内容を分析したいとき、手動でコピーする必要はなく、リンクを渡して「この記事の要点を分析して」と言うだけ。AI が自動でコンテンツを取得して分析します。

MCP の設定方法

MCP の概要を把握したところで、具体的な設定方法を解説します。

設定前の準備

始める前に、次の 2 点を確認してください。

1. Cursor バージョン：最新版であることを確認。MCP サポートは比較的新しい機能です。
2. 転送方式：2 種類の違いを理解しておきましょう。
   • stdio：標準入出力。サービスはローカルで実行され、Cursor が自動管理。個人利用向け。
   • SSE/HTTP：ネットワーク通信。リモートサーバーに配置でき、複数ユーザーで共有可能。

ほとんどの場合、stdio をおすすめします。設定が簡単で、追加サーバーも不要です。

設定方法 1：Cursor 設定画面から（推奨）

初めて設定するなら、この方法が一番簡単です。

手順：

1. Cursor を開く
2. 設定を開く（ショートカット）
   • Windows/Linux：Ctrl+Shift+J
   • macOS：Cmd+Shift+J
3. 左メニューの “Tools & Integrations” を探す
4. 下部の “New MCP Servers” をクリック
5. Cursor が自動的に mcp.json を作成または開く

GUI があり、リアルタイム検証もできるのが利点。設定に問題があれば、すぐにエラーが表示されます。

設定方法 2：設定ファイルを直接編集

設定ファイルを直接編集したい場合は、手動で作成も可能です。

MCP 設定ファイルには 2 つの場所があります。

• プロジェクト単位：.cursor/mcp.json（現在のプロジェクトのみ有効）
• グローバル：~/.cursor/mcp.json（全プロジェクトで有効）

私は常用ツール（GitHub、Fetch など）をグローバルに、プロジェクト固有のもの（DB 接続など）をプロジェクト設定に置いています。

設定ファイルの構造

MCP 設定ファイルの基本構造は次のとおりです。

{
  "mcpServers": {
    "サーバー名": {
      "command": "実行コマンド",
      "args": ["引数リスト"],
      "env": {
        "環境変数": "値"
      }
    }
  }
}

• command：実行するコマンド（npx、node、python など）
• args：コマンドの引数。通常は MCP Server のパッケージ名やスクリプトパス
• env：環境変数。API Token や DB パスワードなどの機密情報を渡す

実践例 1：GitHub MCP の設定

よく使う GitHub MCP から始めましょう。

設定コード：

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

解説：

Railway - モダンなデプロイプラットフォーム、煩わしい運用から解放、数分で公開

今すぐ始める →広告

• command: "npx"：Node.js のパッケージ実行ツールを使用。グローバルインストール不要
• args: ["-y", "@modelcontextprotocol/server-github"]：
  • -y は自動確認
  • @modelcontextprotocol/server-github は公式 GitHub MCP Server パッケージ
• env.GITHUB_PERSONAL_ACCESS_TOKEN：GitHub パーソナルアクセストークン

GitHub Token の取得方法：

1. GitHub を開き、Settings へ
2. 左メニュー下の Developer settings へ
3. Personal access tokens → Tokens (classic) をクリック
4. Generate new token をクリック
5. 必要な権限を選択（最低限 repo 権限が必要）
6. 生成された Token をコピーし、設定ファイルに貼り付け

注意：Token は一度しか表示されません。必ず保存してください。

実践例 2：Fetch Server の設定

API Token 不要なので、もっと簡単です。

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"]
    }
  }
}

これだけです。設定後、AI に任意の Web ページの内容を取得させられます。

実践例 3：データベース MCP の設定

DB 設定は接続情報を渡す必要があるため、少し複雑です。

MySQL を例にします（事前に MySQL MCP Server が必要。自作するかコミュニティ版を使用）：

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql-mcp-server/index.js"],
      "env": {
        "DB_HOST": "localhost",
        "DB_USER": "root",
        "DB_PASSWORD": "your_password",
        "DB_NAME": "your_database"
      }
    }
  }
}

重要：

• /path/to/mysql-mcp-server/index.js は実際のパスに置き換える
• DB パスワードは環境変数で管理し、直接書くのは避ける
• リモート DB の場合は DB_HOST を実際のアドレスに変更

複数 MCP Server の完全設定例

実際には複数の MCP Server を併用することが多いでしょう。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    },
    "fetch": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"]
    },
    "mysql": {
      "command": "node",
      "args": ["/Users/your-name/mcp-servers/mysql/index.js"],
      "env": {
        "DB_HOST": "localhost",
        "DB_USER": "root",
        "DB_PASSWORD": "your_password",
        "DB_NAME": "your_database"
      }
    }
  }
}

設定の検証

設定が完了したら、正しく動作するか確認します。

手順：

1. Cursor 再起動：設定変更を反映させるため再起動が必要
2. 機能テスト：Cursor のチャットで試す
   • GitHub テスト：「私の GitHub リポジトリ一覧を見せて」
   • Fetch テスト：「https://example.com の主要コンテンツを取得して」
3. 応答確認：設定が成功していれば、AI は対応する MCP ツールを呼び出す

AI が「アクセス権限がありません」「接続できません」と答えたら、設定に問題があります。

よくあるトラブルシューティング

私が遭遇した問題と解決策を共有します。

問題 1：設定ファイルのフォーマットエラー

症状：Cursor 起動時にエラー、または MCP 機能が動かない

解決策：

• JSON 構文（カンマ、クォート、括弧）をチェック
• JSON 検証ツールを使用
• 最後の要素の後に余分なカンマがないか確認

問題 2：API Token 権限不足

症状：AI はサービスに接続できるが、特定操作でエラーになる

解決策：

• Token のスコープ（権限範囲）を確認
• GitHub Token には最低限 repo 権限が必要
• 操作が失敗する場合、追加権限が必要なことも

問題 3：ポート占有

症状：MCP Server 起動時にエラー

解決策：

• 他のプログラムがポートを使っていないか確認
• stdio 方式なら通常この問題は起きない
• SSE 方式ならポート番号を変更してみる

問題 4：環境変数が反映されない

症状：環境変数を設定したのに Server が読み取れない

解決策：

• 変数名のスペルミスを確認
• 設定ファイルが保存されているか確認
• Windows ユーザーはパス区切り文字に注意（\\ または / を使用）

応用テクニック

設定成功は第一歩。ここからは実用的なテクニックを紹介します。

適切な転送方式の選択

stdio 方式が向いている場合：

• ローカル開発
• 個人利用
• 追加サーバーなしで手軽に設定したい

SSE/HTTP 方式が向いている場合：

• チームで MCP Server を共有する
• DB やサービスがリモートサーバー上にある
• 集中管理や監視が必要

私は個人ツール（GitHub、Fetch）に stdio、チーム共用 DB に SSE を使っています。

Vultr - 高性能NVMeクラウドサーバー、世界32拠点、Dockerワンクリック展開対応

価格を見る →広告

複数 MCP Server の管理

数が増えると管理が大変になります。おすすめは次のとおり。

• グローバル設定：GitHub、Fetch、Slack などの汎用 Server
• プロジェクト設定：DB、内部 API などの固有 Server
• 必要時のみ有効化：使わない Server はコメントアウトして、リソース浪費を防ぐ

セキュリティ対策

MCP 設定には機密情報が含まれるため、セキュリティは重要です。

Token を Git にコミットしない：

• .cursor/mcp.json を .gitignore に追加
• またはハードコーディングせず環境変数を使用

Token の定期更新：

• GitHub Token に有効期限を設定
• 定期的にパスワードと Token を更新

最小権限の原則：

• GitHub Token は必要な権限だけ付与
• DB ユーザーは（クエリのみなら）Read Only 権限にする

おすすめ MCP Server

実用的な MCP Server をいくつか紹介します。

開発ツール系：

• @modelcontextprotocol/server-github：GitHub 連携
• @modelcontextprotocol/server-gitlab：GitLab 連携

データベース系：

• PostgreSQL MCP Server
• MySQL MCP Server
• MongoDB MCP Server

オフィス/コラボレーション系：

• Google Workspace MCP Server（Gmail、Docs、Sheets など）
• Slack MCP Server

データ取得系：

• @modelcontextprotocol/server-fetch：Web 取得
• Firecrawl MCP Server：より強力なクローラー

ブラウザ自動化：

• Chrome DevTools MCP：ブラウザデバッグ・自動化

パフォーマンス最適化

MCP を多用するとパフォーマンスが気になるかもしれません。

必要な Server だけ有効化：

• 使わないものはコメントアウトまたは削除
• 起動時のリソース消費を抑える

ネットワーク遅延に注意：

• リモート Server には遅延が発生
• クラウド DB の場合、ネットワーク品質を考慮

タイムアウト設定：

• 一部の MCP Server はタイムアウト設定が可能
• 特定のリクエストでプロセス全体が止まるのを防ぐ

まとめ

振り返ってみましょう。

MCP とは：AI が外部ツールやデータに接続するための標準プロトコル。AI の USB-C 端子のようなもの。

何ができるか：

• DB アクセス（SQL 生成・実行）
• ファイルシステム操作（一括処理）
• GitHub、Slack、Google Workspace 連携
• ブラウザ自動化と Web コンテンツ取得

設定方法：

• Cursor 設定画面または mcp.json を編集
• command、args、env の 3 要素を設定
• GitHub、Fetch、DB などの Server が利用可能

まずは簡単な Fetch Server から始めるのがおすすめです。MCP の威力を体感してください。慣れてきたら、ニーズに合わせて他の Server を追加していきましょう。

MCP エコシステムは急速に発展しており、毎週のように新しい Server が登場しています。「一度書けば、どこでも使える」世界が実現しつつあります。将来 AI ツールを乗り換えても、MCP Server をそのまま使い続けられるでしょう。