Mendaftarkan, menguji, dan memublikasikan aplikasi terhubung Anda

Setelah memenuhi prasyarat, ikuti langkah-langkah berikut untuk mendaftarkan, mengonfigurasi, menguji, dan memublikasikan aplikasi terhubung Anda.

Langkah 1: Buat aplikasi terhubung

Untuk membuat aplikasi terhubung:

  1. Login ke Konsol Terhubung Google.
  2. Di halaman beranda, pilih Buat aplikasi.
  3. Dalam dialog Choose what to create:
    • Jika diminta untuk menyetujui Persyaratan Layanan Aplikasi Terhubung, pilih View terms, tinjau dan setujui perjanjian, lalu pilih Create. Hanya administrator akun yang dapat menyetujui perjanjian.
    • Atau, pilih Buat di kartu Aplikasi terhubung.

  4. Dalam dialog Beri nama aplikasi terhubung Anda, ketik nama untuk aplikasi terhubung Anda. Ini adalah nama yang akan digunakan untuk menampilkan aplikasi terhubung Anda di berbagai produk Google, dan merupakan cara pengguna akan menyebut aplikasi terhubung Anda menggunakan @. Pilih Berikutnya.

  5. Di dialog Pilih kategori aplikasi terhubung, pilih domain, kategori, atau industri aplikasi Anda dari menu Pilih kategori.

  6. Dalam dialog Choose connection type, pilih salah satu opsi berikut:

    • Server MCP: Hubungkan server MCP untuk menyediakan layanan Anda kepada pengguna Gemini dan Penelusuran di web, Android, dan iOS.
    • MCP Android: Beri Gemini di Android akses ke kemampuan di perangkat Anda agar Gemini dapat memicu tindakan dan menyelesaikan tugas untuk pengguna di aplikasi Anda.

    Pelajari lebih lanjut cara menyiapkan aplikasi terhubung MCP Android. Anda hanya dapat memilih satu jenis koneksi per aplikasi terhubung, dan pilihan ini tidak dapat diubah nanti.

  7. Pilih Create Connected app.

Tindakan ini akan membuka halaman ringkasan pengelolaan untuk aplikasi terhubung Anda (Siapkan dan uji Aplikasi terhubung Anda), tempat Anda dapat mengonfigurasi detail aplikasi, koneksi server MCP, dan penguji.

Langkah 2: Masukkan detail aplikasi terhubung

Untuk memberikan detail selengkapnya tentang aplikasi terhubung dan mengonfigurasi tampilannya bagi pengguna:

  1. Di halaman ringkasan aplikasi yang terhubung, di baris Detail aplikasi, pilih Mulai (atau Kelola jika Anda memperbarui detail yang ada).
  2. Di bagian atas halaman Detail aplikasi, verifikasi kolom Nama aplikasi yang terhubung. Anda dapat memperbarui nama jika diperlukan. Nama ini ditampilkan kepada pengguna di berbagai produk Google, dan digunakan saat pengguna menyebut aplikasi Anda dengan @.
  3. Di bagian Detail publik, di bagian Ikon, upload ikon aplikasi Anda (JPG atau PNG, maksimal 1 MB, dan 512 px × 512 px).

  4. Lengkapi kolom berikut:

    • Deskripsi: Masukkan ringkasan singkat dalam satu kalimat (kurang dari 30 kata) yang menjelaskan fitur utama aplikasi terhubung Anda dan fungsinya. Teks ini ditampilkan kepada pengguna; teks ini tidak digunakan sebagai petunjuk model.
    • Kemampuan: Masukkan minimal tiga tugas bernilai tinggi yang dapat dilakukan oleh aplikasi terhubung Anda. Pilih Tambahkan kemampuan untuk menambahkan lebih banyak entri. Jangan sertakan angka di awal kapabilitas Anda. Hanya sertakan satu kemampuan per entri. Jika kategori Anda menyertakan kemampuan yang telah ditentukan, kemampuan tersebut akan muncul di bagian atas daftar dan tidak dapat diubah.
    • Contoh perintah: Masukkan minimal tiga contoh perintah yang membantu pengguna memahami apa yang dapat mereka tanyakan. Pilih Tambahkan contoh perintah untuk menambahkan entri.
      • Awali minimal dua perintah dengan @<YourAppName> (misalnya, @Order Tracker where is my last order?).
      • Sebutkan <YourAppName> secara alami minimal di satu perintah tanpa diawali dengan nama aplikasi Anda (misalnya, Track my recent order on Order Tracker).
      • Jangan sertakan awalan bernomor (1., 2., 3.) atau mengapit perintah dengan tanda petik ("...").

    • Pelokalan multibahasa: Untuk memberikan terjemahan untuk Deskripsi, Kemampuan, dan Contoh perintah, gabungkan teks setiap lokalitas dalam tag bahasa di dalam kolom input. Contoh:

      <en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>

      Konsol Terhubung otomatis memvalidasi tag Anda dan menampilkan lokalitas yang terdeteksi di bawah setiap kolom (misalnya, Found translations for 2 languages: en-US, es-ES).

    • URL Persyaratan Layanan: Masukkan link https:// atau http:// yang valid ke Persyaratan Layanan Anda.

    • URL Kebijakan: Masukkan link https:// atau http:// yang valid ke Kebijakan Privasi Anda.

    • URL situs (opsional): Masukkan link ke situs Anda untuk keperluan atribusi.

  5. Pilih Simpan di bagian bawah halaman untuk kembali ke halaman ringkasan.

Langkah 3: Masukkan endpoint MCP Anda dan verifikasi kepemilikan domain

Sebelum Google dapat terhubung ke server MCP Anda atau menyinkronkan alat Anda, Anda harus memberikan URL endpoint server MCP Anda dan memverifikasi bahwa Anda adalah pemilik domain tempat server tersebut dihosting.

Untuk memasukkan endpoint MCP dan memverifikasi kepemilikan domain:

  1. Di halaman ringkasan aplikasi yang terhubung, di kartu Penyiapan MCP dan alat, pilih Mulai (atau Kelola jika Anda memperbarui detail yang ada). Tindakan ini akan membuka Langkah 1 (Endpoint server MCP) dari alur penyiapan MCP.
  2. Di bagian Hubungkan endpoint server MCP Anda, masukkan URL HTTPS lengkap endpoint server MCP Anda (misalnya, https://api.yourdomain.com/v1/mcp).

  3. Di bagian Verifikasi domain Anda, selesaikan verifikasi token verifikasi untuk domain Anda (jika Anda telah memverifikasi domain atau domain induknya di akun developer, domain tersebut akan otomatis ditampilkan sebagai terverifikasi):

    1. Di kartu Verifikasi kepemilikan domain, pilih Download token. Browser Anda akan mendownload file bernama google-connected-apps.json dengan struktur berikut:

      {
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}

    2. Upload dan hosting konten JSON ini di server Anda di https://<your-domain>/.well-known/google-connected-apps.

      • Pastikan endpoint dapat dijangkau secara publik melalui HTTPS, menampilkan HTTP 200 OK secara langsung tanpa pengalihan HTTP, dan menyertakan token Anda di dalam array verification_tokens.

    3. Kembali ke Konsol Terhubung Google, lalu pilih Verifikasi domain.

    4. Setelah verifikasi berhasil, baris Domain verified with challenge token akan menampilkan tanda centang hijau, dan membuka bagian Access credentials di bawahnya.

Langkah 4: Konfigurasi kredensial akses

Setelah memverifikasi domain, konfigurasikan cara Google melakukan autentikasi dengan server MCP Anda dan ambil definisi alat server Anda.

Untuk mengonfigurasi kredensial akses:

  1. Di bagian Provide access credentials (pada Langkah 1 di halaman MCP and tools setup), pilih Get started (atau Update credentials untuk mengubah konfigurasi yang ada).

  2. Di bagian Does your server require authorization?, pilih salah satu opsi berikut:

    • Tidak: Pilih opsi ini jika server MCP Anda dapat diakses secara publik tanpa autentikasi, lalu pilih Konfirmasi.

    • Yes: Pilih opsi ini jika salah satu alat yang diekspos oleh server MCP Anda memerlukan otorisasi. Kemudian, di bagian Select the authorization model your MCP server uses, pilih alur autentikasi Anda:

      • Antar-mesin (Kredensial Klien OAuth): Pilih opsi ini untuk autentikasi antar-layanan (RFC 6749) saat Google berkomunikasi langsung dengan server MCP Anda menggunakan Client ID dan Secret bersama tanpa pengalihan login pengguna akhir:
        1. Masukkan Client ID (wajib) dan Client secret (opsional).
        2. Atau, masukkan Endpoint otorisasi (opsional) dan Endpoint token (opsional) jika server Anda tidak memberitahukannya menggunakan /.well-known/oauth-authorization-server.
        3. Pilih Register client (atau Update client).

      • Didelegasikan pengguna (Kode Otorisasi): Pilih opsi ini jika server MCP Anda mengharuskan setiap pengguna login dan memberikan otorisasi untuk melakukan tindakan menggunakan akun mereka sendiri melalui Penautan Akun Google:

        1. Izinkan URI Pengalihan OAuth Google: Di banner Pastikan Anda telah mengizinkan URI pengalihan yang disediakan, pilih Lihat (atau pilih ikon salin) untuk memeriksa URI Pengalihan khusus aplikasi yang dibuat untuk aplikasi terhubung Anda. Tambahkan URI tersebut ke daftar yang diizinkan server OAuth Anda, lalu kembali ke Konsol Google Connected.
        2. Di bagian Select how Google should authenticate with your OAuth server, pilih cara klien OAuth Anda didaftarkan:
          • Pradaftar: Pilih opsi ini jika Anda membuat Client ID dan rahasia klien (opsional) statis di penyedia OAuth Anda. Anda juga dapat memberikan Endpoint otorisasi kustom (opsional) dan Endpoint token kustom (opsional).
          • Client ID metadata atau Dynamic client registration (direkomendasikan): Pilih opsi ini jika server Anda mendukung OAuth Client ID Metadata Document (CIMD) atau Dynamic Client Registration (RFC 7591). Google akan memeriksa CIMD terlebih dahulu dan beralih ke DCR menggunakan endpoint penemuan .well-known Anda. Jika ingin, Anda juga dapat menentukan endpoint otorisasi dan token kustom.

        3. Di bagian Authenticate with your developer credentials, karena Anda telah memilih User-delegated sebagai model otorisasi, Anda harus login ke server sebelum Google dapat mengambil alat. Pilih salah satu:

          • Autentikasi melalui Pop-up (direkomendasikan): Membuka alur autentikasi Anda dalam dialog overlay. Ini adalah pengalaman default.
          • Autentikasi melalui Pengalihan (pengganti): Membuka alur autentikasi Anda menggunakan pengalihan layar penuh di tab atau jendela yang sama. Gunakan opsi ini jika dialog gagal dirender karena batasan tampilan atau header keamanan (seperti X-Frame-Options atau Content-Security-Policy).

          Sebaiknya coba lakukan autentikasi terlebih dahulu menggunakan dialog. Jika Anda tidak dapat melakukan autentikasi menggunakan dialog, gunakan metode pengalihan. Pilihan Anda juga menentukan pengalaman login bagi pengguna saat mereka pertama kali menggunakan aplikasi terhubung Anda.

        4. Pilih Register client (atau Update client).

Langkah 5: Berikan detail akun pengujian (hanya untuk Otorisasi yang didelegasikan pengguna)

Jika aplikasi yang terhubung memerlukan autentikasi, Anda harus memberikan kredensial pengujian yang telah diisi, yang diisi otomatis dengan data sampel yang realistis dan dengan autentikasi 2 langkah (2FA) dinonaktifkan, beserta petunjuk pengujian kepada perwakilan Google Anda. Hal ini memungkinkan tim peninjauan dan QA Google memverifikasi eksekusi alat tanpa diblokir oleh sandbox kosong, penghalang konten berbayar, atau verifikasi 2FA. Jika Google tidak dapat menguji aplikasi terhubung Anda sepenuhnya, aplikasi tersebut dapat ditolak selama peninjauan.

Langkah 6: Sinkronkan alat Anda

Untuk membuat setiap versi aplikasi yang terhubung, Google akan menyinkronkan dengan endpoint yang Anda berikan untuk mendapatkan alat yang tersedia dan mengambil snapshot. Alat ini akan tersedia untuk pengguna dalam versi tersebut. Saat versi aplikasi terhubung Anda dalam pratinjau dan tersedia untuk penguji, Anda dapat terus membuat perubahan di server dan menyinkronkan ulang alat untuk mengupdate. Tindakan ini akan membuat snapshot baru dari alat Anda.

Saat Anda memublikasikan, snapshot terbaru alat Anda akan digunakan untuk versi aplikasi terhubung tersebut. Anda tidak akan dapat lagi membuat perubahan pada alat, deskripsi, atau detail server. Untuk mengupdate alat atau menyinkronkan modifikasi apa pun dari server, buat versi aplikasi terhubung yang baru. Sebaiknya buat endpoint baru untuk setiap versi aplikasi terhubung Anda.

Untuk menyinkronkan alat:

  1. Di bagian Alat sinkronisasi:

    1. Pilih Alat sinkronisasi.
    2. Jika diminta untuk login, lakukan autentikasi dengan akun developer yang memiliki izin untuk mencantumkan semua alat yang ingin Anda tampilkan kepada pengguna. Alat apa pun yang tidak dapat diakses oleh akun Anda tidak akan disinkronkan.
    3. Setelah terhubung, Konsol Terhubung akan menampilkan jumlah alat yang disinkronkan, bersama dengan tombol Sinkronkan ulang alat.

  2. Pilih Next di bagian bawah halaman untuk melanjutkan ke langkah 2 penyiapan MCP dan alat.

Langkah 7: Tentukan cara dan tempat pengguna menggunakan aplikasi Anda

Di bagian Alat pada halaman Penyiapan MCP dan alat, konfigurasikan parameter dasar seperti tempat aplikasi yang terhubung tersedia secara geografis, bahasanya, dan produk Google yang ingin Anda sediakan.

  1. Di bagian Ketersediaan, di samping Sediakan versi di, konfigurasikan opsi penargetan berikut:
    • Negara/wilayah: Pilih lokasi geografis tempat aplikasi terhubung Anda harus tersedia.
    • Bahasa: Pilih bahasa yang didukung aplikasi terhubung Anda.
    • Produk: Pilih produk Google tempat aplikasi terhubung Anda akan tersedia.

  2. Di bagian Tools setelah Availability, tinjau alat yang disinkronkan dari server MCP Anda. Pilih alat apa pun dalam daftar Tools untuk mengonfigurasi setelannya di panel Manage tool di sebelah kanan:

    • Aktifkan alat: Alihkan tombol Aktifkan alat untuk menyertakan atau mengecualikan alat di aplikasi terhubung Anda. Alat yang dinonaktifkan tidak akan tersedia di aplikasi terhubung Anda untuk berinteraksi dengan pengguna.

    • Konteks tambahan: Pilih apakah alat Anda memerlukan sinyal kontekstual dari Google untuk beroperasi:

      • Lokalitas: Lokalitas yang ditentukan oleh Akun Google pengguna.
      • Perkiraan lokasi: Lokasi fisik pengguna atau perangkat dalam area seluas 3 kilometer persegi atau lebih (misalnya, kota tempat pengguna berada).
      • Lokasi presisi: Lokasi fisik pengguna atau perangkat dengan akurasi hingga 50 meter atau kurang.

    • Konfirmasi pengguna: Pilih Konfirmasi pengguna diperlukan untuk mewajibkan konfirmasi pengguna secara eksplisit sebelum menjalankan alat (opsi ini otomatis dipilih jika anotasi MCP alat Anda menentukan destructiveHint: true).

  3. Jika server MCP Anda menyediakan resource UI, beralihlah ke tab UI resources di samping Tools untuk memeriksa resource UI server Anda (text/html, text/html;profile=mcp-app, text/javascript, text/css), verifikasi alat yang ditautkan ke setiap resource, dan tinjau Kebijakan Keamanan Konten (CSP) connectDomains dan resourceDomains.

  4. Pilih Simpan di bagian bawah halaman.

Setelah Detail aplikasi serta MCP dan penyiapan alat disimpan, konfigurasi Anda akan otomatis tersedia untuk dilihat pratinjaunya oleh penguji yang telah Anda tambahkan, dan status versi Anda di halaman ringkasan akan diperbarui menjadi Tersedia untuk penguji.

Langkah 8: Uji aplikasi terhubung Anda

Agar aplikasi terhubung Anda tersedia untuk penguji, Anda harus menambahkan mereka di layar Kelola penguji. Hanya pengguna yang Anda tambahkan ke daftar penguji yang dapat melihat dan berinteraksi dengan aplikasi terhubung Anda yang belum dipublikasikan. Anda hanya dapat menambahkan penguji yang memiliki akun @gmail.com.

  1. Di halaman ringkasan aplikasi terhubung, pada kartu Uji aplikasi Anda, pilih Tambahkan penguji (atau Kelola penguji jika Anda sudah menambahkan beberapa penguji).

  2. Di layar Kelola penguji, pilih daftar email yang ada atau pilih Buat daftar email untuk menambahkan Akun Google yang diizinkan untuk menguji integrasi Anda. Pastikan untuk menyertakan alamat email Anda sendiri jika Anda ingin menguji aplikasi sendiri.

  3. Pilih Simpan.

  4. Penguji di aplikasi Gemini dapat memanggil aplikasi terhubung Anda dengan mengetik @ diikuti dengan nama aplikasi terhubung Anda dan memilihnya dari menu. Anda juga dapat melihat dan menghubungkan aplikasi di Gemini dengan membuka Setelan & bantuan → Aplikasi terhubung di menu navigasi sebelah kiri.

  5. Sebaiknya uji integrasi Anda secara menyeluruh:

    • Coba semua Contoh perintah Anda.
    • Uji panggilan @<AppName> eksplisit dan kueri bahasa alami.
    • Verifikasi alur autentikasi end-to-end, eksekusi alat, perintah konfirmasi pengguna, dan resource UI apa pun.

Jika sudah puas dengan pengujian, Anda siap mengirimkan aplikasi terhubung ke Google untuk ditinjau.

Langkah 9: Mulai peninjauan aplikasi terhubung Anda, dan publikasikan setelah disetujui

Sebelum aplikasi terhubung Anda dapat disediakan untuk semua pengguna, Google akan meninjau dan menguji integrasi Anda.

Untuk mengirim aplikasi terhubung Anda untuk ditinjau, lakukan hal berikut:

  1. Di halaman ringkasan aplikasi terhubung, pada kartu Rilis di sisi kanan halaman, pilih Kirim untuk ditinjau (diaktifkan setelah konfigurasi aplikasi selesai dan dalam pratinjau tanpa masalah pemblokiran).

  2. Saat versi Anda sedang dalam peninjauan:

    • Konsol Terhubung otomatis membuat versi draf baru yang dapat diedit sehingga penguji dapat terus melihat pratinjau aplikasi Anda dan Anda dapat menyiapkan pengeditan di masa mendatang tanpa mengganggu peninjauan.
    • Mengunci setiap perubahan pada versi yang sedang ditinjau.
    • Untuk melihat detail hanya baca dari versi yang sedang ditinjau atau membatalkan peninjauan, pilih tombol opsi lainnya (⋮) di kartu Sedang ditinjau, lalu pilih Lihat detail aplikasi atau Batalkan peninjauan.

  3. Setelah Google menyelesaikan peninjauan, Anda akan menerima notifikasi dan kartu Rilis akan diperbarui:

    • Jika masalah ditemukan: Kartu Rilis akan menampilkan Masalah ditemukan. Pilih Lihat masalah untuk memeriksa temuan peninjauan tertentu. Perbarui konfigurasi atau server MCP Anda di versi pratinjau yang dapat diedit, verifikasi perbaikan Anda dengan penguji, lalu pilih Kirim untuk ditinjau lagi.
    • Jika disetujui: Kartu Rilis akan menampilkan Siap dipublikasikan. Pilih Publikasikan jika Anda sudah siap merilis aplikasi terhubung kepada pengguna.

Selamat! Aplikasi terhubung Anda kini telah dipublikasikan dan diluncurkan kepada pengguna di seluruh produk Google yang Anda pilih.

Pengelolaan versi pasca-publikasi dan berkelanjutan

Setelah dipublikasikan, kartu bawah di bagian Rilis akan menampilkan Dipublikasikan beserta nomor versi aktif untuk aplikasi terhubung, tanggal terbit, dan jumlah negara/wilayah, bahasa, dan produk yang ditargetkan. Anda dapat memilih menu opsi lainnya (⋮) di kartu Dipublikasikan, lalu memilih Lihat detail aplikasi kapan saja untuk memeriksa konfigurasi hanya baca dari rilis langsung Anda.

Meskipun versi yang dipublikasikan tetap aktif dalam produksi, Anda dapat menggunakan panel Edit dan uji Aplikasi terhubung di sebelah kiri (atau pilih Buat versi baru jika tidak ada draf) untuk mengonfigurasi, melihat pratinjau, dan menguji update dalam versi baru (Version <N+1>) secara independen sebelum mengirimkannya untuk ditinjau dan dipublikasikan.