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_USE_SSL": "true"
      }
    }
  }
}
```

Remplacez-le `<your-endpoint>` 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 terminal.

**Connexion à Amazon ElastiCache : les clusters ** ElastiCache Valkey résident 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 permettre à votre agent de 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><code>VALKEY_HOST</code></td><td>Spécifie le point de terminaison de votre banque de données Valkey. À utiliser <code>127.0.0.1</code> lors de la connexion à un ElastiCache cluster privé via un tunnel.</td></tr>
  <tr><td><code>VALKEY_USE_SSL</code></td><td>Réglez sur pour <code>true</code> activer le protocole TLS. Cela est requis pour les ElastiCache clusters sur lesquels le chiffrement en transit est activé.</td></tr>
  <tr><td><code>--readonly</code></td><td>Limite le serveur au niveau de lecture et désactive tous les outils d'écriture et d'administration, le rendant ainsi adapté à l'exploration de la production.</td></tr>
  <tr><td colspan="2"><b>Paramètres de recherche facultatifs </b></td></tr>
  <tr><td><code>EMBEDDINGS_PROVIDER</code></td><td>Sélectionne le fournisseur d'intégration utilisé par <code>add_documents</code> et. <code>search</code> Les options prises en charge sont <code>bedrock</code> <code>openai</code><code>ollama</code>,, et<code>hash</code>. À utiliser <code>hash</code> pour les tests locaux sans informations d'identification.</td></tr>
  <tr><td><code>BEDROCK_MODEL_ID</code></td><td>Remplace le modèle d'intégration Amazon Bedrock par défaut.</td></tr>
  <tr><td><code>OPENAI_API_KEY</code></td><td>Fournit la clé d'API requise lorsqu'elle <code>EMBEDDING_PROVIDER</code> est définie sur<code>openai</code>.</td></tr>
</tbody>
</table>