View a markdown version of this page

Guida alla configurazione dell'agente - AWS CloudFormation
Collabora con il tuo agente di codificaPrerequisitiCosa viene installatoCodice ClaudeCodexCursoreKiroGitHub CopilotaWindsurfOpenCodePer tutti gli altri agenti compatibili con le competenze degli agenti e la configurazione del server MCPCosa puoi fare con il tuo agenteautorizzazioni IAMRisorse correlate

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Guida alla configurazione dell'agente

L'Agent Toolkit for AWS on GitHub fornisce il aws-core plugin e le relative funzionalità integrate. aws-cloudformation L'abilità aiuta gli agenti di codifica AI a creare e convalidare CloudFormation modelli, risolvere i problemi di distribuzione e generare codice. AWS CDK Il plug-in configura anche il server AWS MCP per la ricerca della documentazione e l'accesso alle API. AWS

Collabora con il tuo agente di codifica

Per una guida rapida, puoi inserire questo link direttamente nel contesto del tuo agente:

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

Scegli il metodo di installazione più adatto al tuo ambiente di sviluppo.

Prerequisiti

Assicurati che siano soddisfatti i seguenti prerequisiti:

  • uv installato sul tuo sistema.

  • Node.js(v18+) installato sul sistema (richiesto per l'installazione delle competenze).

  • (Facoltativo) Un AWS account con credenziali IAM configurato sul computer locale. Le credenziali sono necessarie per gli strumenti che eseguono chiamate AWS API (convalida del modello, risoluzione dei problemi di distribuzione), ma non per la ricerca della documentazione. Se non disponi di credenziali configurate, consulta Configurazione della CLI per istruzioni dettagliate. AWS

Cosa viene installato

Componente Cosa fornisce
aws-cloudformationabilità Creazione di modelli con impostazioni predefinite sicure, pipeline di convalida a 3 livelli (cfn-lint, cfn-guard, change set) e diagnosi delle cause principali degli stack non riusciti mediante eventi e correlazione. CloudFormation CloudTrail
AWS Server MCP IaC Ricerca della documentazione (CloudFormation e CDK), convalida dei modelli, controlli di conformità, risoluzione dei problemi di distribuzione e best practice CDK, il tutto eseguito localmente sul computer.

Codice Claude

Installa il plugin aws-core

Esegui il seguente comando per installare il plugin dal marketplace ufficiale di Claude Code:

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

Questo installa l'aws-cloudformationabilità, le altre AWS competenze di base, gli hook degli agenti e la configurazione del server AWS MCP in un solo passaggio.

Installa AWS Server MCP iAC

Sostituiscilo AWS_PROFILE con il nome del tuo AWS profilo locale.

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

Codex

Installa skill CloudFormation

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

Installa AWS Server MCP iAC

Sostituiscilo AWS_PROFILE con il nome del tuo AWS profilo locale.

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

Cursore

Installa CloudFormation skill

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

Installa AWS Server MCP iAC

Aggiungi quanto segue a sotto. .cursor/mcp.json "mcpServers" Sostituiscilo AWS_PROFILE con il nome AWS del tuo profilo locale.

"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

Installa CloudFormation abilità nella CLI di Kiro

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

Installa AWS Server MCP iAC

Aggiungi quanto segue a sotto. ~/.kiro/settings/mcp.json "mcpServers" Sostituiscilo AWS_PROFILE con il nome AWS del tuo profilo locale.

"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
}

Installa Kiro powers (da Kiro IDE)

Installa il seguente Kiro power che fornisce CloudFormation contesto e strumenti specializzati agli agenti di Kiro su richiesta:

GitHub Copilota

Installa abilità CloudFormation

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

Installa AWS Server MCP iAC

Aggiungi quanto segue a sotto. .vscode/mcp.json "mcpServers" Sostituiscilo AWS_PROFILE con il nome AWS del tuo profilo locale.

"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"
  }
}

Windsurf

Installa skill CloudFormation

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

Installa AWS Server MCP iAC

Aggiungi quanto segue a sotto. /.codeium/windsurf/mcp_config.json "mcpServers" Sostituiscilo AWS_PROFILE con il nome AWS del tuo profilo locale.

"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

Installa CloudFormation skill

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

Installa AWS Server MCP iAC

Aggiungi quanto segue a sotto. /.config/opencode/opencode.jsonc "mcpServers" Sostituiscilo AWS_PROFILE con il nome AWS del tuo profilo locale.

"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"
  }
}

Per tutti gli altri agenti compatibili con le competenze degli agenti e la configurazione del server MCP

Per qualsiasi altro agente che supporti il formato open source delle competenze degli agenti e la configurazione del server MCP, segui questi passaggi:

Installa skill CloudFormation

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

Installa AWS Server MCP iAC

Aggiungi l' AWS IaC MCP Server al file di configurazione del client MCP del tuo agente in. "mcpServers" Sostituiscilo AWS_PROFILE con il nome del tuo profilo locale AWS .

"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"
  }
}

Cosa puoi fare con il tuo agente

Una volta configurato, il tuo agente può aiutarti con:

Operazione Prompt di esempio
Crea un modello «Crea un CloudFormation modello per un VPC con sottoreti pubbliche e private»
Convalida prima della distribuzione «Convalida il mio modello all'indirizzo. /template.yaml e verifica eventuali problemi di sicurezza»
Risolvi un errore «Il mio stack 'my-app' in us-east-1 non è stato distribuito. Cosa è successo?»
Search documentation (Cerca nella documentazione) «Quali proprietà supporta AWS: :ECS: :Service?»
Linee guida CDK «Mostrami le best practice CDK per le funzioni Lambda»
Controlli di conformità «Verifica se il mio modello è conforme alle migliori pratiche di sicurezza»

autorizzazioni IAM

Il server MCP richiede le seguenti AWS autorizzazioni per la piena funzionalità:

Per la convalida e la conformità dei modelli: non è richiesta alcuna AWS autorizzazione (solo convalida locale).

Per la risoluzione dei problemi di distribuzione: 

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