Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Prise en main
<a name="agent-tools-valkey-mcp-getting-started"></a>

## Installation
<a name="agent-tools-valkey-mcp-installation"></a>

**Prérequis :** Python 3.10 ou version ultérieure`uv`, accès à une banque de données Valkey

**Configurez votre client MCP :** Ajoutez ce qui suit à la configuration de votre client MCP :

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

`<your-endpoint>`Remplacez-le par le point de terminaison de votre banque de données Valkey. Votre agent de codage doit disposer d'un accès réseau au point de terminaison.

**Connexion à Amazon ElastiCache :** les clusters ElastiCache Valkey se trouvent dans un VPC privé et ne sont pas accessibles directement depuis votre machine locale. Pour la configuration du tunnel SSM, la génération de jetons d'authentification IAM et la gestion du protocole TLS en mode tunnel, consultez le [guide de ElastiCache connexion](https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/database-skills/amazon-elasticache/references/setup/connection-guide.md) dans l' AWS Agent Toolkit, ou installez [Amazon ElastiCache Skill](agent-tools-skills.md) pour laisser votre agent gérer la configuration de la connexion de bout en bout. Une fois le tunnel établi, utilisez-le `VALKEY_HOST=127.0.0.1` dans la configuration ci-dessus.

Redémarrez votre client MCP après avoir enregistré la configuration.

Vous pouvez demander à votre agent de vérifier la connexion avec :

*Utilisez le serveur Valkey MCP pour vérifier la connexion à ma banque de données et confirmer que les opérations Valkey sont disponibles.*

## Configuration
<a name="agent-tools-valkey-mcp-configuration"></a>

Configurez le serveur Valkey MCP via des variables d'environnement dans la configuration de votre client MCP. Vous pouvez également utiliser l'`--readonly`indicateur pour restreindre l'accès des agents aux opérations en lecture seule.


<table>
<thead>
  <tr><th>Variable</th><th>Objectif</th></tr>
</thead>
<tbody>
  <tr><td>VALKEY\_HOST</td><td>Spécifie le point de terminaison de votre banque de données Valkey. À utiliser 127.0.0.1 lors de la connexion à un ElastiCache cluster privé via un tunnel.</td></tr>
  <tr><td>VALKEY\_USE\_SSL</td><td>Définissez sur pour true activer le protocole TLS. Cela est nécessaire pour les ElastiCache clusters sur lesquels le chiffrement en transit est activé.</td></tr>
  <tr><td>--readonly</td><td>Limite le serveur au niveau de lecture et désactive tous les outils d'écriture et d'administration, ce qui le rend adapté à l'exploration de production.</td></tr>
  <tr><td colspan="2">Paramètres de recherche facultatifs</td></tr>
  <tr><td>EMBEDDINGS\_PROVIDER</td><td>Sélectionne le fournisseur d'intégration utilisé par add\_documents et. search Les options prises en charge sont bedrock openaiollama,, ethash. À utiliser hash pour des tests locaux sans informations d'identification.</td></tr>
  <tr><td>BEDROCK\_MODEL\_ID</td><td>Remplace le modèle d'intégration par défaut d'Amazon Bedrock.</td></tr>
  <tr><td>OPENAI\_API\_KEY</td><td>Fournit la clé d'API requise lorsque EMBEDDING\_PROVIDER ce paramètre est défini suropenai.</td></tr>
</tbody>
</table>