Mengelola server dan alat MCP

Agent Registry memungkinkan Anda memeriksa, memperbarui, dan menghapus server dan alat Model Context Protocol (MCP) yang terdaftar sehingga agen Anda memiliki skema dan endpoint alat yang akurat saat runtime. Anda dapat menemukan server MCP yang terdaftar secara otomatis dan manual, mengupdate definisi alat yang terdaftar secara manual, dan menghapus server MCP yang tidak lagi digunakan.

Sebelum memulai

  1. Menyiapkan Agent Registry.

  2. Untuk penyiapan project tunggal, dapatkan project ID dari project tata kelola tempat Agent Registry diaktifkan. Jika Anda mengonfigurasi batas pengelolaan untuk beberapa project, gunakan ID project pengelolaan Anda untuk penemuan dan pendaftaran di seluruh batas, atau tentukan ID project anggota untuk operasi project tunggal.

  3. Daftarkan server MCP di Agent Registry.

  4. Untuk menggunakan perintah Google Cloud CLI dalam dokumen ini, siapkan lingkungan gcloud CLI Anda.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola server MCP dan alat di Agent Registry, minta administrator untuk memberi Anda peran IAM berikut pada project tata kelola tempat Agent Registry diaktifkan:

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 menampilkan daftar semua server MCP yang terdaftar di lingkungan Anda dan melihat konfigurasi mendetailnya, seperti endpoint dan metadata terkaitnya.

Jika Anda mengonfigurasi batas pengelolaan, Anda dapat mencantumkan server MCP di beberapa project dari project pengelolaan Anda.

Untuk mencantumkan semua server MCP di lingkungan Anda, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud , buka Agent Registry:

    Buka Agent Registry

  2. Dari pemilih project, pilih project Google Cloud tempat Anda menyiapkan Agent Registry.

  3. Pilih tab Server MCP.

    Halaman ini menampilkan daftar semua server MCP yang terdaftar beserta detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.

  4. Untuk melihat detail lengkap server, klik nama server.

gcloud

Untuk mencantumkan semua server MCP di lokasi tertentu, jalankan perintah gcloud agent-registry mcp-servers list:

gcloud agent-registry mcp-servers list \
    --project=PROJECT_ID \
    --location=REGION

Ganti kode berikut:

  • PROJECT_ID: project ID. Jika Anda mengonfigurasi batas pengelolaan, tentukan ID project pengelolaan untuk mencantumkan server MCP di lokasi yang ditentukan di semua project anggota dalam batas tersebut. Setiap nama resource yang ditampilkan mempertahankan ID server MCP dan menggunakan project yang ditentukan dalam permintaan.
  • REGION: lokasi registry, seperti us-central1, eu, atau global. Di project pengelolaan, menentukan lokasi akan menggabungkan server MCP di lokasi yang sama di semua project anggota dalam batasan.

Memfilter server MCP terdaftar

Jika memiliki beberapa server, atau jika ingin mengonfirmasi pendaftaran server tertentu, Anda dapat memfilter daftar berdasarkan metadata server:

Konsol

  1. Di konsol Google Cloud , buka Agent Registry:

    Buka Agent Registry

  2. Dari pemilih project, pilih project Google Cloud tempat Anda menyiapkan Agent Registry.

  3. Pilih tab Server MCP.

    Halaman ini menampilkan daftar semua server MCP yang terdaftar beserta detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.

  4. 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 agar hanya menampilkan resource yang cocok dengan metadata tertentu dengan meneruskan flag --filter ke perintah gcloud agent-registry mcp-servers list:

gcloud agent-registry mcp-servers list \
    --project=PROJECT_ID \
    --location=REGION \
    --filter="FILTER_EXPRESSION"

Ganti kode berikut:

  • PROJECT_ID: project ID.
  • REGION: region registry.
  • FILTER_EXPRESSION: 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 server MCP unik global (URN), gunakan mcpServerId='urn:mcp:SERVER_URN'.
    • Untuk memfilter berdasarkan project anggota tertentu saat mengkueri project pengelolaan, gunakan project_id=MEMBER_PROJECT_ID.

Terraform

Untuk mengambil server MCP terdaftar tertentu dengan memfilter metadatanya, konfigurasikan 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 memfilter, misalnya, Custom MCP Server.

Melihat detail dari server MCP

Melihat detail dari server MCP tertentu, misalnya, alatnya:

Konsol

  1. Di konsol Google Cloud , buka Agent Registry:

    Buka Agent Registry

  2. Dari pemilih project, pilih project Google Cloud tempat Anda menyiapkan Agent Registry.

  3. Pilih tab Server MCP.

    Halaman ini menampilkan daftar semua server MCP yang terdaftar beserta detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.

  4. Klik nama server MCP yang ingin Anda lihat.

    Halaman detail menyertakan tab untuk detail server MCP.

  5. 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 membangun agen menggunakan Agent Development Kit (ADK).
    • Kemampuan observasi: insight tentang kondisi operasional dan penggunaan server MCP. Dasbor ini menampilkan metrik yang berfokus pada aplikasi seperti latensi, traffic, error, dan pengeluaran token. Tab ini terintegrasi dengan Google Cloud Observability untuk menampilkan metrik performa real-time dan pemanfaatan tingkat sistem untuk membantu Anda mengelola biaya, men-debug masalah, dan melacak pengalaman pengguna. Untuk mengetahui informasi selengkapnya, lihat Ringkasan kemampuan observasi.
    • Alat: kemampuan yang disediakan oleh server. Tab ini mencantumkan fungsi tertentu 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 pengorkestrasi harus berinteraksi dengannya. Klik nama alat untuk menampilkan cuplikan kode yang memungkinkan Anda membangun agen menggunakan ADK.

gcloud

Untuk melihat metadata mendetail dari server MCP tertentu, jalankan perintah gcloud agent-registry mcp-servers describe:

gcloud agent-registry mcp-servers describe SERVER_NAME \
    --project=PROJECT_ID \
    --location=REGION

Ganti kode berikut:

  • SERVER_NAME: nama server MCP Anda, misalnya, custom-mcp-server.
  • PROJECT_ID: project ID. Dalam batas pengelolaan, Anda dapat menentukan project ID pengelolaan atau project ID project anggota tempat server di-deploy. Nama resource yang ditampilkan mempertahankan ID server MCP dan menggunakan project yang ditentukan dalam permintaan Anda.
  • REGION: region registry.

Terraform

Untuk mengambil detail tentang server MCP terdaftar tertentu menggunakan ID-nya, konfigurasikan 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.

Di Registry Agen, resource McpServer adalah resource penemuan hanya baca. Untuk server MCP yang terdaftar secara otomatis, update deployment atau workload di runtime dasarnya agar Agent Registry menyinkronkan perubahan. Untuk memperbarui server MCP yang terdaftar secara manual, Anda harus memperbarui resource Service yang dapat ditulis secara langsung dengan menentukan project ID tempat resource Service tersebut didaftarkan. Karena registry tidak otomatis memeriksa server MCP yang didaftarkan secara manual, Anda harus melakukan upload manual spesifikasi alat yang diperbarui, yang akan menggantikan definisi alat yang ada untuk server tersebut.

Konsol

Perbarui detail server yang tersedia dari konsol Google Cloud :

  1. Di konsol Google Cloud , buka Agent Registry:

    Buka Agent Registry

  2. Dari pemilih project, pilih project Google Cloud tempat Anda menyiapkan Agent Registry.

  3. Pilih tab Server MCP.

    Halaman ini menampilkan daftar semua server MCP yang terdaftar beserta detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.

  4. Klik nama server yang ingin Anda perbarui.

  5. Di tab Overview server, klik Edit.

  6. Di panel Edit service, masukkan informasi terbaru server Anda, seperti nama atau deskripsi barunya.

  7. Klik Simpan.

gcloud

Siapkan spesifikasi alat baru Anda. Kemudian, jalankan perintah gcloud agent-registry services update dengan file JSON yang telah diupdate:

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: jalur ke file spesifikasi alat baru, misalnya, new-toolspec.json. Ukuran file maksimum untuk file spesifikasi adalah 10 KB.

Terraform

Untuk memperbarui metadata, URL endpoint, atau spesifikasi alat server MCP yang terdaftar, ubah parameter resource google_agent_registry_service yang ada dalam konfigurasi Anda, lalu jalankan terraform apply:

resource "google_agent_registry_service" "mcp_server" {
  location     = "REGION"
  service_id   = "SERVER_NAME"
  display_name = "DISPLAY_NAME"
  description  = "Updated description of the MCP server."

  interfaces {
    url              = "SERVER_URL"
    protocol_binding = "JSONRPC"
  }

  mcp_server_spec {
    type    = "TOOL_SPEC"
    content = file("TOOL_SPEC")
  }
}

Ganti kode berikut:

  • REGION: region registry.
  • SERVER_NAME: nama server MCP Anda, misalnya, custom-mcp-server.
  • DISPLAY_NAME: nama tampilan yang dapat dibaca manusia untuk server MCP Anda, misalnya, Custom MCP Server.
  • SERVER_URL: URL endpoint server MCP, misalnya, https://api.example.com/mcp.
  • TOOL_SPEC: jalur ke file spesifikasi alat yang telah diupdate, 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 yang mendasarinya atau menonaktifkan API Google Cloud server MCP di project Anda. Server kemudian akan otomatis dihapus dari registry.

Untuk menghapus server MCP yang didaftarkan secara manual dari registry, Anda harus menghapus resource Service-nya dengan menentukan project ID tempat resource Service tersebut didaftarkan. Tindakan ini akan menghapus server MCP dari hasil penelusuran dan membuatnya tidak dapat ditemukan oleh alat lain:

Konsol

  1. Di konsol Google Cloud , buka Agent Registry:

    Buka Agent Registry

  2. Dari pemilih project, pilih project Google Cloud tempat Anda menyiapkan Agent Registry.

  3. Pilih tab Server MCP.

    Halaman ini menampilkan daftar semua server MCP yang terdaftar beserta detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.

  4. Klik nama server yang ingin Anda hapus.

  5. Di tab Overview server, klik Delete.

  6. Dalam dialog konfirmasi, masukkan DELETE untuk mengonfirmasi tindakan.

  7. Klik Hapus.

gcloud

Jalankan perintah gcloud agent-registry services delete:

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 registry pusat 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 referensi berikut: