エージェントを既存のモデル コンテキスト プロトコル (MCP) サーバーに接続する

モデル コンテキスト プロトコル (MCP) サーバーを既に設定している場合は、MCP サーバーをエージェントに接続できます。

Copilot Studioでエージェントを MCP サーバーに接続するには、次の 2 つの方法があります。

  • MCP オンボード ウィザードを使用して、Copilot Studioに MCP サーバーを追加 (推奨)
  • Power Appsを使用してサーバーへのカスタム コネクタを作成する

MCP サーバーをまだ設定していない場合は、「 新しい MCP サーバーを作成 する」を参照してください。

サポートされているトランスポート

MCP では、転送はクライアント/サーバー通信の基盤です。 トランスポートは、メッセージの送受信のメカニズムを処理します。 現在、Copilot Studioはストリーミング可能なトランスポートの種類をサポートしています。

Note

SSE トランスポートが 非推奨になったため、Copilot Studio は 2025 年 8 月以降、MCP の SSE をサポートしなくなりました。

既存の MCP サーバーに接続する最も簡単な方法は、MCP オンボード ウィザードを使用してCopilot Studio内に直接接続することです。

このメソッドには、次の 2 つの部分があります。

  • 基本的な MCP サーバーの詳細を構成する
  • MCP サーバーで認証を構成する

基本的なサーバーの詳細を構成する

  1. エージェントの [ツール] ページに移動します。

  2. ツールの追加を選択します。

  3. [新しいツール] を選択します。

  4. [モデル コンテキスト プロトコル] を選択します。 MCP オンボード ウィザードが表示されます。

    MCP オンボード ウィザードのスクリーンショット

  5. サーバー名、サーバーの説明、サーバーの URL の各フィールドに必要なフィールドを入力します。 MCP サーバーの動作について簡潔かつ明確に説明してください。 エージェント オーケストレーターは、この情報を使用して、実行時にサーバーを呼び出すかどうかを識別します。

  6. 該当する場合は、MCP サーバーの認証の種類を選択します。 次の 3 つのオプションがあります。

  7. [なし] を選択した場合は、[作成] を選択します。 [ ツールの追加] ダイアログが表示されます。 「 新しい接続の作成」に進み、MCP サーバーをエージェントに追加します。

MCP サーバーで認証を構成する

サーバーで認証が必要な場合は、次の 2 つのオプションがあります。

  • API キー: MCP サーバーが認証に API キーを必要とする場合、このオプションを選択します。 API キーは、サーバーで認証するための簡単なオプションです。 エージェントのユーザーは API キーを提供し、エージェントはそれを MCP サーバーへの要求に含めます。
  • OAuth 2.0: MCP サーバーで認証に OAuth 2.0 を使用している場合は、このオプションを選択します。 OAuth 2.0 では、個々のユーザーがサーバーで認証を行い、資格情報を共有せずにアプリケーション (エージェント) にアクセス許可を付与できます。

認証を使用する場合は、認証の詳細を構成する必要があります。 手順は、選択した認証の種類によって異なります。

API キー認証を構成する

  1. 認証の種類として API キー を選択します。 API キーを構成するためのその他のフィールドが表示されます。

  2. 使用する API キーの 種類 を選択します。 次の 2 つのオプションがあります。

    • ヘッダー: MCP サーバーが要求ヘッダーで API キーを送信する必要がある場合は、このオプションを選択します。
    • クエリ: MCP サーバーで API キーを URL のクエリ パラメーターとして送信する必要がある場合は、このオプションを選択します。

  3. API キーを含めるヘッダーまたはクエリ パラメーターの名前を入力します。

  4. 作成を選択します。 [ ツールの追加] ダイアログが表示されます。 「 新しい接続の作成」に進み、MCP サーバーをエージェントに追加します。

OAuth 2.0 認証を構成する

  1. 認証の種類として OAuth 2.0 を選択します。

  2. 使用する OAuth 2.0 認証の 種類 を選択します。 次の 3 つのオプションがあります。

    • 動的検出: MCP サーバーが検出メカニズムを使用した OAuth 2.0 動的クライアント登録 (DCR) をサポートしている場合は、このオプションを選択します。 クライアントは探索エンドポイントを使用して、必要なエンドポイントを自動的に検出し、ID プロバイダーに自身を登録できます。
    • 動的: MCP サーバーが動的 OAuth 2.0 DCR をサポートしているが、動的検出メカニズムをサポートしていない場合は、このオプションを選択します。 クライアントは ID プロバイダーに登録できますが、必要なエンドポイントを手動で指定する必要があります。
    • 手動: MCP サーバーで OAuth 2.0 設定の手動構成が必要な場合は、このオプションを選択します。
動的発見

MCP サーバーで OAuth 2.0 動的クライアント登録 (DCR) メカニズムがサポートされている場合は、動的検出オプションを使用できます。 サポートされている場合、検出を使用した DCR は、Copilot Studioで MCP サーバーで OAuth 2.0 認証を構成する最も簡単な方法です。

OAuth 2.0 の動的検出が選択されている MCP オンボード ウィザードのスクリーンショット

  1. OAuth 2.0 認証の種類として [ 動的検出 ] を選択します。

  2. [ 作成] を選択してサーバーを追加します。 クライアントは探索エンドポイントを使用して、必要なエンドポイントを自動的に検索し、ID プロバイダーに登録します。

  3. [次へ] を選択して続行します。 [ ツールの追加] ダイアログが表示されます。

  4. 新 しい接続の作成に進み、MCP サーバーをエージェントに追加します。

動的

  1. OAuth 2.0 認証の種類として [ 動的 ] を選択します。

  2. 必須フィールドを入力してください。

    • 承認 URL: クライアント登録と承認エンドポイントにアクセスできる ID プロバイダー サーバーの URL。
    • トークン URL テンプレート: エージェントがアクセス トークンと更新トークンの承認コード (または更新トークン) を交換するエンドポイント。 アクセス トークンを使用すると、エージェントはユーザーの代わりに MCP サーバーを使用できます。 更新トークンを使用すると、以前のアクセス トークンの有効期限が切れたときに、エージェントは更新エンドポイントから新しいアクセス トークンと更新トークンを取得できます。

  3. [ 作成] を選択してサーバーを追加します。 構成によっては、 コールバック URL が表示される場合があります。 コールバック URL は、ユーザーがサインインしてエージェントにアクセス許可を付与すると、ID プロバイダーが承認コードで応答する場所です。

  4. コールバック URL が表示された場合は、コールバック URL をコピーして、アプリケーションの ID プロバイダーへの登録に追加します。

  5. [次へ] を選択して続行します。 [ ツールの追加] ダイアログが表示されます。

  6. 新 しい接続の作成に進み、MCP サーバーをエージェントに追加します。

手動

  1. OAuth 2.0 の種類として [ 手動 ] を選択します。 OAuth 2.0 の設定を構成するためのその他のフィールドが表示されます。

  2. 必須フィールドを入力してください。

    • クライアント ID: アプリを登録するときに ID プロバイダーが発行するクライアント識別子。 クライアント ID を使用すると、ID プロバイダーは、要求を行っているアプリを認識できます。
    • クライアント シークレット: アプリを登録するときに ID プロバイダーが発行するクライアント シークレット。 エージェントはクライアント シークレットをクライアント ID と共に送信して、エージェントが MCP サーバーのアクセス トークンを要求する権限があることを証明します。
    • 承認 URL: エージェントがユーザーをリダイレクトしてサインインし、アクセス許可をエージェントに付与する ID プロバイダー エンドポイント (エージェント チャットに表示される同意カード)。 ユーザーはここで認証を行い、ID プロバイダーは 承認コードを使用してエージェントに応答します。
    • トークン URL テンプレート: エージェントが承認コード (または更新トークン) を アクセス トークン と 更新トークンと交換するエンドポイント。 アクセス トークンを使用すると、エージェントはユーザーの代わりに MCP サーバーを使用できます。 更新トークンを使用すると、以前のアクセス トークンの有効期限が切れたときに、エージェントは更新エンドポイントから新しいアクセス トークンと更新トークンを取得できます。
    • 更新 URL: 更新トークンを使用して新しいアクセス トークンを要求するエンドポイント (トークンの有効期限が切れたときにユーザーが再びサインインする必要がないようにするため)。
    • スコープ (省略可能): アプリが要求するアクセス許可 (スペース区切りリスト)。

  3. [ 作成] を選択してサーバーを追加します。 コールバック URL が表示されます。 コールバック URL は、ユーザーがサインインしてエージェントにアクセス許可を付与すると、ID プロバイダーが承認コードで応答する場所です。

  4. コールバック URL をコピーして、アプリケーションの ID プロバイダーへの登録に追加します。

  5. [次へ] を選択して続行します。 [ ツールの追加] ダイアログが表示されます。

  6. 新 しい接続の作成に進み、MCP サーバーをエージェントに追加します。

新しい接続を作成し、MCP サーバーをエージェントに追加する

  1. [追加] ツールで、[MCP サーバーの新しい接続を作成する] を選択するか、既存の接続を使用します。

  2. [ エージェントに追加] を 選択して、MCP サーバーのエージェントへの追加を完了します。

オプション 2: Power Apps でカスタム MCP コネクタを作成する

Power Apps でカスタム コネクタを手動で作成して、サーバーへの接続を構成できます。

この手順を実行するには、MCP サーバーのスキーマ ファイルが必要です。 スキーマ ファイルは、OpenAPI 仕様の YAML ファイルで、MCP サーバーの API を記述します。

仕様ファイルの構成例については、提供されている MCP サーバー スキーマのサンプルを参照してください。

  1. エージェントの [ツール] ページに移動します。

  2. ツールの追加を選択します。

  3. [新しいツール] を選択します。

  4. [カスタム コネクタ] を選択します。 Power Appsに移動し、新しいカスタムコネクタを作成します。

  5. 新しいカスタム コネクタ を選択します。

  6. OpenAPI ファイルのインポートを選択します。

  7. スキーマ ファイルに移動し、インポート を選択してファイルをインポートします。

  8. Continue を選択して、Power Appsでセットアップを完了します。 セットアップ プロセスの詳細については、 OpenAPI 定義のインポートのPower Appsドキュメントを参照してください。

MCP サーバー スキーマの例

架空のデータを使用する MCP サーバーの OpenAPI スキーマ ファイルのサンプルを YAML 形式で次に示します。 独自のMCPサーバーの詳細を入力する必要があります。 このサンプルでは、Streamable トランスポートの種類を使用します。

swagger: '2.0'
info:
  title: Contoso
  description: MCP Test Specification, YAML for streamable MCP support in Copilot Studio
  version: 1.0.0
host: contoso.com
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Contoso Lead Management Server
      x-ms-agentic-protocol: mcp-streamable-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success

MCP 接続の編集

MCP コネクタを編集するか、カスタム パラメーターを追加するには:

  1. Power Apps または Power Automate ポータルに移動し、[ カスタム コネクタ] を選択します。
  2. コネクタの一覧でコネクタ ファイルを見つけ、使用可能な方法のいずれかを使用して必要な更新を行います。
  • Last updated on