

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.

# Erste Schritte mit dem Amazon ECS MCP Server

Diese Anleitung führt Sie durch die Schritte zur Einrichtung und Verwendung des Amazon ECS MCP Servers mit Ihren KI-Codeassistenten. Sie erfahren, wie Sie Ihre Umgebung konfigurieren, eine Verbindung zum Server herstellen und mit der Verwaltung Ihrer Amazon ECS-Cluster durch Interaktionen in natürlicher Sprache beginnen.

**Anmerkung**  
Der Amazon ECS MCP-Server befindet sich in der Vorabversion und kann sich ändern.

## Voraussetzungen
<a name="ecs-mcp-prerequisites"></a>

Stellen Sie vor Beginn sicher, dass Sie über Folgendes verfügen:
+ [Es wurde ein AWS Konto mit Zugriff auf Amazon ECS erstellt ](https://aws.amazon.com/resources/create-account/)
+ [Ich habe das AWS CLI mit Anmeldeinformationen installiert und konfiguriert ](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)
+ [Python 3.10\+ installiert ](https://www.python.org/)
+ [Installierte uv ](https://docs.astral.sh/uv/getting-started/installation/)

## Einrichtung
<a name="ecs-mcp-setup"></a>

### Überprüfen Sie die -Voraussetzungen.
<a name="ecs-mcp-verify-prerequisites"></a>

Überprüfe, ob deine Python-Version 3.10 oder höher ist

```
python3 --version
```

Überprüfen Sie die UV-Installation

```
uv --version
```

Überprüfen Sie die AWS CLI Konfiguration

```
aws configure list
```

### Einrichten von IAM-Berechtigungen
<a name="ecs-mcp-iam-permissions"></a>

Sie benötigen [https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html) IAM-Berechtigungen, um schreibgeschützte Anfragen an AWS Dienste zu stellen und mit dem MCP-Server zu interagieren. Sie können entweder [AWS verwaltete Richtlinien ](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) oder eine einzelne benutzerdefinierte Richtlinie für eine detailliertere Steuerung nutzen.

**Option 1: Kombinierte verwaltete und benutzerdefinierte Richtlinie **

1. Hängen Sie die AWS verwaltete Richtlinie ** ReadOnlyAccess ** für den schreibgeschützten Zugriff an alle Dienste an AWS 

1. Erstellen Sie eine zusätzliche benutzerdefinierte Richtlinie für MCP-Berechtigungen und hängen Sie sie an (siehe das folgende JSON für MCP-Berechtigungen)

```
{
  "Version": "2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "MCPServerAccess",
      "Effect": "Allow",
      "Action": [
        "ecs-mcp:InvokeReadOnlyTools",
        "ecs-mcp:UseMcp"
      ],
      "Resource": "*"
    }
  ]
}
```

**Option 2: Einzelne benutzerdefinierte Richtlinie (detaillierteste Steuerung) **

Alternativ können Sie eine einzelne benutzerdefinierte JSON-Richtlinie erstellen und anhängen, die sowohl AWS Serviceberechtigungen als auch MCP-Berechtigungen umfasst:

```
{
  "Version": "2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "MCPServerAccess",
      "Effect": "Allow",
      "Action": [
        "ecs-mcp:InvokeReadOnlyTools",
        "ecs-mcp:UseMcp"
      ],
      "Resource": "*"
    },
    {
      "Sid": "ECSReadOnlyAccess",
      "Effect": "Allow",
      "Action": [
        "ecs:ListAccountSettings",
        "ecs:ListClusters",
        "ecs:ListContainerInstances",
        "ecs:ListTaskDefinitions",
        "ecs:ListServices",
        "ecs:ListServiceDeployments",
        "ecs:ListTasks",
        "ecs:DescribeClusters",
        "ecs:DescribeCapacityProviders",
        "ecs:DescribeContainerInstances",
        "ecs:DescribeTaskDefinition",
        "ecs:DescribeServices",
        "ecs:DescribeServiceDeployments",
        "ecs:DescribeServiceRevisions",
        "ecs:DescribeTaskSets",
        "ecs:DescribeTasks"
      ],
      "Resource": "*"
    },
    {
      "Sid": "CloudWatchLogsReadOnlyAccess",
      "Effect": "Allow",
      "Action": [
        "logs:DescribeLogGroups",
        "logs:DescribeLogStreams",
        "logs:GetLogEvents",
        "logs:FilterLogEvents"
      ],
      "Resource": "*"
    },
    {
      "Sid": "ELBReadOnlyAccess",
      "Effect": "Allow",
      "Action": [
        "elasticloadbalancing:DescribeLoadBalancers",
        "elasticloadbalancing:DescribeTargetGroups",
        "elasticloadbalancing:DescribeListeners"
      ],
      "Resource": "*"
    },
    {
      "Sid": "EC2ReadOnlyAccess",
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeVpcs",
        "ec2:DescribeSubnets",
        "ec2:DescribeSecurityGroups",
        "ec2:DescribeRouteTables",
        "ec2:DescribeNetworkInterfaces"
      ],
      "Resource": "*"
    },
    {
      "Sid": "ECRReadOnlyAccess",
      "Effect": "Allow",
      "Action": [
        "ecr:DescribeRepositories",
        "ecr:DescribeImages"
      ],
      "Resource": "*"
    },
    {
      "Sid": "IAMReadOnlyAccessForSecurityAnalysis",
      "Effect": "Allow",
      "Action": [
        "iam:GetRole",
        "iam:ListAttachedRolePolicies",
        "iam:GetPolicy",
        "iam:GetPolicyVersion",
        "iam:ListRolePolicies",
        "iam:GetRolePolicy"
      ],
      "Resource": "*"
    }
  ]
}
```

### Wählen und konfigurieren Sie einen KI-Assistenten
<a name="ecs-mcp-configure-assistant"></a>

Installieren Sie MCP-compatible KI-Assistenten oder MCP-compatible ein beliebiges Tool. Sie können beispielsweise [ Kiro, [ Cline ](https://cline.bot/)](https://kiro.dev/), [ Cursor oder [ Claude ](https://www.claude.com/product/claude-code) Code verwenden. ](https://cursor.com/) Richten Sie dann Ihren KI-Codeassistenten so ein, dass er den Amazon ECS MCP-Server über den MCP Proxy für verwendet. Dies ist für den sicheren AWS, authentifizierten Zugriff auf den Amazon ECS MCP Server erforderlich. Der Proxy fungiert als clientseitige Brücke und verarbeitet die AWS SigV4-Authentifizierung mithilfe Ihrer lokalen Anmeldeinformationen. AWS Das folgende Beispiel verwendet die Kiro CLI. Folgen Sie diesem [ Link](https://kiro.dev/docs/cli/mcp/), um mehr über die Einrichtung von MCP in Kiro zu erfahren.

#### Suchen Sie die MCP-Konfigurationsdatei
<a name="ecs-mcp-kiro-config-file"></a>
+ **macOS/Linux:**

  ```
  ~/.kiro/settings/mcp.json
  ```
+ **Windows:**

  ```
  %USERPROFILE%\.kiro\settings\mcp.json
  ```

Erstellen Sie die Konfigurationsdatei, falls sie nicht existiert.

#### Fügen Sie die MCP-Serverkonfiguration hinzu
<a name="ecs-mcp-kiro-add-config"></a>

Achten Sie darauf, den Platzhalter region (`{region}`) durch die gewünschte Region zu ersetzen (z. B.`us-west-2`). Eine vollständige Liste der [Linux-Container an AWS Fargate](AWS_Fargate-Regions.md#linux-regions) Regionen finden Sie unter. Stellen Sie außerdem sicher, dass Sie den `{profile}` Platzhalter durch Ihren [AWS CLI Profilnamen ersetzen](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html), z. B. `default`

**Für Mac/Linux: **

```
{
  "mcpServers": {
    "ecs-mcp": {
      "disabled": false,
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://ecs-mcp.{region}.api.aws/mcp",
        "--service",
        "ecs-mcp",
        "--profile",
        "{profile}",
        "--region",
        "{region}"
      ]
    }
  }
}
```

**Für Windows:**

```
{
  "mcpServers": {
    "ecs-mcp": {
      "disabled": false,
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "mcp-proxy-for-aws@latest",
        "mcp-proxy-for-aws.exe",
        "https://ecs-mcp.{region}.api.aws/mcp",
        "--service",
        "ecs-mcp",
        "--profile",
        "{profile}",
        "--region",
        "{region}"
      ]
    }
  }
}
```

#### Konfiguration überprüfen
<a name="ecs-mcp-kiro-verify"></a>

Starten Sie Kiro CLI neu`kiro-cli`, stellen Sie sicher, dass der MCP-Server geladen ist`/mcp`, und überprüfen Sie die verfügbaren Tools. `/tools`

#### Überprüfen Ihrer Einrichtung
<a name="ecs-mcp-verify-setup"></a>

**Verbindung testen **

Stellen Sie Ihrem KI-Assistenten eine einfache Frage, um die Verbindung zu überprüfen:

```
List all ECS clusters in my AWS account
```

Sie sollten eine Liste Ihrer Amazon ECS-Cluster sehen.

#### Sprechen Sie mit Ihrem KI-Assistenten, der den Amazon ECS MCP-Server verwendet
<a name="ecs-mcp-first-tasks"></a>

**Beispiel 1: Überwachen Sie Bereitstellungen **

```
Check deployment status for my web-service in production-cluster
Show me the ALB URL for my deployed service
Get service events for the last hour
```

**Beispiel 2: Untersuchen Sie den Zustand des Containers **

```
Show me all tasks that failed in the last 2 hours
Why are my containers failing health checks?
Display container logs for my api-service
```

**Beispiel 3: Fehler beheben **

```
Analyze task failures in my production cluster
Check for image pull errors in the last 30 minutes
Why is my task definition stuck in DELETE_IN_PROGRESS state?
```

**Beispiel 4: Konfigurationen überprüfen **

```
Show me the network configuration for my web-service
What security groups are attached to my service?
List all VPC and subnet details for my ECS service
```

**Beispiel 5: Beurteilen Sie die Sicherheitslage **

```
Are there any security issues with my production cluster?
Analyze IAM roles and policies for my web-service
Check for overly permissive security groups in my ECS cluster
```

## Allgemeine Konfigurationen und bewährte Methoden
<a name="ecs-mcp-common-configs"></a>

### Mehrere AWS Profile
<a name="ecs-mcp-multiple-profiles"></a>

Wenn Sie mit mehreren AWS Konten arbeiten, erstellen Sie separate MCP-Serverkonfigurationen.

**Für Mac/Linux: **

```
{
  "mcpServers": {
    "ecs-mcp-prod": {
      "disabled": false,
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://ecs-mcp.{region}.api.aws/mcp",
        "--service",
        "ecs-mcp",
        "--profile",
        "production",
        "--region",
        "us-west-2"
      ]
    },
    "ecs-mcp-dev": {
      "disabled": false,
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://ecs-mcp.{region}.api.aws/mcp",
        "--service",
        "ecs-mcp",
        "--profile",
        "development",
        "--region",
        "us-east-1"
      ]
    }
  }
}
```

### Bewährte Methoden für die Gewährleistung der Sicherheit
<a name="ecs-mcp-security-best-practices"></a>

Geben Sie keine Geheimnisse oder vertraulichen Informationen über zulässige Eingabemechanismen weiter:
+ Fügen Sie keine Geheimnisse oder Anmeldeinformationen in Konfigurationsdateien ein
+ Geben Sie vertrauliche Informationen nicht direkt in Eingabeaufforderungen an das Modell weiter
+ Nehmen Sie keine Geheimnisse in Aufgabendefinitionen oder Dienstkonfigurationen auf
+ Vermeiden Sie es, vertrauliche Informationen in Anwendungsprotokollen zu protokollieren
+ Verwenden Sie unseren Parameter Store, um vertrauliche Informationen zu speichern

## Konfigurationen der Werkzeuge
<a name="ecs-mcp-next-steps"></a>

Eine vollständige Liste der Tools und Konfigurationen finden Sie unter[Konfigurationen des Amazon ECS MCP Server Tools](ecs-mcp-tool-configurations.md).