次の方法で共有

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

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

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

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

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

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

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

注

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 キーは、アプリケーション (エージェント) のみがサーバーで認証する必要がある場合の単純なオプションです。
  • 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 で 認証コードを使用してエージェントに応答します。
    • トークン 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. [ 続行] を選択して、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