Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menghubungkan Server MCP

Server Model Context Protocol (MCP) memperluas kemampuan investigasi AWS DevOps Agen dengan menyediakan akses ke data dari alat observabilitas eksternal Anda, sistem pemantauan khusus, dan sumber data operasional. Panduan ini menjelaskan cara menghubungkan server MCP ke AWS DevOps Agen.

Persyaratan

Sebelum menghubungkan server MCP, pastikan server Anda memenuhi persyaratan ini:

Pertimbangan keamanan

Saat menghubungkan server MCP ke AWS DevOps Agen, pertimbangkan aspek keamanan berikut:

Harap dicatat bahwa panjang alat maksimum dari setiap alat MCP adalah 64.

Lihat AWS DevOps Agen Keamanan untuk informasi lebih lanjut tentang injeksi cepat dan model tanggung jawab bersama.

Mendaftarkan server MCP (tingkat akun)

Server MCP terdaftar di tingkat AWS akun dan dibagikan di antara semua Ruang Agen di akun itu. Individual Agent Spaces kemudian dapat memilih alat spesifik mana yang mereka butuhkan dari setiap server MCP.

Langkah 1: Detail server MCP

Langkah 2: Aliran otorisasi

Pilih metode otentikasi untuk server MCP Anda:

OAuth Client Client Client - Jika server MCP Anda menggunakan alur Client OAuth Client Client:

OAuth 3LO (Three-Legged OAuth) - Jika server MCP Anda menggunakan OAuth 3LO untuk otentikasi:

Kunci API - Jika server MCP Anda menggunakan otentikasi kunci API:

AWS SiGv4 - Jika server MCP Anda menggunakan otentikasi AWS Signature Version 4:

Langkah 3: Konfigurasi otorisasi

Konfigurasikan parameter otorisasi tambahan berdasarkan metode otentikasi yang dipilih:

Untuk Kredensi OAuth Klien:

Untuk OAuth 3LO:

Untuk Kunci API:

Untuk AWS SiGv4:

AWS Otentikasi SiGv4 memungkinkan AWS DevOps Agen untuk terhubung ke server MCP yang menggunakan AWS Signature Versi 4 untuk penandatanganan permintaan. Ini berguna untuk server MCP yang dihosting di belakang Amazon API Gateway atau AWS layanan lain yang mendukung otentikasi SiGv4.

Langkah 4: Tinjau dan kirimkan

Mengkonfigurasi alat MCP di Ruang Agen

Setelah mendaftarkan server MCP di tingkat akun, Anda dapat mengonfigurasi alat mana dari server tersebut yang tersedia untuk Ruang Agen tertentu:

AWS DevOps Agen sekarang akan dapat menggunakan alat yang diizinkan dari server MCP Anda selama penyelidikan di Ruang Agen ini.

Mengelola koneksi server MCP

Memperbarui kredensi otentikasi — Jika kredensi otentikasi Anda perlu diperbarui, Anda harus mendaftarkan ulang server MCP Anda. Arahkan ke halaman Penyedia Kemampuan di konsol AWS DevOps Agen, cari server MCP Anda, hapus semua asosiasi aktif, dan klik Deregister. Selanjutnya, daftarkan server MCP Anda dengan kredensi otentikasi baru dan buat ulang asosiasi yang diperlukan dengan Ruang Agen Anda.

Melihat server MCP yang terhubung — Untuk melihat semua server MCP yang terhubung ke Ruang Agen Anda, pilih Ruang Agen Anda, buka tab Kemampuan, dan periksa bagian Server MCP. Anda juga dapat memperbarui alat yang dipilih di sini.

Menghapus koneksi server MCP - Untuk memutuskan sambungan server MCP dari Ruang Agen, pilih server di bagian MCP Server dan klik Hapus. Untuk menghapus pendaftaran server MCP sepenuhnya, hapus dari semua Ruang Agen terlebih dahulu, lalu hapus pendaftaran tingkat akun.

Membuat peran IAM untuk otentikasi SiGv4

Saat menggunakan otentikasi AWS SigV4, AWS DevOps Agen mengasumsikan peran IAM di akun Anda untuk menandatangani permintaan ke server MCP Anda. Peran ini harus memiliki kebijakan kepercayaan yang memungkinkan prinsipal layanan AWS DevOps Agen (aidevops.amazonaws.com) untuk menganggapnya, dengan perlindungan wakil yang membingungkan.

Kebijakan kepercayaan

Buat peran IAM dengan kebijakan kepercayaan berikut. Ganti REGION dengan AWS Wilayah Anda (misalnya,us-east-1) dan ACCOUNT_ID dengan ID AWS akun Anda.

{
  "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/*"
        }
      }
    }
  ]
}

Kebijakan kepercayaan mencakup kondisi berikut untuk mencegah masalah wakil yang membingungkan:

Kebijakan izin

Lampirkan kebijakan izin ke peran yang memberikan izin minimum yang diperlukan untuk memanggil server MCP Anda. Misalnya, jika server MCP Anda di-host di belakang Amazon API Gateway, peran tersebut harus memiliki execute-api:Invoke izin pada sumber daya API Gateway.

Penandatanganan multi-wilayah (Sigv4a)

Jika server MCP Anda digunakan di beberapa AWS Wilayah, Anda dapat menggunakan Sigv4a (Sigv4a Versi 4a) untuk penandatanganan multi-wilayah. Untuk mengaktifkan ini, masukkan * sebagai AWS Wilayah saat mengonfigurasi otorisasi SigV4. Sigv4a menggunakan penandatanganan asimetris, yang memungkinkan satu permintaan yang ditandatangani valid di beberapa Wilayah.

Topik terkait