Menggunakan server MCP jarak jauh Resource Manager

Dokumen ini menunjukkan cara menggunakan server Model Context Protocol (MCP) jarak jauh Resource Manager untuk terhubung dengan aplikasi AI, termasuk Gemini CLI, ChatGPT, Claude, dan aplikasi kustom yang Anda kembangkan. Server MCP jarak jauh Resource Manager memungkinkan Anda menelusuri dan mengidentifikasi semua Google Cloud project yang memiliki izin yang diperlukan untuk diakses, sehingga memastikan Anda memiliki ID yang benar sebelum mencoba konfigurasi resource yang lebih spesifik.

Alat ini menampilkan daftar terstruktur yang berisi project ID, nomor project, dan status siklus proses project. Server MCP jarak jauh Resource Manager diaktifkan saat Anda mengaktifkan Resource Manager API.

Model Context Protocol (MCP) menstandarkan cara model bahasa besar (LLM) dan aplikasi atau agen AI terhubung ke sumber data eksternal. Server MCP memungkinkan Anda menggunakan alat, resource, dan perintahnya untuk melakukan tindakan dan mendapatkan data terbaru dari layanan backend-nya.

Apa perbedaan antara server MCP lokal dan jarak jauh?

Server MCP lokal
Biasanya dijalankan di komputer lokal Anda dan menggunakan aliran input dan output standar (stdio) untuk komunikasi antar-layanan di perangkat yang sama.
Server MCP jarak jauh
Berjalan di infrastruktur layanan dan menawarkan endpoint HTTP ke aplikasi AI untuk komunikasi antara klien MCP AI dan server MCP. Untuk mengetahui informasi selengkapnya tentang arsitektur MCP, lihat Arsitektur MCP.

Core stateless

Dengan MCP versi 2026-07-28, MCP berubah dari protokol stateful dua arah menjadi protokol stateless. Setiap permintaan MCP menjelaskan dirinya sendiri dan dapat dirutekan menggunakan header. Tidak ada kebutuhan untuk handshake initialize/initialized atau Mcp-Session-Id karena setiap permintaan menyertakan semua informasi yang diperlukan di header HTTP atau parameter _meta. Server MCP dapat meminta informasi tambahan yang diperlukan oleh alat melalui permintaan perjalanan pulang pergi multi-putaran (MRTR).

Untuk membantu merutekan dan memproses permintaan tanpa mengurai isi permintaan, beberapa header MCP diperlukan, termasuk yang berikut:

  • Header yang diperlukan oleh spesifikasi MCP seperti header versi protokol dan header permintaan standar.
  • Header kustom yang ditentukan oleh server MCP. Header ini dicerminkan ke dalam header HTTP dari skema input alat menggunakan properti x-mcp-header. Misalnya, server MCP dapat menentukan header kustom untuk menentukan Google Cloud ID project atau region.

Untuk mengetahui informasi selengkapnya tentang arsitektur MCP, lihat spesifikasi MCP versi 2026-07-28 dan perubahan utama.

Server MCP jarak jauh dan Google Cloud Google

Server MCP jarak jauh Google dan Google Cloud memiliki fitur dan manfaat berikut:

  • Penemuan yang disederhanakan dan terpusat
  • Endpoint HTTP global atau regional yang dikelola
  • Otorisasi terperinci
  • Keamanan perintah dan respons opsional dengan perlindungan Model Armor
  • Logging audit terpusat

Untuk mengetahui informasi tentang server MCP lainnya dan informasi tentang kontrol keamanan dan tata kelola yang tersedia untuk server MCP Google Cloud, lihat Ringkasan server MCP Google Cloud.

Batasan

Anda dapat menggunakan kebijakan penolakan IAM untuk memblokir traffic ke layanan Resource Manager dan server MCP-nya. Namun, atribut IAM dan izin toolUser khusus MCP tidak dapat digunakan untuk membatasi akses alat untuk server ini.

Sebelum memulai

    Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

    Verify that billing is enabled for your Google Cloud project.

    Enable the Cloud Resource Manager API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command: 

    gcloud init

    If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

    Verify that billing is enabled for your Google Cloud project.

    Enable the Cloud Resource Manager API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command: 

    gcloud init

    If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

Autentikasi dan otorisasi

Server MCP jarak jauh Resource Manager menggunakan protokol OAuth 2.0 dengan Identity and Access Management (IAM) untuk autentikasi dan otorisasi. Semua identitasGoogle Cloud didukung untuk autentikasi ke server MCP.

Server MCP Resource Manager tidak menerima kunci API untuk autentikasi.

Sebaiknya buat identitas terpisah untuk agen yang menggunakan alat MCP agar akses ke resource dapat dikontrol dan dipantau. Untuk mengetahui informasi selengkapnya tentang autentikasi, lihat Mengautentikasi ke server MCP.

Cakupan OAuth MCP Resource Manager

OAuth 2.0 menggunakan cakupan dan kredensial untuk menentukan apakah akun utama terautentikasi diizinkan untuk melakukan tindakan tertentu pada resource. Untuk mengetahui informasi selengkapnya tentang cakupan OAuth 2.0 di Google, baca Menggunakan OAuth 2.0 untuk mengakses Google API.

Resource Manager memiliki cakupan OAuth alat MCP berikut:

URI cakupan untuk gcloud CLI Deskripsi
https://www.googleapis.com/auth/cloudresourcemanager.read-only Hanya mengizinkan akses untuk membaca data.
https://www.googleapis.com/auth/cloudresourcemanager.read-write Mengizinkan akses untuk membaca dan mengubah data.

Cakupan tambahan mungkin diperlukan pada resource yang diakses selama panggilan alat. Untuk melihat daftar cakupan yang diperlukan untuk Resource Manager, lihat Resource Manager API.

Mengonfigurasi klien MCP untuk menggunakan server MCP Resource Manager

Aplikasi dan agen AI, seperti Claude atau Antigravity, dapat membuat instance klien MCP yang terhubung ke satu server MCP. Aplikasi AI dapat memiliki beberapa klien yang terhubung ke server MCP yang berbeda. Jika aplikasi Anda tidak tercantum dalam panduan khusus klien, Anda dapat menggunakan informasi berikut untuk terhubung dari sebagian besar aplikasi.

Di aplikasi AI Anda, cari cara untuk menambahkan atau terhubung ke server MCP jarak jauh. Untuk server MCP Resource Manager, masukkan informasi berikut sesuai kebutuhan:

  • Nama server: Server MCP Resource Manager
  • URL Server atau Endpoint: https://cloudresourcemanager.googleapis.com/mcp
  • Transportasi: HTTP yang dapat di-streaming
  • Detail autentikasi: bergantung pada cara autentikasi yang Anda inginkan, Anda dapat memasukkan Google Cloud kredensial, ID Klien OAuth dan rahasia, atau identitas dan kredensial agen. Untuk mengetahui informasi selengkapnya tentang autentikasi, lihat Mengautentikasi ke server MCP.
  • Cakupan OAuth: cakupan OAuth 2.0 yang ingin Anda gunakan saat terhubung ke server MCP Resource Manager.

URI Pengalihan

Untuk aplikasi berbasis web, dan beberapa aplikasi desktop, Anda harus memasukkan URI pengalihan ke daftar yang diizinkan saat membuat ID dan rahasia klien untuk autentikasi. URI pengalihan digunakan oleh server otorisasi untuk mengirim token ke aplikasi Anda. Dokumentasi aplikasi Anda harus menentukan URI pengalihan yang harus Anda gunakan. URI pengalihan kustom tidak didukung.

Untuk panduan khusus aplikasi tentang cara menyiapkan dan terhubung ke server MCP, lihat Panduan khusus klien.

Untuk panduan umum lainnya, lihat referensi berikut:

Alat yang tersedia

Untuk melihat detail alat MCP yang tersedia dan deskripsinya untuk server MCP Resource Manager, lihat referensi MCP Resource Manager.

Alat daftar

Gunakan MCP inspector untuk mencantumkan alat, atau kirim permintaan HTTP tools/list langsung ke server MCP jarak jauh Resource Manager. Metode tools/list tidak memerlukan autentikasi.

curl -X POST https://cloudresourcemanager.googleapis.com/TOOLSET_ENDPOINT \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
    -H 'Mcp-Method: tools/list' \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/list",
      "params": {
        "_meta": {
          "io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
          "io.modelcontextprotocol/clientCapabilities": {
            "extensions": {
              "io.modelcontextprotocol/ui": {
                "mimeTypes": ["text/html;profile=mcp-app"]
              }
            }
          }
        }
      }
    }'

Ganti kode berikut:

  • TOOLSET_ENDPOINT: sisa endpoint MCP setelah nama layanan. Misalnya, untuk Resource Manager, nilainya mungkin mcp/toolset-name.
  • MCP_PROTOCOL_VERSION: versi protokol MCP. Contoh, 2026-07-28.

Kasus penggunaan sampel

Alat search_projects di server MCP jarak jauh Resource Manager memungkinkan agen AI menemukan dan mengidentifikasi semua Google Cloud project secara dinamis yang izin aksesnya Anda miliki sehingga agen dapat menjalankan perintah di alat lain.

Alat ini menampilkan daftar terstruktur yang berisi project ID, nomor project, dan status siklus proses project. Berikut adalah contoh kasus penggunaan untuk server MCP Resource Manager:

  • Audit aksesibilitas dan inventaris resource: Mencantumkan dan meringkas project cloud aktif yang dapat Anda akses.

    Perintah pengguna: "Cantumkan semua project Google Cloud aktif saya."

    Tindakan agen: Agen mengirimkan kueri penelusuran ke server MCP untuk mengambil dan menampilkan daftar ringkasan semua project aktif di bawah kredensial Anda.

  • Penelusuran berbasis induk yang ditargetkan: Ambil project yang berada dalam folder atau organisasi tertentu untuk mempersempit cakupan permintaan.

    Perintah pengguna: "Temukan semua project di Folder 223."

    Tindakan agen: Agen menjalankan panggilan alat dengan kueri parent:folders/223 untuk menampilkan daftar project dalam batas administratif tersebut.

  • Penyelesaian konteks implisit: Saat Anda meminta informasi tentang resource tanpa memberikan project ID tertentu, agen dapat menyelesaikan konteks secara otomatis.

    Perintah pengguna: "Periksa status layanan 'pemroses pembayaran' saya."

    Tindakan agen: Agen mengenali bahwa project_id tidak ada untuk alat Cloud Run. Alat ini menggunakan alat search_projects untuk menemukan project dengan payment dalam nama, mengidentifikasi project yang mungkin (seperti payment-prod-123), dan meminta konfirmasi Anda sebelum melanjutkan.

  • Penemuan khusus lingkungan: Anda dapat menemukan project yang difilter berdasarkan lingkungan atau struktur organisasi tertentu tanpa keluar dari antarmuka chat.

    Perintah pengguna: "Project mana yang dapat saya akses di lingkungan staging?"

    Tindakan agen: Agen melakukan operasi penelusuran untuk semua project yang diberi label atau diberi nama staging yang izin melihatnya Anda miliki dan menampilkan ID project tertentu.

Menyesuaikan perilaku LLM

Alat search_projects serbaguna, tetapi LLM mungkin tidak selalu tahu kapan harus mengkueri hierarki Google Cloud Anda. Untuk memanggil alat dalam skenario tertentu, berikan konteks kustom dalam file Markdown, misalnya, ~/.gemini/GEMINI.md atau AGENTS.md level project.

Langkah berikutnya