# Instrucciones para el agente: AWS API MCP: consulta recursos con comandos de AWS

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: avanzado
- Proyecto: https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/aws-api-mcp-server

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: comprueba los requisitos

Comprueba que tienes un entorno Python ≥3.10 separado con pip y que el cliente puede ejecutar su intérprete. El [README del servidor](https://github.com/awslabs/mcp/blob/main/src/aws-api-mcp-server/README.md#-using-python-pip) recomienda aislarlo para evitar conflictos con tu AWS CLI. Confirma también la región y el perfil AWS que utilizarás; uv no es necesario en esta ruta.

### Paso 2: instalación según el README

```text
pip install awslabs.aws-api-mcp-server
```

### Paso 3: registra el servidor en el cliente

Esta prueba usa Claude Desktop ya instalado. Combina este bloque con su configuración `claude_desktop_config.json` (en macOS bajo `~/Library/Application Support/Claude/`; en Windows bajo `%APPDATA%/Claude/`), conservando los otros servidores. Es una adaptación del ejemplo Using Python. Sustituye `/ruta/absoluta/.venv/bin/python` por el intérprete real y `perfil-lectura` por el perfil autorizado ya configurado:

```json
{
  "mcpServers": {
    "awslabs.aws-api-mcp-server": {
      "command": "/ruta/absoluta/.venv/bin/python",
      "args": ["-m", "awslabs.aws_api_mcp_server.server"],
      "env": {
        "AWS_REGION": "us-east-1",
        "AWS_API_MCP_PROFILE_NAME": "perfil-lectura"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

Confirma también que esa región es la prevista. Reinicia el cliente y pide consultar la identidad de la sesión con `aws sts get-caller-identity`, sin modificar recursos. La respuesta debe contener el identificador de la cuenta y la identidad esperados.

## Comprobación

Prueba una consulta de inventario autorizada y confirma cuenta y región contra las esperadas.

## Si algo falla

Si aparece otra cuenta o un permiso denegado, revisa la cadena de credenciales y el perfil, sin ampliar permisos a ciegas. Consulta la guía de migración si tu cliente usa un transporte antiguo.

[Procedimiento oficial](https://github.com/awslabs/mcp/blob/main/src/aws-api-mcp-server/README.md).