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 `uv` dados Valkey

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

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

`<your-endpoint>`Substitua pelo endpoint do seu datastore Valkey. Seu agente de codificação deve ter acesso à rede para o endpoint.

**Conectando-se à Amazon ElastiCache: os clusters ** ElastiCache Valkey vivem 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 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 AWS Agent Toolkit 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 da 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 o `--readonly` sinalizador 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><code>VALKEY_HOST</code></td><td>Especifica o endpoint do seu armazenamento de dados Valkey. Use <code>127.0.0.1</code> ao se conectar a um ElastiCache cluster privado por meio de um túnel.</td></tr>
  <tr><td><code>VALKEY_USE_SSL</code></td><td>Defina como <code>true</code> para ativar o TLS. Isso é necessário para ElastiCache clusters com criptografia em trânsito ativada.</td></tr>
  <tr><td><code>--readonly</code></td><td>Restringe o servidor à camada de leitura e desativa todas as ferramentas administrativas e de gravação, tornando-o adequado para a exploração da produção.</td></tr>
  <tr><td colspan="2"><b>Parâmetros de pesquisa opcionais </b></td></tr>
  <tr><td><code>EMBEDDINGS_PROVIDER</code></td><td>Seleciona o provedor de incorporação usado por e. <code>add_documents</code> <code>search</code> As opções suportadas são <code>bedrock</code> <code>openai</code><code>ollama</code>,, <code>hash</code> e. Use <code>hash</code> para testes locais sem credenciais.</td></tr>
  <tr><td><code>BEDROCK_MODEL_ID</code></td><td>Substitui o modelo de incorporação padrão do Amazon Bedrock.</td></tr>
  <tr><td><code>OPENAI_API_KEY</code></td><td>Fornece a chave de API necessária quando <code>EMBEDDING_PROVIDER</code> está definida como<code>openai</code>.</td></tr>
</tbody>
</table>