Agent Registry memungkinkan Anda menemukan dan mengelola server Model Context Protocol (MCP) dan alat tertentu yang diekspos.
Server MCP Google dan pihak ketiga otomatis terdaftar dan dimasukkan ke Agent Registry saat Anda mengaktifkan API yang didukung di project Anda. Google Cloud Google CloudAnda 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 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 project ID Anda 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:
-
Menemukan server dan alat MCP yang tersedia:
Penampil Agent Registry API (
roles/agentregistry.viewer) -
Memperbarui definisi alat:
Editor Agent Registry API (
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 Anda.
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 Google Cloud konsol, buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab MCP servers.
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 agent-registry mcp-servers list \
--project=PROJECT_ID \
--location=REGION
Ganti kode berikut:
PROJECT_ID: Project ID.REGION: Region registry.
Memfilter server MCP terdaftar
Jika Anda memiliki beberapa server, atau jika ingin mengonfirmasi pendaftaran server tertentu, Anda dapat memfilter daftar berdasarkan metadata server:
Konsol
Di Google Cloud konsol, buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab MCP servers.
Halaman ini menampilkan daftar semua server MCP terdaftar dan detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.
Untuk memfilter menurut lokasi, klik menu Location, pilih lokasi yang ingin Anda filter, lalu klik Apply.
Halaman ini menampilkan daftar server MCP terdaftar yang difilter untuk kondisi yang Anda pilih.
gcloud
Filter daftar Anda agar hanya menampilkan resource yang cocok dengan metadata tertentu, menggunakan flag --filter:
gcloud 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
identifier (URN), gunakan
mcpServerId='urn:mcp:SERVER_URN'.
Terraform
Untuk mengambil server MCP terdaftar tertentu dengan memfilter metadata-nya, konfigurasi sumber data google_agent_registry_mcp_server dengan argumen filter:
data "google_agent_registry_mcp_server" "filtered_mcp_server" {
location = "REGION"
filter = "displayName=\"DISPLAY_NAME\""
}
Ganti kode berikut:
REGION: Region registry.DISPLAY_NAME: Nama server MCP yang dapat dibaca manusia untuk difilter, misalnya,Custom MCP Server.
Melihat detail dari server MCP
Lihat detail dari server MCP tertentu, misalnya, alatnya:
Konsol
Di Google Cloud konsol, buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab MCP servers.
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:
- Ikhtisar: 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 performa operasional dan penggunaan server MCP. Fitur ini menampilkan metrik yang berpusat pada aplikasi seperti latensi, traffic, error, dan pengeluaran 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.
- Tools: Katalog kemampuan yang disediakan oleh server. Tab ini mencantumkan fungsi tertentu yang diekspos oleh server MCP yang dapat dipanggil oleh agen untuk melakukan tindakan tertentu. Untuk setiap alat, antarmuka menampilkan skemanya, termasuk nama, deskripsi, dan anotasi perilaku penting yang memandu cara agen orkestrasi berinteraksi dengannya. Klik nama alat untuk menampilkan cuplikan kode yang memungkinkan Anda membuat agen menggunakan ADK.
gcloud
Untuk melihat metadata mendetail dari server MCP tertentu, gunakan perintah mcp-servers describe:
gcloud agent-registry mcp-servers describe SERVER_NAME \
--project=PROJECT_ID \
--location=REGION
Ganti SERVER_NAME dengan nama server MCP Anda, misalnya, custom-mcp-server.
Terraform
Untuk mengambil detail tentang server MCP terdaftar tertentu menggunakan ID-nya, konfigurasi sumber data google_agent_registry_mcp_server:
data "google_agent_registry_mcp_server" "my_mcp_server" {
location = "REGION"
mcp_server_id = "SERVER_NAME"
}
output "server_create_time" {
description = "The timestamp when the MCP server was registered."
value = data.google_agent_registry_mcp_server.my_mcp_server.create_time
}
output "server_update_time" {
description = "The timestamp when the MCP server was last updated."
value = data.google_agent_registry_mcp_server.my_mcp_server.update_time
}
Ganti kode berikut:
REGION: Region registry.SERVER_NAME: ID unik 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 otomatis melakukan introspeksi 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 terdaftar secara langsung.
Konsol
Perbarui detail server yang tersedia dari Google Cloud konsol:
Di Google Cloud konsol, buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab MCP servers.
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 service, masukkan informasi server Anda yang diperbarui, seperti nama atau deskripsi barunya.
Klik Save.
gcloud
Siapkan spesifikasi alat baru Anda. Kemudian, perbarui file JSON Anda dengan definisi alat terbaru:
gcloud 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 registry.TOOL_SPEC: Nama spesifikasi alat baru, misalnya,new-toolspec.json. Ukuran file maksimum untuk file spesifikasi adalah 10 KB.
Terraform
Terraform hanya mendukung jenis NO_SPEC untuk server MCP. Anda tidak dapat mengonfigurasi spesifikasi alat secara inline. Untuk memperbarui definisi alat server
MCP Anda, gunakan Google Cloud konsol, gcloud CLI, atau
Agent Registry API.
Menghapus server MCP
Untuk menghapus server MCP yang otomatis terdaftar ke Agent Registry, Anda harus menghapus server MCP yang mendasarinya 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 Google Cloud konsol, buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab MCP servers.
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 Overview server, klik Delete.
Di dialog konfirmasi, ketik DELETE untuk mengonfirmasi tindakan.
Klik Delete.
gcloud
gcloud 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 registry.
Terraform
Hapus resource google_agent_registry_service yang mewakili server MCP dari konfigurasi Terraform Anda, lalu jalankan terraform apply.
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 penerapan 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 pengaturan akses alat, lihat hal berikut:
- Ringkasan kebijakan IAM: Menentukan siapa yang dapat mengakses alat tertentu dan dalam kondisi apa.
- Ringkasan Agent Gateway: Memahami cara gateway menerapkan keamanan dan observabilitas di semua interaksi agen-ke-alat (MCP).
- Melihat temuan keamanan: Memantau dan meninjau insight keamanan untuk ekosistem agen Anda menggunakan Gemini Enterprise Agent Platform.