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

Connect ke server jauh DevOps Agen

AWS DevOps Agen menyediakan server jarak jauh khusus untuk protokol Model Context Protocol (MCP) dan Agent-to-Agent (A2A). Gunakan server ini untuk menghubungkan IDE, CLI, atau integrasi agen kustom Anda ke Ruang Agen.

Protokol yang didukung

Titik akhir

Server jarak jauh tersedia di URL regional:

https://connect.aidevops.{region}.api.aws

Untuk daftar Wilayah yang tersedia, lihatWilayah yang Didukung.

Autentikasi

Dua metode otentikasi tersedia untuk titik akhir MCP dan A2A:

Buat token akses

Prasyarat

Aktifkan token akses

Buat token

Setelah membuat token, aplikasi web menampilkan contoh konfigurasi yang dapat Anda salin langsung ke klien Anda.

Connect dengan Kiro

Untuk pengguna Kiro, kekuatan AWS DevOps Agen khusus tersedia dari IDE atau dari pasar Kiro Powers.

Langkah 1: Pasang daya

Instal kekuatan aws-devops-agent dari pasar Powers.

Langkah 2: Mengatur variabel lingkungan

Mengatur variabel lingkungan berikut untuk mengkonfigurasi koneksi:

DEVOPS_AGENT_TOKEN=<your-access-token>
DEVOPS_AGENT_REGION=<your-agent-space-region>

Langkah 3: Menyetujui variabel di Kiro

Buka Pengaturan> MCP Disetujui Env Vars dan setujui dan. DEVOPS_AGENT_TOKEN DEVOPS_AGENT_REGION Kiro tidak meneruskan variabel lingkungan ke server MCP sampai mereka disetujui.

Langkah 4: Mulai ulang Kiro

Mulai ulang Kiro untuk menerapkan perubahan.

Daya Kiro termasuk aws-mcp sebagai fallback, yang menyediakan akses AWS API langsung ketika titik akhir server jarak jauh tidak tersedia.

Connect dengan Claude Code

Untuk pengguna Claude Code, AWS DevOps Agen tersedia dari plugin Claude aws-agents-for-devsecops, yang membawa kemampuan Agen dan Agen Keamanan ke Claude. AWS DevOps AWS Instal dari plugin Claude atau repositori sumber.

Connect dengan klien MCP lainnya

Untuk MCP-compatible klien apa pun, konfigurasikan server dengan:

Konfigurasi ini juga berfungsi dengan Kiro dan Claude Code jika Anda lebih suka mengonfigurasi koneksi secara manual daripada menggunakan daya atau plugin khusus.

Contoh konfigurasi MCP:

{
  "mcpServers": {
    "aws-devops-agent": {
      "url": "https://connect.aidevops.{region}.api.aws/mcp",
      "headers": {
        "Authorization": "Bearer <your-access-token>"
      }
    }
  }
}

Ganti {region} dengan Wilayah Ruang Agen Anda (misalnya,us-east-1) dan <your-access-token> dengan nilai token.

Gunakan otentikasi SiGv4

Otentikasi SiGv4 menggunakan AWS kredensyal Anda alih-alih token akses. Plugin Kiro power dan Claude Code menyertakan dukungan SigV4 bawaanmcp-proxy-for-aws, yang menandatangani permintaan menggunakan kredensyal lokal Anda. AWS

Ketika SiGv4 digunakan

Prasyarat

Contoh konfigurasi

Untuk mengonfigurasi klien MCP agar menggunakan SiGv4 alih-alih token akses, jalankan server melalui. mcp-proxy-for-aws Ganti {region} dengan Wilayah Ruang Agen Anda (misalnya,us-east-1):

{
  "mcpServers": {
    "aws-devops-agent": {
      "command": "uvx",
      "timeout": 120000,
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://connect.aidevops.{region}.api.aws/mcp",
        "--service", "aidevops",
        "--region", "{region}"
      ]
    }
  }
}

Proxy menandatangani setiap permintaan dengan AWS kredensyal lokal Anda, jadi tidak diperlukan token akses.

Multi-Agent-Space perutean

Dalam mode SiGv4, agent_space_id teruskan setiap panggilan alat untuk menentukan Ruang Agen mana yang akan digunakan. Ini memungkinkan untuk merutekan beberapa Ruang Agen dari satu klien.

Integrasi A2A

Titik akhir A2A mengimplementasikan spesifikasi A2A v1.0 menggunakan pengikatan HTTP+JSON.

Penemuan kartu agen

Ambil kartu agen di:

GET https://connect.aidevops.{region}.api.aws/.well-known/agent-card.json

Operasi yang didukung

Keterampilan

Pertimbangan keamanan

Pelingkupan token

Daftar Izin IP

Saat membuat token akses, Anda dapat secara opsional menentukan daftar izin IP. Saat dikonfigurasi, token hanya dapat digunakan dari alamat IP atau rentang CIDR yang ditentukan. Permintaan dari IP lain ditolak dengan kesalahan akses ditolak.

Rotasi dan pencabutan token

Menanggapi token yang dikompromikan

Jika Anda mencurigai token telah disusupi, ikuti langkah-langkah berikut:

Pencabutan token secara terprogram

Anda juga dapat mencabut token secara terprogram menggunakan. awscurl Perintah berikut menggunakan otentikasi SiGv4. Ganti Region (us-east-1) dengan Region tempat Agen Space Anda dibuat.

Langkah 1: Daftar Ruang Agen Anda

aws aidevops list-agent-spaces --region us-east-1

Langkah 2: Daftar token akses untuk Ruang Agen

awscurl --service aidevops --region us-east-1 \
  -H "Accept: application/json" \
  "https://cp.aidevops.us-east-1.api.aws/v1/agentspaces/{agentSpaceId}/access-tokens"

Langkah 3: Cabut token

awscurl --service aidevops --region us-east-1 -X POST \
  -H "Accept: application/json" \
  "https://cp.aidevops.us-east-1.api.aws/v1/agentspaces/{agentSpaceId}/access-tokens/{accessTokenId}/revoke"

Ganti {agentSpaceId} dan {accessTokenId} dengan nilai dari tanggapan sebelumnya.

Ketertelusuran

Ketika token akses digunakan, AWS DevOps Agen mengambil peran atas nama Anda untuk melakukan tindakan. AssumeRolePanggilan ini masuk AWS CloudTrail dengan tag sesi yang mengidentifikasi token dan pemanggil:

Pemanggilan titik akhir MCP dan A2A langsung tidak masuk untuk kedua metode otentikasi. CloudTrail Setiap pemanggilan memiliki panggilan AWS API hilir terkait yang masuk CloudTrail, dengan nama sesi peran yang dapat diidentifikasi dalam format. token_{spaceId}_{timestamp}_{tokenName}

Batasan kebijakan titik akhir VPC

Titik akhir server jarak jauh tidak mendukung kebijakan titik akhir VPC. Panggilan yang menggunakan token akses atau otentikasi SigV4 tidak dapat dibatasi oleh kebijakan titik akhir VPC.

Menonaktifkan token akses

Fitur token akses dinonaktifkan secara default. Untuk menonaktifkannya setelah mengaktifkan:

Menonaktifkan segera memblokir semua akses berbasis token. Token yang ada tidak dihapus tetapi tidak dapat digunakan sampai fitur diaktifkan kembali.

Untuk mencegah pengguna di organisasi Anda mengaktifkan token akses, buat Kebijakan Kontrol Layanan (SCP) yang menolak tindakan API token akses dan UpdateAgentSpace tindakan (yang mengontrol sakelar token akses):

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "DenyAccessTokenOperations",
      "Effect": "Deny",
      "Action": [
        "aidevops:UpdateAgentSpace",
        "aidevops:CreateAccessToken",
        "aidevops:GetAccessToken",
        "aidevops:ListAccessTokens",
        "aidevops:RotateAccessToken",
        "aidevops:RevokeAccessToken"
      ],
      "Resource": "*"
    }
  ]
}

Pemecahan masalah