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á.

# Introdução
<a name="agent-tools-valkey-mcp-getting-started"></a>

## Instalação
<a name="agent-tools-valkey-mcp-installation"></a>

**Pré-requisitos: Python** 3.10 ou posterior, Acesso a um armazenamento de dados Valkey `uv`

**Configure seu cliente MCP:** adicione o seguinte à configuração do cliente MCP:

```
{
  "mcpServers": {
    "valkey": {
      "command": "uvx",
      "args": ["awslabs.valkey-mcp-server@latest"],
      "env": {
        "VALKEY_HOST": "<your-endpoint>",
        "VALKEY_SSL": "true"
      }
    }
  }
}
```

`<your-endpoint>`Substitua pelo endpoint do seu armazenamento de dados Valkey. Seu agente de codificação deve ter acesso de rede ao endpoint.

**Conectando-se à Amazon ElastiCache:** os clusters ElastiCache Valkey residem em uma VPC privada e não podem ser acessados diretamente de sua máquina local. Para configuração de túnel SSM, geração de token de autenticação do IAM e tratamento de TLS no modo túnel, consulte o [guia de ElastiCache conexão](https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/database-skills/amazon-elasticache/references/setup/connection-guide.md) no kit de ferramentas do AWS agente ou instale o [Amazon ElastiCache Skill](agent-tools-skills.md) para permitir que seu agente gerencie a configuração da conexão de ponta a ponta. Depois que o túnel for estabelecido, use `VALKEY_HOST=127.0.0.1` na configuração acima.

Reinicie seu cliente MCP depois de salvar a configuração.

Você pode solicitar que seu agente verifique a conexão com:

*Use o servidor Valkey MCP para verificar a conexão com meu armazenamento de dados e confirmar se as operações do Valkey estão disponíveis.*

## Configuração
<a name="agent-tools-valkey-mcp-configuration"></a>

Configure o servidor Valkey MCP por meio de variáveis de ambiente na configuração do cliente MCP. Você também pode usar a `--readonly` sinalização para restringir o acesso do agente às operações somente para leitura.


<table>
<thead>
  <tr><th>Variável</th><th>Finalidade</th></tr>
</thead>
<tbody>
  <tr><td>VALKEY\_HOST</td><td>Especifica o endpoint do seu armazenamento de dados Valkey. Use 127.0.0.1 ao se conectar a um ElastiCache cluster privado por meio de um túnel.</td></tr>
  <tr><td>VALKEY\_USE\_SSL</td><td>Defina como true para ativar o TLS. Isso é necessário para ElastiCache clusters com criptografia em trânsito ativada.</td></tr>
  <tr><td>--readonly</td><td>Restringe o servidor ao nível de leitura e desativa todas as ferramentas administrativas e de gravação, tornando-o adequado para exploração de produção.</td></tr>
  <tr><td colspan="2">Parâmetros de pesquisa opcionais</td></tr>
  <tr><td>EMBEDDINGS\_PROVIDER</td><td>Seleciona o provedor de incorporação usado por e. add\_documents search As opções suportadas são bedrock openaiollama,, hash e. Use hash para testes locais sem credenciais.</td></tr>
  <tr><td>BEDROCK\_MODEL\_ID</td><td>Substitui o modelo de incorporação padrão do Amazon Bedrock.</td></tr>
  <tr><td>OPENAI\_API\_KEY</td><td>Fornece a chave de API necessária quando EMBEDDING\_PROVIDER está definida comoopenai.</td></tr>
</tbody>
</table>