Guia de Configuração do Servidor AWS MCP

Quando Usar

Use esta habilidade quando precisar configurar servidores AWS MCP para busca de documentação e acesso à API. Use ao configurar o AWS MCP, configurar ferramentas de documentação da AWS, solucionar problemas de conectividade do MCP ou quando o usuário mencionar aws-mcp, awsdocs, uvx setup ou configuração do servidor MCP. Abrange tanto o Servidor AWS MCP Completo (com...

Visão Geral

Este guia ajuda você a configurar ferramentas AWS MCP para agentes de IA. Duas opções estão disponíveis:

Etapa 1: Verificar Configuração Existente

Antes de configurar, verifique se as ferramentas AWS MCP já estão disponíveis usando qualquer um dos métodos:

Método A: Verificar Ferramentas Disponíveis (Recomendado)

Procure por estes padrões de nome de ferramenta nas ferramentas disponíveis do seu agente:

• mcp__aws-mcp__* ou mcp__aws__* → Servidor AWS MCP Completo configurado
• mcp__*awsdocs*__aws___* → MCP de Documentação AWS configurado

Como verificar: Execute o comando /mcp para listar todos os servidores MCP ativos.

Método B: Verificar Arquivos de Configuração

As ferramentas do agente usam configuração hierárquica (precedência: local → projeto → usuário → empresa):

Verifique estes arquivos em busca de mcpServers contendo as chaves aws-mcp, aws ou awsdocs:

# Check project config
cat .mcp.json 2>/dev/null | grep -E '"(aws-mcp|aws|awsdocs)"'

# Check user config
cat ~/.claude.json 2>/dev/null | grep -E '"(aws-mcp|aws|awsdocs)"'

# Or use Claude CLI
claude mcp list

Se o AWS MCP já estiver configurado, nenhuma configuração adicional será necessária.

Etapa 2: Escolher Método de Configuração

Detecção Automática

Execute estes comandos para determinar qual opção usar:

# Check for uvx (requires Python 3.10+)
which uvx || echo "uvx not available"

# Check for valid AWS credentials
aws sts get-caller-identity || echo "AWS credentials not configured"

Opção A: Servidor AWS MCP Completo (Recomendado)

Use quando: uvx disponível E credenciais AWS válidas

Pré-requisitos:

• Python 3.10+ com o gerenciador de pacotes uv
• Credenciais AWS configuradas (via perfil, variáveis de ambiente ou função IAM)

Permissões IAM Necessárias:

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "aws-mcp:InvokeMCP",
      "aws-mcp:CallReadOnlyTool",
      "aws-mcp:CallReadWriteTool"
    ],
    "Resource": "*"
  }]
}

Configuração (adicione às suas configurações do MCP):

{
  "mcpServers": {
    "aws-mcp": {
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://aws-mcp.us-east-1.api.aws/mcp",
        "--metadata", "AWS_REGION=us-west-2"
      ]
    }
  }
}

Opções de Configuração de Credenciais:

1. Perfil AWS (recomendado para desenvolvimento):

   "args": [
     "mcp-proxy-for-aws@latest",
     "https://aws-mcp.us-east-1.api.aws/mcp",
     "--profile", "my-profile",
     "--metadata", "AWS_REGION=us-west-2"
   ]
   

2. Variáveis de Ambiente:

   "env": {
     "AWS_ACCESS_KEY_ID": "...",
     "AWS_SECRET_ACCESS_KEY": "...",
     "AWS_REGION": "us-west-2"
   }
   

3. Função IAM (para EC2/ECS/Lambda): Nenhuma configuração adicional necessária - usa credenciais da instância

Opções Adicionais:

• --region <region>: Substituir região AWS
• --read-only: Restringir a ferramentas somente leitura
• --log-level <level>: Definir nível de log (debug, info, warning, error)

Referência: https://github.com/aws/mcp-proxy-for-aws

Opção B: Servidor MCP de Documentação AWS (Sem Autenticação)

Use quando:

• Não há ambiente Python/uvx
• Não há credenciais AWS
• Apenas busca de documentação necessária (sem execução de API)

Configuração:

{
  "mcpServers": {
    "awsdocs": {
      "type": "http",
      "url": "https://knowledge-mcp.global.api.aws"
    }
  }
}

Etapa 3: Verificação

Após a configuração, verifique se as ferramentas estão disponíveis:

Para AWS MCP Completo:

• Procure por ferramentas: mcp__aws-mcp__aws___search_documentation, mcp__aws-mcp__aws___call_aws

Para MCP de Documentação:

…