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

# Menggunakan MCP dengan Pengembang Amazon Q
<a name="qdev-mcp"></a>

Model Context Protocol (MCP) adalah standar terbuka yang memungkinkan asisten AI berinteraksi dengan alat dan layanan eksternal. Amazon Q Developer CLI sekarang mendukung MCP, memungkinkan Anda untuk memperluas kemampuan Q dengan menghubungkannya ke alat dan layanan khusus.

**Topics**
+ [Ikhtisar MCP](qdev-mcp-overview.md)
+ [Konfigurasi MCP di CLI](command-line-mcp-config-CLI.md)
+ [Konfigurasi MCP](#mcp-configuration)
+ [Alat dan petunjuk](#command-line-mcp-tools-prompts)
+ [Konfigurasi MCP untuk Pengembang Q di IDE](mcp-ide.md)
+ [Manfaat utama](#command-line-mcp-benefits)
+ [Arsitektur MCP](#command-line-mcp-architecture)
+ [Konsep MCP inti](#command-line-mcp-concepts)
+ [Keamanan MCP](command-line-mcp-security.md)
+ [Tata kelola MCP untuk Pengembang Q](mcp-governance.md)

## Konfigurasi MCP
<a name="mcp-configuration"></a>

### Menyiapkan server MCP dengan Q CLI
<a name="setting-up-mcp-Q-CLI"></a>

Konfigurasi MCP yang ditentukan secara global untuk Amazon Q CLI ditangani di:

```
~/.aws/amazonq/cli-agents
```

Amazon Q Developer CLI mendukung server MCP lokal (yang berjalan sebagai proses) dan server MCP jarak jauh (yang berkomunikasi melalui HTTP). Server jarak jauh dapat menggunakan OAuth otentikasi atau terbuka tanpa otentikasi yang diperlukan.

Untuk informasi selengkapnya, lihat [panduan konfigurasi agen kustom di repo Q CLI Github](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#mcpservers-field) dan. [Server MCP jarak jauh](command-line-mcp-config-CLI.md#command-line-mcp-remote-servers)

### Menyiapkan server MCP dengan Q di IDE
<a name="setting-up-mcp-Q-IDE"></a>

Konfigurasi MCP yang didefinisikan secara global untuk Amazon Q di IDE ditangani di:

```
~/.aws/amazonq/agents/default.json
```

Untuk informasi selengkapnya, lihat [Konfigurasi MCP untuk Pengembang Q di IDE](mcp-ide.md).

### Memuat server MCP
<a name="command-line-mcp-server-loading"></a>

Amazon Q memuat server MCP di latar belakang, memungkinkan Anda untuk segera mulai berinteraksi tanpa menunggu semua server diinisialisasi. Alat menjadi tersedia secara progresif karena server masing-masing selesai memuat.

#### Memeriksa status server
<a name="command-line-mcp-server-status"></a>

Anda dapat menggunakan `/tools` perintah untuk melihat server mana yang masih memuat dan alat mana yang sudah tersedia.

#### Mengkonfigurasi inisialisasi server
<a name="command-line-mcp-server-config"></a>

Anda dapat menyesuaikan batas waktu inisialisasi server menggunakan:

```
$ q settings mcp.initTimeout [value]
```

Di `[value]` mana batas waktu dalam milidetik. Pengaturan ini mengontrol berapa lama Amazon Q akan menunggu server untuk diinisialisasi sebelum memungkinkan Anda untuk mulai berinteraksi.

## Alat dan petunjuk
<a name="command-line-mcp-tools-prompts"></a>

Bagian ini mencakup cara menggunakan alat dan petunjuk MCP dengan Amazon Q Developer CLI.

### Memahami alat MCP
<a name="command-line-mcp-tools"></a>

Alat MCP adalah fungsi yang dapat dieksekusi yang diekspos oleh server MCP ke Amazon Q Developer CLI. Mereka memungkinkan Pengembang Amazon Q untuk melakukan tindakan, memproses data, dan berinteraksi dengan sistem eksternal atas nama Anda.

Setiap alat di MCP memiliki:
+  **Nama**: Pengidentifikasi unik untuk alat
+  **Deskripsi: Deskripsi** yang dapat dibaca manusia tentang apa yang dilakukan alat
+  **Skema Input**: Skema JSON yang mendefinisikan parameter yang diterima alat
+  **Anotasi**: Petunjuk opsional tentang perilaku dan efek alat

### Menemukan alat yang tersedia
<a name="command-line-mcp-discovering-tools"></a>

Untuk melihat alat apa yang tersedia di sesi Q CLI Anda:

```
/tools
```

Perintah ini menampilkan semua alat yang tersedia, termasuk alat bawaan dan yang disediakan oleh server MCP.

Alat dapat memiliki tingkat izin berbeda yang menentukan cara penggunaannya:
+  **Disetujui otomatis**: Alat-alat ini dapat digunakan tanpa izin eksplisit untuk setiap pemanggilan
+  **Memerlukan persetujuan**: Alat ini memerlukan izin eksplisit Anda setiap kali digunakan
+  **Berbahaya**: Alat-alat ini ditandai sebagai berpotensi berisiko dan memerlukan pertimbangan yang cermat sebelum persetujuan

### Menggunakan alat
<a name="command-line-mcp-using-tools"></a>

Anda dapat menggunakan alat MCP dengan dua cara:

1.  **Permintaan Bahasa Alami**: Cukup jelaskan apa yang ingin Anda lakukan, dan Q akan menentukan alat mana yang akan digunakan.

1.  **Direct Tool Invocation**: Anda juga dapat secara eksplisit meminta Q untuk menggunakan alat tertentu.

### Bekerja dengan petunjuk
<a name="command-line-mcp-prompts"></a>

Server MCP dapat memberikan petunjuk yang telah ditentukan sebelumnya yang membantu memandu Q dalam tugas-tugas tertentu:
+ Daftar petunjuk yang tersedia: `/prompts` 
+ Gunakan prompt: 
  +  `@ prompt-name arg1 arg2` 

Contoh menggunakan prompt dengan argumen:

```
@fetch https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html
```

## Manfaat utama
<a name="command-line-mcp-benefits"></a>
+  **Ekstensibilitas**: Hubungkan Amazon Q ke alat khusus untuk domain atau alur kerja tertentu
+  **Kustomisasi**: Buat alat khusus yang disesuaikan dengan kebutuhan spesifik Anda
+  **Integrasi Ekosistem**: Memanfaatkan ekosistem yang berkembang dari alat yang kompatibel dengan MCP
+  **Standardisasi**: Gunakan protokol konsisten yang didukung oleh beberapa asisten AI
+  **Fleksibilitas**: MCP memungkinkan Anda untuk beralih di antara penyedia LLM yang berbeda sambil mempertahankan integrasi alat yang sama
+  **Keamanan**: Simpan data Anda dalam infrastruktur Anda dengan server MCP lokal

## Arsitektur MCP
<a name="command-line-mcp-architecture"></a>

MCP mengikuti arsitektur client-server di mana:
+  **MCP Host**: Program seperti Amazon Q Developer CLI yang ingin mengakses data melalui MCP
+  Klien **MCP: Klien** protokol yang memelihara koneksi 1:1 dengan server
+  **MCP Server**: Program ringan yang masing-masing mengekspos kemampuan spesifik melalui Protokol Konteks Model standar
+  **Sumber Data Lokal**: File, database, dan layanan komputer Anda yang dapat diakses dengan aman oleh server MCP
+  **Layanan Jarak Jauh**: Sistem eksternal yang tersedia melalui internet (misalnya, melalui APIs) yang dapat dihubungkan oleh server MCP

**Example Aliran Komunikasi MCP**  

```
  User
   |
   v
+------------------+     +-----------------+     +------------------+
|                  |     |                 |     |                  |
| Amazon Q Dev     | --> | MCP Client API  | --> | MCP Server       |
|                  |     |                 |     |                  |
+------------------+     +-----------------+     +------------------+
                                                        |
                                                        v
                                                 +------------------+
                                                 |                  |
                                                 | External Service |
                                                 |                  |
                                                 +------------------+
```
Aliran komunikasi antara pengguna, Amazon Q Developer CLI, dan layanan eksternal melalui MCP

## Konsep MCP inti
<a name="command-line-mcp-concepts"></a>

### Alat
<a name="command-line-mcp-concepts-tools"></a>

Alat adalah fungsi yang dapat dieksekusi yang diekspos oleh server MCP ke klien. Mereka mengizinkan Amazon Q untuk:
+ Lakukan tindakan dalam sistem eksternal
+ Memproses data dengan cara khusus
+ Berinteraksi dengan APIs dan layanan
+ Jalankan perintah atas nama Anda

Alat didefinisikan dengan nama unik, deskripsi, skema masukan (menggunakan Skema JSON), dan anotasi opsional tentang perilaku alat.

### Permintaan
<a name="command-line-mcp-concepts-prompts"></a>

Prompt adalah templat yang telah ditentukan sebelumnya yang membantu memandu Amazon Q dalam tugas tertentu. Mereka dapat:
+ Terima argumen dinamis
+ Sertakan konteks dari sumber daya
+ Rantai beberapa interaksi
+ Memandu alur kerja tertentu
+ Permukaan sebagai elemen UI (seperti perintah garis miring)

### Sumber Daya
<a name="command-line-mcp-concepts-resources"></a>

Sumber daya mewakili data yang dapat disediakan oleh server MCP ke Amazon Q, seperti:
+ Isi file
+ Catatan basis data
+ Respons API
+ Dokumentasi
+ Data konfigurasi