Konfigurasi MCP untuk Pengembang Q di IDE - Amazon Q Developer
File konfigurasi MCP IDEMengakses UIMenambahkan server MCPMemecahkan masalah konfigurasi MCP AndaMengaktifkan server MCPMenonaktifkan server MCPMenghapus server MCP yang saat ini diaktifkanMenghapus server MCP yang saat ini dinonaktifkanMeninjau dan menyesuaikan izin alat

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

Konfigurasi MCP untuk Pengembang Q di IDE

Halaman ini mencakup opsi khusus IDE untuk mengkonfigurasi server MCP.

Memahami file konfigurasi MCP untuk Q Developer di IDE

Saat Anda menggunakan GUI untuk menambahkan server MCP ke Q Developer di IDE, konfigurasi disimpan dalam salah satu dari dua file:

  • Pada lingkup global: ~/. aws/amazonq/default.json

  • Pada lingkup lokal: .amazonq/default.json

Namun, untuk alasan lama, dimungkinkan juga untuk menempatkan informasi konfigurasi MCP di dua lokasi lain:

  • Pada lingkup global: ~/. aws/amazonq/mcp.json

  • Di lingkup lokal: .amazonq/mcp.json

Q Developer memberikan prioritas untuk konfigurasi tingkat ruang kerja untuk server MCP, izin mereka, dan pengaturan yang disimpan.

catatan

Jika Anda telah menyiapkan konfigurasi MCP dalam file mcp.json, dan Anda menggunakan GUI konfigurasi MCP untuk pertama kalinya, Anda akan melihat konfigurasi itu di GUI.

Support untuk file mcp.json lama diaktifkan oleh bidang Json di file konfigurasi useLegacyMcp default.json global Anda. Secara default, bidang ini diatur ke true. Untuk informasi selengkapnya, lihat UseLegacyMcpJson Bidang di repo Q Developer CLI GitHub .

Perhatikan bahwa file mcp.json juga dapat digunakan oleh Q CLI.

Untuk informasi tentang cara mengatur kontrol granular pada perkakas MCP, lihat referensi Alat bawaan.

Mengakses UI konfigurasi MCP

Untuk mengakses UI konfigurasi MCP di Q Developer di IDE:

  1. Buka IDE Anda (Kode VS, JetBrains, dll.).

  2. Buka panel Q Developer.

  3. Buka panel Obrolan.

  4. Pilih ikon alat. tools icon

Menambahkan server MCP

Ada dua mekanisme transportasi utama untuk komunikasi antara klien AI dan server MCP: STDIO dan HTTP.

Menambahkan server HTTP MCP

Untuk menambahkan server HTTP MCP ke IDE:

  1. Akses UI konfigurasi MCP.

  2. Pilih simbol plus (+).

  3. Pilih ruang lingkup: global atau lokal.

    Jika Anda memilih lingkup global, konfigurasi server MCP disimpan dalam ~/. aws/amazonq/default.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/default.json dalam proyek Anda saat ini.

  4. Di bidang Nama, masukkan nama server MCP.

  5. Pilih http sebagai protokol transportasi.

  6. Di bidang URL, masukkan URL yang akan dipanggil server MCP saat diinisialisasi.

  7. Di bawah Header - opsional, Anda dapat memasukkan pasangan kunci-nilai yang harus dikirim sebagai header permintaan HTTP.

  8. Masukkan nilai Timeout, sebagaimana berlaku.

  9. Pilih Simpan.

    Panel konfigurasi akan diganti dengan panel izin alat.

  10. Ikuti prosedur di bawahMeninjau dan menyesuaikan izin alat.

catatan

Jika titik akhir HTTP MCP memerlukan otorisasi, maka Amazon Q akan secara otomatis membuka halaman browser sehingga Anda dapat mengotorisasi Amazon Q untuk mengakses server MCP.

Menambahkan server STDIO MCP

Untuk menambahkan server STDIO MCP ke IDE:

  1. Akses UI konfigurasi MCP.

  2. Pilih simbol plus (+).

  3. Pilih ruang lingkup: global atau lokal.

    Jika Anda memilih lingkup global, konfigurasi server MCP disimpan dalam ~/. aws/amazonq/default.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/default.json dalam proyek Anda saat ini.

  4. Di bidang Nama, masukkan nama server MCP.

    Misalnya, jika kita menginstal server MCP AWS Dokumentasi, namanya mungkinAWS DocMCPServer.

  5. Pilih stdio sebagai protokol transportasi.

  6. Di bidang Command, masukkan perintah shell yang akan dijalankan server MCP saat diinisialisasi.

    Dalam kasus AWS Dokumentasi MCP Server, perintahnya adalahuvx. Ini adalah alias untukuv tool run, yang menciptakan lingkungan Python sementara.

  7. Di bidang Argumen, masukkan argumen yang akan diberikan ke perintah shell, jika berlaku.

    Dalam kasus AWS Dokumentasi MCP Server, argumennya adalahawslabs.aws-documentation-mcp-server@latest. Ini adalah pengenal paket Python yang menunjuk ke paket yang dihosting di PyPI (Indeks Paket Python).

    Tambahkan lebih banyak argumen seperlunya.

  8. Isi variabel lingkungan yang berlaku.

    Dalam kasus contoh kita, pertama-tama kita mengisi Nama: FASTMCP_LOG_LEVEL dan Nilai:ERROR.

    Kami juga akan menggunakan nama AWS_DOCUMENTATION_PARTITION dan nilai aws untuk menunjukkan partisi yang akan kami kerjakan.

  9. Masukkan nilai Timeout, sebagaimana berlaku.

    Sebagai contoh, kami akan menyimpan nilai yang disarankan 60 (detik).

  10. Pilih Simpan.

    Panel konfigurasi akan diganti dengan panel izin alat.

  11. Ikuti prosedur di bawahMeninjau dan menyesuaikan izin alat.

Memecahkan masalah konfigurasi MCP Anda

Setelah Anda menambahkan server MCP di IDE, Amazon Q akan mencoba menghubungkannya.

Jika ada masalah koneksi, maka peringatan akan ditampilkan di bagian atas panel. Anda seharusnya tidak mengharapkan alat dari server MCP itu berfungsi dengan baik sampai peringatan diselesaikan.

Pilih Perbaiki Konfigurasi untuk kembali ke layar konfigurasi MCP sehingga Anda dapat membuat perubahan yang sesuai.

Mengaktifkan server MCP

Prosedur berikut mengasumsikan bahwa server MCP yang dimaksud belum diaktifkan.

Untuk mengaktifkan server MCP di IDE:

  1. Buka panel MCP Server.

  2. Di samping server yang ingin Anda aktifkan, pilih Aktifkan.

Menonaktifkan server MCP

Untuk menonaktifkan server MCP di IDE:

  1. Buka panel MCP Server.

  2. Pilih server yang ingin Anda nonaktifkan.

  3. Pilih tiga titik di sebelah Edit setup.

  4. Pilih Nonaktifkan MCP Server.

Menghapus server MCP yang saat ini diaktifkan

Untuk menghapus server MCP yang saat ini diaktifkan dari IDE:

  1. Buka panel MCP Server.

  2. Pilih server yang ingin Anda hapus.

    Sebuah panel akan terbuka dengan rincian tentang server itu.

  3. Pilih tiga titik di sebelah Edit setup.

  4. Pilih Hapus server MCP.

  5. Konfirmasikan penghapusan saat diminta.

Menghapus server MCP yang saat ini dinonaktifkan

Untuk menghapus server MCP yang saat ini dinonaktifkan dari IDE:

  1. Buka panel MCP Server.

  2. Di samping server yang ingin Anda hapus, pilih Hapus.

  3. Konfirmasikan penghapusan saat diminta.

Meninjau dan menyesuaikan izin alat

Untuk meninjau dan menyesuaikan izin alat:

  1. Buka panel MCP Server.

  2. Pilih server MCP yang ingin Anda tinjau dan sesuaikan izinnya.

  3. Untuk setiap alat, Anda dapat mengatur salah satu tingkat izin berikut:

    • Tanyakan: Minta izin setiap kali alat digunakan.

    • Selalu izinkan: Izinkan alat berjalan tanpa meminta.

    • Tolak: Jangan gunakan alat ini.