Model Context Protocol (MCP)

MCP を使って外部ツールやデータソースを Cursor に接続する

MCP とは？

Model Context Protocol (MCP) は、Cursor が外部のツールやデータソースと接続できるようにする。

なんで MCP を使うの？

MCP は Cursor を外部のシステムやデータに接続してくれる。プロジェクト構成を毎回説明する代わりに、ツールと直接連携しよう。

stdout に出力するか、HTTP エンドポイントを提供できる言語なら何でも MCP サーバーを書ける—Python、JavaScript、Go など。

仕組み

MCP サーバーはプロトコルを通じて機能を公開し、Cursor を外部ツールやデータソースに接続する。

Cursor は 3 つのトランスポート方式をサポートしている:

Transport	Execution environment	Deployment	Users	Input	Auth
stdio	ローカル	Cursor が管理	単一ユーザー	シェルコマンド	手動
SSE	ローカル/リモート	サーバーとしてデプロイ	複数ユーザー	SSE エンドポイントの URL	OAuth
Streamable HTTP	ローカル/リモート	サーバーとしてデプロイ	複数ユーザー	HTTP エンドポイントの URL	OAuth

プロトコル対応

Cursor はこれらの MCP プロトコル機能に対応してる:

機能	対応状況	説明
Tools	対応	AI モデルが実行するための関数群
Prompts	対応	ユーザー向けのテンプレート化メッセージとワークフロー
Resources	対応	参照・読み取り可能な構造化データソース
Roots	対応	操作対象となる URI やファイルシステム境界へのサーバー起点の問い合わせ
Elicitation	対応	ユーザーに追加情報を求めるサーバー起点のリクエスト

MCP サーバーのインストール

ワンクリックインストール

コレクションから MCP サーバーをインストールして、OAuth で認証しよう。

MCP ツールを参照

利用可能な MCP サーバーを一覧表示

Add to Cursor ボタン

「Add to Cursor」ボタンを作成

mcp.json の使用

JSON ファイルでカスタム MCP サーバーを設定する:

CLI Server - Node.js

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

STDIO サーバーの設定

STDIO サーバー（ローカルのコマンドラインサーバー）の場合、mcp.json に次のフィールドを設定してね:

Field	Required	Description	Examples
type	Yes	サーバーの接続タイプ	"stdio"
command	Yes	サーバーの実行ファイルを起動するコマンド。システムの PATH で見つかるか、フルパスを指定してね。	"npx", "node", "python", "docker"
args	No	コマンドに渡す引数配列	["server.py", "--port", "3000"]
env	No	サーバー用の環境変数	{"API_KEY": "${input:api-key}"}
envFile	No	追加の変数を読み込むための環境ファイルのパス	".env", "${workspaceFolder}/.env"

Extension API の使用

プログラムによる MCP サーバーの登録のために、Cursor は mcp.json ファイルを変更せずに動的に設定できる拡張 API を提供してる。これは特にエンタープライズ環境や自動セットアップのワークフローで役立つ。

MCP Extension API リファレンス

vscode.cursor.mcp.registerServer() を使ってプログラムで MCP サーバーを登録する方法を学ぶ

設定場所

プロジェクト設定

プロジェクト専用のツール用に、プロジェクト直下に .cursor/mcp.json を作成してね。

グローバル設定

どこでも使えるツール用に、ホームディレクトリに ~/.cursor/mcp.json を作成してね。

設定の補間（Interpolation）

mcp.json の値で変数を使えるよ。Cursor は次のフィールド内の変数を解決する: command、args、env、url、headers。

サポートされる構文:

• ${env:NAME} 環境変数
• ${userHome} ホームフォルダへのパス
• ${workspaceFolder} プロジェクトルート（.cursor/mcp.json を含むフォルダ）
• ${workspaceFolderBasename} プロジェクトルート名
• ${pathSeparator} と ${/} OS のパス区切り文字

例

{
  "mcpServers": {
    "local-server": {
      "command": "python",
      "args": ["${workspaceFolder}/tools/mcp_server.py"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "remote-server": {
      "url": "https://api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
      }
    }
  }
}

認証

MCP サーバーは認証に環境変数を使うよ。API キーやトークンは config 経由で渡してね。

Cursor は、必要なサーバー向けに OAuth にも対応してるよ。

チャットでの MCP の使い方

Composer Agent は、必要に応じて Available Tools に一覧表示されている MCP ツールを自動で使うよ。特定のツール名を指定するか、やりたいことを説明してね。設定からツールを有効化・無効化できる。

ツールの切り替え

チャットインターフェイスから直接 MCP ツールを有効／無効にできる。ツールリストでツール名をクリックすると切り替わる。無効化したツールはコンテキストに読み込まれず、Agent でも利用できない。

ツールの承認

エージェントはデフォルトで MCP ツールを使う前に承認を求めるよ。引数を確認するには、ツール名の横にある矢印をクリックしてね。

自動実行

Agent が確認なしで MCP ツールを使えるように自動実行をオンにしよう。ターミナルコマンドみたいに動くよ。Yolo モードの詳しい話はここを見てね。

ツールのレスポンス

Cursor は、引数とレスポンスを展開できるビュー付きで、チャットにレスポンスを表示するよ:

コンテキストとしての画像

MCP サーバーは画像（スクリーンショットやダイアグラムなど）を返せる。base64 エンコード文字列として返してね:

const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ 可読性のため base64 全体を省略

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});

実装の詳細はこのサーバー例を見てね。Cursor は返された画像をチャットに添付する。モデルが画像に対応していれば、それを解析する。

セキュリティ上の考慮事項

MCP サーバーをインストールするときは、次のセキュリティプラクティスを意識しよう:

• ソースの検証: 信頼できる開発者やリポジトリの MCP サーバーだけをインストールする
• 権限の確認: サーバーがアクセスするデータや API をチェックする
• API キーの制限: 権限を必要最小限に絞った制限付き API キーを使う
• コードレビュー: 重要な統合では、サーバーのソースコードを確認する

MCP サーバーは外部サービスにアクセスできて、きみの代わりにコードを実行できることを忘れないで。インストール前に、そのサーバーが何をするのか必ず把握しておこう。

実例

MCP が実際にどう動くかの実践例は、開発ワークフローに Linear、Figma、ブラウザツールを統合する方法を紹介している Web Development ガイドをチェックしてね。

よくある質問

MCP サーバーって何のためにあるの？

MCP サーバーは、Cursor を Google Drive や Notion などの外部ツール／サービスにつなげて、ドキュメントや要件をコーディングのワークフローに取り込むための仕組みだよ。

MCP サーバーの不具合はどうやってデバッグする？

MCP のログを見るには: 1. Cursor で Output パネルを開く（Ctrl+Shift+U） 2. ドロップダウンから「MCP Logs」を選ぶ 3. 接続エラー、認証エラー、サーバークラッシュがないか確認 ログにはサーバーの初期化、ツール呼び出し、エラーメッセージが出るよ。

MCP サーバーを一時的に無効化できる？

できるよ！削除せずにオン／オフを切り替えられる: 1. 設定を開く（ Ctrl+Shift+J） 2. Features → Model Context Protocol に進む 3. 任意のサーバーのトグルをクリックして有効／無効化 無効化したサーバーは読み込まれず、 チャットにも出てこない。トラブルシューティングやツールの散らかりを減らすのに便利。

MCP サーバーがクラッシュしたりタイムアウトしたらどうなる？

MCP サーバーが失敗した場合: - Cursor はチャットにエラーメッセージを表示 - ツール呼び出しは失敗としてマーク - 操作を再試行するか、ログで詳細を確認できる - 他の MCP サーバーは通常どおり動作 Cursor はサーバーの障害を分離して、1 つのサーバーが他に影響しないようにしてるよ。

MCP サーバーをどうやって更新する？

npm ベースのサーバーの場合: 1. 設定からサーバーを削除 2. npm キャッシュをクリア: npm cache clean --force 3. 最新版を取得するためにサーバーを再追加 カスタムサーバーはローカルのファイルを更新して、Cursor を再起動してね。

機密データで MCP サーバーを使っても大丈夫？

大丈夫、でもセキュリティのベストプラクティスに従ってね: - シークレットは環境変数を使い、ハードコードしない - 機密性の高いサーバーは stdio トランスポートでローカル実行 - API キーの権限は必要最小限に絞る - 機密システムに接続する前にサーバーコードをレビュー - サーバーを分離環境で動かすことも検討してね