Agent Registry memungkinkan Anda menemukan dan mengelola server Model Context Protocol (MCP) dan alat tertentu yang dieksposnya.
Server MCP resmi Google dan Google Cloud jarak jauh otomatis didaftarkan dan dimasukkan ke dalam Pendaftaran Agen saat Anda mengaktifkan Google Cloud API yang didukung di project Anda. Anda juga dapat mendaftarkan server MCP eksternal lainnya secara manual. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan server MCP.
Dokumen ini menjelaskan cara menemukan server dan alat MCP yang terdaftar serta cara mengubah definisi alat Anda.
Sebelum memulai
Sebelum dapat mengelola server dan alat MCP, daftarkan server MCP di Agent Registry. Anda juga memerlukan ID project untuk melakukan tugas ini.
Untuk menggunakan perintah gcloud CLI dalam dokumen ini, pastikan Anda telah menyiapkan lingkungan Google Cloud CLI.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk mengelola server dan alat MCP di Agent Registry, minta administrator untuk memberi Anda peran IAM berikut pada project:
-
Temukan server dan alat MCP yang tersedia:
Agent Registry API Viewer (
roles/agentregistry.viewer) -
Perbarui definisi alat:
Agent Registry API Editor (
roles/agentregistry.editor)
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Menemukan server dan alat MCP yang tersedia
Setelah mendaftarkan server MCP, Anda dapat menemukannya untuk mengikatnya ke agen.
Mencantumkan semua server MCP yang tersedia
Anda dapat mencantumkan semua server MCP yang terdaftar di lingkungan Anda dan melihat konfigurasi detailnya, seperti endpoint dan metadata terkait:
Konsol
Di konsol Google Cloud , buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab Server MCP.
Halaman ini menampilkan daftar semua server MCP terdaftar dan detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.
Untuk melihat detail lengkap server, klik nama server.
gcloud
Untuk mencantumkan semua server MCP di lokasi tertentu, gunakan perintah mcp-servers list:
gcloud alpha agent-registry mcp-servers list \
--project=PROJECT_ID \
--location=REGION
Ganti kode berikut:
PROJECT_ID: Project ID.REGION: Region registri.
Memfilter server MCP terdaftar
Jika memiliki beberapa server, atau jika ingin mengonfirmasi pendaftaran server tertentu, Anda dapat memfilter daftar menurut metadata server:
Konsol
Di konsol Google Cloud , buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab Server MCP.
Halaman ini menampilkan daftar semua server MCP terdaftar dan detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.
Untuk memfilter menurut lokasi, klik menu Lokasi, pilih lokasi yang ingin Anda filter, lalu klik Terapkan.
Halaman ini menampilkan daftar server MCP terdaftar yang difilter untuk kondisi yang Anda pilih.
gcloud
Filter daftar Anda untuk hanya menampilkan resource yang cocok dengan metadata tertentu, menggunakan
flag --filter:
gcloud alpha agent-registry mcp-servers list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
Ganti FILTER_EXPRESSION dengan ekspresi filter
untuk server MCP yang ingin Anda filter. Misalnya, Anda dapat menggunakan filter berikut:
- Untuk memfilter menurut nama tampilan, gunakan
displayName='DISPLAY_NAME'. - Untuk menelusuri berdasarkan
ID unik global (URN), gunakan
mcpServerId='urn:mcp:SERVER_URN'.
Melihat detail dari server MCP
Melihat detail dari server MCP tertentu, misalnya, alatnya:
Konsol
Di konsol Google Cloud , buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab Server MCP.
Halaman ini menampilkan daftar semua server MCP terdaftar dan detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.
Klik nama server MCP yang ingin Anda lihat.
Halaman detail mencakup tab untuk detail server MCP.
Klik tab yang sesuai untuk melihat detail server MCP tertentu:
- Ringkasan: Detail inti dari server MCP, termasuk nama, ID, lokasi, dan deskripsi server. Ringkasan ini juga menampilkan cuplikan kode untuk memungkinkan Anda membuat agen menggunakan Agent Development Kit (ADK).
- Observability: Insight tentang kondisi operasional dan penggunaan server MCP. Tab ini menampilkan metrik yang berfokus pada aplikasi seperti latensi, traffic, error, dan pembelanjaan token. Tab ini terintegrasi dengan Google Cloud Observability untuk menampilkan metrik performa real-time dan penggunaan tingkat sistem guna membantu Anda mengelola biaya, men-debug masalah, dan melacak pengalaman pengguna. Untuk mengetahui informasi selengkapnya, lihat Ringkasan Observability.
- Alat: Katalog kemampuan yang disediakan oleh server. Tab ini mencantumkan fungsi spesifik yang diekspos oleh server MCP yang dapat dipanggil agen untuk melakukan tindakan tertentu. Untuk setiap alat, antarmuka menampilkan skemanya, termasuk nama, deskripsi, dan anotasi perilaku penting yang memandu cara agen orkestrasi harus berinteraksi dengannya. Klik nama alat untuk menampilkan cuplikan kode yang memungkinkan Anda membuat agen menggunakan ADK.
gcloud
Untuk melihat metadata mendetail server MCP tertentu, gunakan
perintah mcp-servers describe:
gcloud alpha agent-registry mcp-servers describe SERVER_NAME \
--project=PROJECT_ID \
--location=REGION
Ganti SERVER_NAME dengan nama server MCP
Anda, misalnya, custom-mcp-server.
Memperbarui detail server dan definisi alat
Jika server MCP Anda menambahkan alat baru atau mengubah skema yang ada, Anda harus memperbarui registry untuk mencerminkan perubahan ini. Karena registry tidak secara otomatis menginspeksi server MCP, Anda harus mengupload spesifikasi alat yang diperbarui secara manual. Konten yang Anda upload akan menggantikan definisi alat yang ada untuk server ini.
Untuk Agent Registry API, resource McpServer digunakan untuk penemuan. Oleh karena itu,
Anda harus memperbarui resource Service yang terdaftar secara langsung.
Konsol
Perbarui detail server yang tersedia dari konsol Google Cloud :
Di konsol Google Cloud , buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab Server MCP.
Halaman ini menampilkan daftar semua server MCP terdaftar dan detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.
Klik nama server yang ingin Anda perbarui.
Di tab Overview server, klik Edit.
Di panel Edit layanan, masukkan informasi server yang telah diperbarui, seperti nama atau deskripsi barunya.
Klik Simpan.
gcloud
Siapkan spesifikasi alat baru Anda. Kemudian, perbarui file JSON Anda dengan definisi alat terbaru:
gcloud alpha agent-registry services update SERVER_NAME \
--project=PROJECT_ID \
--location=REGION \
--mcp-server-spec-content=TOOL_SPEC
Ganti kode berikut:
SERVER_NAME: Nama server MCP Anda, misalnya,custom-mcp-server.PROJECT_ID: Project ID.REGION: Region registri.TOOL_SPEC: Nama spesifikasi alat baru, misalnya,new-toolspec.json. Ukuran file maksimum untuk file spesifikasi adalah 10 KB.
Menghapus server MCP
Untuk menghapus server MCP yang otomatis terdaftar ke Registry Agen, Anda harus menghapus server MCP pokok atau menonaktifkan Google Cloud API server MCP di project Anda. Server tersebut kemudian akan otomatis dihapus dari registry.
Untuk menghapus server MCP yang terdaftar secara manual dari registry, Anda harus menghapus
resource Service yang mendasarinya. Tindakan ini akan menghapus server MCP dari hasil penelusuran dan membuatnya tidak dapat ditemukan oleh alat lain:
Konsol
Di konsol Google Cloud , buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab Server MCP.
Halaman ini menampilkan daftar semua server MCP terdaftar dan detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.
Klik nama server yang ingin Anda hapus.
Di tab Ringkasan server, klik Hapus.
Pada dialog konfirmasi, ketik HAPUS untuk mengonfirmasi tindakan.
Klik Hapus.
gcloud
gcloud alpha agent-registry services delete SERVER_NAME \
--project=PROJECT_ID \
--location=REGION
Ganti kode berikut:
SERVER_NAME: Nama server MCP yang ingin Anda hapus, misalnya,my-mcp-server.PROJECT_ID: Project ID.REGION: Region registri.
Mengatur akses alat
Terapkan tata kelola dan keamanan tingkat perusahaan untuk server dan alat MCP Anda. Gunakan Agent Registry sebagai katalog terpusat dan Agent Gateway untuk penegakan kebijakan aktif.
Agent Gateway memungkinkan Anda mengatur interaksi antara agen dan alat dengan aman, terlepas dari apakah agen tersebut berjalan di Google Cloud atau merupakan alat developer eksternal.
Untuk mengetahui informasi selengkapnya tentang cara mengatur akses alat, lihat artikel berikut:
- Ringkasan kebijakan IAM: Tentukan siapa yang dapat mengakses alat tertentu dan dalam kondisi apa.
- Ringkasan Agent Gateway: Pahami cara gateway menerapkan keamanan dan kemampuan observasi di semua interaksi agen-ke-alat (MCP).
- Melihat temuan keamanan: Pantau dan tinjau insight keamanan untuk ekosistem agentik Anda menggunakan Gemini Enterprise Agent Platform.