View a markdown version of this page

パートナーマネージドコネクタの使用 - AWS DevOps エージェント

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

パートナーマネージドコネクタの使用

パートナーマネージドコネクタは、 AWS DevOps エージェントを、パートナーがホストするモデルコンテキストプロトコル (MCP) サーバーに接続します。例としては、パートナーのオブザーバビリティやインシデント管理サービスなどがあります。パートナーは、GitHub ウェブサイトの AWS DevOps エージェントツールリポジトリにコネクタを公開します。コネクタは、サーバーのエンドポイントと受け入れる認証方法を定義します。また、パートナーが推奨するスキルを一覧表示することもできます。

コネクタを使用すると、パートナーのエンドポイント URLs、OAuth URLs、またはスコープを検索する必要はありません。エンドポイントを選択し、独自の認証情報のみを入力すると、 AWS DevOps Agent はコネクタから残りの登録を構築します。パートナーが MCP サーバー用にコネクタを発行するときは、コネクタを使用します。他の MCP サーバーを登録する手順については、「MCP サーバーの登録」を参照してください。

このトピックでは、コネクタはパートナーの定義を意味し、MCP サーバーはそこから作成する登録を意味します。コンソールは MCP サーバーの削除など、同じ用語を使用します。

コネクタは MCP サーバーを登録するため、そのツールは自分で登録した MCP サーバーと同じように機能します。コネクタには、以下も用意されています。

  • 固定設定 – エンドポイント URLs、認証方法、および OAuth URLs とスコープはコネクタから取得されます。これらは変更できません。

  • 推奨されるスキル – エージェントスペースに追加する際にコネクタが推奨するスキルをインストールできます。後で、さらにインストールしたり、オンまたはオフにしたり、削除したりできます。

  • アラートウェブフック – コネクタをエージェントスペースに追加すると、 AWS DevOps Agent はウェブフックを作成し、パートナーの製品からのアラートが調査を開始できるようにします。コネクタによっては、アラートペイロードも定義されています。

パートナーマネージドコネクタの仕組み

次のリストは、コネクタのサーバーを実行するユーザーとデータの場所を示しています。

  • サーバーオペレーション – パートナーは MCP server. AWS doesn operation を操作し、サポートします。サーバーに関するヘルプについては、コンソールのコネクタのサポートリンクを使用します。

  • コネクタメンテナンス – 各コネクタには、パートナー管理または AWS管理のバッジが表示されます。コネクタ定義を維持するバッジ名。

  • 認証情報 – 認証情報はコネクタ定義の URLsにのみ送信されます。

  • リクエスト - 選択したエンドポイントは、パートナーとのアカウントのパートナーのリージョンまたはサイトに属します。エージェントスペースの AWS リージョン外にある場合があります。接続する MCP サーバーと同様に、 はサーバーへのリクエストをその AWS リージョンから退出します。

登録とバージョン

次のリストは、登録がエージェントスペースとコネクタバージョンにどのように関連しているかを示しています。

  • 登録スコープ – コネクタを AWS アカウントに 1 回登録します。次に、それを必要とする各エージェントスペースに追加します。

  • バージョン – 登録すると、登録したコネクタバージョンが保持されます。パートナーがコネクタを廃止すると、コネクタは使用可能セクションに表示されなくなり、再度登録することはできません。現在登録されているカードには非推奨と表示され、すべてのオープンを表示するページでは、それを置き換えるコネクタに名前を付けることができます。既存の登録は、登録を解除するまで機能し続けます。

推奨スキルとは、調査中にパートナーのツールを使用するためのガイダンスなど、パートナーがコネクタに提案するスキルです。推奨されるスキルは、GitHub ウェブサイトの AWS DevOps エージェントツールリポジトリのスキルカタログから取得されます。エージェントスペースにコネクタを追加するときに、推奨されるスキルをインストールできます。後で MCP サーバーを編集すると、さらにスキルをインストールしたり、インストールされたスキルを有効または無効にしたり、削除したりできます。

インストールされた推奨スキルは、エージェントスペースに他のスキルとともに表示されます。コンテンツはカタログから取得されるため、編集することはできません。エージェントは、他のスキルと同じ方法でロードします。スキルの詳細については、DevOps エージェントスキル」を参照してください。

[開始する前に]

パートナーマネージドコネクタを使用するには、以下があることを確認します。

  • API キーや OAuth クライアントなど、コネクタに必要な認証情報を作成できるパートナーを持つアカウント。コネクタのセットアップガイドには、パートナーの製品のステップが記載されています。

  • 機能プロバイダーを登録し、 AWS DevOps エージェントコンソールでエージェントスペースに機能を追加するアクセス許可。

  • (オプション) プライベートネットワークを介してパートナーのエンドポイントに到達した場合の、既存のプライベート接続。プライベート接続の詳細については、「プライベートにホストされたツールへの接続」を参照してください。

必要なツールのみの許可リストなど、任意の MCP サーバーに適用されるセキュリティ上の考慮事項の詳細については、「セキュリティ上の考慮事項」を参照してください。

コネクタの検索

コネクタを検索して、登録する前にセットアップガイドと推奨されるスキルを確認してください。機能プロバイダーページまたはエージェントスペースから開始できます。

機能プロバイダーページでコネクタを検索する

機能プロバイダーページでコネクタを検索するには、次の手順を実行します。

  1. https://console.aws.amazon.com/devops-agent/ で AWS DevOps エージェントコンソールを開きます。

  2. ナビゲーションペインで、機能プロバイダーを選択します。

  3. 利用可能なセクションで、コネクタを見つけます。リストを絞り込むには、検索機能に名前を入力するか、カテゴリを選択します。各カードには、コネクタのバッジ、説明、カテゴリが表示されます。

  4. コネクタの名前を選択します。

コネクタのページが開きます。スキップして登録を開始するには、代わりにカードに登録を選択します。

エージェントスペースからのコネクタの検索

エージェントスペースからコネクタを検索するには、次の手順を実行します。

  1. https://console.aws.amazon.com/devops-agent/ で AWS DevOps エージェントコンソールを開き、エージェントスペースを選択します。

  2. [機能] タブを選択します。

  3. テレメトリ、通信、DevOps などのコネクタのカテゴリの セクションで、追加 を選択します。

  4. 「機能の追加」の「パートナーマネージドコネクタ」で「登録」を選択します。

  5. コネクタのリストで、コネクタの選択を選択します。

コネクタのページが開きます。

コネクタのページに表示される内容

コネクタのページには、次の情報が表示されます。

  • パートナー、コネクタバージョン、およびカテゴリ

  • パートナーのドキュメントとサポートへのリンク

  • コネクタのセットアップガイド

  • コネクタが推奨するスキル

登録を開始するには、登録を選択します。手順については、「コネクタの登録」を参照してください。

コネクタの登録

コネクタを登録すると、 AWS DevOps Agent はコネクタ定義から AWS アカウントに MCP サーバー登録を作成します。登録には 4 つのステップがあります。コンソールは、コネクタが不要なステップをスキップします。

ステップ 1: MCP サーバーの詳細

このステップでは、MCP サーバーに名前を付け、 AWS DevOps Agent が接続する場所を選択します。ステップタイトルには、Example Corp MCP サーバーの詳細など、コネクタの名前が含まれます。

ステップにセットアップガイドが表示されている場合は、フォームに入力する前に展開し、パートナーのステップを完了します。ステップ 3: 認証設定で入力した認証情報を作成する方法を示します。ステップのコピーを保持するには、コピーを選択します。

次の情報を入力します。

  • 名前 – この MCP サーバーの短縮名を入力します。コンソールはコネクタの名前を入力します。この名前は変更できます。文字、数字、ハイフン (-)、アンダースコア () を使用します_。名前は AWS アカウント内で一意である必要があります。 AWS DevOps Agent は各ツール名の先頭に名前を追加します。ツール名には最大 64 文字を含めることができるため、名前は省略してください。

  • エンドポイント – 一部のパートナーは、リージョンサイトなど、複数のエンドポイントを提供しています。その場合は、パートナーのアカウントが使用するエンドポイントを選択します。それ以外の場合は、コンソールにコネクタのエンドポイントが表示されます。エンドポイント URL は、アカウントの AWS CloudTrail ログに表示されます。

  • コネクタフィールド – 一部のコネクタは、パートナーとのインスタンスの名前など、より多くの値を要求します。各フィールドには、コネクタから渡されるラベルが表示されます。パートナーのアカウントから値を入力します。

  • プライベート接続を使用してエンドポイントに接続する – (オプション) このオプションを選択して、既存のプライベート接続を介してパートナーのエンドポイントにリクエストをルーティングします。OAuth を使用するコネクタの場合、トークン交換用に別のプライベート接続を選択できます。

  • 詳細設定 – (オプション) カスタマー管理の AWS Key Management Service (AWS KMS) キーを選択して登録を暗号化します。暗号化の詳細については、DevOps Agent の保管時の暗号化」を参照してください。

[次へ] を選択します。

ステップ 2: 認証方法

このステップでは、 AWS DevOps Agent がパートナーの製品に対して認証する方法を選択します。このステップは、コネクタが複数の認証方法を提供している場合にのみ表示されます。コネクタはメソッドの順序を定義します。次のいずれかを選択します。

  • API キー – AWS DevOps Agent は、パートナーの製品で作成したキーで認証するため、アクセス許可を制御します。

  • OAuth クライアント認証情報 – AWS DevOps Agent は、パートナーの製品で作成したクライアント ID とシークレットを使用して認証します。

  • パートナーにサインインする (例: Example Corp にサインインする) – AWS DevOps Agent は、パートナーの製品にサインインした後にユーザーに代わって動作します。

  • 動的クライアント登録でサインイン – AWS DevOps Agent は独自の OAuth クライアントをパートナーに登録し、サインイン後にユーザーに代わって動作します。

[次へ] を選択します。

ステップ 3: 認証設定

このステップでは、認証方法に必要な認証情報を入力します。コネクタで定義されるセクションには、コネクタが設定する値が表示されますが、変更することはできません。

コンソールは、動的クライアント登録でサインインするためにこのステップをスキップします。また、コネクタが独自の OAuth クライアントを提供する場合、パートナーへのサインインのこのステップもスキップされます。

API キー

API キーには、コネクタがリストする各ヘッダーの値を入力します。コネクタはヘッダー名と などのプレフィックスを設定するためBearer 、 キーのみを入力します。

OAuth クライアントの認証情報

OAuth クライアント認証情報の場合は、次の手順を実行します。

  1. パートナーの製品で作成したクライアント ID とクライアントシークレットを入力します。

  2. (オプション) 追加のスコープと追加の交換パラメータを追加します。 AWS DevOps Agent は、コネクタが定義するスコープとパラメータに加えてそれらをリクエストします。

パートナーにサインインする

パートナーにサインインするには、次の手順を実行します。

  1. コネクタが独自の OAuth クライアントを提供していない場合は、パートナーの製品で作成したクライアント ID とクライアントシークレットを入力します。パートナーがコード交換 (PKCE) の証明キーをサポートしている場合は、クライアントシークレットを空のままにしておくことができます。

  2. (オプション) スコープを追加します。

[次へ] を選択します。

ステップ 4: 確認して登録する

登録を完了するには、次の手順を実行します。

  1. 詳細を確認します。ステップを変更するには、そのステップの セクションで編集を選択します。

  2. [登録] を選択します。

  3. サインイン方法を選択した場合は、コンソールが開いたパートナーのページでサインインし、アクセスを承認します。

コンソールが AWS DevOps エージェントに戻り、登録が完了しました。エージェントスペースから登録した場合、コンソールはそのエージェントスペースにコネクタを追加するステップを開きます。機能プロバイダーページから登録した場合は、「エージェントスペースへのコネクタの追加」を参照してください。 #adding-a-connector-to-an-agent-space

登録が失敗した場合、コンソールはレビューステップにとどまり、エラーが表示されます。詳細を修正し、もう一度登録を選択します。

エージェントスペースへのコネクタの追加

エージェントスペースにコネクタを追加するときは、エージェントが使用できるツールを選択し、オプションでコネクタの推奨スキルをインストールします。機能プロバイダーページからコネクタを登録した場合は、エージェントスペースから開始します。

  1. https://console.aws.amazon.com/devops-agent/ で AWS DevOps エージェントコンソールを開き、エージェントスペースを選択します。

  2. [機能] タブを選択します。

  3. コネクタのカテゴリの セクションで、追加 を選択します。

  4. 「機能を追加する」で、コネクタから登録した MCP サーバーを見つけ、「追加」を選択します。

ステップ 1: ツールを選択する

このステップでは、エージェントがこのエージェントスペースで使用できるツールを選択します。エージェントスペースに必要なツールのみを選択します。ツールを読み取り専用または変更として分類する場合は、各ツールの分類を選択します。ツールの分類の詳細については、「指示されたアクションの使用」を参照してください。エージェントスペース内の MCP ツールの最大数の詳細については、「クォータ」を参照してください。

一部のコネクタには、Webhook 認証タイプも表示されます。パートナーの製品がエージェントスペースのアラートウェブフックに対してどのように認証されるかを選択します。HMAC (デフォルト) または API キー。独自のアラートを定義するコネクタがこれを設定します。

オプションのスキルステップをスキップするには、「スキップして確認して保存します」を選択します。それ以外の場合は[次へ] を選択してください。

このステップは、コネクタがスキルを推奨している場合にのみ表示されます。このステップでは、インストールする推奨スキルを選択します。コンソールには、コネクタが推奨するスキルが一覧表示され、何も選択されていません。エージェントスペースに既にインストールされているスキルには有効または無効が表示され、選択することはできません。インストールするスキルを選択し、次へを選択します。

ステップ 3: 確認して保存する

コネクタをエージェントスペースに保存するには、次の手順を実行します。

  1. ツール、スキル、アラートウェブフックタイプを確認します。変更するには、セクションで編集を選択します。

  2. [保存] を選択します。

AWS DevOps Agent は MCP サーバーをエージェントスペースに追加し、選択したスキルをインストールします。スキルのインストールに失敗すると、通知にリストされ、MCP サーバーはエージェントスペースに残ります。再試行するには、エージェントスペースのコネクタを編集し、スキルを選択します。手順については、「エージェントスペースでのコネクタの編集」を参照してください。

アラートウェブフックのセットアップ

保存を選択すると、コンソールでアラートウェブフックのセットアップが開きます。これは、コネクタをエージェントスペースに追加するたびに開きますが、コネクタを編集するときは開きません。ウェブフックを設定すると、ウェブフックに送信される各アラートがエージェントスペースで調査を開始します。

ウェブフックを設定するには、次の手順を実行します。

  1. Webhook URL、ヘッダーまたは署名シークレット、リクエスト本文またはリクエスト本文形式をコピーします。URL とシークレットをファイルに保存するには、.csv ファイルのダウンロードを選択します。 AWS DevOps エージェントはシークレットを 1 回だけ表示します。

  2. 「URL と認証情報を保存して保存した」を選択し、「完了」を選択します。

  3. パートナーの製品でウェブフックを設定します。手順については、コネクタのセットアップガイドを参照してください。

値は次のように機能します。

  • Webhook URL – パートナーの製品がアラートを送信する URL。

  • ヘッダー – ベアラートークンを使用するウェブフックの場合、パートナーの製品が各リクエストで送信するAuthorization: Bearerヘッダー。

  • 署名シークレット – リクエストに署名するウェブフックの場合、パートナーの製品が HMAC-SHA256 timestamp:bodyで署名するために使用するシークレット。パートナーの製品は、 x-amzn-event-timestampヘッダーのタイムスタンプと x-amzn-event-signatureヘッダーの署名を送信します。

  • リクエスト本文 – アラートを定義するコネクタの場合、アラートペイロード。アラートが発生すると、パートナーの製品はテンプレート値を入力します。

  • リクエスト本文形式 – 他のコネクタの場合、各アラートが使用する必要がある JSON 形式。各アラートに一意の を割り当てますincidentId。

表示されるヘッダーまたは署名シークレットは、ウェブフックの認証方法によって異なります。コネクタで設定するか、ツールの選択で選択します。コネクタの登録時に選択した認証方法には依存しません。

ウェブフックの認証とペイロードの詳細については、「ウェブフックを介した DevOps エージェントの呼び出し」を参照してください。紛失したシークレットの置き換えの詳細については、「ウェブフック認証情報のローテーション」を参照してください。

コネクタが表示される場所

機能タブで、コネクタはテレメトリ、パイプライン、通信、DevOps の最初のカテゴリの セクションに表示されますDevOps。最初のカテゴリが クラウドであるか、カタログにリストされなくなったコネクタが MCP サーバーセクションに表示されます。

エージェントスペースでのコネクタの編集

エージェントスペースでコネクタのツールを変更し、その推奨スキルをインストール、有効化、無効化、または削除できます。コネクタを編集するには、次の手順を実行します。

  1. https://console.aws.amazon.com/devops-agent/ で AWS DevOps エージェントコンソールを開き、エージェントスペースを選択します。

  2. 機能タブで、セクションで MCP サーバーを選択し、編集を選択します。

  3. ツールの選択で、ツールを変更します。コンソールは、保存したツールから開始します。MCP サーバーが保存されたツールを一覧表示しなくなった場合、コンソールはツールを選択から削除し、警告を表示します。

  4. 「推奨されるスキルを選択する」で、保持またはインストールするスキルを選択します。インストールされているスキルを削除するには、スキルをクリアします。

  5. (オプション) スキルステータスの設定 で、インストールされている各スキルのオン/オフを切り替えます。エージェントは、オンになっているスキルのみを使用します。このステップは、少なくとも 1 つのスキルがインストールされている場合にのみ表示されます。

  6. 確認して保存で、各スキルの変更を確認し、保存を選択します。

AWS DevOps エージェントは変更を保存し、アラートウェブフックは変わりません。保存する前に、変更によってスキルが削除されると、レビューによって警告されます。また、変更がそのコネクタにも適用されるため、エージェントスペース内の別のコネクタが無効にしたり削除したりするスキルを推奨している場合にも警告します。削除したスキルは、後で再度インストールできます。

スキルの変更が失敗した場合、通知にリストされ、その他の変更は保持されます。再試行するには、コネクタを再度編集します。

エージェントスペースからのコネクタの削除

エージェントスペースからコネクタを削除するには、次の手順を実行します。

  1. https://console.aws.amazon.com/devops-agent/ で AWS DevOps エージェントコンソールを開き、エージェントスペースを選択します。

  2. 機能タブで、そのセクションで MCP サーバーを選択し、削除を選択します。

  3. MCP サーバーの削除で確認を確認し、削除を選択します。

MCP サーバーはエージェントスペースから削除されます。また、これを削除すると、エージェントスペースにインストールされているコネクタの推奨スキルも削除されます。これには、独自にインストールした推奨スキルが含まれます。エージェントスペース内の別のコネクタでも推奨されている場合、スキルはインストールされたままになります。確認では、削除される前にスキルに名前を付けるか、スキルの数を指定します。このアクションは元に戻すことができません。

AWS DevOps Agent がインストールされているスキルを確認できない場合、確認ではそのように表示されます。この場合、スキルはインストールされたままになり、削除は MCP サーバーのみを削除します。

コネクタの更新または登録解除

コネクタ登録を検索するには、次の手順を実行します。

  1. https://console.aws.amazon.com/devops-agent/ で AWS DevOps エージェントコンソールを開きます。

  2. ナビゲーションペインで、機能プロバイダーを選択します。

  3. 現在登録されている で、コネクタのカードを検索し、すべて表示を選択します。

  4. 登録で、MCP サーバーを選択します。

登録でサインインを使用してパートナーにサインインするか、動的クライアント登録を使用してサインインする場合は、パートナーがアクセスを取り消した後など、登録を解除せずに再度サインインできます。アクションを選択し、更新を選択します。レビューステップでは、認可 URL を空のままにして、更新を選択し、パートナーのページでサインインします。 AWS DevOps エージェントはアクセスを更新し、クライアント認証情報とエージェントスペースの関連付けは変わりません。

API キーまたは OAuth クライアントの認証情報を変更するか、コネクタの新しいバージョンを使用するには、MCP サーバーを登録解除してコネクタを再登録します。登録を解除するには、まず、それを使用するすべてのエージェントスペースから MCP サーバーを削除します。手順については、「エージェントスペースからのコネクタの削除」を参照してください。次に、MCP サーバーを選択し、アクションを選択し、登録解除を選択します。コンソールは、確認を求めることなく、すぐに MCP サーバーを登録解除します。

パートナーマネージドコネクタのトラブルシューティング

パートナーマネージドコネクタの一般的な問題を解決するには、次の情報を使用します。

「このコネクタは、選択したエンドポイントの URL を定義しません」

このエラーは、コネクタ定義に選択したエンドポイントが含まれていないことを意味します。これを解決するには、別のエンドポイントを選択します。エラーが続く場合は、コネクタのサポートにお問い合わせください。

名前が使用中のため登録が失敗する

MCP サーバー名は AWS アカウント内で一意である必要があります。この問題を解決するには、ステップ 1: MCP サーバーの詳細に別の名前を入力し、再度登録します。

アラートウェブフックページに認証情報が表示されない

アラートウェブフックの設定でヘッダーや署名シークレットの代わりにエラーが表示される場合、 AWS DevOps Agent はウェブフックの認証情報を返しません。取得するには、ウェブフックをローテーションします。手順については、「ウェブフック認証情報の更新」を参照してください。

アラートが調査を開始しない

パートナーの製品は、コンソールで示されたとおりにリクエストを送信する必要があります。この問題を解決するには、次の手順に従います。

  1. パートナーの製品で、ウェブフックがコンソールからウェブフック URL を使用していることを確認します。

  2. 各リクエストに Authorizationヘッダー、または署名付きウェブフックの x-amzn-event-timestampおよび x-amzn-event-signatureヘッダーが含まれていることを確認します。

  3. リクエスト本文がコンソールのリクエスト本文またはリクエスト本文形式と一致していることを確認します。

トラブルシューティング手順の詳細については、「ウェブフックのトラブルシューティング」を参照してください。