View a markdown version of this page

Panduan pengaturan agen - AWS CloudFormation
Bekerja dengan agen pengkodean AndaPrasyaratApa yang dipasangKode ClaudekodeksKursorKiroGitHub KopilotSelancar anginOpenCodeUntuk semua agen lain yang kompatibel dengan keterampilan agen dan konfigurasi Server MCPApa 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 pengaturan agen

Agen Toolkit untuk AWS on GitHub menyediakan aws-core plugin dan aws-cloudformation keterampilan yang dibundel. Keterampilan ini membantu agen pengkodean AI membuat dan memvalidasi CloudFormation templat, memecahkan masalah penerapan, dan menghasilkan AWS CDK kode. Plugin ini juga mengkonfigurasi Server AWS MCP untuk pencarian dokumentasi dan akses AWS API.

Bekerja dengan agen pengkodean Anda

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

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

Pilih metode instalasi yang sesuai dengan lingkungan pengembangan Anda.

Prasyarat

Pastikan prasyarat berikut ada:

  • uv diinstal pada sistem Anda.

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

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

Apa yang dipasang

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

Kode Claude

Instal plugin aws-core

Jalankan perintah berikut untuk menginstal plugin dari pasar Claude Code resmi:

/plugin install aws-core@claude-plugins-official

Ini menginstal aws-cloudformation keterampilan, AWS keterampilan inti lainnya, kait agen, dan konfigurasi Server AWS MCP dalam satu langkah.

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 aws/agent-toolkit-for-aws/skills --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 aws/agent-toolkit-for-aws/skills --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 skill di Kiro CLI

npx skills add aws/agent-toolkit-for-aws/skills --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:

  • CloudFormation dan CDK - instal melalui tautan kekuatan Kiro.

GitHub Kopilot

Instal CloudFormation keterampilan

npx skills add aws/agent-toolkit-for-aws/skills --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 aws/agent-toolkit-for-aws/skills --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 aws/agent-toolkit-for-aws/skills --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 Server MCP

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

Instal CloudFormation keterampilan

npx skills add aws/agent-toolkit-for-aws/skills --skill aws-cloudformation --yes --global

Menginstal AWS Server MCP iAC

Tambahkan AWS iAc MCP Server 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
Buat 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 saya 'my-app' 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 template dan kepatuhan: 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": "*"
    }
  ]
}