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: ** ElastiCache Cluster Valkey hidup di VPC pribadi dan tidak dapat dijangkau langsung dari mesin lokal Anda. Untuk pengaturan 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 Agen, atau instal [ Amazon ElastiCache Skill ](agent-tools-skills.md) untuk membiarkan AWS agen Anda menangani pengaturan koneksi dari ujung ke ujung. 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 Valkey MCP melalui variabel lingkungan dalam konfigurasi klien MCP Anda. Anda juga dapat menggunakan `--readonly` flag untuk membatasi akses agen ke operasi read-only.


<table>
<thead>
  <tr><th>Variabel</th><th>Tujuan</th></tr>
</thead>
<tbody>
  <tr><td><code>VALKEY_HOST</code></td><td>Menentukan titik akhir 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 dalam 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 embedding 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 kredenSIAL.</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 <code>EMBEDDING_PROVIDER</code> diperlukan saat disetel ke<code>openai</code>.</td></tr>
</tbody>
</table>