# Configurações de ferramentas do servidor MCP do Amazon ECS
Este guia mostra todas as configurações disponíveis para o servidor MCP do Amazon ECS totalmente gerenciado.
**nota**
O servidor MCP do Amazon ECS está em fase de pré-visualização e sujeito a alterações.
## Variáveis de ambiente
**AWS\_PROFILE** (opcional)
Nome do perfil de credenciais da AWS a ser usado; pode ser substituído pelo argumento `--profile` da linha de comando.
Exemplo: `export AWS_PROFILE=dev`
**AWS\_REGION** (opcional)
Região da AWS para assinatura do SigV4; o padrão será `us-west-2` se não for definido.
Exemplo: `export AWS_REGION=us-west-2`
## Argumentos
**URL do endpoint do MCP SigV4** (obrigatório)
URL do endpoint do MCP ao qual se conectar.
Exemplo: `https://ecs-mcp.us-west-2.api.aws/mcp`
**--service** (opcional)
Nome do serviço da AWS para assinatura do SigV4; detectado automaticamente pelo nome do host do endpoint, se não for informado.
Exemplo: `--service ecs-mcp`
**--profile** (opcional)
Perfil de credenciais da AWS a ser usado. O padrão será a variável de ambiente `AWS_PROFILE`, se não for especificado.
Exemplo: `--profile dev`
**--Região**
Região da AWS a ser usada. Usa a variável de ambiente `AWS_REGION`; se não for definida, o padrão será `us-east-1`.
Exemplo: `--region us-west-2`
**--read-only** (opcional)
Desabilite as ferramentas que podem exigir permissões de gravação (as ferramentas que NÃO exigem permissões de gravação são anotadas com `readOnlyHint=true`). Por padrão, todas as ferramentas são habilitadas.
Exemplo: `--read-only`
Para obter mais opções de configuração, consulte [Parâmetros de configuração](https://github.com/aws/mcp-proxy-for-aws?tab=readme-ov-file#configuration-parameters).
## Ferramentas
O servidor MCP do Amazon ECS expõe as seguintes [ferramentas do MCP](https://modelcontextprotocol.io/specification/2025-06-18/server/tools).
### Ferramentas somente leitura
**get\_deployment\_status**
A ferramenta verifica o status de implantação do Amazon ECS para um determinado cluster e serviço do Amazon ECS.
+ Ações obrigatórias do IAM:
+ `ecs:DescribeServices`
+ `elasticloadbalancing:DescribeTargetGroups`
+ `elasticloadbalancing:DescribeLoadBalancers`
+ Parâmetros obrigatórios:
+ `cluster_name` (string): nome do cluster do Amazon ECS
+ `service_name` (string): nome do serviço do Amazon ECS
+ Resposta: a ferramenta retorna o status da implantação e os detalhes associados à implantação.
**fetch\_service\_events**
Essa ferramenta recupera eventos de serviços do Amazon ECS para diagnóstico com janelas de tempo personalizáveis.
+ Ações obrigatórias do IAM:
+ `ecs:DescribeServices`
+ Parâmetros obrigatórios:
+ `cluster_name` (string): nome do cluster do Amazon ECS
+ `service_name` (string): nome do serviço do Amazon ECS
+ Parâmetros opcionais:
+ `time_window` (inteiro): você pode mencionar uma janela de tempo em segundos (o padrão é 1 hora ou 3.600 segundos)
+ `start_time` (string): hora de início personalizada no formato ISO
+ `end_time` (string): hora de término personalizada no formato ISO
+ Resposta: a ferramenta retorna a lista de eventos do serviço com resumo.
**fetch\_task\_failures**
Essa ferramenta ajuda você a recuperar e analisar falhas de tarefas do Amazon ECS com resumos. Usando essa ferramenta, você pode identificar qualquer padrão nas falhas de tarefas.
+ Ações obrigatórias do IAM:
+ `ecs:ListTasks`
+ `ecs:DescribeTasks`
+ Parâmetros obrigatórios:
+ `cluster_name` (string): nome do cluster Amazon ECS em que sua tarefa reside
+ Parâmetros opcionais:
+ `service_name` (string): você pode filtrar por serviço específico
+ `time_window` (inteiro): você pode mencionar uma janela de tempo em segundos (o padrão é 1 hora ou 3.600 segundos)
+ `start_time` (string): hora de início personalizada no formato ISO
+ `end_time` (string): hora de término personalizada no formato ISO
+ Resposta: a ferramenta retorna TaskFailureResult com as tarefas que falharam e o resumo
**fetch\_task\_logs**
Essa ferramenta recupera os logs do CloudWatch para tarefas do Amazon ECS com opções flexíveis de intervalo de tempo. Você usa essa ferramenta para solucionar problemas de runtime.
+ Ações obrigatórias do IAM:
+ `ecs:DescribeServices`
+ `ecs:DescribeTaskDefinition`
+ `logs:FilterLogEvents`
+ Parâmetros obrigatórios:
+ `cluster_name` (string): nome do cluster do Amazon ECS
+ `service_name` (string): nome do serviço do Amazon ECS
+ Parâmetros opcionais:
+ `time_window` (inteiro): você pode mencionar uma janela de tempo em segundos (o padrão é 1 hora ou 3.600 segundos)
+ `start_time` (string): hora de início personalizada no formato ISO
+ `end_time` (string): hora de término personalizada no formato ISO
+ `log_group_name` (string): especifique o grupo de logs do CloudWatch
+ Resposta: a ferramenta retorna TaskLogsResult com entradas de log
**get\_task\_definition\_deletion\_blockers**
Essa ferramenta identifica dependências que podem impedir a exclusão da definição da tarefa. A ferramenta é apropriada quando você está executando operações de limpeza e entende o que está impedindo a exclusão de recursos do Amazon ECS.
+ Ações obrigatórias do IAM:
+ `ecs:ListClusters`
+ `ecs:ListServices`
+ `ecs:DescribeServices`
+ `ecs:ListTasks`
+ `ecs:DescribeTasks`
+ Parâmetros obrigatórios:
+ `task_definition_arn` (string): o nome do recurso da Amazon (ARN) da definição da tarefa a ser analisado
+ Resposta: a ferramenta retorna os bloqueadores e o status de exclusão
**detect\_image\_pull\_failures**
Essa ferramenta ajuda você a detectar e categorizar falhas de extração de imagem do contêiner.
+ Ações obrigatórias do IAM:
+ `ecs:ListTasks`
+ `ecs:DescribeTasks`
+ Parâmetros obrigatórios:
+ `cluster_name` (string): nome do cluster do Amazon ECS
+ Parâmetros opcionais:
+ `service_name` (string): você pode filtrar por serviço específico
+ `time_window` (inteiro): você pode mencionar uma janela de tempo em segundos (o padrão é 1 hora ou 3.600 segundos)
+ `start_time` (string): hora de início personalizada no formato ISO
+ `end_time` (string): hora de término personalizada no formato ISO
+ Resposta: a ferramenta retorna as falhas e o resumo
**fetch\_network\_configuration**
Essa ferramenta recupera detalhes da configuração da rede de serviços do Amazon ECS. Você pode usar essa ferramenta para entender a configuração da Amazon VPC, da sub-rede e do grupo de segurança da sua configuração do Amazon ECS.
+ Ações obrigatórias do IAM:
+ `ecs:DescribeServices`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeSubnets`
+ Parâmetros obrigatórios:
+ `cluster_name` (string): nome do cluster do Amazon ECS
+ `service_name` (string): nome do serviço do Amazon ECS
+ Resposta: a ferramenta retorna uma lista de NetworkConfigurationResult com detalhes da rede