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

MCP サーバーの接続

Model Context Protocol (MCP) サーバーは、外部オブザーバビリティツール、カスタムモニタリングシステム、運用データソースからのデータへのアクセスを提供することで、 AWS DevOps Agent の調査機能を拡張します。このガイドでは、MCP サーバーを AWS DevOps エージェントに接続する方法について説明します。

要件

MCP サーバーを接続する前に、サーバーが次の要件を満たしていることを確認してください。

セキュリティに関する考慮事項

MCP サーバーを AWS DevOps エージェントに接続するときは、次のセキュリティ面を考慮してください。

MCP ツールの最大ツール名の長さは 64 文字です。エージェントスペースごとに許可される MCP ツールの最大数については、「」を参照してくださいクォータ。

プロンプトインジェクションと責任共有モデルの詳細については、AWS DevOps エージェントセキュリティ「」を参照してください。

コミュニティ MCP サーバー

AWS DevOps エージェントツールリポジトリには、Amazon Elastic Kubernetes Service (Amazon EKS) ノードログ収集、Amazon Virtual Private Cloud (Amazon VPC) DNS 解決プローブ、Amazon Relational Database Service (Amazon RDS) データベースヘルスチェックなどのディープインフラストラクチャ診断用のカスタムツールをエージェントに提供するデプロイ可能な MCP サーバーが含まれています。リポジトリは AWS DevOps エージェントサービスチームによって管理され、すべてのコントリビューションは追加される前に同じセキュリティレビューバーを通過します。利用可能なものを参照するには、GitHub ウェブサイトの MCP サーバーカタログを参照してください。

コミュニティ MCP サーバーを使用するには:

MCP サーバーの登録 (アカウントレベル)

MCP サーバーは AWS アカウントレベルで登録され、そのアカウントのすべてのエージェントスペース間で共有されます。個々のエージェントスペースは、各 MCP サーバーから必要な特定のツールを選択できます。

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

ステップ 2: 認可フロー

MCP サーバーの認証方法を選択します。

OAuth クライアント認証情報 – MCP サーバーが OAuth クライアント認証情報フローを使用している場合:

OAuth 3LO (Three-Legged OAuth) – MCP サーバーが認証に OAuth 3LO を使用している場合:

API キー – MCP サーバーが API キー認証を使用する場合:

マルチ認証ヘッダー – MCP サーバーが、名前を付けた HTTP ヘッダーに 1 つ以上のシークレットを想定している場合:

AWS SigV4 – MCP サーバーが AWS 署名バージョン 4 認証を使用している場合:

ステップ 3: 認可設定

選択した認証方法に基づいて追加の認可パラメータを設定します。

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

OAuth 3LO の場合:

API キーの場合:

マルチ認証ヘッダーの場合:

マルチ認証ヘッダー認証は、最大 3 つのシークレットを MCP サーバーに送信します。各シークレットは、名前を付けたヘッダーにあります。複数の認証情報を必要とするサーバーに使用します。たとえば、Datadog は の API キーDD-API-KEYと のアプリケーションキーを想定していますDD-APPLICATION-KEY。選択したヘッダーに 1 つのシークレットを必要とするサーバーも機能します。

AWS DevOps Agent は、HTTP インフラストラクチャまたは MCP プロトコルが予約するヘッダー名を拒否します。予約名には、Host、Content-Type、、Content-Length、Cookie、Accept、User-Agentおよび が含まれますMcp-Session-Id。x-amz-、、x-amzn-、Proxy-、または x-forwarded-で始まる名前も拒否Sec-されます。 Authorization は許可されているため、 にトークンを、別の ヘッダーに Authorization 2 番目のシークレットを期待するサーバーを登録できます。

AWS DevOps エージェントは各シークレットを暗号化して保存し、サーバーを登録した後は再度表示しません。後で値が必要な場合は、独自のコピーを保持します。これは、署名付きリクエストごとにプレーンテキスト値を送信する、 AWS SigV4 設定ステップのオプションのカスタムヘッダーフィールドとは異なります。

For AWS SigV4:

AWS SigV4 認証により、 AWS DevOps Agent は AWS 署名バージョン 4 を使用してリクエスト署名を行う MCP サーバーに接続できます。これは、Amazon API Gateway または SigV4 認証をサポートする他の AWS サービスでホストされている MCP サーバーに役立ちます。

ステップ 4: 確認して送信する

エージェントスペースでの MCP ツールの設定

アカウントレベルで MCP サーバーを登録したら、そのサーバーから特定のエージェントスペースで使用できるツールを設定できます。

AWS DevOps Agent は、このエージェントスペースの調査中に MCP サーバーから許可リストに登録されたツールを使用できるようになりました。

エージェントが MCP ツールを読み取り専用アクションまたは変更アクションとして呼び出すことができるかどうかを制御するには、各ツールを分類します。toolDetails デフォルトを読み取り専用に指定せずにプログラムで登録するツール。エージェントは承認をリクエストせずにそれらを実行します。MCP ツールを読み取り専用または変更として分類する方法の詳細については、「」を参照してください有向アクションの使用。

MCP サーバー接続の管理

認証情報の更新 – 登録済みの MCP サーバーの認証情報は、登録を解除することなく更新できます。 AWS DevOps Agent コンソールの Capability Providers ページに移動し、MCP サーバーを選択し、Actions メニューから Update を選択します。エージェントスペースの関連付けは保持されます。更新できる内容は、認証方法によって異なります。

OAuth クライアント認証情報またはマルチ認証ヘッダーを使用する MCP サーバーは更新できません。マルチ認証ヘッダー認証は登録時にのみ使用できるため、シークレットをローテーションしたり、登録されたサーバーでヘッダーの名前を変更したりするパスはありません。これらの認証情報を変更するには、アクティブな関連付けを削除し、MCP サーバーを登録解除して、新しい値で再登録します。

接続された MCP サーバーの表示 – エージェントスペースに接続されているすべての MCP サーバーを表示するには、エージェントスペースを選択し、機能タブに移動して MCP サーバーセクションを確認します。選択したツールをここで更新することもできます。

MCP サーバー接続の削除 – MCP サーバーをエージェントスペースから切断するには、MCP サーバーセクションでサーバーを選択し、削除を選択します。MCP サーバー登録を完全に削除するには、まずすべてのエージェントスペースから削除してから、アカウントレベルの登録を削除します。

SigV4 認証用の IAM ロールの作成

AWS SigV4 認証を使用する場合、 AWS DevOps Agent はアカウントの IAM ロールを引き受けて MCP サーバーへのリクエストに署名します。このロールには、 AWS DevOps エージェントサービスプリンシパル (aidevops.amazonaws.com) が混乱した代理保護で引き受けることを許可する信頼ポリシーが必要です。

信頼ポリシー

次の信頼ポリシーを使用して IAM ロールを作成します。を AWS リージョン ( などus-east-1) REGIONに、 を AWS アカウント ID ACCOUNT_IDに置き換えます。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "aidevops.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "ACCOUNT_ID"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:aidevops:REGION:ACCOUNT_ID:service/*"
        }
      }
    }
  ]
}

信頼ポリシーには、混乱した代理問題を防ぐための以下の条件が含まれています。

アクセス許可ポリシー

MCP サーバーの呼び出しに必要な最小限のアクセス許可を付与するアクセス許可ポリシーをロールにアタッチします。例えば、MCP サーバーが Amazon API Gateway の背後でホストされている場合、ロールには API Gateway リソースに対するexecute-api:Invokeアクセス許可が必要です。

マルチリージョン署名 (SigV4a)

MCP サーバーが複数の AWS リージョンにデプロイされている場合は、SigV4a (署名バージョン 4a) を使用してマルチリージョン署名を行うことができます。これを有効にするには、SigV4 認可を設定するときに AWS リージョン*として を入力します。SigV4a は非対称署名を使用します。これにより、1 つの署名付きリクエストを複数のリージョンで有効にできます。

専用ロールのないクロスアカウントアクセス

MCP サーバー専用の IAM ロールを登録する代わりに、ロールレス登録を使用できます。ロールなしでサーバーを登録し、エージェントスペースに既に関連付けられている AWS アカウントの IAM ロールを使用して AWS DevOps Agent がリクエストに署名します。これは、1 つの AWS アカウントにスコープされた 1 つのロールではなく、MCP サーバーがエージェントスペースに接続されているプライマリアカウントとセカンダリアカウントにまたがるリソースにアクセスする必要がある場合に便利です。

仕組み

専用ロールのないクロスアカウントアクセスは、次のように機能します。

要件

ロールレス SigV4 MCP サーバーをエージェントスペースに関連付ける前に:

トラブルシューティング

ロールレス MCP サーバーの関連付けが失敗する：「プライマリアカウントの関連付けが必要です」

専用ロールなしで MCP サーバーを登録し、関連付けが失敗した場合、エラーメッセージを確認します。サーバーがエージェントスペースにプライマリアカウントの関連付けを必要とするというエラーが表示された場合、エージェントスペースにはプライマリ AWS アカウントが接続されていません。

AWS DevOps エージェントは、エージェントスペースのプライマリ AWS アカウントの IAM ロールを使用して、ロールレス SigV4 MCP サーバーを関連付けるときに検証します。これを解決するには:

関連トピック