​
MCPとは？

Model Context Protocol (MCP)により、Cursorは外部ツールやデータソースに接続できます。

​
なぜMCPを使うのか？

MCPはCursorを外部システムやデータに接続します。プロジェクト構造を繰り返し説明する代わりに、ツールと直接統合できます。 MCPサーバーはstdoutに出力するか、HTTPエンドポイントを提供できる任意の言語（Python、JavaScript、Goなど）で記述できます。

​
仕組み

MCPサーバーはプロトコルを通じて機能を公開し、Cursorを外部ツールやデータソースに接続します。 Cursorは3つのトランスポート方式をサポートしています：
トランスポート実行環境デプロイユーザー入力認証
stdioローカルCursorが管理単一ユーザーシェルコマンド手動
SSEローカル/リモートサーバーとしてデプロイ複数ユーザーSSEエンドポイントのURLOAuth
Streamable HTTPローカル/リモートサーバーとしてデプロイ複数ユーザーHTTPエンドポイントのURLOAuth

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

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

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

MCPツールを参照

利用可能なMCPサーバーを参照

Cursorに追加ボタン

「Cursorに追加」ボタンを作成

​
mcp.jsonを使用

JSONファイルでカスタムMCPサーバーを設定します： 
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

​
設定場所

プロジェクト設定

プロジェクト固有のツール用にプロジェクト内に.cursor/mcp.jsonを作成します。

グローバル設定

どこでも利用できるツール用にホームディレクトリに~/.cursor/mcp.jsonを作成します。

​
認証

MCPサーバーは認証に環境変数を使用します。設定を通じてAPIキーとトークンを渡します。 Cursorは必要なサーバーに対してOAuthをサポートしています。

​
チャットでMCPを使用する

Composer Agentは、関連する場合にAvailable Toolsの下にリストされているMCPツールを自動的に使用します。特定のツールを名前で要求するか、必要なものを説明してください。設定からツールを有効または無効にできます。

​
ツールの切り替え

チャットインターフェースから直接MCPツールを有効または無効にできます。ツールリストのツール名をクリックして切り替えます。無効にされたツールはコンテキストに読み込まれず、Agentでも使用できません。

​
ツールの承認

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開発ガイドをご覧ください。

​
FAQ