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

# Panduan penyiapan agen
<a name="agent-setup-guide"></a>

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
<a name="agent-setup-work-with-agent"></a>

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
<a name="agent-setup-prerequisites"></a>

Pastikan prasyarat berikut sudah ada:
+ [uv](https://docs.astral.sh/uv/) diinstal pada sistem Anda.
+ [Node.js](https://nodejs.org/)(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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).

## Apa yang akan diinstal
<a name="agent-setup-what-gets-installed"></a>


| 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
<a name="agent-setup-claude-code"></a>

### Instal plugin aws-core dari Agen Toolkit untuk AWS
<a name="agent-setup-claude-code-plugin"></a>

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
<a name="agent-setup-claude-code-mcp"></a>

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
<a name="agent-setup-codex"></a>

### Instal CloudFormation keterampilan
<a name="agent-setup-codex-skill"></a>

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

### Menginstal AWS Server MCP iAC
<a name="agent-setup-codex-mcp"></a>

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
<a name="agent-setup-cursor"></a>

### Instal CloudFormation keterampilan
<a name="agent-setup-cursor-skill"></a>

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

### Menginstal AWS Server MCP iAC
<a name="agent-setup-cursor-mcp"></a>

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
<a name="agent-setup-kiro"></a>

### Instal CloudFormation keterampilan di Kiro CLI
<a name="agent-setup-kiro-skill"></a>

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

### Menginstal AWS Server MCP iAC
<a name="agent-setup-kiro-mcp"></a>

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)
<a name="agent-setup-kiro-powers"></a>

Instal kekuatan Kiro berikut yang menyediakan CloudFormation konteks dan alat khusus untuk agen Kiro sesuai permintaan:
+ **CloudFormation dan CDK** -- instal melalui tautan [kekuatan Kiro](https://kiro.dev/powers/aws-iac).

## GitHub Kopilot
<a name="agent-setup-github-copilot"></a>

### Instal CloudFormation keterampilan
<a name="agent-setup-github-copilot-skill"></a>

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

### Menginstal AWS Server MCP iAC
<a name="agent-setup-github-copilot-mcp"></a>

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
<a name="agent-setup-windsurf"></a>

### Instal CloudFormation keterampilan
<a name="agent-setup-windsurf-skill"></a>

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

### Menginstal AWS Server MCP iAC
<a name="agent-setup-windsurf-mcp"></a>

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
<a name="agent-setup-opencode"></a>

### Instal CloudFormation keterampilan
<a name="agent-setup-opencode-skill"></a>

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

### Menginstal AWS Server MCP iAC
<a name="agent-setup-opencode-mcp"></a>

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
<a name="agent-setup-other-agents"></a>

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

### Instal CloudFormation keterampilan
<a name="agent-setup-other-agents-skill"></a>

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

### Menginstal AWS Server MCP iAC
<a name="agent-setup-other-agents-mcp"></a>

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
<a name="agent-setup-what-you-can-do"></a>

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
<a name="agent-setup-iam-permissions"></a>

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": "*"
    }
  ]
}
```

## Sumber daya terkait
<a name="agent-setup-related-resources"></a>
+ [AWS Server MCP iAC aktif GitHub](https://github.com/awslabs/mcp/tree/main/src/aws-iac-mcp-server)
+ [Agen Toolkit untuk AWS](https://github.com/aws/agent-toolkit-for-aws)
+ [Panduan Pengguna CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/)
+ [AWS Panduan Pengembang CDK](https://docs.aws.amazon.com/cdk/v2/guide/)
+ [Memperkenalkan Server MCP AWS IAc (blog)](https://aws.amazon.com/blogs/devops/introducing-the-aws-infrastructure-as-code-mcp-server-ai-powered-cdk-and-cloudformation-assistance/)