Mendaftarkan server MCP

Agent Registry bertindak sebagai katalog terpusat dengan mendaftarkan dan mengelola endpoint server Model Context Protocol (MCP) dan alat tertentu yang dieksposnya.

Dokumen ini menjelaskan cara mendaftarkan server MCP dan cara spesifikasi alatnya dikelola dalam Agent Registry.

Penemuan otomatis Google Cloud server MCP

Server MCP jarak jauh Google dan Google Cloud resmi otomatis didaftarkan dan dimasukkan ke dalam Registry Agen. Server MCP jarak jauh dan Google yang tersedia tercantum di Produk yang didukung dari dokumentasi server MCPGoogle Cloud . Google Cloud

Saat Anda mengaktifkan API yang didukung Google Cloud di project Anda, seperti Compute Engine API, server MCP yang sesuai dan alatnya akan langsung didaftarkan dan tersedia untuk penemuan di Agent Registry. Anda tidak perlu mengonfigurasi atau mengupload spesifikasi alat secara manual untuk server ini.

Mendaftarkan server MCP eksternal

Untuk mengelola dan menggunakan kembali alat yang disediakan oleh server eksternal atau API kustom, Anda harus mendaftarkan server MCP secara eksplisit.

Saat mendaftarkan server MCP secara manual, Agent Registry akan mendaftarkan endpoint. Namun, alat ini tidak otomatis mengintrospeksi server untuk menentukan alat mana yang tersedia. Untuk memungkinkan pengguna menemukan alat yang tepat yang tersedia di server MCP Anda, Anda harus memberikan spesifikasi alat selama pendaftaran dengan mengupload file toolspec.json.

Sebelum memulai

Sebelum memulai, siapkan Agent Registry. Anda memerlukan project ID 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 diperlukan guna mendaftarkan server MCP secara manual di Agent Registry, minta administrator untuk memberi Anda peran IAM Agent Registry API Editor (roles/agentregistry.editor) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Siapkan spesifikasi alat Anda

Buat file toolspec.json yang menguraikan alat yang disediakan server. File JSON ini harus sesuai dengan spesifikasi MCP untuk skema alat, misalnya:

{
  "tools": [
    {
      "name": "get_customer_info",
      "description": "Retrieves customer details from the database.",
      "annotations": {
        "title": "Get Customer Info",
        "readOnlyHint": true,
        "idempotentHint": true
      }
    },
    {
      "name": "create_support_ticket",
      "description": "Creates a new support ticket in the issue tracking system.",
      "annotations": {
        "title": "Create Support Ticket",
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true
      }
    }
  ]
}

Untuk persyaratan struktural mendetail, lihat skema JSON dan referensi REST.

Mendaftarkan server dan alat

Mendaftarkan server MCP dan mengupload definisi alat secara bersamaan:

Konsol

  1. Di konsol Google Cloud , buka Agent Registry:

    Buka Agent Registry

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

  3. Pilih tab Server MCP.

  4. Klik Tambahkan server MCP.

  5. Di panel MCP server details, masukkan nama tampilan, deskripsi, dan wilayah geografis.

  6. Di bagian Spesifikasi alat, masukkan URL endpoint server MCP dan tempelkan konten file toolspec.json Anda.

    Atau, klik Impor alat di panel ini untuk mengimpor alat MCP dari URL. Opsi ini hanya berfungsi jika URL endpoint server MCP Anda dihosting secara publik melalui internet. Anda tidak dapat menggunakan fitur ini untuk mengimpor alat dari server MCP yang dihosting secara pribadi.

  7. Klik Berikutnya.

    Panel Select MCP tools menampilkan daftar alat dengan nama dan deskripsi dari server MCP Anda.

  8. Pilih semua alat MCP yang ingin Anda sertakan. Anda dapat memfilter alat dari daftar menurut nama atau nilai.

  9. Klik Simpan.

gcloud

Daftarkan server MCP dengan spesifikasi alat:

gcloud alpha agent-registry services create SERVER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --mcp-server-spec-type=tool-spec \
  --mcp-server-spec-content=toolspec.json \
  --interfaces=url=SERVER_URL,protocolBinding=PROTOCOL

Ganti kode berikut:

  • SERVER_NAME: Nama yang ingin Anda berikan ke server MCP, misalnya, custom-mcp-server.
  • PROJECT_ID: Project ID.
  • REGION: Region registri.
  • DISPLAY_NAME: Nama yang mudah dibaca yang ingin Anda berikan ke server, misalnya, Custom MCP Server.
  • SERVER_URL: URL endpoint server MCP, misalnya, https://api.example.com/mcp.
  • PROTOCOL: Pengikatan protokol untuk endpoint. Nilai yang valid adalah JSONRPC, HTTP_JSON, atau GRPC. Untuk server MCP, nilai ini sering kali JSONRPC.

Verifikasi pendaftaran

Buat daftar, filter, dan lihat detail server MCP yang baru terdaftar. Untuk mengonfirmasi bahwa server MCP Anda berhasil didaftarkan, Anda dapat mencantumkan server di registry Anda.