Trabalhe com seu agente de codificação Pré-requisitos O que é instalado Claude Code Codex Cursor Kiro GitHub Copilot Windsurf OpenCode Para todos os outros atendentes compatíveis com as habilidades do atendente e a configuração do servidor MCP O que você pode fazer com seu agente Permissões do IAM Recursos relacionados

Guia de configuração do atendente

Os agentes de codificação de IA podem acelerar o desenvolvimento da infraestrutura fornecendo assistência inteligente para criação de modelos do CloudFormation, validação de pré-implantação, solução de problemas de implantação e geração de código de CDK. Ao configurar seu agente com a habilidade CloudFormation e o Servidor MCP do AWS IaC Server, você o equipa com a experiência necessária para criar e gerenciar a infraestrutura como código na AWS.

Trabalhe com seu agente de codificação

Para obter uma referência rápida, você pode inserir esse link diretamente no contexto do seu atendente:


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

Escolha o método de instalação que corresponda ao seu ambiente de desenvolvimento.

Pré-requisitos

Certifique-se de que os seguintes pré-requisitos estejam atendidos:

uv instalado no sistema.
Node.js (v18+) instalado em seu sistema (necessário para a instalação de habilidades).
(Opcional) Uma conta da AWS com credenciais do IAM configurada em seu computador local. As credenciais são necessárias para ferramentas que executam chamadas de API da AWS (validação de modelos, solução de problemas de implantação), mas não para pesquisa de documentação. Se você não tiver credenciais configuradas, consulte Configurando a AWS CLI para obter instruções detalhadas.

O que é instalado

Componente	O que ele fornece
Habilidade do CloudFormation	Criação de modelos com padrões seguros, pipeline de validação de 3 camadas (cfn-lint, cfn-guard, conjuntos de alterações) e diagnóstico da causa raiz de pilhas com falha usando eventos do CloudFormation e correlação do CloudTrail.
Servidor MCP do AWS IaC	Pesquisa de documentação (CloudFormation e CDK), validação de modelos, verificações de conformidade, solução de problemas de implantação e melhores práticas de CDK — tudo executado localmente em sua máquina.

Claude Code

Instale o plug-in aws-core do Agent Toolkit para AWS

Use o comando a seguir para instalar o plug-in:


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

Isso instala as habilidades do agente, incluindo a habilidade do AWS CloudFormation, os hooks do agente e a configuração do Servidor MCP da AWS em uma única etapa.

Instale o Servidor MCP do AWS IaC

Substitua AWS_PROFILE pelo nome do seu perfil local da AWS.


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

Instale a habilidade do CloudFormation


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

Instale o Servidor MCP do AWS IaC

Substitua AWS_PROFILE pelo nome do seu perfil local da AWS.


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

Cursor

Instale a habilidade do CloudFormation


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

Instale o Servidor MCP do AWS IaC

Adicione o seguinte a .cursor/mcp.json em "mcpServers". Substitua AWS_PROFILE pelo nome do seu perfil local da 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"
  }
}

Kiro

Instale a habilidade do CloudFormation na CLI do Kiro


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

Instale o Servidor MCP do AWS IaC

Adicione o seguinte a ~/.kiro/settings/mcp.json em "mcpServers". Substitua AWS_PROFILE pelo nome do seu perfil local da 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"
  },
  "disabled": false
}

Instale os saberes do Kiro (do Kiro IDE)

Instale o seguinte saber do Kiro, que fornece contexto e ferramentas especializadas do CloudFormation aos agentes do Kiro sob demanda:

CloudFormation e CDK: instale via Kiro powers link.

GitHub Copilot

Instale a habilidade do CloudFormation


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

Instale o Servidor MCP do AWS IaC

Adicione o seguinte a .vscode/mcp.json em "mcpServers". Substitua AWS_PROFILE pelo nome do seu perfil local da 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"
  }
}

Windsurf

Instale a habilidade do CloudFormation


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

Instale o Servidor MCP do AWS IaC

Adicione o seguinte a /.codeium/windsurf/mcp_config.json em "mcpServers". Substitua AWS_PROFILE pelo nome do seu perfil local da 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"
  }
}

OpenCode

Instale a habilidade do CloudFormation


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

Instale o Servidor MCP do AWS IaC

Adicione o seguinte a /.config/opencode/opencode.jsonc em "mcpServers". Substitua AWS_PROFILE pelo nome do seu perfil local da 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"
  }
}

Para todos os outros atendentes compatíveis com as habilidades do atendente e a configuração do servidor MCP

Para qualquer outro atendente que ofereça suporte ao formato de habilidades de atendente de código aberto e à configuração do servidor MCP, siga estas etapas:

Instale a habilidade do CloudFormation


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

Instale o Servidor MCP do AWS IaC

Adicione o servidor MCP do AWS IaC ao arquivo de configuração do cliente MCP do seu agente, na pasta "mcpServers". Substitua AWS_PROFILE pelo nome do seu perfil local da 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"
  }
}

O que você pode fazer com seu agente

Depois de configurado, seu agente pode ajudar a:

Tarefa	Exemplos de prompt
Criar um modelo	"Crie um modelo do CloudFormation para uma VPC com sub-redes públicas e privadas"
Validar antes da implantação	“Valide meu modelo em ./template.yaml e verifique se há problemas de segurança”
Solucionar problemas de falha	“Minha pilha ‘my-app’ em us-east-1 falhou ao ser implantada. O que aconteceu?"
Search documentation (Pesquisar documentação)	“Quais propriedades o AWS::ECS::Service aceita?”
Orientação do CDK	"Mostre-me as práticas recomendadas do CDK para funções do Lambda"
Verificações de conformidade	“Verifique se meu modelo está em conformidade com as práticas recomendadas de segurança”

Permissões do IAM

O servidor MCP requer as seguintes permissões da AWS para funcionalidade completa:

Para validação e conformidade do modelo: nenhuma AWS permissão é necessária (somente validação local).

Para solucionar problemas de implantação:


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

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Criar e gerenciar pilhas

Criar uma pilha