こんにちは、Lena です。その午後、わざわざ複雑なことを組み立てようとしていたわけではありません。

Cursor にデータベースに手を伸ばして、手でコピーせずにコンテキストを引っ張ってきてほしかっただけです。理屈の上では単純でした。でも初めて Cursor の MCP サーバーを見たとき、思ったより長く止まってしまいました。設定パネルは二つ前のバージョンで見たドキュメントと少し違う感じでした。設定パスが変わっていました。UI に新しいラベルがありました。壊れているわけではない — ただ… 覚えていたのと同じではなかった、というだけです。

この記事が扱うのは実はそこです。「JSON はこう」だけではなく — 慎重に手順を踏んだときに気づいたこと、最初は私を迷わせた部分も含めて、という意味です。

Cursor における MCP サーバーの役割

Cursor IDE の中でツール呼び出しがどう動くか

MCP — Model Context Protocol — は、アプリケーションが LLM にツールとコンテキストを渡す方法を標準化するオープンプロトコルです。Anthropic が 2024 年 11 月にオープンソース化しました。2025 年中頃には OpenAI と Google DeepMind も採用しました。2025 年 12 月には Agentic AI Foundation — Linux Foundation プロジェクト — の傘下に移りました。その移行も少し意味があります。Anthropic 一社のものから、より本当に共有されたものへと変わりました。

Cursor の中では、MCP はエージェント向けのプラグインレイヤーのように動きます。エージェントのセッションを開くと、Cursor は有効な MCP サーバーをスキャンし、公開されているツールを読み込み、実行中のタスクの一部としてどれを呼ぶかを判断します。

プロトコルは三つの要素を定義します：ホスト（Cursor 自身）、クライアント（Cursor 内のコネクタ）、サーバー（向こう側で JSON-RPC 2.0 越しにツールを公開する軽量プログラム）。

主役はツールです — create_issue や run_query のような実行可能な関数。Cursor は早い段階からツールをサポートしてきました。リソース — ファイル内容やデータベーススキーマのようなコンテキストデータ — は Cursor v1.6（2025 年 9 月）で入りました。サーバーが再利用可能なテンプレートを提供するプロンプトは、少し後です。

うーん… リソースがそんなに最近だったとは知りませんでした。古いチュートリアルがどこか物足りない理由がそれかもしれません。

始める前に：前提条件

MCP に対応した Cursor のバージョン

MCP 対応は Cursor にしばらく入っていますが、リリースごとに設定形式は変わってきました。何より先に、バージョンを確認してください。Cursor を開く → Help → About。2026 年初頭時点の現行安定版は、stdio、SSE、Streamable HTTP の三つのトランスポートタイプをすべてサポートしています。

確認しておくとよい一点：設定パネルではこのセクションが Tools & MCP とラベル付けされており、単なる「Extensions」などのより汎用的な名前ではありません。探しているのに見つからない — そのせいかもしれません。

サーバーに応じた Node.js または Python の要件

出会う MCP サーバーの多くは、次の二つのスタックのどちらかで動きます：

Node.js ベースのサーバー — npx または node で起動。PATH に Node.js 18 以上が必要です。
Python ベースのサーバー — uv run または python で起動。Python 3.10 以上と、多くの場合パッケージマネージャーとしての uv が必要です。

何より先にターミナルで node --version と python --version を実行するのをおすすめします。当たり前に聞こえますが、このステップを飛ばすことが、意外な数の失敗したセットアップの静かな原因です。サーバープロセスが… そもそも起動せず、パネルには役に立つ表示がありません。

Cursor に MCP サーバーを追加する方法

ステップ 1：MCP サーバーを見つけるか自作する

すでにかなりの数のサーバーがあります — GitHub、Postgres、Slack、ブラウザ自動化など。GitHub 上の公式 MCP サーバー一覧は妥当な出発点です。ドキュメントにワンクリックの「Add to Cursor」ボタンがあるものもあり、設定を自動で扱います。

自作する場合：サーバーは stdout に出力する（stdio トランスポート）か、HTTP エンドポイントを提供すればよいです。言語は問いません。以前使ったプラグインシステムとは少し違う感じがする理由の一つです。

ステップ 2：Cursor の設定で構成する

ここは正確に書きたいところです。形式が重要で、間違っているときにドキュメントが必ずしも警告してくれません。

設定場所は二つあります：

プロジェクト単位：プロジェクトルートの .cursor/mcp.json
グローバル：ホームディレクトリの ~/.cursor/mcp.json

構造は次のとおりです：

JSON

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "your-mcp-server-package"],
      "env": {
        "API_KEY": "your-value-here"
      }
    }
  }
}

API キーや機微な設定を渡すのは env フィールドです — args には入れません。直感的に分かるまで少し時間がかかりました。

多くの人が引っかかる点：ルートキー "mcpServers" を書き忘れると、Cursor はファイル全体を黙って無視します。エラーも警告もありません。サーバーが単に表示されない。なぜそう動くのかは分かりませんが、そうなります。

uv を使う Python サーバー向けの例：

JSON

{
  "mcpServers": {
    "my-python-server": {
      "command": "uv",
      "args": ["run", "--with", "my-server-package", "my-server-package", "run"]
    }
  }
}

代わりに UI から追加することもできます：Settings → Tools & MCP → New MCP Server。JSON を直接編集に不安がある場合は、その経路のほうが少し寛容です。

ステップ 3：接続を確認する

設定を保存したら、Settings → Tools & MCP を開きます。各サーバーにステータス表示が付くはずです — 緑は接続済み、それ以外は未接続です。

サーバーが表示されない場合：まずルートキー（"mcpServers" であり、"servers" などではないこと）を確認してください。次に、コマンドが PATH で実際に見つかるか。Cursor はここで必ずしも有用なエラーを出してくれません — 私にとってまだ少し未解決に感じる部分の一つです。

ステップ 4：エージェントのセッションでツール呼び出しを試す

Cursor で新しいエージェントのセッションを開きます（通常のチャットではありません）。サーバーのツールの一つを自然に呼び出すような文を入力します。実行前に確認を求められるのは想定どおりの挙動で、問題ではありません。

ツール呼び出しは動くのに有用な結果が返らない場合、サーバーが思っているツールを実際に公開しているか確認してください。Tools & MCP パネルに、各サーバーが公開するツールが表示されます。壊れていると決めつける前に、その一覧を見る価値があります。

よくある MCP セットアップのトラブルシューティング

サーバーが表示されない

だいたい三つのどれかです：ルートキー "mcpServers" の欠如、PATH で見つからないコマンド、JSON の構文エラー。Cursor はこれらすべてに静かです。JSON を手で検証する — リンターに貼り付けるだけでも — のは時間の節約になります。

ツール呼び出しが静かに失敗する

Cursor では、すべてのサーバー合わせてアクティブなツールがおおよそ 40 個までという上限があります。 それを超えると、コンテキストが埋まってエージェントが適切なツールを選びにくくなります。多くのサーバーを有効にしている場合は、使っていないものをオフにして、Tools & MCP パネルの更新ボタンを押してみてください。私も何度か助かりました。

認証エラー

サーバーが API キーを必要としていて、ツール呼び出しが権限エラーで失敗する場合、キーが設定の env フィールドにあり、args に直書きされていないか再確認してください。サーバーパッケージによっては特定の環境変数名を期待するものもあります — 期待される変数名はサーバー自身のドキュメントを確認する価値があります。

Cursor の MCP 設定を再利用可能にする

なぜ設定がリセットされるのか、どうすれば残せるか

単一プロジェクト内の .cursor/mcp.json だけを使っていると、別のフォルダで作業するときに設定が消えたように感じます。初めてのときは私も驚きました。どこでも使いたいサーバー — ファイルシステムサーバーやドキュメント検索ツールなど — には、グローバルな ~/.cursor/mcp.json も併せて持つとよい、というのが解決策です。

チーム運用では、.cursor/mcp.json をソース管理に含めると、プロジェクトの全員が同じサーバー設定を得られます。env の値はもちろんコミットすべきではありません — ローカルの環境設定やシークレットマネージャに置きます。

もう一つ心に留めておくこと：MCP サーバーはあなたの認証情報でコードを実行します。データベースアクセス、GitHub トークン、API キーなど、サーバーに与えた権限はそのまま使われます。サードパーティのサーバーを追加する前に、公式の MCP セキュリティガイダンスを確認する価値があります。2025 年の Cursor MCP まわりの CVE 開示はパッチ済みですが、根底の原則は変わりません：各サーバーを完全に信頼した統合として扱う、ということです。

FAQ

Cursor に MCP サーバーを追加するにはどうすればよいですか？

プロジェクトディレクトリの .cursor/mcp.json（またはグローバルには ~/.cursor/mcp.json）を作成または編集し、ルートキー "mcpServers" を使います。サーバーのコマンド、args、必要な環境変数を追加します。その後、Settings → Tools & MCP で接続できたか確認します。

どのバージョンの Cursor が MCP に対応していますか？

MCP のツールサポートは Cursor にしばらく入っています。リソース（スキーマやファイル内容などのコンテキストデータ）のサポートは v1.6（2025 年 9 月）で入りました。Help → About でバージョンを確認し、Cursor はアップデートを続けてください — MCP 統合はリリースをまたいで意味のある変更が入っています。

なぜ MCP サーバーが Cursor に表示されないのですか？

いちばん多い原因は、設定ファイルにルートキー "mcpServers" がないか、綴りが間違っていることです。このキーがないと Cursor はファイル全体を黙って無視します。その他の原因には、PATH でコマンドが見つからないこと、JSON の構文エラーがあります。設定ファイルを検証し、ターミナルから Node.js または Python のランタイムにアクセスできるか確認してください。

この変化をこれからも見ていくと思います。MCP のエコシステムはまだ形を変えています — サーバーが追加され、プロトコルはより多くのツールで採用が広がっています — あと一つか二つのリリースで設定がどう見えるか、正直まだ分かりません。

…でも、無秩序に感じはしません。

Cursor に MCP サーバーを追加する方法：完全セットアップチュートリアル