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

Target server MCP

Server MCP menyediakan alat lokal, akses data, atau fungsi khusus untuk interaksi Anda dengan model dan agen di Bed AgentCore rock. Di Bedrock AgentCore, Anda dapat menentukan server MCP yang telah dikonfigurasi sebelumnya sebagai target saat membuat gateway.

Server MCP menghosting alat, petunjuk, dan sumber daya yang dapat ditemukan dan digunakan agen. Di Bedrock AgentCore, Anda menggunakan gateway untuk mengaitkan target dengan kemampuan ini dan menghubungkannya ke runtime agen Anda. Anda terhubung dengan server MCP eksternal melalui SynchronizeGatewayTargets API yang melakukan jabat tangan protokol dan mengindeks kemampuan yang tersedia. Untuk informasi selengkapnya tentang menginstal dan menggunakan server MCP, lihat Amazon Bedrock AgentCore MCP Server: Pengkodean Vibe dengan asisten pengkodean Anda.

Pertimbangan dan batasan utama

Modus Listing

ListingMode dapat diatur sebagai DYNAMIC atau DEFAULT untuk target server MCP.

Sinkronisasi implisit

Untuk target dalam mode DEFAULT, CreateGatewayTarget dan UpdateGatewayTarget operasi secara otomatis memicu penemuan dan pengindeksan kemampuan. Ketika salah satu operasi dipanggil, Gateway mengambil alat yang tersedia menggunakan tools/list kemampuan MCP, meminta penggunaanprompts/list, menggunakan sumber dayaresources/templates/list, resources/list dan menambahkan kemampuan yang dikembalikan ke katalog terpadu.

Sinkronisasi Eksplisit

Katalog kemampuan untuk Target dalam mode DEFAULT, dapat diperbarui secara manual dengan memanggil SynchronizeGatewayTargets API. Saat dipanggil, itu memperbarui daftar kemampuan Gateway yang tersedia. Anda harus memanggil API setiap kali alat server MCP, prompt, definisi sumber daya berubah.

Sinkronisasi adalah mekanisme penting untuk mempertahankan katalog kemampuan yang akurat saat mengintegrasikan server MCP. Sinkronisasi implisit terjadi secara otomatis selama pembuatan dan pembaruan target, di mana Gateway segera menemukan dan mengindeks alat, petunjuk, dan sumber daya dari server MCP untuk memastikan kemampuan tersedia untuk pencarian semantik dan daftar terpadu. Sinkronisasi eksplisit dilakukan sesuai permintaan melalui SynchronizeGatewayTargets API, memungkinkan penemuan katalog kemampuan MCP ketika server MCP secara independen memodifikasi kemampuan mereka.

Kapan harus menelepon SynchronizeGatewayTargets

Setiap kali target server MCP memiliki Mode Listing disetel ke DEFAULT, gunakan SynchronizeGatewayTargets API setelah alat, prompt, atau sumber daya ditambahkan, dihapus, atau dimodifikasi. Karena Gateway melakukan pra-perhitungan penyematan vektor untuk pencarian semantik dan memelihara katalog kemampuan yang dinormalisasi, sinkronisasi diperlukan untuk memastikan pengguna Anda dapat menemukan dan memanggil alat, petunjuk, dan sumber daya terbaru yang tersedia.

Cara memanggil API

Buat permintaan PUT ke /gateways/ {gatewayIdentifier} /sync dengan ID target di badan permintaan. API mengembalikan respons 202 segera dan memproses sinkronisasi secara asinkron. Pantau status target GetGatewayTarget untuk melacak kemajuan sinkronisasi, karena operasi dapat memakan waktu beberapa menit untuk set kemampuan yang besar.

Strategi otorisasi

Jenis strategi otorisasi berikut didukung.

Pertimbangan konfigurasi untuk target server MCP

Berikut ini harus dikonfigurasi.

On-behalf-of pertimbangan pertukaran token

Batasan berikut berlaku saat Anda menggunakan pertukaran token on-behalf of (jenis TOKEN_EXCHANGE hibah) sebagai otorisasi keluar untuk target server MCP:

Mengamankan status permintaan untuk elisitasi dan pengambilan sampel (versi 2026-07-28 dan yang lebih baru)

Pada versi 2026-07-28 dan yang lebih baru, elicitasi dan pengambilan sampel menggunakan pola permintaan multi pulang pergi (MRTR). Target server MCP Anda menghasilkan requestState nilai dalam input_required hasil; gateway memperlakukan nilai ini sebagai buram. Gateway tidak menyimpanrequestState. Ini menyimpan nilai dalam memori hanya saat meneruskannya tidak berubah antara klien Anda dan target server MCP Anda, dan membuangnya ketika permintaan selesai.

AgentCore Gateway dan target server MCP Anda berbagi tanggung jawab untuk mengamankan status permintaan:

Untuk melindungi status permintaan, ikuti panduan dalam spesifikasi MCP. Enkripsi atau tanda tangani status (misalnya, dengan AES-GCM atau JWT yang ditandatangani) untuk memastikan kerahasiaan dan integritas. Ikat status khusus pengguna ke pengguna asal, kedaluwarsa status, dan perlakukan nilai status plaintext apa pun sebagai input yang tidak tepercaya. Untuk informasi selengkapnya, lihat Per mintaan multi pulang- pergi di situs web Model Context Protocol.

Menghubungkan ke server OAuth-protected MCP menggunakan aliran Kode Otorisasi

Untuk mendukung jenis pemberian Kode Otorisasi (OAuth berkaki tiga) dengan target server MCP, Amazon Bedrock AgentCore Gateway menyediakan dua metode untuk pembuatan target.

Sinkronisasi implisit selama pembuatan target server MCP

Dengan metode ini, pengguna admin menyelesaikan aliran kode otorisasi selamaCreateGatewayTarget,UpdateGatewayTarget, atau SynchronizeGatewayTargets operasi menggunakan URL otorisasi yang dikembalikan dalam respons. Hal ini memungkinkan Amazon Bedrock AgentCore Gateway untuk menemukan dan menyimpan alat server MCP di muka.

Menyediakan skema di muka selama pembuatan target server MCP

Dengan metode ini, pengguna admin menyediakan skema alat secara langsung selama CreateGatewayTarget atau UpdateGatewayTarget operasi menggunakan mcpToolSchema bidang, daripada Amazon Bedrock AgentCore Gateway mengambilnya secara dinamis dari server MCP. Amazon Bedrock AgentCore Gateway mengurai skema yang disediakan dan menyimpan definisi alat dalam cache.

Pengikatan Sesi URL

Pengikatan sesi URL otorisasi OAuth 2.0 memverifikasi bahwa pengguna yang memulai permintaan otorisasi OAuth adalah pengguna yang sama yang memberikan persetujuan. Setelah pengguna menyelesaikan persetujuan, browser mengalihkan kembali ke URL pengembalian yang dikonfigurasi pada target dengan URI sesi unik. Aplikasi kemudian bertanggung jawab untuk memanggil CompleteResourceTokenAuth API, menyajikan identitas pengguna dan URI sesi. Amazon Bedrock AgentCore Identity memvalidasi bahwa pengguna yang memulai alur adalah pengguna yang sama yang menyelesaikannya sebelum menukar kode otorisasi dengan token akses.

Ini mencegah skenario di mana pengguna secara tidak sengaja membagikan URL otorisasi dan orang lain menyelesaikan persetujuan, yang akan memberikan token akses ke pihak yang salah. URL otorisasi dan URI sesi hanya berlaku selama 10 menit, yang selanjutnya membatasi jendela untuk penyalahgunaan. Pengikatan sesi berlaku selama pembuatan target (sinkronisasi implisit) dan selama pemanggilan alat.

Mengonfigurasi izin

Peran IAM yang Anda gunakan untuk membuat, memperbarui, atau menyinkronkan target server MCP harus memiliki izin yang ditunjukkan dalam contoh berikut.

{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateGateway",
                "bedrock-agentcore:GetGateway",
                "bedrock-agentcore:CreateGatewayTarget",
                "bedrock-agentcore:GetGatewayTarget",
                "bedrock-agentcore:SynchronizeGatewayTargets",
                "bedrock-agentcore:UpdateGatewayTarget"
            ],
            "Resource": "arn:aws:bedrock-agentcore:*:*:*gateway*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateWorkloadIdentity",
                "bedrock-agentcore:GetWorkloadAccessToken",
                "bedrock-agentcore:GetWorkloadAccessTokenForUserId",
                "bedrock-agentcore:GetResourceOauth2Token",
                "bedrock-agentcore:GetResourceApiKey",
                "bedrock-agentcore:CompleteResourceTokenAuth",
                "secretsmanager:GetSecretValue"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "kms:EnableKeyRotation",
                "kms:Decrypt",
                "kms:Encrypt",
                "kms:GenerateDataKey*",
                "kms:ReEncrypt*",
                "kms:CreateAlias",
                "kms:DisableKey",
                "kms:*"
            ],
            "Resource": "arn:aws:kms:*:123456789012:key/*"
        }
    ]
}