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

Gli agenti di codifica AI possono accelerare lo sviluppo dell'infrastruttura fornendo assistenza intelligente per la creazione di CloudFormation modelli, la convalida prima dell'implementazione, la risoluzione dei problemi di implementazione e la generazione di codice CDK. Configurando il tuo agente con le CloudFormation competenze e il server MCP AWS IaC, lo doterai delle competenze necessarie per creare e gestire l'infrastruttura come codice. 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/samples/aws-cloudformation-agent-setup.md

Scegliete il metodo di installazione più adatto al vostro ambiente di sviluppo.

Prerequisiti

Assicurati che siano soddisfatti i seguenti prerequisiti:

  • uv installato sul sistema.

  • Node.js(v18+) installato sul sistema (necessario 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 le chiamate AWS API (convalida dei modelli, risoluzione dei problemi di implementazione), ma non per la ricerca della documentazione. Se non hai configurato le credenziali, consulta Configurazione della AWS CLI per istruzioni dettagliate.

Cosa viene installato

Componente Cosa fornisce
CloudFormation abilità Creazione di modelli con impostazioni predefinite sicure, pipeline di convalida a 3 livelli (cfn-lint, cfn-guard, set di modifiche) e diagnosi della causa principale degli stack falliti utilizzando eventi e correlazioni. CloudFormation CloudTrail
AWS Server MCP iAC Ricerca della documentazione (CloudFormation e CDK), convalida dei modelli, controlli di conformità, risoluzione dei problemi di implementazione e best practice CDK, il tutto eseguito localmente sul computer.

Codice Claude

Installa il plugin aws-core da Agent Toolkit per AWS

Esegui il seguente comando per installare il plugin:

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

Questo installa le competenze dell'agente, tra cui la AWS CloudFormation skill, gli agent hook e la configurazione del server AWS MCP, in un unico passaggio.

Installa AWS Server MCP iAC

AWS_PROFILESostituiscilo 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 abilità CloudFormation

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

Installa AWS Server MCP iAC

AWS_PROFILESostituiscilo 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 https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

Installa AWS Server MCP iAC

Aggiungere quanto segue a under. .cursor/mcp.json "mcpServers" AWS_PROFILESostituiscilo 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 l'abilità nella CLI di Kiro

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

Installa AWS Server MCP iAC

Aggiungere quanto segue a under. ~/.kiro/settings/mcp.json "mcpServers" AWS_PROFILESostituiscilo 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 Kiro su richiesta:

GitHub Copilota

Installa abilità CloudFormation

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

Installa AWS Server MCP iAC

Aggiungere quanto segue a under. .vscode/mcp.json "mcpServers" AWS_PROFILESostituiscilo 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 abilità CloudFormation

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

Installa AWS Server MCP iAC

Aggiungere quanto segue a under. /.codeium/windsurf/mcp_config.json "mcpServers" AWS_PROFILESostituiscilo 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 https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

Installa AWS Server MCP iAC

Aggiungere quanto segue a under. /.config/opencode/opencode.jsonc "mcpServers" AWS_PROFILESostituiscilo 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 Agent Skills e la configurazione del server MCP, procedi nel seguente modo:

Installa skill CloudFormation

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

Installa AWS Server MCP iAC

Aggiungi AWS iAc MCP Server al file di configurazione del client MCP del tuo agente sotto. "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 a:

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 su. /template.yaml e verifica la presenza di 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?»
Guida CDK «Mostrami le migliori pratiche 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 sono richieste AWS autorizzazioni (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": "*"
    }
  ]
}