View a markdown version of this page

Anleitung zur Einrichtung des Agenten - AWS CloudFormation

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Anleitung zur Einrichtung des Agenten

Das Agent Toolkit for AWS on GitHub stellt das aws-core Plugin und die darin enthaltenen Fähigkeiten zur Verfügung. aws-cloudformation Der Skill hilft KI-Codierungsagenten dabei, CloudFormation Vorlagen zu erstellen und zu validieren, Probleme bei Bereitstellungen zu beheben und Code zu generieren. AWS CDK Das Plugin konfiguriert auch den AWS MCP-Server für die Dokumentationssuche und AWS den API-Zugriff.

Arbeiten Sie mit Ihrem Codierungsagenten

Als Schnellstart-Referenz können Sie diesen Link direkt in den Kontext Ihres Agenten einfügen:

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

Wählen Sie die Installationsmethode, die zu Ihrer Entwicklungsumgebung passt.

Voraussetzungen

Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

  • uv ist auf Ihrem System installiert.

  • Node.js(v18+) auf Ihrem System installiert (für die Installation von Skills erforderlich).

  • (Optional) Ein AWS Konto mit IAM-Anmeldeinformationen, das auf Ihrem lokalen Computer eingerichtet ist. Anmeldeinformationen sind für Tools erforderlich, die AWS API-Aufrufe ausführen (Vorlagenvalidierung, Problembehandlung bei der Bereitstellung), jedoch nicht für die Suche in der Dokumentation. Wenn Sie keine Anmeldeinformationen konfiguriert haben, finden Sie unter AWS CLI konfigurieren eine ausführliche Anleitung.

Was wird installiert

Komponente Was es bietet
aws-cloudformationFähigkeit Erstellung von Vorlagen mit sicheren Standardeinstellungen, dreischichtiger Validierungspipeline (cfn-lint, cfn-guard, Change Sets) und Ursachendiagnose fehlgeschlagener Stacks anhand von Ereignissen und Korrelation. CloudFormation CloudTrail
AWS iAC MCP Server Dokumentationssuche (CloudFormation und CDK), Vorlagenvalidierung, Konformitätsprüfungen, Problembehebung bei der Bereitstellung und bewährte CDK-Methoden — alles läuft lokal auf Ihrem Computer.

Claude Code

Installieren Sie das AWS-Core-Plugin

Führen Sie den folgenden Befehl aus, um das Plugin vom offiziellen Claude Code-Marktplatz zu installieren:

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

Dadurch werden der aws-cloudformation Skill, andere AWS Kernfähigkeiten, Agenten-Hooks und die AWS MCP Server-Konfiguration in einem Schritt installiert.

Installieren AWS iAC MCP Server

Ersetzen Sie ihn AWS_PROFILE durch Ihren lokalen AWS Profilnamen.

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

Kodex

Skill installieren CloudFormation

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

Installieren AWS IaC MCP Server

Ersetzen Sie ihn AWS_PROFILE durch Ihren lokalen AWS Profilnamen.

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

CloudFormation Skill installieren

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

Installieren AWS IaC MCP Server

Fügen Sie unter Folgendes hinzu. .cursor/mcp.json "mcpServers" AWS_PROFILEErsetzen Sie es durch Ihren lokalen AWS Profilnamen.

"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

Installieren Sie den CloudFormation Skill in Kiro CLI

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

Installieren AWS iAC-MCP-Server

Fügen Sie unter Folgendes hinzu. ~/.kiro/settings/mcp.json "mcpServers" AWS_PROFILEErsetzen Sie es durch Ihren lokalen AWS Profilnamen.

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

Installieren Sie Kiro Powers (von Kiro IDE)

Installieren Sie das folgende Kiro-Modul, das den Kiro-Agenten auf Abruf speziellen CloudFormation Kontext und spezielle Tools zur Verfügung stellt:

GitHub Copilot

Skill installieren CloudFormation

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

Installieren AWS IaC MCP Server

Fügen Sie unter Folgendes hinzu. .vscode/mcp.json "mcpServers" AWS_PROFILEErsetzen Sie es durch Ihren lokalen AWS Profilnamen.

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

Windsurfen

Skill installieren CloudFormation

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

Installieren AWS IaC MCP Server

Fügen Sie unter Folgendes hinzu. /.codeium/windsurf/mcp_config.json "mcpServers" AWS_PROFILEErsetzen Sie es durch Ihren lokalen AWS Profilnamen.

"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

CloudFormation Skill installieren

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

Installieren AWS IaC MCP Server

Fügen Sie unter Folgendes hinzu. /.config/opencode/opencode.jsonc "mcpServers" AWS_PROFILEErsetzen Sie es durch Ihren lokalen AWS Profilnamen.

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

Für alle anderen Agenten, die mit den Agentenfähigkeiten und der MCP-Serverkonfiguration kompatibel sind

Gehen Sie für jeden anderen Agenten, der das Open-Source-Format für Agentenfähigkeiten und die MCP Server-Konfiguration unterstützt, wie folgt vor:

Skill installieren CloudFormation

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

Installieren AWS IaC MCP Server

Fügen Sie den AWS IaC MCP Server zur MCP-Client-Konfigurationsdatei Ihres Agenten unter hinzu. "mcpServers" Ersetzen Sie ihn AWS_PROFILE durch Ihren lokalen Profilnamen 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" } }

Was können Sie mit Ihrem Agenten machen

Nach der Konfiguration kann Ihr Agent Ihnen helfen bei:

Aufgabe Beispiel für einen Prompt
Erstellen Sie eine Vorlage „Erstellen Sie eine CloudFormation Vorlage für eine VPC mit öffentlichen und privaten Subnetzen“
Vor der Bereitstellung validieren „Bestätigen Sie meine Vorlage unter. /template.yaml und suche nach Sicherheitsproblemen“
Beheben Sie einen Fehler „Mein Stack 'my-app' in us-east-1 konnte nicht bereitgestellt werden. Was ist passiert?“
Search documentation (Dokumentation durchsuchen) „Welche Eigenschaften unterstützt AWS: :ECS: :Service?“
CDK-Anleitung „Zeigen Sie mir die besten CDK-Methoden für Lambda-Funktionen“
Überprüfungen der Einhaltung der Vorschriften „Prüfen Sie, ob meine Vorlage den bewährten Sicherheitsmethoden entspricht“

IAM-Berechtigungen

Der MCP-Server benötigt die folgenden AWS Berechtigungen für den vollen Funktionsumfang:

Für die Validierung und Einhaltung von Vorlagen: Keine AWS Berechtigungen erforderlich (nur lokale Validierung).

Zur Fehlerbehebung bei der Bereitstellung:

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