# Guia de configuração do atendente
<a name="agent-setup-guide"></a>

Os agentes de codificação de IA podem acelerar o desenvolvimento de tecnologia sem servidor fornecendo assistência inteligente para estrutura de aplicativos, configuração de implantação, depuração e geração de infraestrutura como código. Ao configurar seu atendente com a combinação adequada de plug-ins, habilidades e servidores MCP, você o equipa com a experiência necessária para criar e gerenciar aplicativos de tecnologia sem servidor.

**Trabalhe com seu agente de codificação**  
Para obter uma referência rápida, você pode inserir esse link diretamente no contexto do seu atendente:  

```
https://docs.aws.amazon.com/lambda/latest/dg/samples/aws-lambda-agent-setup.md
```

Escolha o método de instalação que corresponda ao seu ambiente de desenvolvimento.

## Pré-requisitos
<a name="agent-setup-prerequisites"></a>

Verifique se os seguintes pré-requisitos estão em vigor para instalar o plug-in aws-core e o servidor MCP da tecnologia sem servidor:
+ [uv](https://docs.astral.sh/uv/) instalado no sistema.
+ (Opcional) Uma Conta da AWS com credenciais do IAM configuradas em sua máquina local. As credenciais são necessárias para ferramentas que executam chamadas de API da AWS e executam scripts, mas não para pesquisar documentação ou descobrir habilidades. Se você não tiver credenciais configuradas, consulte [Configurar o servidor MCP da AWS](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/getting-started-aws-mcp-server.html) para obter instruções detalhadas.

## Claude Code
<a name="agent-setup-claude-code"></a>

Instale o plug-in aws-core, parte do [Agent Toolkit para AWS](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/what-is-agent-toolkit.html), que agrupa a configuração do servidor MCP da AWS e um conjunto selecionado de habilidades do atendente (incluindo a habilidade de tecnologia sem servidor da AWS). 

### Instale o plug-in aws-core do Agent Toolkit para AWS
<a name="agent-setup-claude-code-toolkit"></a>

Use o comando a seguir para instalar o plug-in:

```
/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-core@agent-toolkit-for-aws
```

Esse comando instala as habilidades do atendente, incluindo a habilidade de tecnologia sem servidor da AWS, os hooks de agente e a configuração do servidor MCP da AWS em uma única etapa.

### Instalar o servidor MCP de tecnologia sem servidor
<a name="agent-setup-claude-code-mcp"></a>

Substitua `AWS_PROFILE` pelo nome do seu perfil local da AWS.

```
claude mcp add awslabs-aws-serverless-mcp \
  -e AWS_PROFILE=default \
  -e AWS_REGION=us-east-1 \
  -e FASTMCP_LOG_LEVEL=ERROR \
  --scope user \
  -- uvx awslabs.aws-serverless-mcp-server@latest
```

## Codex
<a name="agent-setup-codex"></a>

### Instale a habilidade de tecnologia sem servidor da AWS
<a name="agent-setup-codex-skill"></a>

```
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
```

### Instalar o servidor MCP de tecnologia sem servidor
<a name="agent-setup-codex-mcp"></a>

Substitua `AWS_PROFILE` pelo nome do seu perfil local da AWS.

```
codex mcp add awslabs-aws-serverless-mcp \
  --env AWS_PROFILE=default \
  --env AWS_REGION=us-east-1 \
  --env FASTMCP_LOG_LEVEL=ERROR \
  -- uvx awslabs.aws-serverless-mcp-server@latest
```

## Cursor
<a name="agent-setup-cursor"></a>

### Instale a habilidade de tecnologia sem servidor da AWS
<a name="agent-setup-cursor-skill"></a>

```
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
```

### Instalar o servidor MCP de tecnologia sem servidor
<a name="agent-setup-cursor-mcp"></a>

Adicione o seguinte a `.cursor/mcp.json` em `"mcpServers"`. Substitua `AWS_PROFILE` pelo nome do seu perfil local da AWS.

```
"awslabs.aws-serverless-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-serverless-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}
```

## Kiro
<a name="agent-setup-kiro"></a>

### Instale a habilidade de tecnologia sem servidor da AWS no Kiro CLI
<a name="agent-setup-kiro-skill"></a>

```
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
```

### Instalar o servidor MCP de tecnologia sem servidor
<a name="agent-setup-kiro-mcp"></a>

Adicione o seguinte a `~/.kiro/settings/mcp.json` em `"mcpServers"`. Substitua `AWS_PROFILE` pelo nome do seu perfil local da AWS.

```
"awslabs.aws-serverless-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-serverless-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  },
  "disabled": false
}
```

### Instale os saberes do Kiro (do Kiro IDE)
<a name="agent-setup-kiro-powers"></a>

Instale os seguintes saberes do Kiro que fornecem contextos e ferramentas especializados para os atendentes do Kiro sob demanda:
+ **Modelo de aplicação com tecnologia sem servidor (SAM)**: instale pelo [link dos saberes do Kiro](https://kiro.dev/launch/powers/add/?name=aws-sam).
+ **Instâncias gerenciadas do Lambda**: instale pelo [link dos saberes do Kiro](https://kiro.dev/launch/powers/add/?name=aws-lambda-managed-instances).
+ **Funções duráveis do Lambda**: instale pelo [link dos saberes do Kiro](https://kiro.dev/launch/powers/add/?name=aws-lambda-durable-functions).

## GitHub Copilot
<a name="agent-setup-github-copilot"></a>

### Instale a habilidade de tecnologia sem servidor da AWS
<a name="agent-setup-github-copilot-skill"></a>

```
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
```

### Instalar o servidor MCP de tecnologia sem servidor
<a name="agent-setup-github-copilot-mcp"></a>

Adicione o seguinte a `.vscode/mcp.json` em `"mcpServers"`. Substitua `AWS_PROFILE` pelo nome do seu perfil local da AWS.

```
"awslabs.aws-serverless-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-serverless-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}
```

## Windsurf
<a name="agent-setup-windsurf"></a>

### Instale a habilidade de tecnologia sem servidor da AWS
<a name="agent-setup-windsurf-skill"></a>

```
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
```

### Instalar o servidor MCP de tecnologia sem servidor
<a name="agent-setup-windsurf-mcp"></a>

Adicione o seguinte a `/.codeium/windsurf/mcp_config.json` em `"mcpServers"`. Substitua `AWS_PROFILE` pelo nome do seu perfil local da AWS.

```
"awslabs.aws-serverless-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-serverless-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}
```

## OpenCode
<a name="agent-setup-opencode"></a>

### Instale a habilidade de tecnologia sem servidor da AWS
<a name="agent-setup-opencode-skill"></a>

```
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
```

### Instalar o servidor MCP de tecnologia sem servidor
<a name="agent-setup-opencode-mcp"></a>

Adicione o seguinte a `/.config/opencode/opencode.jsonc` em `"mcpServers"`. Substitua `AWS_PROFILE` pelo nome do seu perfil local da AWS.

```
"awslabs.aws-serverless-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-serverless-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}
```

## Para todos os outros atendentes compatíveis com as habilidades do atendente e a configuração do servidor MCP
<a name="agent-setup-other-agents"></a>

Para qualquer outro atendente que ofereça suporte ao formato de [habilidades de atendente](https://agentskills.io/specification) de código aberto e à configuração do servidor MCP, siga estas etapas:

### Instale a habilidade de tecnologia sem servidor da AWS
<a name="agent-setup-other-agents-skill"></a>

```
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
```

### Instalar o servidor MCP de tecnologia sem servidor
<a name="agent-setup-other-agents-mcp"></a>

Adicione o servidor MCP de tecnologia sem servidor ao arquivo de configuração do cliente MCP do seu atendente em `"mcpServers"`. Substitua `AWS_PROFILE` pelo nome do seu perfil local da AWS.

```
{
  "mcpServers": {
    "awslabs.aws-serverless-mcp": {
      "command": "uvx",
      "args": ["awslabs.aws-serverless-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "default",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}
```