Ringkasan Model Context Protocol (MCP) di Apigee

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.

MCP dalam arsitektur hybrid Apigee: Klien MCP memanggil ingress Apigee yang ada melalui HTTPS, yang merutekan ke Message Processor, lalu ke bidang data MCP dalam cluster yang baru. Konfigurasi alat MCP dibuat oleh
  bidang kontrol Apigee dan ditarik oleh cluster Anda; bidang kontrol Apigee
  tidak pernah memanggil cluster 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
  • server/discover
  • tools/list
  • tools/call
Stateful
  • 2025-11-25
  • 2025-06-18
  • 2025-03-26
  • 2024-11-05
  • initialize
  • notifications/initialized
  • tools/list
  • tools/call

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-Version dari 2026-07-28, tetapi tanpa io.modelcontextprotocol/protocolVersion di params._meta adalah permintaan stateful. Versi 2026-07-28 bukan versi stateful, sehingga Apigee menolaknya dengan HTTP 400 dan error JSON-RPC protokol stateful -32602 (Unsupported protocol version), bukan error stateless -32022. Untuk menggunakan versi 2026-07-28, permintaan harus menggunakan format permintaan stateless.
  • Jika permintaan initialize meminta versi 2026-07-28, atau untuk versi apa pun yang tidak didukung Apigee, Apigee akan menegosiasikan versi 2025-11-25.
  • Metode server/discover hanya tersedia dalam protokol stateless. Permintaan server/discover stateful mengikuti penanganan error protokol stateful: permintaan ini mendapatkan HTTP 200 dengan error JSON-RPC -32601 (Method server/discover is not supported) dalam isi respons. Status 404 HTTP 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._meta dengan versi protokol dan kemampuan klien.
  • Setiap permintaan membawa header MCP-Protocol-Version dan Mcp-Method, dan permintaan tools/call juga membawa header Mcp-Name.
  • Permintaan yang tidak valid akan mendapatkan HTTP 400 atau 404 dengan 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 dengan name dan version klien 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 in yang 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 in yang 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 nilai in yang berbeda, klien akan menyediakan satu nilai dan nilai tersebut dikirim ke kedua lokasi yang dideklarasikan pada permintaan backend: sessionId yang dideklarasikan in: cookie dan in: query tiba di header Cookie dan di string kueri. Periksa hal ini jika backend Anda memiliki logika yang bergantung pada asal nilai.
  • Nama argumen peka huruf besar/kecil, sehingga UserID dan userid adalah dua argumen yang berbeda. Untuk parameter header, 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 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, header Cookie akan diteruskan ke backend tanpa perubahan.
  • Jika operasi mendeklarasikan parameter cookie, tetapi panggilan tidak menyediakan parameter tersebut, header Cookie akan diteruskan lagi ke backend tanpa perubahan.
  • Segera setelah panggilan memberikan setidaknya satu argumen cookie, header Cookie akan diganti dengan cookie terikat saja. Setiap cookie yang masuk dalam permintaan klien dan tidak dideklarasikan sebagai parameter cookie akan 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-central2
    • europe-southwest1
    • europe-west9
    • me-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: header atau in: cookie dikirim 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. Baris in: query dan in: path dari 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/list per 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 ApigeeDeployment Message 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 kolom overrides.yaml untuk 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.4 atau yang lebih baru. Apigee hybrid versi 1.17.0 hingga 1.17.3 hanya mendukung versi protokol MCP stateful 2025-11-25, 2025-06-18, 2025-03-26, dan 2024-11-05. Mulai versi 1.17.4, Apigee hybrid juga mendukung protokol MCP stateless, versi 2026-07-28. Lihat Versi protokol MCP yang didukung.
  • TLS satu arah antara Message Processor dan bidang data MCP. Versi 1.17.0 menggunakan 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 lingkungan tlsMode: MUTUAL yang 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 Kubernetes app=apigee-runtime di namespace Kubernetes yang sama tempat Apigee hybrid diinstal) yang dapat menjangkau Layanan MCP di TCP 443. Gunakan Policy Engine apa pun yang didukung platform Anda (Kubernetes NetworkPolicy, Cilium, Calico, Istio AuthorizationPolicy) untuk menerapkan batasan ini.

Langkah berikutnya