Menggunakan server MCP jarak jauh Cloud Location Finder

Dokumen ini menunjukkan cara menggunakan server Model Context Protocol (MCP) jarak jauh Cloud Location Finder untuk terhubung dengan aplikasi AI termasuk Gemini CLI, ChatGPT, Claude, dan aplikasi kustom yang sedang Anda kembangkan. Server MCP jarak jauh Cloud Location Finder memungkinkan agen yang didukung model bahasa besar (LLM) mengambil data lokasi cloud secara aman dan melakukan tindakan menggunakan alat MCP standar. Integrasi bawaan ini memungkinkan agen bernalar tentang latensi, keberlanjutan, dan batas kepatuhan saat mengelola deployment multi-cloud atau hybrid. Server MCP jarak jauh Cloud Location Finder diaktifkan saat Anda mengaktifkan Cloud Location Finder 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 input dan output stream (stdio) standar 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.

Stateless core

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 region atau ID project.

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 Cloud dan Google 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.

Sebelum memulai

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menggunakan server MCP Cloud Location Finder, minta administrator Anda untuk memberi Anda peran IAM berikut pada project tempat Anda ingin menggunakan server MCP Cloud Location Finder:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk menggunakan server MCP Cloud Location Finder. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk menggunakan server MCP Cloud Location Finder:

  • Lakukan panggilan alat MCP: mcp.tools.call

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Autentikasi dan otorisasi

Server MCP jarak jauh Cloud Location Finder menggunakan protokol OAuth 2.0 dengan Identity and Access Management (IAM) untuk autentikasi dan otorisasi. Semua Google Cloud identitas didukung untuk autentikasi ke server MCP.

Server MCP jarak jauh Cloud Location Finder memerlukan autentikasi menggunakan OAuth 2.0. API ini tidak menerima kunci API.

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 Cloud Location Finder

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.

Cloud Location Finder memerlukan cakupan OAuth alat MCP berikut:

URI cakupan untuk gcloud CLI Deskripsi
https://www.googleapis.com/auth/cloud-platform Mengizinkan akses penuh ke semua Google Cloud layanan.

Cakupan tambahan mungkin diperlukan pada resource yang diakses selama panggilan alat.

Mengonfigurasi klien MCP untuk menggunakan server MCP Cloud Location Finder

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 menghubungkan ke server MCP jarak jauh. Untuk server MCP Cloud Location Finder, masukkan informasi berikut sesuai kebutuhan:

  • Nama server: Server MCP Cloud Location Finder
  • URL Server atau Endpoint: https://cloudlocationfinder.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: server MCP Cloud Location Finder memerlukan cakupan https://www.googleapis.com/auth/cloud-platform.

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 Cloud Location Finder, lihat referensi MCP Cloud Location Finder.

Alat daftar

Gunakan pemeriksa MCP untuk mencantumkan alat, atau kirim permintaan HTTP tools/list secara langsung ke server MCP jarak jauh Cloud Location Finder. Metode tools/list tidak memerlukan autentikasi.

curl -X POST https://cloudlocationfinder.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 Cloud Location Finder, nilainya mungkin mcp/toolset-name.
  • MCP_PROTOCOL_VERSION: versi protokol MCP. Contoh, 2026-07-28.

Contoh kasus penggunaan

Berikut adalah contoh kasus penggunaan untuk server MCP Cloud Location Finder: Contoh ini menunjukkan jenis perintah yang dapat Anda berikan kepada agen Anda.

Kedekatan dan latensi

Perintah: "Temukan zona Google Cloud terdekat dengan region AWS us-east-1."

Hal ini akan meminta agen menggunakan alat search_cloud_locations untuk memfilter zona yang paling dekat dengan lokasi aws-us-east-1 berdasarkan latensi jaringan:

Keberlanjutan

Perintah: "Buat daftar Google Cloud region yang memiliki persentase energi bebas karbon sebesar 80% atau lebih tinggi."

Hal ini akan meminta agen untuk menggunakan alat list_cloud_locations guna memfilter wilayah dengan carbon_free_energy_percentage >= 80:

Penyiapan kepatuhan

Perintah: "Temukan semua lokasi cloud di Eropa untuk memastikan kepatuhan residensi data."

Konfigurasi keamanan dan keselamatan opsional

MCP memperkenalkan risiko dan pertimbangan keamanan baru karena berbagai tindakan yang dapat Anda lakukan dengan alat MCP. Untuk meminimalkan dan mengelola risiko ini,Google Cloud menawarkan setelan default dan kebijakan yang dapat disesuaikan untuk mengontrol penggunaan alat MCP di organisasi atau project Google CloudAnda.

Untuk mengetahui informasi selengkapnya tentang keamanan dan tata kelola MCP, lihat Keamanan dan keselamatan AI.

Mengontrol penggunaan MCP dengan kebijakan IAM

Kebijakan penolakan dan kebijakan izin Identity and Access Management (IAM) membantu Anda mengamankan Google Cloud server Google MCP.

Anda dapat menggabungkan beberapa kriteria untuk membuat kebijakan keamanan dan tata kelola yang disesuaikan dengan mengizinkan atau menolak akses berdasarkan hal-hal berikut:

  • Entitas utama.
  • Properti alat seperti atribut hanya baca.
  • Nama layanan atau nama alat.
  • Client ID klien OAuth aplikasi.

Untuk mengetahui informasi selengkapnya, lihat Mengontrol penggunaan MCP dengan Identity and Access Management.

Langkah berikutnya