統合

コーディングエージェント向け MCP:エージェントをスタックに接続する方法

読了時間 2分

エージェントはすでにリポジトリ内で作業できます。コードを検索し、ファイルを編集し、コマンドを実行し、Web を確認できます。しかし、エラートラッカー、データベース、チケット、ドキュメントにはアクセスできません。これらを接続するまでは、エディターの外部にある情報が必要になると作業が止まります。

モデルコンテキストプロトコル (MCP) は、エージェントを外部のツールやデータに接続するオープンスタンダードです。MCP サーバーを接続すれば、エージェントはスキーマを尋ねるのではなくデータベースをクエリできます。チケットに何を書くべきかを説明するのではなく、チケットを開けます。

このアクセスの有無が、チームが頼りにできるエージェントと、孤立してコードを書くエージェントを分けます。そのため、コーディングエージェント MCP の戦略は、チームが早い段階で取り組むべき課題の一つです。このガイドでは、MCP が実際にコーディングエージェントに何をもたらすのか、まず接続すべきサーバー、そして数分で追加する方法を紹介します。

なぜエージェントには実際のツールへのアクセスが必要なのか

作業の重心は、コードを書くことから、それを取り巻くループを回すことへ移りつつあり、コーディングエージェントはすでに、そのためにより多くのツールを使おうとしています。私たちの使用状況でも、直近2か月の間に、セッションあたりの平均ツール呼び出し数は約30%増加しました。これは、エージェントが1つのタスクの中で、これまで以上に頻繁にファイルを読み、コードを検索し、コマンドを実行し、Webを確認しているためです。

そのツール呼び出しの一つひとつで、統合が用意されているか、あるいはエージェントが行き詰まるかが決まります。MCPは、そうした呼び出しをそれぞれ行き止まりではなく実際に機能する接続に変えます。どれほど賢いモデルでも、エラートラッカーを見られなければ、ステージング環境へのデプロイがなぜ失敗したのかはわかりません。同じモデルをトラッカー、データベース、Issueキューに接続すれば、症状の把握から修正まで問題全体を進められることがよくあります。MCPは、こうした接続をポータブルにする仕組みです。そのため、一度設定したサーバーを、チームが必要とするエージェントや各種サーフェスでそのまま利用できます。

接続前のご質問

初めてコーディングエージェント MCP を設定するなら、サーバーのインストールを始める前に、まず次の点を決めておきましょう。

MCP サーバーとは?

MCP サーバーは、1 つのツールやデータソース (データベース、API、SaaS 製品など) を モデルコンテキストプロトコル 経由で公開する小さなアダプターで、MCP 対応のエージェントならどれでも利用できます。コーディングエージェント MCP 設定では、エージェントがクライアントで、サーバーがコネクターです。MCP サーバーは ツール、プロンプト、リソースといった機能をプロトコル経由で公開します。実際には、その大半を自分で実装する必要はありません。ベンダーやコミュニティが提供したものを使い、エージェントからそれを参照するだけです。

MCPはプラグインや一般的なAPI統合と何が違うのでしょうか?

プラグインは1つのアプリ向けに作られます。生のAPI統合は特定の2つのシステム向けに作られるため、別のエージェントで使うにはまた作り直す必要があります。MCPはその間に入る標準レイヤーなので、一度書いたサーバーは、そのプロトコルに対応するどのクライアントでも使えます。SentryやPostgresをMCP経由で接続すれば、CursorでもほかのMCPクライアントでも、その都度専用の統合を作らなくても同じように使えます。

エージェントはこれらのツールを勝手に実行するのですか?

エージェントは、あなたが許可したアクセス範囲内で、作業の一環としてそれらを呼び出します。どのサーバーをインストールするかはあなたが選び、機密性の高いものについては OAuth で認証するため、サーバーがアクセスできるのはあなたのアカウントに許可された範囲に限られます。リモートサーバーは、サーバーが必要とする場合は OAuth、またはヘッダーと API キーで認証できます。ローカルサーバーはあなたのマシン上でシェルコマンドとして実行されます。エージェントに与えられるのはあらかじめ定義されたツールセットであり、あなたのシステムに対する無制限の権限ではありません。

優れた MCP サーバーとノイズの多いものは何が違うのでしょうか?

優れたものは、名前がわかりやすく厳選されたアクション群をエージェントに提供するので、エージェントはそれらをいつ使うべきか判断できます。よくないものは、価値の低いツールを何十個もすべてのプロンプトに詰め込み、未使用のツール説明でコンテキストウィンドウを膨らませます。これはサーバーを追加するほど悪化します。まずは、タスクの途中で実際によく使うシステム向けのサーバー、たとえばデータベースやエラートラッカーなど、作業中に何度も Alt-Tab して開いているものから始め、本当に必要なワークフローが出てきたときにだけ追加しましょう。

ユースケース別:Cursor におすすめの MCP サーバー

Cursor マーケットプレイス には、ワンクリックでインストールでき、MCP サーバー (多くの場合はルールやスキルも) を同梱した公式プラグインが掲載されています。以下は、ユースケース別にまとめた、まず接続しておきたい MCP サーバーです。

データベース。 エージェントにスキーマやデータへの読み取りアクセス (必要に応じて慎重に書き込める権限も) を与えることで、テーブルを推測で扱わなくて済むようにします。

  • Supabase: Supabase プロジェクト全体で、テーブルの管理、設定の取得、データのクエリを行えます。
  • MongoDB: データベースに接続し、データを調査し、コレクションを管理し、クエリを最適化できます。
  • Neon Postgres: Neon MCP サーバー経由で、Neon のプロジェクトやデータベースを管理できます。
  • Prisma: データベース開発向けの MCP サーバー、ルール、スキルを提供します。

開発ワークフロー。 作業の管理、リリース、監視を行うツールにエージェントを組み込みます。

  • Linear: Linear workspace 全体で、Issue、プロジェクト、ドキュメントを管理できます。
  • Sentry: エラーや trace を取り込み、エージェントが実際の本番 Issue をもとにデバッグできるようにします。
  • GitLab: エディタから Issue、merge request、パイプラインの計画や管理を行えます。
  • Datadog: あらかじめ設定済みの MCP サーバー (プレビュー) 経由で、ログ、メトリクス、trace、ダッシュボードをクエリできます。

注: GitHub は Cursor にネイティブ統合された機能のため、MCP リストには含まれていません。Cursor GitHub アプリ は、ダッシュボードからリポジトリを接続し、クラウドエージェントや Bugbot などの機能が PR に対して動作できるようにします。mcp.json で追加するのではなく、Integrations で一度接続します。

ブラウザ自動化。 エージェントに実際のブラウザを操作させて、テストやバグの再現、ライブデータの取得を行います。

  • Browserbase Browse: MCP 経由で、ページ移動、クリック、フォーム入力、データ抽出、スクリーンショットの取得を行えます。
  • BrowserStack: 実機でサイトやモバイルアプリをテストし、不具合をデバッグできます。
  • Bright Data: Web データプラットフォーム上で、Web 検索、コンテンツ抽出、ブラウザ自動化を行えます。

ドキュメント取得。 古い training data ではなく、最新かつバージョン固有のドキュメントをエージェントに参照させます。

  • Context7: 最新のバージョン固有ドキュメントやコード例を、そのままコンテキストに取り込めます。
  • Notion: チームのドキュメント、仕様、要件をコーディングワークフローに取り込めます。

marketplace にはほかにも多くのサーバー (Figma、Stripe、Postman など) が掲載されています。自分の技術スタックに合わせて確認してみてください。新しいサーバーは定期的に追加されています。

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

方法は 2 つあります。Marketplace からワンクリックで追加する方法と、カスタムのものを小さな設定ファイルで追加する方法です。

How to add an MCP serverMarketplace click, or a small config fileOne clickCursor MarketplaceBrowse official serversAdd to CursorInstall + OAuthReady to useConfig filemcp.jsonProject or home directoryCommand or URLLocal or remote serverReady to use
Two ways to add an MCP server in Cursor: one click from the marketplace, or a config file.

ワンクリック。 Marketplace の掲載ページで Add to Cursor をクリックすると、サーバーをインストールし、OAuth で認証できます。上記のサーバーに接続するには、これが最も手早い方法です。

設定ファイル。 カスタムまたはセルフホストのサーバーは、mcp.json に追加します。プロジェクト固有のツールにはプロジェクト内の .cursor/mcp.json を、どこでも利用可能なツールにはホームディレクトリ内の ~/.cursor/mcp.json を使います。ローカルの (コマンドベースの) サーバーは次のようになります。

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

リモート (HTTP または SSE) サーバーでは、代わりに URL を使います:

{
  "mcpServers": {
    "server-name": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "API_KEY": "value"
      }
    }
  }
}

チーム向け。 管理者はダッシュボードからクラウドエージェント向けに Team MCP サーバーを一度設定でき、同じサーバーをエージェントウィンドウ、IDE、CLI 向けのチーム Marketplace にリンクできます。チームメイトは引き続きインストールと認証が必要になる場合がありますが、各自が mcp.json を手作業で編集する必要はありません。

ドキュメントでは、トランスポート、認証、完全な設定リファレンスを扱っています。詳しくは cursor.com/docs/mcp をご覧ください。

独自の MCP サーバーを構築する

社内サービス用のサーバーがない場合は、自分で構築できます。stdout に出力するか HTTP エンドポイントを提供できる任意の言語で作成し、API をラップする、適切に命名された少数のツールを公開します。

最も手早く始めるには、エージェントに作成させます。Cursor でサービスの API リファレンス、OpenAPI 仕様、またはクライアントライブラリを参照し、必要なエンドポイント用の MCP サーバーのひな形を作成するよう依頼します。エージェントはスキーマを読み取り、各ツールの JSON スキーマとハンドラーを生成し、認証を組み込めるため、空のファイルから始める代わりにレビューと改善に集中できます。ツールセットは絞り込み、各アクションには明確な名前を付け、サードパーティ製のものと同じようにサーバーを mcp.json に追加します。

すでに使っている技術スタックに組み込む

モデル単体でもコードは書けます。ですが、MCP であなたが作業するシステムにつながったコーディングエージェントなら、チケットから修正までタスクを進めながら、途中で自分の作業内容も確認できます。MCP は、そうした接続を使っているツールをまたいで持ち運べるようにします。自分たちの技術スタックに合うサーバーを 2 つか 3 つ選んで接続し、頻繁に切り替えているシステムへの直接アクセスをエージェントに与えてください。

カテゴリー: 統合