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_USE_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:** Jika cache tanpa server Valkey Anda memiliki titik akhir publik, gunakan alamat titik akhir publik sebagai. `VALKEY_HOST` Tidak diperlukan terowongan. Koneksi membutuhkan TLS 1.3 dan token otentikasi IAM. Untuk detail tentang menghasilkan token, lihat[Connect ke cache dengan titik akhir publik](connecting-public-endpoint.md).

Untuk semua cache Valkey lainnya ElastiCache , Anda tidak dapat mencapai cache 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><code>VALKEY_HOST</code></td><td>Menentukan titik akhir dari datastore Valkey Anda. Gunakan <code>127.0.0.1</code> saat menghubungkan ke ElastiCache cluster pribadi melalui terowongan.</td></tr>
  <tr><td><code>VALKEY_USE_SSL</code></td><td>Setel <code>true</code> untuk mengaktifkan TLS. Ini diperlukan untuk ElastiCache cluster dengan enkripsi saat transit diaktifkan.</td></tr>
  <tr><td><code>--readonly</code></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"><b>Parameter Pencarian Opsional</b></td></tr>
  <tr><td><code>EMBEDDINGS_PROVIDER</code></td><td>Memilih penyedia penyematan yang digunakan oleh <code>add_documents</code> dan. <code>search</code> Opsi yang didukung adalah<code>bedrock</code>,<code>openai</code>,<code>ollama</code>, dan<code>hash</code>. Gunakan <code>hash</code> untuk pengujian lokal tanpa kredensyal.</td></tr>
  <tr><td><code>BEDROCK_MODEL_ID</code></td><td>Mengganti model penyematan Amazon Bedrock default.</td></tr>
  <tr><td><code>OPENAI_API_KEY</code></td><td>Menyediakan kunci API yang diperlukan saat <code>EMBEDDING_PROVIDER</code> disetel ke<code>openai</code>.</td></tr>
</tbody>
</table>