やす研究所 AI Lab
戻る

Cursor MCP設定の最短手順 2026年版:3つのサーバーで開発を加速

Cursor MCP設定の最短手順 2026年版:3つのサーバーで開発を加速

Cursor を使い始めて半年、正直なところ MCP サーバーの設定はずっと後回しにしていました。「便利らしいけど、設定がめんどくさそう」というだけの理由です。先週、重い腰を上げて 3 つだけ入れてみたら、コードを書く時間が体感で 2 〜 3 割短くなりました。

この記事では、私が実際に試した Cursor MCP 設定の最短手順 を共有します。読み終える頃には、あなたの .cursor/mcp.json に最初の 3 サーバーを書き込み、Cursor を再起動して green dot が並んでいるはずです。

結論:最小構成は「GitHub + Context7 + Brave Search」の3つでいい

先に答えを書きます。Cursor で MCP を初めて触るなら、入れるべきサーバーは次の 3 つです。

理由はシンプルで、Cursor には 同時に有効化できるツール数の上限が約 40 個 あるからです。truefoundry の 2026 年ガイドによると、この上限を超えると警告が出るうえ、エージェントが一部のツールを「見失う」挙動になります。だから最初から欲張らない方が結果的に賢いんですよね。

3 つから始めて、足りなくなったら足す。これが私のたどり着いた運用ルールです。

なぜ今 Cursor MCP 設定を学ぶ価値があるのか

MCP(Model Context Protocol)は Anthropic が 2024 年 11 月にオープンソース化した後、2025 年に OpenAI と Google DeepMind が採用し、2025 年 12 月には Linux Foundation 配下の Agentic AI Foundation に移管されました。つまり、もう特定ベンダーの仕様ではなく、業界標準 になっています。

さらに 2026 年 3 月時点で、コミュニティ製の MCP サーバーは 5,000 を超えているそうです。GitHub・Postgres・Figma・Sentry あたりはほぼ揃っています。

そして Cursor 側も進化しています。2026 年 1 月のアップデートで、複数の MCP サーバーを使うときのトークン消費を 約 47% 削減 する動的コンテキスト管理が入りました。つまり「サーバー入れすぎると重くなる問題」が以前よりだいぶマシになっています。これは想像以上に効きました。

事前準備:Cursor のバージョンと Node.js を確認する

設定を始める前に、3 つだけチェックします。

  1. Cursor 0.45 以降:メニューの「About Cursor」で確認。古いと UI が違って詰まります
  2. Node.js 18 以上:node --version で確認。多くの MCP サーバーが npx 経由で動く
  3. 必要な API キー:GitHub Personal Access Token、Brave Search API Key

Node.js が古いと、npx で MCP サーバーを起動した瞬間に無言で落ちます。私はこれで 30 分溶かしました。先に確認しておいてください。

Cursor MCP 設定の具体的な手順:mcp.jsonを書く

UI からも追加できますが、私はファイル編集派です。バージョン管理に乗せられて、チームで共有できるからです。

ステップ1:設定ファイルの場所を決める

Cursor は 2 か所の設定を読み込みます。

両方に同名サーバーがあると プロジェクト側が勝ちます。私のおすすめは、GitHub・Context7・Brave Search はグローバルに置き、Postgres などプロジェクト固有のものだけ .cursor/mcp.json に書く運用です。

ステップ2:最小構成の mcp.json を書く

以下を ~/.cursor/mcp.json に保存します。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp-server"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    }
  }
}

キーポイントが 2 つあります。環境変数はシェルではなく env ブロックに書く。Cursor は起動時に config を読み込んでサーバープロセスを生成するので、シェルの環境変数は届かないからです。もうひとつ、Windows なら command を cmd /c npx にする 必要があります。素の npx だと PATH が通らないことがあります。

ステップ3:Cursor を完全に再起動する

ここを軽く見るとハマります。MCP サーバーは 起動時にしか読み込まれない ので、Cmd+R で更新しただけでは反映されません。Cursor を完全に終了して、もう一度開いてください。

設定が正しければ、Settings > Tools & MCP に 3 つのサーバーが緑のドット付きで並びます。赤いドットなら接続失敗です。

トラブルシューティング:つまずきやすい3つのパターン

私が実際にハマったやつだけ書きます。

Server failed to start:8 割は npx のパスか、パッケージ名のタイポです。ターミナルで npx -y @modelcontextprotocol/server-github を直接叩いてみると、Cursor が隠している本当のエラーが見えます。

ツールが途中で反応しなくなる:外部 API のレートリミットで MCP サーバー側がスタックしているケースが多いです。Cursor を再起動すれば直りますが、頻発するならパッケージのバージョンを @1.2.3 のように固定すると安定します。

40 ツール上限の警告:サーバーを増やしすぎたサインです。Settings から不要なツールを個別にオフにします。一気にぜんぶオンにしないこと、これに尽きます。

さらに一歩進めるなら:プロジェクト固有のMCPを追加する

3 つで物足りなくなったら、プロジェクトごとに .cursor/mcp.json を追加していきます。私が次に入れたのは Playwright(E2E テスト)と Supabase(DB クエリ)でした。

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase/mcp-server"],
      "env": {
        "SUPABASE_URL": "https://xxx.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "xxx"
      }
    }
  }
}

この設定をリポジトリにコミットしておけば、チームメンバーが clone してきた瞬間に同じ MCP 環境が再現できます。チーム開発をする人にはこれが地味に効くポイントです。

なお、Cursor は 2026 年 2 月に公式マーケットプレイス(cursor.com/marketplace)をローンチしていて、ワンクリックインストールできるサーバーも増えています。GUI 派ならこちらから入るのもアリです。

Cursor MCP 設定とライセンス料金の関係:Pro プランで十分か

「MCP を使うのに Ultra プランが必要では?」とよく聞かれます。結論、Pro($20/月)で十分 です。

公式の料金ページと複数の比較記事を確認すると、MCP・skills・hooks のサポートは Pro 以上のすべてのプランに含まれています。Pro+ や Ultra との差は機能ではなく クレジット枠の倍率(Pro+ は 3 倍、Ultra は 20 倍)だけです。

私の使い方(Auto モード中心、フロンティアモデルは複雑なリファクタのみ)だと、月末のクレジット残高はだいたい $5 〜 $8 余ります。MCP 経由のツール呼び出し自体がトークンを食うのは確かですが、Auto モードならクレジットを消費しないので、設計次第で Pro 枠に十分収まります。

まとめ:今日からやる3つのアクション

長くなったので、今日のうちにやるべきことを 3 つに絞ります。

  1. ~/.cursor/mcp.json を作成し、GitHub・Context7・Brave Search の 3 つを書き込む(コードは上記参照)
  2. 必要な API キーを取得して env ブロックに貼る:GitHub PAT と Brave Search API Key の 2 つ
  3. Cursor を完全再起動して、Tools & MCP の緑ドットを確認する

ここまで来れば、エージェントに「最新の React Router v7 の useNavigate の使い方を Context7 で調べて、その情報をもとにこのファイルを書き換えて」と頼めるようになります。エディタが「コードを書く道具」から「リサーチ込みで実装する相棒」に変わる瞬間です。

最初の 3 つを動かしてから、Playwright や Postgres を足していくのが体に優しい順序だと、自分は思います。

参考リンク

この記事をシェア:
X で共有 Facebook で共有 Telegram で共有
次の記事
Claude APIコスト最適化2026:5分TTL時代に効くプロンプトキャッシュ実装