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
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.
Topik
Memuat server MCP
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
Anda dapat menggunakan /tools perintah untuk melihat server mana yang masih memuat dan alat mana yang sudah tersedia.
Mengkonfigurasi inisialisasi server
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
Bagian ini mencakup cara menggunakan alat dan petunjuk MCP dengan Amazon Q Developer CLI.
Memahami alat MCP
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
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
Anda dapat menggunakan alat MCP dengan dua cara:
-
Permintaan Bahasa Alami: Cukup jelaskan apa yang ingin Anda lakukan, dan Q akan menentukan alat mana yang akan digunakan.
-
Direct Tool Invocation: Anda juga dapat secara eksplisit meminta Q untuk menggunakan alat tertentu.
Bekerja dengan petunjuk
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-namearg1 arg2
-
Contoh menggunakan prompt dengan argumen:
@fetch https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html
Manfaat utama
-
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
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
contoh 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
Alat
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
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
Sumber daya mewakili data yang dapat disediakan oleh server MCP ke Amazon Q, seperti:
-
Isi file
-
Catatan basis data
-
Respons API
-
Dokumentasi
-
Data konfigurasi
