Mengkonfigurasi server MCP

Aplikasi desktop Amazon Quick mendukung Model Context Protocol (MCP), standar terbuka yang memperluas kemampuan Quick dengan alat dan integrasi khusus. Anda dapat menghubungkan server MCP untuk memberikan akses cepat ke database, API internal, alat pengembang, dan sistem lain yang tidak tersedia melalui koneksi bawaan.

Apa itu MCP?

Model Context Protocol (MCP) adalah protokol yang memungkinkan asisten AI berinteraksi dengan alat eksternal dan sumber data. Saat Anda menghubungkan server MCP ke Quick, alat yang disediakan oleh server tersebut tersedia dalam percakapan obrolan dan agen terjadwal Anda. Misalnya, Anda dapat menghubungkan server MCP yang menyediakan alat kueri database, dan kemudian meminta Quick untuk menanyakan database Anda secara langsung di obrolan.

Mengakses pengaturan MCP

Untuk mengelola server MCP Anda, buka Pengaturan di bilah sisi, pilih Kemampuan, lalu pilih tab MCP.

Tab MCP menampilkan server Anda yang terhubung dengan bilah pencarian, dropdown filter, dan sakelar tampilan kisi atau daftar. Anda dapat menambahkan server baru dengan memilih + Tambahkan MCP.

Menambahkan server MCP

Saat Anda memilih + Tambahkan MCP, dialog muncul dengan tiga jenis koneksi: Lokal, Impor, dan Jarak Jauh. Pilih jenis koneksi yang cocok dengan cara server MCP Anda berjalan.

Lokal:

Gunakan jenis koneksi lokal untuk menjalankan server MCP sebagai perintah pada mesin Anda. Ini adalah opsi paling umum untuk alat pengembangan dan server yang diinstal secara lokal.

Tabel berikut menjelaskan bidang untuk koneksi MCP Lokal.

Bidang	Diperlukan	Deskripsi
Nama	Ya	Nama yang ramah untuk mengidentifikasi server MCP ini (misalnya, “MCP Database Saya”).
Perintah	Ya	Yang dapat dieksekusi untuk dijalankan. Nilai-nilai umum termasuk pythonnpx,node,, danuvx.
Argumen	Tidak	Argumen baris perintah, dipisahkan oleh spasi (misalnya,-m mcp_server --port 8080).
Deskripsi	Tidak	Deskripsi tentang apa yang dilakukan server MCP ini dan alat apa yang disediakannya. Ini membantu Cepat memahami kapan harus menggunakan alat server.
Variabel lingkungan	Tidak	Variabel lingkungan yang dibutuhkan oleh server. Pilih + Tambahkan variabel untuk menambahkan pasangan kunci-nilai.
Batas waktu (detik)	Tidak	Waktu maksimum untuk menunggu server dimulai, dari 5 hingga 300 detik. Waktu default-nya adalah 30 detik.

Untuk menambahkan server MCP lokal

Gunakan prosedur berikut:

1. Buka Pengaturan di bilah sisi dan pilih Kemampuan.

2. Pilih tab MCP.

3. Pilih + Tambahkan MCP.

4. Pilih Lokal sebagai jenis koneksi.

5. Masukkan Nama dan Perintah untuk dijalankan (misalnya,python).

6. Masukkan Argumen apa pun yang dibutuhkan perintah (misalnya,-m my_mcp_server).

7. Pilih + Tambahkan MCP untuk menyimpan.

Impor

Gunakan jenis koneksi Impor untuk memuat konfigurasi server MCP dari file konfigurasi yang ada. Ini berguna ketika Anda sudah memiliki server MCP yang dikonfigurasi untuk alat lain dan ingin menggunakan kembali konfigurasi itu di Quick.

Quick mendukung file konfigurasi dari alat-alat berikut.

• Kiro

• Kode Claude

• TUJUAN

• Antigravitasi

• QuickWork ekspor

Tabel berikut menjelaskan bidang untuk koneksi Impor MCP.

Bidang	Diperlukan	Deskripsi
Jalur file Config	Ya	Path ke file konfigurasi pada mesin Anda (misalnya,~/.kiro/settings/mcp.json).

Saat Anda memasukkan jalur file konfigurasi, Quick secara otomatis memindai file dan mendeteksi server MCP yang ditentukan di dalamnya. Quick juga mendeteksi alat yang diinstal pada sistem Anda dan menampilkannya sebagai chip (misalnya, “Kiro”, “AIM”, “Kode Claude”) di bawah Terdeteksi pada sistem ini.

Untuk mengimpor server MCP dari file konfigurasi

Gunakan prosedur berikut:

1. Buka Pengaturan di bilah sisi dan pilih Kemampuan.

2. Pilih tab MCP.

3. Pilih + Tambahkan MCP.

4. Pilih Impor sebagai jenis koneksi.

5. Masukkan path file Config ke file konfigurasi MCP yang ada.

6. Tinjau server dan alat sistem yang terdeteksi.

7. Pilih Muat file untuk mengimpor server.

Jarak Jauh

Gunakan jenis koneksi jarak jauh untuk terhubung ke server MCP yang berjalan pada mesin jarak jauh atau layanan cloud melalui HTTP. Ini berguna untuk server tim bersama atau layanan MCP yang dihosting.

Tabel berikut menjelaskan bidang untuk koneksi MCP Jarak Jauh.

Bidang	Diperlukan	Deskripsi
Nama	Ya	Nama yang ramah untuk mengidentifikasi server MCP ini.
URL	Ya	URL dari endpoint MCP (misalnya,https://mcp.example.com/sse).
Token	Tidak	Token pembawa untuk otentikasi dengan server jarak jauh.
Deskripsi	Tidak	Deskripsi tentang apa yang dilakukan server MCP ini dan alat apa yang disediakannya.
Batas waktu (detik)	Tidak	Waktu maksimum untuk menunggu server merespons, dari 5 hingga 300 detik. Waktu default-nya adalah 30 detik.

Untuk menambahkan server MCP jarak jauh

Gunakan prosedur berikut:

1. Buka Pengaturan di bilah sisi dan pilih Kemampuan.

2. Pilih tab MCP.

3. Pilih + Tambahkan MCP.

4. Pilih Remote sebagai jenis koneksi.

5. Masukkan Nama dan URL titik akhir MCP.

6. (Opsional) Masukkan Token jika server memerlukan otentikasi.

7. Pilih + Tambahkan MCP untuk menyimpan.

Mengelola server MCP

Setelah Anda menambahkan server MCP, mereka muncul di tab MCP. Anda dapat mengelola server Anda menggunakan fitur-fitur berikut.

• Cari — Gunakan bilah pencarian untuk menemukan server berdasarkan nama.

• Filter — Gunakan filter dropdown untuk menampilkan semua server atau filter berdasarkan status.

• Lihat sakelar - Beralih antara tampilan kisi dan tampilan daftar.

• Toggle — Mengaktifkan atau menonaktifkan server MCP individual tanpa menghapusnya.

• Edit - Ubah konfigurasi server.

• Hapus - Hapus koneksi server.

Agen pengkodean

Tab MCP juga mencakup bagian Coding agent di bawah server MCP. Agen pengkodean menggunakan Agent Client Protocol (ACP) untuk mendelegasikan tugas pengkodean ke agen pengkodean lokal seperti Kiro atau Claude Code.

Untuk menambahkan agen pengkodean

Gunakan prosedur berikut:

1. Buka Pengaturan di bilah sisi dan pilih Kemampuan.

2. Pilih tab MCP.

3. Di bagian Coding agents, pilih + Add Agent.

4. Konfigurasikan pengaturan koneksi agen.

5. Simpan konfigurasi.

Setelah mengonfigurasi agen pengkodean, Anda dapat mendelegasikan tugas ke sana dari obrolan. Misalnya, Anda dapat mengatakan “gunakan Kiro untuk memfaktorkan ulang modul ini” atau “minta Kode Claude untuk menulis tes untuk fungsi ini.” Cepat mengirimkan pekerjaan ke agen pengkodean dan melaporkan hasilnya kembali kepada Anda.

Menggunakan alat MCP di agen terjadwal

Anda dapat melampirkan server MCP ke agen terjadwal sebagai kemampuan. Saat Anda membuat atau mengedit agen terjadwal, Anda dapat memilih server MCP mana yang dapat diakses agen tersebut. Hal ini memungkinkan agen otomatis Anda untuk menggunakan alat kustom ketika mereka berjalan sesuai jadwal mereka.

Untuk melampirkan kemampuan MCP ke agen terjadwal, buka agen di Pengaturan > Kemampuan > Tugas terjadwal, pilih tab Kemampuan untuk agen tersebut, dan pilih server MCP yang ingin Anda sediakan.

catatan

Server MCP harus berjalan dan dapat diakses ketika agen terjadwal mencoba menggunakan alat mereka. Untuk server MCP lokal, proses server dimulai secara otomatis saat diperlukan. Untuk server jarak jauh, verifikasi bahwa server online dan dapat dijangkau.