

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configure um agente de codificação de IA para o Amazon SES
<a name="agent-setup-guide"></a>

O Amazon SES publica a `amazon-ses` habilidade para ajudar os agentes de codificação de IA a configurar e solucionar problemas de envio de e-mails. O AWS MCP Server pode fornecer a habilidade atual quando sua solicitação precisar.

A `amazon-ses` habilidade atual não inclui o Mail Manager nem o recebimento de e-mails.

**Topics**
+ [Antes de começar](#agent-setup-guide-prerequisites)
+ [Etapa 1: Conecte seu agente ao AWS](#agent-setup-guide-choose-setup)
+ [Etapa 2: Use a habilidade do Amazon SES](#agent-setup-guide-use-skill)
+ [Mantenha sua configuração atualizada](#agent-setup-guide-keeping-current)

## Antes de começar
<a name="agent-setup-guide-prerequisites"></a>

Os pré-requisitos dependem do método de configuração escolhido.
+ Para o AWS Command Line Interface assistente, um `aws-core` plug-in ou a configuração de proxy local do Kiro nesta página, instale o [uv](https://docs.astral.sh/uv/), que inclui. `uvx` Esses métodos são usados `uvx` para executar o proxy local para o servidor AWS MCP. Não é necessária uma conexão direta com OAuth. `uv`
+ Essa etapa se aplica somente quando você instala a habilidade localmente para o Kiro. Instale [Node.js](https://nodejs.org/), que fornece o `npx` comando.
+ Para uma conexão de proxy local ou IAM SigV4, configure as AWS credenciais localmente antes que o agente chame as APIs. AWS A pesquisa de documentação e a descoberta de habilidades não exigem credenciais. Uma conexão OAuth direta usa o login do navegador e não exige AWS credenciais locais para a conexão MCP. Os scripts locais que chamam AWS APIs ainda precisam de credenciais.
+ Para uma conexão OAuth direta, a identidade do IAM que faz login deve permitir e. `signin:AuthorizeOAuth2Access` `signin:CreateOAuth2Token`

## Etapa 1: Conecte seu agente ao AWS
<a name="agent-setup-guide-choose-setup"></a>

Siga as instruções do seu agente. Quando conectado, seu agente pode acessar a `amazon-ses` habilidade quando necessário.

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

Execute estes comandos no Claude Code:

```
/plugin install aws-core@claude-plugins-official
/reload-plugins
```

**nota**  
Se o Claude Code informar que o plug-in não foi encontrado`/plugin marketplace update claude-plugins-official`, execute e tente novamente a instalação.

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

Adicione o mercado do Agent Toolkit a partir do seu terminal:

```
codex plugin marketplace add aws/agent-toolkit-for-aws
```

Inicie o Codex`/plugins`, execute e instale`aws-core`. Inicie uma nova conversa antes de continuar na Etapa 2.

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

No Cursor, escolha *Configurações*, *Plugins*, *Team Marketplaces*, *Adicionar Marketplace* e *Importar do Repo*. Insira `aws/agent-toolkit-for-aws`. Em seguida, abra o painel Plugins e instale`aws-core`.

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

O Kiro usa configurações separadas de MCP e habilidades locais. Adicione o servidor AWS MCP a. `.kiro/settings/mcp.json` `us-west-2`Substitua pela AWS região padrão para suas operações.

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

Na raiz do seu projeto, instale a `amazon-ses` habilidade local e seus arquivos de referência:

```
npx skills add https://github.com/aws/agent-toolkit-for-aws \
    --skill amazon-ses \
    --agent kiro-cli \
    --yes
```

### Alternativa: Configuração automática com o AWS Command Line Interface
<a name="agent-setup-guide-automatic-setup"></a>

Se você tiver a AWS Command Line Interface versão 2.35.0 ou posterior, execute o assistente de configuração:

```
aws configure agent-toolkit
```

O assistente detecta agentes instalados compatíveis, instala as AWS habilidades padrão e configura o AWS servidor MCP. Reinicie seu agente após a conclusão do assistente.

### Alternativa: Conecte-se diretamente com o OAuth 2.1
<a name="agent-setup-guide-connect-oauth"></a>

Se seu agente oferecer suporte a servidores MCP remotos, você poderá se conectar diretamente ao OAuth 2.1 em vez de executar o proxy local. Esse caminho usa o login do navegador e não requer AWS credenciais locais `uv` para a conexão MCP. Para comandos para Claude Code, Codex, Cursor e Kiro, consulte Autenticação [OAuth 2.1](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/oauth-authentication.html) para MCP Server. AWS Uma conexão direta não instala as habilidades locais incluídas no`aws-core`.

### Outro agente ou estrutura personalizada
<a name="agent-setup-guide-custom-mcp-client"></a>

Se seu agente oferecer suporte ao MCP, conecte-o diretamente ao servidor AWS MCP. Para opções de configuração e autenticação do cliente, incluindo OAuth e IAM SigV4, consulte [Configurando](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/getting-started-aws-mcp-server.html) o servidor MCP. AWS 

Se o agente oferecer suporte às habilidades do agente, você também poderá instalar `amazon-ses` localmente a partir do [kit de ferramentas do agente, por exemplo AWS](https://github.com/aws/agent-toolkit-for-aws). GitHub Escolha o agente alvo quando solicitado.

## Etapa 2: Use a habilidade do Amazon SES
<a name="agent-setup-guide-use-skill"></a>

Para obter orientações sobre controle de acesso do Amazon SES, consulte. [Gerenciamento de identidade e acesso no Amazon SES](control-user-access.md) Para problemas de conexão ou autenticação, consulte [Configurando o servidor AWS MCP.](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/getting-started-aws-mcp-server.html)

Descreva o resultado que você deseja. Você não precisa nomear a habilidade. Por exemplo, `example.com` substitua pelo seu domínio e use este prompt:

```
Set up example.com as a sending domain in Amazon SES.
```

## Mantenha sua configuração atualizada
<a name="agent-setup-guide-keeping-current"></a>

O AWS MCP Server fornece a `amazon-ses` habilidade atual. Se você instalou uma cópia local, repita o processo de instalação para atualizá-la.