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, accesso a un datastore `uv` 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_USE_SSL": "true"
      }
    }
  }
}
```

Sostituiscilo `<your-endpoint>` con l'endpoint del tuo datastore Valkey. Il tuo agente di codifica deve avere accesso alla 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 end-to-end. Una volta stabilito il tunnel, utilizzalo nella configurazione precedente. `VALKEY_HOST=127.0.0.1`

Riavviate il client MCP dopo aver salvato la configurazione.

Puoi chiedere al tuo agente di verificare la connessione con:

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

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

Configura il server Valkey MCP tramite le variabili di ambiente nella configurazione del tuo 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><code>VALKEY_HOST</code></td><td>Specifica l'endpoint del datastore Valkey. Da utilizzare <code>127.0.0.1</code> quando ci si connette a un cluster privato tramite un tunnel ElastiCache .</td></tr>
  <tr><td><code>VALKEY_USE_SSL</code></td><td>Impostato su <code>true</code> per abilitare TLS. Questo è necessario per ElastiCache i cluster con crittografia in transito abilitata.</td></tr>
  <tr><td><code>--readonly</code></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"><b>Parametri di ricerca opzionali </b></td></tr>
  <tr><td><code>EMBEDDINGS_PROVIDER</code></td><td>Seleziona il provider di incorporamento utilizzato da <code>add_documents</code> e. <code>search</code> Le opzioni supportate sono<code>bedrock</code>, <code>openai</code><code>ollama</code>, e. <code>hash</code> Da utilizzare <code>hash</code> per test locali senza credenziali.</td></tr>
  <tr><td><code>BEDROCK_MODEL_ID</code></td><td>Sostituisce il modello di incorporamento predefinito di Amazon Bedrock.</td></tr>
  <tr><td><code>OPENAI_API_KEY</code></td><td>Fornisce la chiave API richiesta quando <code>EMBEDDING_PROVIDER</code> è impostata su. <code>openai</code></td></tr>
</tbody>
</table>