View a markdown version of this page

Panduan penyiapan agen - AWS CloudFormation
Bekerja dengan agen pengkodean AndaPrasyaratApa yang akan diinstalKode ClaudekodeksKursorKiroGitHub KopilotSelancar AnginOpenCodeUntuk semua agen lain yang kompatibel dengan keterampilan agen dan konfigurasi MCP ServerApa yang dapat Anda lakukan dengan agen AndaIzin IAMSumber daya terkait

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

Panduan penyiapan agen

Agen pengkodean AI dapat mempercepat pengembangan infrastruktur dengan memberikan bantuan cerdas untuk pembuatan CloudFormation template, validasi pra-penerapan, pemecahan masalah penerapan, dan pembuatan kode CDK. Dengan mengonfigurasi agen Anda dengan CloudFormation keterampilan dan Server MCP AWS IAc, Anda melengkapinya dengan keahlian yang diperlukan untuk membangun dan mengelola infrastruktur sebagai kode aktif. AWS

Bekerja dengan agen pengkodean Anda

Untuk referensi mulai cepat, Anda dapat memasukkan tautan ini langsung ke konteks agen Anda:

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/samples/aws-cloudformation-agent-setup.md

Pilih metode instalasi yang sesuai dengan lingkungan pengembangan Anda.

Prasyarat

Pastikan prasyarat berikut sudah ada:

  • uv diinstal pada sistem Anda.

  • Node.js(v18+) diinstal pada sistem Anda (diperlukan untuk instalasi keterampilan).

  • (Opsional) AWS Akun dengan kredenal IAM yang disiapkan di mesin lokal Anda. Kredenal diperlukan untuk alat yang menjalankan panggilan AWS API (validasi template, pemecahan masalah penerapan), tetapi tidak untuk pencarian dokumentasi. Jika Anda tidak memiliki kredenal yang dikonfigurasi, lihat Mengonfigurasi AWS CLI untuk petunjuk terperinci.

Apa yang akan diinstal

Komponen Apa yang disediakannya
CloudFormation keterampilan Pembuatan templat dengan default aman, pipeline validasi 3 lapis (cfn-lint, cfn-guard, set perubahan), dan diagnosis penyebab akar tumpukan yang gagal menggunakan peristiwa dan korelasi. CloudFormation CloudTrail
AWS Server MCP iAC Pencarian dokumentasi (CloudFormation dan CDK), validasi templat, pemeriksaan kepatuhan, pemecahan masalah penerapan, dan praktik terbaik CDK - semuanya berjalan secara lokal di mesin Anda.

Kode Claude

Instal plugin aws-core dari Agen Toolkit untuk AWS

Jalankan perintah berikut untuk menginstal plugin:

/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-core@agent-toolkit-for-aws

Ini menginstal keterampilan agen termasuk keterampilan, kait agen, dan konfigurasi AWS MCP Server dalam satu langkah. AWS CloudFormation

Menginstal AWS Server MCP iAC

Ganti AWS_PROFILE dengan nama AWS profil lokal Anda.

claude mcp add awslabs-aws-iac-mcp \
  -e AWS_PROFILE=default \
  -e AWS_REGION=us-east-1 \
  -e FASTMCP_LOG_LEVEL=ERROR \
  --scope user \
  -- uvx awslabs.aws-iac-mcp-server@latest

kodeks

Instal CloudFormation keterampilan

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

Menginstal AWS Server MCP iAC

Ganti AWS_PROFILE dengan nama AWS profil lokal Anda.

codex mcp add awslabs-aws-iac-mcp \
  --env AWS_PROFILE=default \
  --env AWS_REGION=us-east-1 \
  --env FASTMCP_LOG_LEVEL=ERROR \
  -- uvx awslabs.aws-iac-mcp-server@latest

Kursor

Instal CloudFormation keterampilan

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

Menginstal AWS Server MCP iAC

Tambahkan yang berikut ini ke .cursor/mcp.json bawah"mcpServers". Ganti AWS_PROFILE dengan nama AWS profil lokal Anda.

"awslabs.aws-iac-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-iac-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

Kiro

Instal CloudFormation keterampilan di Kiro CLI

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

Menginstal AWS Server MCP iAC

Tambahkan yang berikut ini ke ~/.kiro/settings/mcp.json bawah"mcpServers". Ganti AWS_PROFILE dengan nama AWS profil lokal Anda.

"awslabs.aws-iac-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-iac-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  },
  "disabled": false
}

Instal kekuatan Kiro (dari Kiro IDE)

Instal kekuatan Kiro berikut yang menyediakan CloudFormation konteks dan alat khusus untuk agen Kiro sesuai permintaan:

GitHub Kopilot

Instal CloudFormation keterampilan

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

Menginstal AWS Server MCP iAC

Tambahkan yang berikut ini ke .vscode/mcp.json bawah"mcpServers". Ganti AWS_PROFILE dengan nama AWS profil lokal Anda.

"awslabs.aws-iac-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-iac-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

Selancar Angin

Instal CloudFormation keterampilan

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

Menginstal AWS Server MCP iAC

Tambahkan yang berikut ini ke /.codeium/windsurf/mcp_config.json bawah"mcpServers". Ganti AWS_PROFILE dengan nama AWS profil lokal Anda.

"awslabs.aws-iac-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-iac-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

OpenCode

Instal CloudFormation keterampilan

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

Menginstal AWS Server MCP iAC

Tambahkan yang berikut ini ke /.config/opencode/opencode.jsonc bawah"mcpServers". Ganti AWS_PROFILE dengan nama AWS profil lokal Anda.

"awslabs.aws-iac-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-iac-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

Untuk semua agen lain yang kompatibel dengan keterampilan agen dan konfigurasi MCP Server

Untuk agen lain yang mendukung format keterampilan agen sumber terbuka dan konfigurasi MCP Server, ikuti langkah-langkah berikut:

Instal CloudFormation keterampilan

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

Menginstal AWS Server MCP iAC

Tambahkan Server MCP AWS iAC ke file konfigurasi klien MCP agen Anda di bawah. "mcpServers" Ganti AWS_PROFILE dengan nama AWS profil lokal Anda.

"awslabs.aws-iac-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-iac-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

Apa yang dapat Anda lakukan dengan agen Anda

Setelah dikonfigurasi, agen Anda dapat membantu Anda dengan:

Tugas Contoh prompt
Penulis template “Buat CloudFormation template untuk VPC dengan subnet publik dan pribadi”
Validasi sebelum menerapkan “Validasi template saya di. /template.yaml dan periksa masalah keamanan”
Memecahkan masalah kegagalan “Tumpukan 'aplikasi saya' di us-east-1 gagal diterapkan. Apa yang terjadi?”
Dokumentasi pencarian “Properti apa yang didukung AWS: :ECS: :Service?”
Panduan CDK “Tunjukkan praktik terbaik CDK untuk fungsi Lambda”
Pemeriksaan kepatuhan “Periksa apakah template saya sesuai dengan praktik terbaik keamanan”

Izin IAM

Server MCP memerlukan AWS izin berikut untuk fungsionalitas penuh:

Untuk validasi dan kepatuhan templat: Tidak diperlukan AWS izin (hanya validasi lokal).

Untuk pemecahan masalah penerapan:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudformation:DescribeStacks",
        "cloudformation:DescribeStackEvents",
        "cloudformation:DescribeStackResources",
        "cloudtrail:LookupEvents"
      ],
      "Resource": "*"
    }
  ]
}