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
<a name="mcp-ide"></a>

Halaman ini mencakup IDE-specific opsi untuk mengkonfigurasi server MCP. 

## Memahami file konfigurasi MCP untuk Q Developer di IDE
<a name="mcp-ide-configuration-understanding"></a>

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
+ Di 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 LegacyMcpJson bidang penggunaan di file konfigurasi default.json global Anda. Secara default, bidang ini diatur ke true. Untuk informasi selengkapnya, lihat [UseLegacyMcpJson Bidang](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#uselegacymcpjson-field) 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. Built-in ](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#tools-field)

## Mengakses UI konfigurasi MCP
<a name="mcp-ide-configuration-access-ui"></a>

Untuk mengakses UI konfigurasi MCP di Q Developer di IDE:

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

1. Buka panel Q Developer.

1. Buka panel **Obrolan**.

1. Pilih ikon alat. ![tools icon](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/tools-icon-full.png) 

## Menambahkan server MCP
<a name="mcp-ide-configuration-add-mcp-server"></a>

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

### Menambahkan server HTTP MCP
<a name="mcp-ide-configuration-add-http-server"></a>

Untuk menambahkan server HTTP MCP ke IDE:

1.  [Akses UI konfigurasi MCP](#mcp-ide-configuration-access-ui). 

1. Pilih simbol plus (\+).

1. Pilih ruang lingkup: global atau lokal.

   Jika Anda memilih lingkup global, konfigurasi server MCP disimpan dalam \~/. aws/amazonq/default.json dan tersedia di semua proyek Anda. Jika Anda memilih lingkup lokal, konfigurasi disimpan di. amazonq/default.json dalam proyek Anda saat ini.

1. Di bidang **Nama**, masukkan nama server MCP.

1. Pilih `http` sebagai protokol transportasi.

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

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

1. Masukkan nilai **Timeout**, sebagaimana berlaku.

1. Pilih **Simpan**. 

   Panel konfigurasi akan diganti dengan panel izin alat.

1. Ikuti prosedur di bawah[Meninjau dan menyesuaikan izin alat](#mcp-ide-configuration-review-adjust-tool).

**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
<a name="mcp-ide-configuration-add-stdio-server"></a>

Untuk menambahkan server STDIO MCP ke IDE:

1.  [Akses UI konfigurasi MCP](#mcp-ide-configuration-access-ui). 

1. Pilih simbol plus (\+).

1. Pilih ruang lingkup: global atau lokal.

   Jika Anda memilih lingkup global, konfigurasi server MCP disimpan dalam \~/. aws/amazonq/default.json dan tersedia di semua proyek Anda. Jika Anda memilih lingkup lokal, konfigurasi disimpan di. amazonq/default.json dalam proyek Anda saat ini.

1. Di bidang **Nama**, masukkan nama server MCP.

   Misalnya, jika kita menginstal [server MCP AWS Dokumentasi](https://awslabs.github.io/mcp/servers/aws-documentation-mcp-server/), namanya mungkin{{AWS DocMCPServer}}. 

1. Pilih `stdio` sebagai protokol transportasi.

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

   Dalam kasus AWS Dokumentasi MCP Server, perintahnya adalah`uvx`. Ini adalah alias untuk`uv tool run`, yang menciptakan lingkungan Python sementara.

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

   Dalam kasus AWS Dokumentasi MCP Server, argumennya adalah{{awslabs.aws-documentation-mcp-server@latest}}. Ini adalah pengenal paket Python yang menunjuk ke paket yang dihosting di PyPI (Python Package Index).

   Tambahkan lebih banyak argumen seperlunya.

1. 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](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/partitions.html) yang akan kami kerjakan.

1. Masukkan nilai **Timeout**, sebagaimana berlaku.

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

1. Pilih **Simpan**. 

   Panel konfigurasi akan diganti dengan panel izin alat.

1. Ikuti prosedur di bawah[Meninjau dan menyesuaikan izin alat](#mcp-ide-configuration-review-adjust-tool).

## Memecahkan masalah konfigurasi MCP Anda
<a name="mcp-ide-configuration-troubleshooting"></a>

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
<a name="mcp-ide-configuration-disable-server"></a>

Prosedur berikut mengasumsikan bahwa server MCP yang dimaksud belum diaktifkan.

Untuk mengaktifkan server MCP di IDE:

1. Buka panel MCP Server.

1. Di samping server yang ingin Anda aktifkan, pilih **Aktifkan**. 

## Menonaktifkan server MCP
<a name="mcp-ide-configuration-disable-server"></a>

Untuk menonaktifkan server MCP di IDE:

1. Buka panel MCP Server.

1. Pilih server yang ingin Anda nonaktifkan.

1. Pilih tiga titik di sebelah **Edit setup**. 

1. Pilih **Nonaktifkan MCP Server**. 

## Menghapus server MCP yang saat ini diaktifkan
<a name="mcp-ide-configuration-delete-enabled-server"></a>

Untuk menghapus server MCP yang saat ini diaktifkan dari IDE:

1. Buka panel MCP Server.

1. Pilih server yang ingin Anda hapus.

   Sebuah panel akan terbuka dengan rincian tentang server itu.

1. Pilih tiga titik di sebelah **Edit setup**. 

1. Pilih **Hapus server MCP**. 

1. Konfirmasikan penghapusan saat diminta.

## Menghapus server MCP yang saat ini dinonaktifkan
<a name="mcp-ide-configuration-delete-disabled-server"></a>

Untuk menghapus server MCP yang saat ini dinonaktifkan dari IDE:

1. Buka panel MCP Server.

1. Di samping server yang ingin Anda hapus, pilih **Hapus**. 

1. Konfirmasikan penghapusan saat diminta.

## Meninjau dan menyesuaikan izin alat
<a name="mcp-ide-configuration-review-adjust-tool"></a>

Untuk meninjau dan menyesuaikan izin alat:

1. Buka panel MCP Server.

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

1. 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.