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à.

# Configurazioni degli strumenti del server Amazon ECS MCP
<a name="ecs-mcp-tool-configurations"></a>

Questa guida mostra tutte le configurazioni disponibili per il server MCP Amazon ECS completamente gestito.

**Nota**  
Il server Amazon ECS MCP è in versione di anteprima ed è soggetto a modifiche.

## Variabili di ambiente
<a name="ecs-mcp-env-variables"></a>

**AWS\$1PROFILE** (facoltativo)  
AWS nome del profilo delle credenziali da utilizzare; può essere sovrascritto dall'argomento della riga di comando. `--profile`  
Ad esempio: `export AWS_PROFILE=dev`

**AWS\$1REGION** (facoltativo)  
AWS regione per la firma di SigV4; il valore predefinito è se non è impostato. `us-west-2`  
Ad esempio: `export AWS_REGION=us-west-2`

## Arguments (Argomenti)
<a name="ecs-mcp-arguments"></a>

URL dell'**endpoint MCP SigV4 (richiesto)**  
L'URL dell'endpoint MCP a cui connettersi.  
Ad esempio: `https://ecs-mcp.us-west-2.api.aws/mcp`

**--service (opzionale**)  
AWS nome del servizio per la firma SigV4; rilevato automaticamente dal nome host dell'endpoint se non fornito.  
Ad esempio: `--service ecs-mcp`

**--profile (opzionale)**  
AWS profilo di credenziali da usare. Il valore predefinito è la variabile di `AWS_PROFILE` ambiente se non specificata.  
Ad esempio: `--profile dev`

**--region**  
AWS regione da usare. Utilizza la variabile di `AWS_REGION` ambiente se non è impostata, il valore predefinito è. `us-east-1`  
Ad esempio: `--region us-west-2`

**--read-only (opzionale**)  
Disabilita gli strumenti che potrebbero richiedere permessi di scrittura (gli strumenti che NON richiedono permessi di scrittura sono annotati con). `readOnlyHint=true` Per impostazione predefinita, tutti gli strumenti sono abilitati.  
Ad esempio: `--read-only`

Per ulteriori opzioni di configurazione, vedere [Parametri di configurazione](https://github.com/aws/mcp-proxy-for-aws?tab=readme-ov-file#configuration-parameters).

## Tools (Strumenti)
<a name="ecs-mcp-tools"></a>

[Il server Amazon ECS MCP espone i seguenti strumenti MCP.](https://modelcontextprotocol.io/specification/2025-06-18/server/tools)

### Strumenti di sola lettura
<a name="ecs-mcp-read-only-tools"></a>

**get\$1deployment\$1status**  
Lo strumento verifica lo stato della distribuzione di Amazon ECS per un determinato cluster e servizio Amazon ECS.  
+ Azioni IAM richieste:
  + `ecs:DescribeServices`
  + `elasticloadbalancing:DescribeTargetGroups`
  + `elasticloadbalancing:DescribeLoadBalancers`
+ Parametri obbligatori:
  + `cluster_name`(stringa): nome del cluster Amazon ECS
  + `service_name`(stringa): nome del servizio Amazon ECS
+ Risposta: lo strumento restituisce lo stato della distribuzione e i dettagli associati alla distribuzione.

**fetch\$1service\$1events**  
Questo strumento recupera gli eventi del servizio Amazon ECS per la diagnostica con finestre temporali personalizzabili.  
+ Azioni IAM richieste:
  + `ecs:DescribeServices`
+ Parametri obbligatori:
  + `cluster_name`(stringa): nome del cluster Amazon ECS
  + `service_name`(stringa): nome del servizio Amazon ECS
+ Parametri facoltativi:
  + `time_window`(numero intero): puoi indicare una finestra temporale in secondi (l'impostazione predefinita è 1 ora o 3600 secondi)
  + `start_time`(stringa): ora di inizio personalizzata in formato ISO
  + `end_time`(string): Ora di fine personalizzata in formato ISO
+ Risposta: Lo strumento restituisce l'elenco degli eventi per il servizio con un riepilogo.

**fetch\$1task\$1failures**  
Questo strumento ti aiuta a recuperare e analizzare gli errori delle attività di Amazon ECS con riepiloghi. Utilizzando questo strumento, puoi identificare qualsiasi modello di fallimento delle attività.  
+ Azioni IAM richieste:
  + `ecs:ListTasks`
  + `ecs:DescribeTasks`
+ Parametri obbligatori:
  + `cluster_name`(stringa): nome del cluster Amazon ECS in cui risiede l'attività
+ Parametri facoltativi:
  + `service_name`(stringa): puoi filtrare per servizio specifico
  + `time_window`(numero intero): Puoi indicare una finestra temporale in secondi (l'impostazione predefinita è 1 ora o 3600 secondi)
  + `start_time`(stringa): ora di inizio personalizzata in formato ISO
  + `end_time`(string): Ora di fine personalizzata in formato ISO
+ Risposta: Lo strumento restituisce TaskFailureResult le attività non riuscite e il riepilogo

**fetch\$1task\$1logs**  
Questo strumento recupera CloudWatch i log per le attività di Amazon ECS con opzioni di intervallo di tempo flessibili. Questo strumento viene utilizzato per risolvere i problemi di runtime.  
+ Azioni IAM richieste:
  + `ecs:DescribeServices`
  + `ecs:DescribeTaskDefinition`
  + `logs:FilterLogEvents`
+ Parametri obbligatori:
  + `cluster_name`(stringa): nome del cluster Amazon ECS
  + `service_name`(stringa): nome del servizio Amazon ECS
+ Parametri facoltativi:
  + `time_window`(numero intero): puoi indicare una finestra temporale in secondi (l'impostazione predefinita è 1 ora o 3600 secondi)
  + `start_time`(stringa): ora di inizio personalizzata in formato ISO
  + `end_time`(string): Ora di fine personalizzata in formato ISO
  + `log_group_name`(stringa): Specificare il gruppo di CloudWatch log
+ Risposta: lo strumento restituisce TaskLogsResult le voci di registro

**get\$1task\$1definition\$1deletion\$1blockers**  
Questo strumento identifica le dipendenze che possono impedire l'eliminazione delle definizioni delle attività. Lo strumento è adatto quando si eseguono operazioni di pulizia e si capisce cosa impedisce l'eliminazione delle risorse di Amazon ECS.  
+ Azioni IAM richieste:
  + `ecs:ListClusters`
  + `ecs:ListServices`
  + `ecs:DescribeServices`
  + `ecs:ListTasks`
  + `ecs:DescribeTasks`
+ Parametri obbligatori:
  + `task_definition_arn`(stringa): definizione dell'attività Amazon Resource Name (ARN) da analizzare
+ Risposta: lo strumento restituisce i blocchi e lo stato di eliminazione

**detect\$1image\$1pull\$1failures**  
Questo strumento consente di rilevare e classificare gli errori di pull delle immagini dei contenitori.  
+ Azioni IAM richieste:
  + `ecs:ListTasks`
  + `ecs:DescribeTasks`
+ Parametri obbligatori:
  + `cluster_name`(stringa): nome del cluster Amazon ECS
+ Parametri facoltativi:
  + `service_name`(stringa): puoi filtrare per servizio specifico
  + `time_window`(numero intero): Puoi indicare una finestra temporale in secondi (l'impostazione predefinita è 1 ora o 3600 secondi)
  + `start_time`(stringa): ora di inizio personalizzata in formato ISO
  + `end_time`(string): Ora di fine personalizzata in formato ISO
+ Risposta: Lo strumento restituisce gli errori e il riepilogo

**fetch\$1network\$1configuration**  
Questo strumento recupera i dettagli di configurazione della rete del servizio Amazon ECS. Puoi utilizzare questo strumento per comprendere la configurazione di Amazon VPC, sottorete e gruppo di sicurezza della tua configurazione Amazon ECS.  
+ Azioni IAM richieste:
  + `ecs:DescribeServices`
  + `ec2:DescribeSecurityGroups`
  + `ec2:DescribeSubnets`
+ Parametri obbligatori:
  + `cluster_name`(stringa): nome del cluster Amazon ECS
  + `service_name`(stringa): nome del servizio Amazon ECS
+ Risposta: lo strumento restituisce un elenco di dettagli NetworkConfigurationResult di rete