Halaman ini berlaku untuk Apigee dan Apigee hybrid.
Lihat dokumentasi
Apigee Edge.
Halaman ini menjelaskan cara menggunakan Apigee untuk mengekspos API Anda
sebagai alat MCP ke aplikasi agentic. MCP di Apigee tersedia untuk
organisasi Langganan, bayar sesuai penggunaan, dan Evaluasi, termasuk
organisasi yang mengaktifkan Residensi Data. Mulai dari Apigee hybrid versi
1.17.0, MCP juga tersedia untuk Apigee hybrid — bidang data runtime berjalan di dalam cluster Kubernetes Anda sendiri, bukan di infrastruktur yang dikelola Google. Lihat
Mengaktifkan MCP di Apigee hybrid
untuk alur penginstalan dan konfigurasi khusus Hybrid.
Apa itu MCP?
Model Context Protocol (MCP) adalah protokol open source yang dikembangkan oleh Anthropic yang menstandarkan cara aplikasi AI terhubung ke sumber data, alur kerja, dan alat.
Aplikasi AI dapat menggunakan MCP untuk mengakses layanan Google Cloud dan Apigee sebagai alat. Dalam konteks ini, istilah MCP berikut berguna untuk dipahami:
- Host MCP: Aplikasi atau lingkungan AI yang berinteraksi dengan pengguna. Host MCP menggunakan model bahasa besar (LLM) untuk memproses permintaan yang mungkin memerlukan data atau alat eksternal.
- Klien MCP: Komponen dalam host MCP yang membantu LLM dan server MCP berkomunikasi satu sama lain. Klien ini menerjemahkan permintaan LLM untuk server MCP dan mengonversi balasan server MCP untuk LLM. Klien ini juga menemukan dan menggunakan server MCP yang tersedia.
- Server MCP: Layanan eksternal yang menyediakan konteks, data, atau kemampuan ke LLM, yang bertindak sebagai proxy antara LLM dan klien MCP.
Cara kerja MCP di Apigee
Endpoint MCP untuk Google, Google Cloud, dan Apigee menerapkan spesifikasi server MCP. Hal ini memungkinkan klien MCP yang mematuhi standar mengaksesnya untuk:
- Menemukan endpoint yang tersedia.
- Mencantumkan alat yang tersedia di endpoint.
- Melakukan autentikasi ke endpoint.
- Memanggil alat sesuai dengan kebijakan akses yang ditentukan.
Klien MCP apa pun yang mendukung endpoint MCP jarak jauh melalui HTTP/S dapat mengakses alat ini.
Karena endpoint dikelola, Anda tidak perlu menginstal atau mengelola server MCP lokal, server MCP jarak jauh, atau infrastruktur tambahan untuk
memungkinkan aplikasi agen mengakses layanan Anda.
MCP di Apigee menawarkan dukungan JSON-RPC untuk metode tools/list dan tools/call,
serta untuk metode server/discover dalam protokol MCP stateless. Anda dapat menyesuaikan endpoint MCP
dengan parameter untuk visibilitas, keamanan, ketersediaan jaringan, dan kemampuan observasi. Untuk versi protokol MCP yang didukung Apigee, lihat Versi protokol MCP yang didukung.
Model deployment
MCP tersedia dalam dua model deployment Apigee:
- Apigee (SaaS): Bidang data MCP dihosting di infrastruktur yang dikelola Google. Anda men-deploy proxy MCP Discovery dan endpoint akan langsung tersedia.
- Apigee hybrid (dihosting sendiri, mulai di Apigee hybrid
1.17.0): Bidang data MCP berjalan di dalam cluster Kubernetes Anda sendiri. Bidang kontrol Apigee membuat konfigurasi alat MCP dari Spesifikasi OpenAPI Anda, dan cluster Anda mengambil konfigurasi tersebut sesuai jadwalnya sendiri. Traffic permintaan MCP tidak pernah keluar dari cluster Anda. Lihat Mengaktifkan MCP di Apigee hybrid.
Arsitektur bidang data MCP di Apigee hybrid
Diagram berikut menunjukkan cara komponen MCP didistribusikan antara bidang kontrol Apigee dan cluster Apigee hybrid Anda.
Dua properti arsitektur ini penting untuk perencanaan dan peninjauan keamanan:
- Traffic permintaan MCP tetap berada di dalam cluster Anda. Klien MCP mengakses ingress Apigee yang ada di URL yang sama dengan yang akan mereka gunakan untuk proxy Apigee lainnya. Message Processor Anda kemudian merutekan permintaan ke bidang data MCP di cluster yang sama. Tidak ada permintaan atau respons MCP yang melewati batas ke Google Cloud pada waktu permintaan.
- Konfigurasi ditarik, bukan didorong. Konfigurasi alat MCP dibuat oleh bidang kontrol Apigee dan diambil oleh komponen di cluster Anda sesuai jadwal. Bidang kontrol Apigee tidak pernah memulai koneksi ke cluster Anda. Lihat Persyaratan jaringan keluar untuk endpoint yang tepat yang harus diizinkan oleh egress cluster Anda.
Versi protokol MCP yang didukung
MCP di Apigee mendukung protokol MCP stateless, versi 2026-07-28, dan versi protokol MCP stateful 2025-11-25, 2025-06-18, 2025-03-26, dan 2024-11-05. Endpoint MCP menyajikan kedua protokol secara bersamaan, sehingga klien MCP yang ada tetap berfungsi saat klien MCP yang menggunakan protokol stateless memanggil endpoint yang sama.
Di halaman ini, stateless mengacu pada model metadata per permintaan yang diperkenalkan di MCP
versi 2026-07-28, yang juga disebut modern dalam spesifikasi MCP.
Stateful mengacu pada model sebelumnya yang dimulai dengan permintaan initialize,
yang juga disebut lama dalam spesifikasi MCP. Untuk contoh yang berhasil, lihat
Mencantumkan
alat dengan protokol MCP stateless di panduan memulai.
| Protokol | Versi | Metode yang didukung |
|---|---|---|
| Stateless | 2026-07-28 |
|
| Stateful |
|
|
Cara Apigee memilih protokol
Apigee memilih protokol dari isi permintaan, bukan dari header MCP-Protocol-Version. Permintaan yang objek params._meta-nya
berisi io.modelcontextprotocol/protocolVersion dengan nilai string JSON menggunakan
protokol stateless. Permintaan tanpa kunci tersebut, atau dengan nilai yang bukan string, akan menggunakan protokol stateful.
- Nilai string apa pun akan memilih protokol stateless. Jika string tersebut menyebutkan versi yang
tidak didukung Apigee, permintaan akan tetap menggunakan protokol stateless dan gagal
dengan error JSON-RPC
-32022(Unsupported protocol version). Protokol ini tidak akan beralih ke protokol stateful. - Permintaan dengan header
MCP-Protocol-Versiondari2026-07-28, tetapi tanpaio.modelcontextprotocol/protocolVersiondiparams._metaadalah permintaan stateful. Versi2026-07-28bukan versi stateful, sehingga Apigee menolaknya dengan HTTP400dan error JSON-RPC protokol stateful-32602(Unsupported protocol version), bukan error stateless-32022. Untuk menggunakan versi2026-07-28, permintaan harus menggunakan format permintaan stateless. - Jika permintaan
initializememinta versi2026-07-28, atau untuk versi apa pun yang tidak didukung Apigee, Apigee akan menegosiasikan versi2025-11-25. - Metode
server/discoverhanya tersedia dalam protokol stateless. Permintaanserver/discoverstateful mengikuti penanganan error protokol stateful: permintaan ini mendapatkan HTTP200dengan error JSON-RPC-32601(Method server/discover is not supported) dalam isi respons. Status404HTTP dalam Error protokol stateless hanya berlaku untuk permintaan stateless.
Permintaan protokol stateless
Setiap permintaan stateless harus menyertakan versi protokol dalam isi permintaan dan header. Jika Anda memindahkan klien MCP dari protokol stateful, berikut adalah perbedaan utamanya:
- Klien MCP tidak memanggil
initialize. Apigee tidak membuat sesi untuk protokol stateless. - Klien MCP tidak mengirim header
Mcp-Session-Id. Jika permintaan stateless menyertakannya, Apigee akan mengabaikannya. - Setiap permintaan membawa objek
params._metadengan versi protokol dan kemampuan klien. - Setiap permintaan membawa header
MCP-Protocol-VersiondanMcp-Method, dan permintaantools/calljuga membawa headerMcp-Name. - Permintaan yang tidak valid akan mendapatkan HTTP
400atau404dengan kode error di Error protokol stateless.
Permintaan stateless harus menyertakan kolom berikut dalam isi permintaan:
params._meta["io.modelcontextprotocol/protocolVersion"]: harus berupa string JSON"2026-07-28", bukan angka.params._meta["io.modelcontextprotocol/clientCapabilities"]: harus berupa objek JSON. Jika klien MCP tidak mendeklarasikan kemampuan, kirim objek kosong ({}).- Opsional:
params._meta["io.modelcontextprotocol/clientInfo"], objek dengannamedanversionklien MCP. Spesifikasi MCP merekomendasikan agar klien MCP mengirimkannya pada setiap permintaan.
Permintaan stateless harus menyertakan header HTTP berikut:
| Header | Diperlukan untuk | Nilai |
|---|---|---|
MCP-Protocol-Version |
Semua metode | 2026-07-28. Harus cocok dengan versi protokol di _meta. |
Mcp-Method |
Semua metode | Metode JSON-RPC, misalnya tools/list. Harus cocok dengan kolom method
dalam isi permintaan. |
Mcp-Name |
tools/call saja |
Nama alat. Harus cocok dengan params.name dalam isi permintaan. Kirim nama alat sebagai nilai header ASCII biasa. Jika nama alat berisi karakter non-ASCII atau karakter
kontrol, memiliki spasi kosong di awal atau di akhir, atau cocok dengan pola
=?base64?...?=, Anda harus mengenkodenya sebagai
=?base64?ENCODED_NAME?=, dengan ENCODED_NAME adalah
encoding base64 yang diisi dari nama alat UTF-8. Untuk mengetahui detailnya, lihat
Encoding nilai dalam spesifikasi MCP. Jangan kirim
Mcp-Name dengan tools/list atau server/discover. |
Kirim setiap header satu kali. Apigee memperlakukan header MCP-Protocol-Version,
Mcp-Method, atau Mcp-Name yang berulang sebagai ketidakcocokan header.
Hasil stateless mencakup "resultType": "complete". Hasil
tools/list dan server/discover juga mencakup
"cacheScope": "public" dan "ttlMs": 0. ttlMs sebesar
0 berarti hasil akan usang begitu tiba: Apigee tidak
menawarkan jendela cache untuk hasil tersebut, sehingga cacheScope tidak memiliki efek praktis. Hasil server/discover mencantumkan
versi protokol yang didukung di supportedVersions, kemampuan server di
capabilities ("tools": {"listChanged": false}), dan informasi
server di _meta["io.modelcontextprotocol/serverInfo"]. Urutan kolom dalam objek JSON tidak dijamin, sehingga klien MCP harus membaca kolom berdasarkan nama.
Jika permintaan tools/call stateless menyertakan kunci OpenTelemetry
traceparent, tracestate, atau baggage di
params._meta, Apigee akan meneruskan nilainya ke backend sebagai header HTTP dengan
nama yang sama.
Apigee tidak menambahkan anotasi x-mcp-header ke definisi alat yang ditampilkan tools/list, sehingga klien MCP tidak mengirim header Mcp-Param-NAME ke Apigee.
Error protokol stateless
Apigee menolak permintaan stateless yang tidak memenuhi persyaratan dalam
Permintaan protokol stateless dengan salah satu error berikut.
Untuk memperbaiki error 400, periksa permintaan berdasarkan persyaratan tersebut.
Apigee tidak memerlukan kemampuan klien apa pun, sehingga tidak menampilkan error JSON-RPC
-32021 (MissingRequiredClientCapability).
| Kondisi | Status HTTP | Kode error JSON-RPC | Pesan error |
|---|---|---|---|
Header MCP-Protocol-Version, Mcp-Method, atau Mcp-Name
tidak ada. |
400 |
-32020 |
Missing HEADER header |
| Header tidak cocok dengan isi permintaan, kosong, atau muncul lebih dari sekali. | 400 |
-32020 |
Header mismatch: HEADER header does not match request body |
Versi protokol tidak didukung. Error data berisi versi yang diminta di requested dan versi yang didukung di supported. |
400 |
-32022 |
Unsupported protocol version |
io.modelcontextprotocol/clientCapabilities tidak ada di _meta. |
400 |
-32602 |
Missing io.modelcontextprotocol/clientCapabilities in _meta |
io.modelcontextprotocol/clientCapabilities bukan objek JSON. |
400 |
-32602 |
io.modelcontextprotocol/clientCapabilities in _meta is not an object |
Metode ini tidak didukung dalam protokol stateless, misalnya initialize,
notifications/initialized, ping, resources/list,
resources/read, prompts/list, atau
subscriptions/listen. |
404 |
-32601 |
Method METHOD is not supported |
Fitur utama MCP di Apigee
MCP di Apigee menawarkan fitur untuk penemuan, keamanan, dan tata kelola alat. Fitur ini membantu Anda mengelola cara aplikasi agentic berinteraksi dengan layanan Anda.
Penemuan alat yang disederhanakan dengan API hub
Anda dapat menemukan endpoint MCP yang tersedia untuk layanan Apigee menggunakan layanan direktori yang dapat diakses melalui antarmuka REST. Setiap endpoint MCP juga mendukung metode tools/list MCP, yang memungkinkan klien MCP menemukan alat yang tersedia di endpoint tersebut.
Selain itu, MCP terintegrasi dengan hub API Apigee. Saat Proxy Discovery MCP di-deploy, hub API akan otomatis menyerap spesifikasi OpenAPI-nya, menetapkan gaya API MCP, dan memetakan operasi API ke setiap alat MCP. Hal ini memudahkan developer memfilter API yang mendukung MCP di API hub dan menggunakan Penelusuran Semantik dengan kueri bahasa alami untuk menemukan alat yang relevan bagi aplikasi agen mereka.
Penempatan argumen alat pada permintaan backend
Saat klien MCP memanggil alat, Apigee akan membuat permintaan ke backend Anda
dari argumen yang diberikan klien. Nilai in yang dideklarasikan setiap parameter dalam spesifikasi OpenAPI menentukan tempat argumen tersebut ditempatkan pada permintaan keluar.
Nilai in OpenAPI |
Tempat argumen dikirim pada permintaan backend |
|---|---|
header |
Sebagai header permintaan. Nama parameter digunakan sebagai nama header persis seperti yang tertulis dalam spesifikasi. |
cookie |
Di header permintaan Cookie, sebagai pasangan name=value. Jika suatu operasi
mendeklarasikan beberapa parameter cookie, parameter tersebut akan dikirim dalam satu
header Cookie, yang dipisahkan oleh ; (titik koma
dan spasi). |
query |
Dalam string kueri. |
path |
Disubstitusikan ke jalur URL permintaan. |
Setiap parameter muncul di inputSchema alat, terlepas dari
nilai in-nya, sehingga klien MCP menyediakan semuanya dengan cara yang sama.
Nilai in hanya berubah di tempat nilai tersebut ditempatkan pada
permintaan ke backend Anda.
Misalnya, operasi berikut mendeklarasikan satu parameter di masing-masing dari tiga lokasi:
paths: /orders: get: operationId: listOrders parameters: - name: X-Session-Id in: header schema: type: string - name: tenantId in: cookie schema: type: string - name: limit in: query schema: type: integer
Permintaan tools/call yang menyediakan ketiga argumen akan menghasilkan
permintaan backend dengan bentuk berikut:
GET /orders?limit=25 X-Session-Id: sess-abc-123 Cookie: tenantId=tenant-xyz-789
Perhatikan perilaku berikut:
- Argumen yang terikat ke header atau cookie juga tidak ditambahkan ke string kueri, dan tidak disertakan dalam isi permintaan.
- Argumen yang tidak diberikan klien akan dilewati. Tidak ada header, cookie, atau parameter kueri kosong yang dikirim sebagai gantinya.
- Header terikat menggantikan header dengan nama yang sama yang sudah ada di permintaan backend. Header lain pada permintaan backend diteruskan tanpa perubahan.
- Nilai dienkode persen (RFC 3986) saat ditempatkan pada permintaan backend, sehingga nilai yang berisi spasi atau karakter yang dicadangkan akan mencapai backend Anda dalam bentuk yang dienkode. Dekode di sana jika Anda memerlukan yang asli.
- Jika operasi dan jalurnya mendeklarasikan parameter dengan nama yang sama dan nilai
inyang sama, deklarasi tingkat operasi akan berlaku, seperti yang diwajibkan oleh spesifikasi OpenAPI. - Beri nama yang berbeda pada parameter dalam operasi yang sama, meskipun parameter tersebut mendeklarasikan nilai
inyang berbeda. OpenAPI mengidentifikasi parameter berdasarkan pasangan nama dan lokasinya, tetapi alat MCP mengambil satu nilai per nama argumen. Jika spesifikasi mendeklarasikan dua parameter bernama sama dengan nilaiinyang berbeda, klien akan menyediakan satu nilai dan nilai tersebut dikirim ke kedua lokasi yang dideklarasikan pada permintaan backend:sessionIdyang dideklarasikanin: cookiedanin: querytiba di headerCookiedan di string kueri. Periksa hal ini jika backend Anda memiliki logika yang bergantung pada asal nilai. - Nama argumen peka huruf besar/kecil, sehingga
UserIDdanuseridadalah dua argumen yang berbeda. Untuk parameterheader, lakukan langkah lebih lanjut untuk membuat nama berbeda lebih dari sekadar huruf besar/kecil: Nama header HTTP tidak peka huruf besar/kecil, sehingga dua parameter header yang namanya hanya berbeda dalam huruf besar/kecil akan di-resolve ke header yang sama pada permintaan backend dan hanya satu dari dua nilai yang akan bertahan.
Cookie pada permintaan ke backend Anda
Cookie adalah satu-satunya kasus di mana binding dapat menghapus sesuatu dari
permintaan, bukan hanya menambahkannya. Tidak seperti header HTTP lainnya, yang
membawa pasangan nama/nilai independen yang masing-masing dapat ditetapkan sendiri, semua
cookie menggunakan satu header Cookie. Apigee tidak
menggabungkan cookie yang Anda ikat dengan cookie yang tiba di permintaan klien
MCP: saat panggilan menyediakan argumen cookie apa pun, header Cookie
akan diganti secara keseluruhan dengan cookie terikat saja.
Jadi, apakah cookie yang tiba dengan permintaan HTTP klien MCP itu sendiri mencapai backend Anda bergantung pada panggilan alat individual:
- Jika operasi tidak mendeklarasikan parameter
cookie, headerCookieakan diteruskan ke backend tanpa perubahan. - Jika operasi mendeklarasikan parameter
cookie, tetapi panggilan tidak menyediakan parameter tersebut, headerCookieakan diteruskan lagi ke backend tanpa perubahan. - Segera setelah panggilan memberikan setidaknya satu argumen cookie, header
Cookieakan diganti dengan cookie terikat saja. Setiap cookie yang masuk dalam permintaan klien dan tidak dideklarasikan sebagai parametercookieakan dihapus.
Karena kasus ketiga didorong oleh argumen yang diberikan oleh panggilan tertentu, operasi dengan parameter cookie opsional dapat meneruskan cookie pada satu panggilan dan menghapusnya pada panggilan berikutnya. Tidak ada setelan yang
mempertahankan cookie yang tidak dideklarasikan. Jika backend Anda bergantung pada cookie, deklarasikan
cookie tersebut sebagai parameter cookie pada setiap operasi yang memerlukannya, sehingga
nilainya selalu disediakan oleh panggilan alat, bukan diwarisi dari
permintaan klien.
Keamanan
MCP di Apigee mencakup beberapa lapisan keamanan untuk melindungi layanan Anda. Anda dapat mengontrol akses menggunakan autentikasi, otorisasi, batas jaringan, dan pemindaian konten.
Autentikasi
Endpoint MCP yang dihosting Apigee mendukung OAuth 2.1 dan OpenID Connect (OIDC) untuk autentikasi. Hal ini memastikan bahwa hanya agen, klien MCP, dan pengguna akhir dengan identitas yang ditetapkan yang dapat mengakses endpoint MCP Anda dan memanggil alat MCP. Metadata Resource yang Dilindungi memungkinkan klien menemukan server otorisasi OAuth.
Kebijakan otorisasi terperinci
Anda dapat membatasi akses ke alat MCP berdasarkan identitas klien OAuth. Misalnya, Anda dapat mengonfigurasi kebijakan di proxy MCP Discovery untuk menentukan bahwa hanya agen yang ditetapkan dengan identitas klien yang diketahui yang dapat mengakses alat MCP untuk layanan pembayaran.
Tanggung jawab klien untuk pemanggilan alat
Aplikasi klien MCP bertanggung jawab untuk menerapkan pengawasan manusia terhadap pemanggilan alat, seperti meminta konfirmasi pengguna sebelum menjalankan operasi yang mengubah status. Untuk informasi selengkapnya, lihat dokumentasi Model Context Protocol.
Kemampuan observasi dan analisis
Untuk endpoint yang dihosting Apigee, Anda dapat menggunakan Apigee Analytics untuk melihat informasi penggunaan mendetail untuk alat MCP Anda.
Analytics memungkinkan Anda menyegmentasikan traffic khusus MCP dari traffic API standar dan melihat metrik
di tingkat alat individual, seperti volume permintaan tools/list (penemuan) versus
tools/call (eksekusi). Metrik performa juga membantu Anda membedakan
antara overhead proxy dan waktu respons target, sehingga Anda
dapat menentukan bottleneck secara lebih efektif.
Keandalan dan pemecahan masalah
Untuk meningkatkan pemecahan masalah dan memberikan visibilitas yang lebih baik ke dalam proses deployment, Apigee menampilkan error infrastruktur dan konfigurasi tertentu di UI. Jika deployment gagal karena spesifikasi OpenAPI yang tidak valid atau masalah infrastruktur regional, UI akan memberikan masukan yang dapat ditindaklanjuti untuk membantu Anda menyelesaikan masalah tanpa memerlukan intervensi dukungan.
Menggunakan MCP dengan Apigee
Anda dapat mengekspos API Apigee yang ada sebagai alat MCP dan membuatnya dapat diakses melalui endpoint MCP.
Endpoint ini dapat dikonfigurasi di tingkat per host atau grup lingkungan. Misalnya, jika organisasi cymbal Anda memiliki
delapan nama host (misalnya, api.cymbal.com, partners.cymbal.com), yang masing-masing terkait dengan grup lingkungan yang berbeda,
Anda dapat menghosting server MCP khusus untuk setiap nama host.
Endpoint target terkelola (ORG_NAME.mcp.apigee.internal) di-deploy menggunakan proxy MCP Discovery khusus di organisasi Apigee Anda, tempat server MCP Anda tersedia.
Tabel berikut menunjukkan contoh cara pelanggan, termasuk organisasi fiktif Cymbal, dapat mengonfigurasi beberapa endpoint MCP menggunakan Apigee.
| Pelanggan | Nama host dan jalur dasar MCP | Endpoint target server MCP | Proxy API | Lingkungan/Grup lingkungan |
|---|---|---|---|---|
| simbal | api.cymbal.com/mcp |
cymbal.mcp.apigee.internal(project tenant organisasi cymbal) |
mcp-api-proxy1 |
prod/prod-env-group |
api-internal.cymbal.com/mcp |
cymbal.mcp.apigee.internal(project tenant organisasi cymbal) |
mcp-api-proxy2 |
internal/internal-env-group |
|
api-service.cymbal.com/mcp |
cymbal.mcp.apigee.internal(project tenant organisasi cymbal) |
mcp-api-proxy3 |
dev/dev-env-group |
Batasan
Batasan berikut berlaku untuk MCP di Apigee:
- Jumlah alat MCP di organisasi Apigee dibatasi hingga 1.000.
- Deployment infrastruktur MCP mungkin tunduk pada batasan kapasitas di region berikut:
europe-central2europe-southwest1europe-west9me-central2
Jika Anda melihat error penyediaan, atau status penyediaan tidak pernah berubah menjadi Deployed, hal ini mungkin disebabkan oleh batas kapasitas infrastruktur sementara di region yang dipilih. Coba deploy proxy ke lingkungan di region lain.
- MCP di Apigee mendukung versi OpenAPI berikut: 3.0.0, 3.0.1, 3.0.2., 3.0.3.
- Insight API di hub API Apigee tidak tersedia untuk API dan alat MCP yang di-deploy di organisasi Apigee dengan VPC-SC diaktifkan.
- Panggilan GET pada respons error MCP akan menampilkan error
405, karena server MCP saat ini tidak mendukung streaming Server-Sent Events (SSE). - Insight API hub API Apigee tidak akan menampilkan API bergaya MCP atau traffic untuk resource MCP hingga Apigee versi 1-17-0-apigee-6 diluncurkan sepenuhnya ke semua region yang tersedia.
- Anda tidak dapat mengubah atribut gaya API menjadi MCP untuk resource API yang memiliki operasi API yang sudah ada.
Batasan khusus Apigee hybrid
Batasan berikut berlaku untuk MCP di Apigee hybrid:
- Argumen alat yang dideklarasikan
in: headeratauin: cookiedikirim dalam string kueri. Pemilihan rute per lokasi yang dijelaskan dalam Penempatan argumen alat pada permintaan backend belum tersedia di Apigee hybrid. Sebelumnya, parameter yang mendeklarasikan salah satu lokasi tersebut akan mencapai backend Anda sebagai parameter kueri, yang merupakan perilaku sebelum fitur tersebut. Barisin: querydanin: pathdari tabel tersebut berlaku untuk Apigee hybrid seperti yang tertulis. - Jumlah alat MCP dibatasi oleh ukuran, bukan oleh angka tetap. Tidak seperti
Apigee (yang menerapkan jumlah maksimum alat MCP tetap per
organisasi), Apigee hybrid membatasi kapasitas alat melalui empat batas
ukuran: ukuran file spesifikasi OpenAPI, ukuran paket proxy MCP,
ukuran respons
tools/listper nama host, dan jumlah nama host per grup lingkungan. Untuk sebagian besar spesifikasi OpenAPI, Anda biasanya dapat memuat 10.000 alat MCP per organisasi pada batas ukuran respons default. Kapasitas sebenarnya bervariasi sesuai dengan bentuk spesifik spesifikasi Anda (didominasi oleh jumlah parameter dan properti isi permintaan, ditambah panjang deskripsi); skema respons tidak mengurangi anggaran. Untuk memperkirakan kapasitas spesifikasi OpenAPI tertentu dan melihat empat batas pasti serta mode kegagalannya, lihat Memperkirakan kapasitas alat MCP. - Mengaktifkan atau menonaktifkan MCP akan memicu rilis terbatas bertahap dari pod Message Processor. Operator Apigee memperbarui spesifikasi pod Message Processor saat Anda mengaktifkan atau menonaktifkan MCP, dan pengontrol
ApigeeDeploymentMessage Processor menjalankan perubahan melalui rilis terbatas bertahap, bukan sebagai mulai ulang berkelanjutan Kubernetes standar. Rilis hanya diaktifkan pada transisi pengaktifan dan penonaktifan, bukan pada aktivitas deployment MCP yang sedang berlangsung atau traffic MCP status stabil. Jadwalkan pengaktifan awal dan operasi penonaktifan berikutnya selama masa pemeliharaan yang disetujui. - Penentuan ukuran resource pod MCP dikelola oleh pelanggan. Pod MCP berjalan dengan
permintaan dan batas resource yang ditetapkan oleh setelan default bawaan di chart Helm
Apigee hybrid. Jika workload Anda memerlukan lebih banyak kapasitas, sesuaikan CPU dan memori di
overrides.yaml. Lihat referensi kolomoverrides.yamluntuk mengetahui kolom yang tersedia. - Satu bidang data MCP per organisasi Apigee, per cluster. Dalam versi
1.17.0, operator Apigee menyediakan satu bidang data MCP untuk setiap organisasi Apigee yang diinstal di cluster. Cluster yang menghosting beberapa organisasi Apigee menjalankan satu bidang data MCP per organisasi; bidang data bersifat independen dan tidak berbagi konfigurasi. - Pengaktifan yang seragam di seluruh grup lingkungan diperlukan. Aktifkan MCP
secara seragam di semua cluster yang melayani grup lingkungan Apigee yang sama. Jika MCP diaktifkan di beberapa cluster dan tidak diaktifkan di cluster lain dalam grup, permintaan MCP yang dirutekan ke cluster tanpa MCP yang diaktifkan akan menerima respons
503 Service Unavailable. - Protokol MCP stateless memerlukan versi
1.17.4atau yang lebih baru. Apigee hybrid versi1.17.0hingga1.17.3hanya mendukung versi protokol MCP stateful2025-11-25,2025-06-18,2025-03-26, dan2024-11-05. Mulai versi1.17.4, Apigee hybrid juga mendukung protokol MCP stateless, versi2026-07-28. Lihat Versi protokol MCP yang didukung. - TLS satu arah antara Message Processor dan bidang data MCP. Versi
1.17.0menggunakan TLS satu arah antara Message Processor dan bidang data MCP. - TLS satu arah antara bidang data MCP dan gateway masuk secara default. Bidang data MCP meneruskan panggilan alat ke gateway masuk Apigee Anda melalui TLS, tetapi secara default tidak menampilkan sertifikat klien dan tidak memverifikasi sertifikat gateway masuk.
Mulai versi
1.17.4, Anda dapat mengaktifkan mutual TLS pada koneksi ini per grup lingkungan. Mutual TLS diperlukan untuk setiap grup lingkungantlsMode: MUTUALyang menyajikan panggilan alat MCP. Lihat Mengonfigurasi mTLS antara bidang data MCP dan gateway masuk. - Bidang data MCP mengandalkan Message Processor untuk identitas pemanggil. Data plane MCP
dalam cluster tidak mengautentikasi pemanggilnya secara independen di
1.17.0; data plane ini memercayai bahwa permintaan yang mencapainya telah diautentikasi oleh proxy Apigee yang berjalan di Message Processor. Setiap permintaan MCP yang harus diautentikasi harus masuk melalui proxy MCP Apigee yang menerapkan kebijakan autentikasi (lihat Mengelola akses alat MCP). Pelanggan produksi harus menerapkan kontrol ingress cluster sehingga hanya pod Message Processor (label Kubernetesapp=apigee-runtimedi namespace Kubernetes yang sama tempat Apigee hybrid diinstal) yang dapat menjangkau Layanan MCP di TCP443. Gunakan Policy Engine apa pun yang didukung platform Anda (Kubernetes NetworkPolicy, Cilium, Calico, Istio AuthorizationPolicy) untuk menerapkan batasan ini.
Langkah berikutnya
- Pelajari cara Mulai menggunakan Apigee dan MCP.
- Untuk Apigee hybrid, aktifkan MCP di cluster Anda terlebih dahulu, lalu ikuti panduan memulai.
- Untuk mengakses produk Google dan Google Cloud lainnya melalui alat MCP, lihat Ringkasan server MCP Google Cloud