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

# Tambahkan API REST API Gateway sebagai target untuk Amazon Bedrock AgentCore Gateway
<a name="mcp-server"></a>

Amazon Bedrock AgentCore Gateway memberi pengembang agen AI cara aman untuk mengekspos REST API Gateway Anda APIs sebagai alat yang kompatibel dengan Model Context Protocol (MCP). AgentCore Gateway menggunakan target untuk menentukan alat. Saat Anda menambahkan tahap sebagai target, Gateway Anda menjadi URL MCP tunggal yang memungkinkan akses ke alat untuk agen. Untuk informasi selengkapnya, lihat [Tahapan API Gateway REST API sebagai target](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-api-gateway.html) di *Panduan Pengembang Amazon Bedrock AgentCore Gateway*.

Target API Gateway menghubungkan AgentCore Gateway Anda ke tahapan REST Anda APIs. Anda dapat memasukkan seluruh tahap sebagai target, atau memilih sumber daya. Setelah Anda membuat target API Gateway, AgentCore Gateway menerjemahkan permintaan MCP yang masuk ke dalam permintaan HTTP dan menangani pemformatan respons. Klien MCP dapat mengambil dokumentasi API menggunakan `tools/list` metode dan memanggil APIs menggunakan metode. `tools/call`

## Pertimbangan-pertimbangan
<a name="w2aac15c11c11c34c11b7"></a>

Pertimbangan berikut mungkin memengaruhi penggunaan Anda menambahkan tahap sebagai target ke AgentCore Gateway:
+ Anda harus sudah memiliki AgentCore Gateway.
+ Hanya REST publik APIs yang didukung.
+ Titik akhir default API Anda tidak dapat dinonaktifkan.
+ Setiap metode API Anda harus memiliki [nama operasi](https://docs.aws.amazon.com/apigateway/latest/api/API_PutMethod.html#apigw-PutMethod-request-operationName) yang ditentukan untuknya, atau kebutuhan Anda untuk membuat penggantian nama saat Anda menambahkan tahap sebagai target. Nama ini digunakan sebagai nama alat yang digunakan agen untuk berinteraksi dengan metode Anda.
+ Anda dapat menggunakan`API_KEY`,`NO_AUTH`, atau jenis penyedia `GATEWAY_IAM_ROLE` kredensi untuk Outbound Auth agar Gateway Anda dapat mengakses API Anda. Penyedia `API_KEY` kredensi ditentukan oleh AgentCore Gateway. Anda dapat menggunakan kunci API Gateway API yang ada. Untuk informasi selengkapnya, lihat [Menyiapkan Autentikasi Keluar](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-outbound-auth.html).
+ Jika Anda menggunakan kumpulan pengguna Amazon Cognito atau otorisasi Lambda untuk mengontrol akses ke API Anda, klien MCP tidak dapat mengaksesnya.
+ API Anda harus berada di akun dan Wilayah yang sama dengan AgentCore Gateway Anda.

## Menambahkan tahap API sebagai target untuk AgentCore Gateway
<a name="mcp-server-api-gateway"></a>

Prosedur berikut menunjukkan cara menambahkan tahap API sebagai target untuk AgentCore Gateway.

**Untuk menambahkan tahap API sebagai target untuk AgentCore Gateway**

1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).

1. Pilih REST API yang diterapkan ke panggung.

1. Di panel navigasi utama, pilih **Tahapan**.

1. Pilih **Tindakan tahap**, lalu pilih **Buat target MCP**.

1. Untuk **AgentCore Gateway**, pilih AgentCore Gateway.

1. Untuk **nama Target**, masukkan nama target.

1. Untuk **deskripsi Target**, masukkan deskripsi.

1. Simpan API dan panggung yang disediakan.

1. Untuk **sumber daya API Pilih**, pilih sumber daya API Anda yang dapat diakses oleh agen yang menggunakan AgentCore Gateway Anda.

   Jika Anda tidak memilih sumber daya, agen tidak dapat melihat dokumentasi atau memanggil titik akhir. 

1. Kombinasi sumber daya dan metode adalah operasi untuk alat. Jika operasi Anda tidak memiliki nama, buat penggantian nama.

   Anda juga dapat menentukan nama operasi untuk metode saat Anda membuatnya.

1. **Untuk **konfigurasi Outbound Auth**, pilih **Peran IAM**, **Tanpa otorisasi**, atau kunci API.**

1. Pilih **Buat target**.

Untuk melihat semua AgentCore Gateway yang memiliki akses ke Anda APIs, pilih bagian **target MCP** di panel navigasi utama. Di bagian ini, Anda dapat membuat target MCP untuk API apa pun di Wilayah yang diterapkan ke sebuah panggung. Pilih **Buat target MCP** dan ikuti langkah-langkah sebelumnya.

Anda juga dapat melihat alat yang tersedia untuk target Anda dan mengedit target Anda di konsol AgentCore Gateway. Untuk informasi selengkapnya, lihat [Menambahkan target ke AgentCore Gateway yang ada](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-adding-targets.html).