Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Introducción
<a name="agent-tools-valkey-mcp-getting-started"></a>

## Instalación
<a name="agent-tools-valkey-mcp-installation"></a>

**Requisitos previos:** Python 3.10 o posterior`uv`, acceso a un almacén de datos de Valkey

**Configure su cliente MCP: añada lo siguiente a la configuración de su cliente** MCP:

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

Reemplácelo por `<your-endpoint>` el punto final de su almacén de datos de Valkey. Su agente de codificación debe tener acceso de red al punto final.

**Conexión a Amazon ElastiCache:** los clústeres de ElastiCache Valkey se encuentran en una VPC privada y no se puede acceder a ellos directamente desde la máquina local. Para configurar el túnel SSM, generar el token de autenticación de IAM y gestionar el TLS en modo túnel, consulte la [guía de ElastiCache conexión](https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/database-skills/amazon-elasticache/references/setup/connection-guide.md) del kit de herramientas para agentes o instale [Amazon ElastiCache Skill](agent-tools-skills.md) para que su AWS agente pueda gestionar la configuración de la conexión de principio a fin. Una vez establecido el túnel, `VALKEY_HOST=127.0.0.1` utilícelo en la configuración anterior.

Reinicie el cliente MCP después de guardar la configuración.

Puede pedirle a su agente que verifique la conexión con:

*Utilice el servidor MCP de Valkey para comprobar la conexión a mi almacén de datos y confirmar que las operaciones de Valkey están disponibles.*

## Configuración
<a name="agent-tools-valkey-mcp-configuration"></a>

Configure el servidor MCP de Valkey mediante variables de entorno en la configuración de su cliente MCP. También puede usar el `--readonly` indicador para restringir el acceso de los agentes a operaciones de solo lectura.


<table>
<thead>
  <tr><th>Variable</th><th>Finalidad</th></tr>
</thead>
<tbody>
  <tr><td>VALKEY\_HOST</td><td>Especifica el punto final del almacén de datos de Valkey. Se usa 127.0.0.1 cuando se conecta a un ElastiCache clúster privado a través de un túnel.</td></tr>
  <tr><td>VALKEY\_USE\_SSL</td><td>trueConfigúrelo en para habilitar TLS. Esto es obligatorio para ElastiCache los clústeres con el cifrado en tránsito activado.</td></tr>
  <tr><td>--readonly</td><td>Limita el servidor al nivel de lectura y desactiva todas las herramientas de escritura y administración, lo que lo hace adecuado para la exploración de la producción.</td></tr>
  <tr><td colspan="2">Parámetros de búsqueda opcionales</td></tr>
  <tr><td>EMBEDDINGS\_PROVIDER</td><td>Selecciona el proveedor de incrustación utilizado por add\_documents ysearch. Las opciones compatibles son bedrock openaiollama, yhash. hashÚselo para pruebas locales sin credenciales.</td></tr>
  <tr><td>BEDROCK\_MODEL\_ID</td><td>Anula el modelo de incrustación predeterminado de Amazon Bedrock.</td></tr>
  <tr><td>OPENAI\_API\_KEY</td><td>Proporciona la clave de API necesaria cuando EMBEDDING\_PROVIDER se establece en. openai</td></tr>
</tbody>
</table>