Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Erste Schritte
<a name="agent-tools-valkey-mcp-getting-started"></a>

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

**Voraussetzungen: ** Python 3.10 oder höher`uv`, Zugriff auf einen Valkey-Datenspeicher

**Konfigurieren Sie Ihren MCP-Client: ** Fügen Sie Ihrer MCP-Client-Konfiguration Folgendes hinzu:

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

Ersetzen Sie es `<your-endpoint>` durch den Endpunkt Ihres Valkey-Datenspeichers. Ihr Coding-Agent muss Netzwerkzugriff auf den Endpunkt haben.

**Verbindung zu Amazon herstellen ElastiCache: ** ElastiCache Valkey-Cluster befinden sich in einer privaten VPC und sind nicht direkt von Ihrem lokalen Computer aus erreichbar. Informationen zum SSM-Tunnel-Setup, zur Generierung von IAM-Authentifizierungstoken und zur TLS-Handhabung im Tunnelmodus finden Sie in der [ ElastiCache Verbindungsanleitung ](https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/database-skills/amazon-elasticache/references/setup/connection-guide.md) im AWS Agent Toolkit, oder installieren Sie den [ Amazon ElastiCache Skill, damit Ihr Agent die Verbindungseinrichtung von ](agent-tools-skills.md) Anfang bis Ende übernimmt. Nachdem der Tunnel eingerichtet ist, verwenden Sie ihn `VALKEY_HOST=127.0.0.1` in der obigen Konfiguration.

Starten Sie Ihren MCP-Client neu, nachdem Sie die Konfiguration gespeichert haben.

Sie können Ihren Agenten bitten, die Verbindung zu überprüfen mit:

*Verwenden Sie den Valkey MCP-Server, um die Verbindung zu meinem Datenspeicher zu überprüfen und zu bestätigen, dass Valkey-Operationen verfügbar sind. *

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

Konfigurieren Sie den Valkey MCP-Server über Umgebungsvariablen in Ihrer MCP-Client-Konfiguration. Sie können das `--readonly` Flag auch verwenden, um den Agentenzugriff auf schreibgeschützte Operationen zu beschränken.


<table>
<thead>
  <tr><th>Variable</th><th>Zweck</th></tr>
</thead>
<tbody>
  <tr><td><code>VALKEY_HOST</code></td><td>Gibt den Endpunkt Ihres Valkey-Datenspeichers an. <code>127.0.0.1</code>Wird verwendet, wenn über einen Tunnel eine Verbindung zu einem privaten ElastiCache Cluster hergestellt wird.</td></tr>
  <tr><td><code>VALKEY_USE_SSL</code></td><td>Auf setzen, <code>true</code> um TLS zu aktivieren. Dies ist für ElastiCache Cluster erforderlich, bei denen die Verschlüsselung bei der Übertragung aktiviert ist.</td></tr>
  <tr><td><code>--readonly</code></td><td>Schränkt den Server auf die Leseebene ein und deaktiviert alle Schreib- und Verwaltungstools, sodass er für die Produktionsumgebung geeignet ist.</td></tr>
  <tr><td colspan="2"><b>Optionale Suchparameter </b></td></tr>
  <tr><td><code>EMBEDDINGS_PROVIDER</code></td><td>Wählt den von <code>add_documents</code> und <code>search</code> verwendeten Einbettungsprovider aus. Die unterstützten Optionen sind<code>bedrock</code>, <code>openai</code><code>ollama</code>, und<code>hash</code>. Wird <code>hash</code> für lokale Tests ohne Anmeldeinformationen verwendet.</td></tr>
  <tr><td><code>BEDROCK_MODEL_ID</code></td><td>Überschreibt das standardmäßige Amazon Bedrock-Einbettungsmodell.</td></tr>
  <tr><td><code>OPENAI_API_KEY</code></td><td>Stellt den API-Schlüssel bereit, der erforderlich <code>EMBEDDING_PROVIDER</code> ist, wenn auf gesetzt ist. <code>openai</code></td></tr>
</tbody>
</table>