Prasyarat untuk menggunakan aplikasi terhubung

Sebelum memulai, pastikan Anda sudah memiliki yang berikut:

  • Server MCP yang di-deploy dengan endpoint HTTPS yang aman

    Server MCP Anda harus dapat dijangkau secara publik melalui HTTPS menggunakan transpor HTTP yang Dapat Di-streaming (misalnya, https://api.yourdomain.com/v1/mcp).

    Lihat panduan developer server MCP Platform Aplikasi Terhubung untuk mengetahui detail implementasi.

  • Memastikan server Anda dapat menerima permintaan dari Google

    Jika server Anda membatasi akses eksternal berdasarkan IP sumber, izinkan alamat IP berikut:

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    Rentang IP keluar Google dapat berubah seiring waktu, jadi sebaiknya baca rentang IP tersebut dari daftar yang dipublikasikan Google dan perbarui daftar yang diizinkan secara rutin:

  • Akses ke akun developer terdaftar di Konsol Terhubung Google

    Setelah login, pastikan Anda memiliki salah satu izin Aplikasi Terhubung berikut di Konsol Terhubung Google:

    • Melihat Aplikasi Terhubung
    • Membuat dan mengelola Aplikasi Terhubung

    Persyaratan Layanan Aplikasi Terhubung juga harus disetujui oleh pemilik atau administrator akun. Saat pertama kali organisasi Anda mengakses aplikasi terhubung di Konsol Terhubung Google, pemilik atau administrator akun harus login dan menyetujui perjanjian program sebelum anggota tim yang diundang dapat melanjutkan.

    Jika Anda merasa memiliki akses, tetapi tidak dapat membuat aplikasi terhubung, minta pemilik atau administrator akun untuk memberikan izin 'Melihat aplikasi terhubung' atau 'Membuat dan mengelola aplikasi terhubung' kepada akun pengguna Anda di halaman Pengguna dan izin.

  • Kemampuan untuk menghosting file verifikasi .well-known di domain server MCP Anda

    Untuk memverifikasi kepemilikan domain, Anda harus dapat menyajikan file token verifikasi JSON secara langsung (dengan HTTP 200 OK dan tanpa pengalihan) di https://<your-domain>/.well-known/google-connected-apps.

  • Meninjau kategori aplikasi terhubung yang tersedia

    Kategori aplikasi terhubung Anda dikaitkan dengan kemampuan tertentu yang harus didukung untuk memastikan pengalaman pengguna yang berkualitas tinggi. Setelah kategori untuk aplikasi terhubung dipilih, kategori tersebut tidak dapat diubah. Pelajari lebih lanjut.

  • Server MCP yang di-deploy dengan URL endpoint yang valid

    Lihat Panduan developer server MCP aplikasi terhubung untuk mengetahui detail selengkapnya.

  • Metadata dan aset merek yang ditampilkan kepada publik untuk aplikasi terhubung Anda

    • Nama aplikasi terhubung: Nama tampilan untuk aplikasi terhubung Anda yang ditampilkan kepada pengguna di berbagai produk Google, dan digunakan saat pengguna menyebut aplikasi Anda dengan @.
    • Deskripsi: Ringkasan singkat dalam satu kalimat (kurang dari 30 kata) tentang fungsi aplikasi terhubung Anda bagi pengguna, seperti "Lacak pembelian terbaru, periksa status pengiriman, dan lihat histori pesanan Anda".
    • Ikon: Ikon aplikasi berukuran 512 px × 512 px dalam format JPEG atau PNG, dengan ukuran file maksimum 1 MB (1.024 KB).
    • Kapabilitas: Minimal 3 tugas bernilai tinggi yang dapat dilakukan oleh aplikasi terhubung Anda, seperti "Telusuri histori pesanan Anda" atau "Periksa status pengiriman langsung", selain kemampuan default yang ditentukan oleh kategori aplikasi Anda. Informasi ini ditampilkan kepada pengguna agar mereka dapat memutuskan apakah ingin menggunakan aplikasi atau tidak. Jangan sertakan angka di awal kapabilitas Anda.
    • Contoh perintah: Minimal 3 contoh kueri yang membantu pengguna memahami apa yang dapat mereka tanyakan. Mulai minimal 2 contoh perintah dengan nama aplikasi yang terhubung. Sebutkan nama aplikasi Anda secara alami minimal di 1 perintah (yaitu tanpa diawali dengan nama aplikasi Anda). Jangan sertakan angka di awal contoh perintah Anda.
    • URL Persyaratan Layanan: URL yang dapat diakses secara publik untuk Persyaratan Layanan aplikasi terhubung Anda.
    • URL Kebijakan Privasi: URL yang dapat diakses secara publik untuk Kebijakan Privasi aplikasi terhubung Anda.
    • URL situs (opsional): Situs untuk aplikasi yang terhubung.