Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Mendaftarkan server MCP

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

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

Penemuan otomatis server Google Cloud MCP

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

Saat Anda mengaktifkan Google Cloud APIdi project yang didukung, 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 untuk server ini secara manual.

Mendaftarkan server MCP dari GKE

Anda dapat mengonfigurasi pendaftaran otomatis untuk server MCP kustom yang di-deploy di Google Kubernetes Engine (GKE) dengan menambahkan label registry.gke.io/functional-type: "MCP_SERVER" ke deployment GKE Anda.

Agar Agent Registry dapat melakukan pemindaian introspeksi dan menemukan alat MCP Anda, deployment Anda juga harus menyertakan anotasi yang mendeklarasikan URL endpoint dan detail kemampuan server. Selain itu, konfigurasikan Workload Identity menggunakan anotasi iam.gke.io/spiffe-identity-type: agent-identity untuk membantu mengaktifkan komunikasi terautentikasi yang aman.

Contoh berikut menunjukkan manifes deployment server MCP GKE menggunakan konfigurasi ini.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-mcp-server
  labels:
    # GKE takes this label and registers the deployment as an MCP server to the registry
    registry.gke.io/functional-type: "MCP_SERVER"
  annotations:
    # A list of endpoint URLs where the GKE controller can access this MCP server
    modelcontextprotocol.info/urls: |
      - https://my-mcp-server.default.svc.cluster.local/mcp
    # Defines structural capabilities for the MCP server card
    modelcontextprotocol.info/capabilities: |
      card:
        endpoint: "/mcp"
        protocol: "HTTP"
spec:
  selector:
    matchLabels:
      app: my-mcp-server
  template:
    metadata:
      annotations:
        # Workload Identity annotation for identity and access management
        iam.gke.io/spiffe-identity-type: agent-identity
      labels:
        app: my-mcp-server
    spec:
      containers:
      - name: server
        image: gcr.io/my-project/my-mcp-server:1.0.0

Saat Anda menerapkan deployment, GKE akan otomatis mencoba mendapatkan spesifikasi alat dari server dan mendaftarkan alat langsung ke model data Agent Registry.

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, server tidak otomatis melakukan introspeksi untuk menentukan alat mana yang tersedia. Agar pengguna dapat menemukan alat 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 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 diperlukan guna mendaftarkan server MCP secara manual di Agent Registry, minta administrator untuk memberi Anda peran IAM Editor Agent Registry API (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.

Menyiapkan spesifikasi alat

Buat file toolspec.json yang menguraikan alat yang disediakan server. Ukuran file maksimum untuk file spesifikasi ini adalah 10 KB.

File JSON 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 mengetahui persyaratan struktural mendetail, lihat Skema JSON dan referensi REST.

Mendaftarkan server dan alat

Daftarkan server MCP dan upload definisi alat secara bersamaan:

Konsol

Di Google Cloud konsol, buka Agent Registry:

Buka Agent Registry
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab MCP servers.
Klik Add server MCP.
Di panel detail server MCP , masukkan nama tampilan, deskripsi, dan region geografis.
Di bagian Tool specification, masukkan URL endpoint server MCP dan tempelkan konten file toolspec.json Anda.

Secara opsional, klik Import tools 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.
Klik Next.

Panel Select MCP tools menampilkan daftar alat dengan nama dan deskripsi dari server MCP Anda.
Pilih semua alat MCP yang ingin Anda sertakan. Anda dapat memfilter alat dari daftar berdasarkan nama atau nilai.
Klik Save.

gcloud

Daftarkan server MCP dengan spesifikasi alat:

gcloud 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 registry.
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: Binding protokol untuk endpoint. Nilai yang valid adalah JSONRPC, HTTP_JSON, atau GRPC. Untuk server MCP, nilai ini sering kali adalah JSONRPC.

Terraform

Untuk mendaftarkan server MCP dan menentukan alatnya, konfigurasikan resource google_agent_registry_service dengan blok mcp_server_spec:

resource "google_agent_registry_service" "mcp_server" {
  location     = "REGION"
  service_id   = "SERVER_NAME"
  display_name = "DISPLAY_NAME"
  description  = "An external MCP server registered using Terraform."

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

  mcp_server_spec {
    type    = "NO_SPEC"
  }
}

output "server_resource_name" {
  description = "The generated read-only Server resource name."
  value       = google_agent_registry_service.mcp_server.registry_resource
}