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, acceso a un almacén de datos de `uv` Valkey

**Configure su cliente MCP: ** Agregue 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_USE_SSL": "true"
      }
    }
  }
}
```

`<your-endpoint>`Sustitúyalo por 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 tu 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, consulta la guía [ de ](https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/database-skills/amazon-elasticache/references/setup/connection-guide.md) ElastiCache conexión en el kit de herramientas del agente o instala [ Amazon ElastiCache Skill ](agent-tools-skills.md) para que tu 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 su 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 verificar 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 Valkey MCP mediante variables de entorno en la configuración de su cliente MCP. También puede usar la `--readonly` marca para restringir el acceso de los agentes a las operaciones de solo lectura.


<table>
<thead>
  <tr><th>Variable</th><th>Finalidad</th></tr>
</thead>
<tbody>
  <tr><td><code>VALKEY_HOST</code></td><td>Especifica el punto final de su almacén de datos de Valkey. Úselo <code>127.0.0.1</code> cuando se conecte a un ElastiCache clúster privado a través de un túnel.</td></tr>
  <tr><td><code>VALKEY_USE_SSL</code></td><td>Configúralo <code>true</code> en para habilitar TLS. Esto es necesario para ElastiCache los clústeres con el cifrado en tránsito habilitado.</td></tr>
  <tr><td><code>--readonly</code></td><td>Restringe el servidor al nivel de lectura y desactiva todas las herramientas administrativas y de escritura, por lo que es adecuado para la exploración en producción.</td></tr>
  <tr><td colspan="2"><b>Parámetros de búsqueda opcionales </b></td></tr>
  <tr><td><code>EMBEDDINGS_PROVIDER</code></td><td>Selecciona el proveedor de incrustación utilizado por <code>add_documents</code> y<code>search</code>. Las opciones admitidas son <code>bedrock</code> <code>openai</code><code>ollama</code>, y<code>hash</code>. <code>hash</code>Úselo para pruebas locales sin credenciales.</td></tr>
  <tr><td><code>BEDROCK_MODEL_ID</code></td><td>Anula el modelo de incrustación predeterminado de Amazon Bedrock.</td></tr>
  <tr><td><code>OPENAI_API_KEY</code></td><td>Proporciona la clave de API necesaria cuando <code>EMBEDDING_PROVIDER</code> se establece en. <code>openai</code></td></tr>
</tbody>
</table>