Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Nozioni di base
<a name="agent-tools-valkey-mcp-getting-started"></a>

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

**Prerequisiti:** Python 3.10 o successivo`uv`, accesso a un datastore Valkey

**Configura il tuo client MCP: aggiungi quanto segue alla configurazione del tuo client MCP:**

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

`<your-endpoint>`Sostituiscilo con l'endpoint del tuo datastore Valkey. Il tuo agente di codifica deve avere accesso di rete all'endpoint.

**Connessione ad Amazon ElastiCache:** i cluster ElastiCache Valkey risiedono in un VPC privato e non sono raggiungibili direttamente dal computer locale. Per la configurazione del tunnel SSM, la generazione di token di autenticazione IAM e la gestione TLS in modalità tunnel, consulta la [guida alla ElastiCache connessione](https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/database-skills/amazon-elasticache/references/setup/connection-guide.md) nell' AWS Agent Toolkit o installa [Amazon ElastiCache Skill](agent-tools-skills.md) per consentire al tuo agente di gestire la configurazione della connessione dall'inizio alla fine. Dopo aver stabilito il tunnel, usalo nella configurazione precedente. `VALKEY_HOST=127.0.0.1`

Riavvia il client MCP dopo aver salvato la configurazione.

Puoi richiedere al tuo agente di verificare la connessione con:

*Utilizza il server MCP Valkey per verificare la connessione al mio datastore e confermare che le operazioni Valkey siano disponibili.*

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

Configura il server Valkey MCP tramite le variabili di ambiente nella configurazione del client MCP. È inoltre possibile utilizzare il `--readonly` flag per limitare l'accesso degli agenti alle operazioni di sola lettura.


<table>
<thead>
  <tr><th>Variabile</th><th>Scopo</th></tr>
</thead>
<tbody>
  <tr><td>VALKEY\_HOST</td><td>Specifica l'endpoint del tuo datastore Valkey. Da utilizzare 127.0.0.1 quando ci si connette a un cluster privato tramite un tunnel ElastiCache .</td></tr>
  <tr><td>VALKEY\_USE\_SSL</td><td>Impostato true per abilitare TLS. È necessario per ElastiCache i cluster con crittografia in transito abilitata.</td></tr>
  <tr><td>--readonly</td><td>Limita il server al livello di lettura e disabilita tutti gli strumenti di scrittura e amministrazione, rendendolo adatto all'esplorazione della produzione.</td></tr>
  <tr><td colspan="2">Parametri di ricerca opzionali</td></tr>
  <tr><td>EMBEDDINGS\_PROVIDER</td><td>Seleziona il provider di incorporamento utilizzato da add\_documents e. search Le opzioni supportate sonobedrock, openaiollama, e. hash hashUtilizzatelo per test locali senza credenziali.</td></tr>
  <tr><td>BEDROCK\_MODEL\_ID</td><td>Sostituisce il modello di incorporamento predefinito di Amazon Bedrock.</td></tr>
  <tr><td>OPENAI\_API\_KEY</td><td>Fornisce la chiave API richiesta quando EMBEDDING\_PROVIDER è impostata su. openai</td></tr>
</tbody>
</table>