Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

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

**Prasyarat:** Python 3.10 atau yang lebih baru`uv`,, Akses ke datastore Valkey

**Konfigurasikan klien MCP Anda:** Tambahkan yang berikut ini ke konfigurasi klien MCP Anda:

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

Ganti `<your-endpoint>` dengan titik akhir datastore Valkey Anda. Agen pengkodean Anda harus memiliki akses jaringan ke titik akhir.

**Menghubungkan ke Amazon ElastiCache:** Cluster ElastiCache Valkey hidup di VPC pribadi dan tidak dapat dijangkau langsung dari mesin lokal Anda. Untuk penyiapan terowongan SSM, pembuatan token autentikasi IAM, dan penanganan TLS dalam mode terowongan, lihat [panduan ElastiCache koneksi](https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/database-skills/amazon-elasticache/references/setup/connection-guide.md) di Toolkit AWS Agen, atau instal [ ElastiCache Keterampilan Amazon](agent-tools-skills.md) agar agen Anda menangani penyiapan koneksi secara end-to-end. Setelah terowongan dibuat, gunakan `VALKEY_HOST=127.0.0.1` dalam konfigurasi di atas.

Mulai ulang klien MCP Anda setelah menyimpan konfigurasi.

Anda dapat meminta agen Anda untuk memverifikasi koneksi dengan:

*Gunakan server Valkey MCP untuk memverifikasi koneksi ke datastore saya dan mengonfirmasi bahwa operasi Valkey tersedia.*

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

Konfigurasikan server MCP Valkey melalui variabel lingkungan dalam konfigurasi klien MCP Anda. Anda juga dapat menggunakan `--readonly` bendera untuk membatasi akses agen ke operasi hanya-baca.


<table>
<thead>
  <tr><th>Variabel</th><th>Tujuan</th></tr>
</thead>
<tbody>
  <tr><td>VALKEY\_HOST</td><td>Menentukan titik akhir dari datastore Valkey Anda. Gunakan 127.0.0.1 saat menghubungkan ke ElastiCache cluster pribadi melalui terowongan.</td></tr>
  <tr><td>VALKEY\_USE\_SSL</td><td>Setel true untuk mengaktifkan TLS. Ini diperlukan untuk ElastiCache cluster dengan enkripsi saat transit diaktifkan.</td></tr>
  <tr><td>--readonly</td><td>Membatasi server ke tingkat baca dan menonaktifkan semua alat tulis dan administrasi, sehingga cocok untuk eksplorasi produksi.</td></tr>
  <tr><td colspan="2">Parameter Pencarian Opsional</td></tr>
  <tr><td>EMBEDDINGS\_PROVIDER</td><td>Memilih penyedia penyematan yang digunakan oleh add\_documents dan. search Opsi yang didukung adalahbedrock,openai,ollama, danhash. Gunakan hash untuk pengujian lokal tanpa kredensyal.</td></tr>
  <tr><td>BEDROCK\_MODEL\_ID</td><td>Mengganti model penyematan Amazon Bedrock default.</td></tr>
  <tr><td>OPENAI\_API\_KEY</td><td>Menyediakan kunci API yang diperlukan saat EMBEDDING\_PROVIDER disetel keopenai.</td></tr>
</tbody>
</table>