Bağlı uygulamanızı kaydetme, test etme ve yayınlama

Ön koşulları karşıladıktan sonra bağlı uygulamanızı kaydetmek, yapılandırmak, test etmek ve yayınlamak için aşağıdaki adımları uygulayın.

1. adım: Bağlı uygulama oluşturun

Bağlı uygulama oluşturmak için:

  1. Google Connected Console'da oturum açın.
  2. Ana sayfada Uygulama oluştur'u seçin.
  3. Choose what to create (Oluşturulacak öğeyi seçin) iletişim kutusunda:
    • Bağlı Uygulamalar Hizmet Şartları'nı kabul etmeniz istenirse Şartları görüntüle'yi seçin, sözleşmeyi inceleyip kabul edin ve ardından Oluştur'u seçin. Sözleşmeyi yalnızca hesap yöneticisi kabul edebilir.
    • Aksi takdirde, Bağlı uygulama kartında Oluştur'u seçin.

  4. Bağlı uygulamanıza bir ad verin iletişim kutusunda bağlı uygulamanız için bir ad yazın. Bu ad, bağlı uygulamanızı Google ürünlerinde göstermek için kullanılır ve kullanıcılar bağlı uygulamanızdan @ kullanarak bu şekilde bahseder. Sonraki'yi seçin.

  5. Bağlı uygulama kategorisi seçin iletişim kutusunda, Kategori seçin menüsünden uygulamanızın alanını, kategorisini veya sektörünü seçin.

  6. Bağlantı türünü seçin iletişim kutusunda aşağıdaki seçeneklerden birini belirleyin:

    • MCP sunucusu: Hizmetlerinizi web, Android ve iOS'te Gemini ve Google Arama kullanıcılarına sunmak için bir MCP sunucusu bağlayın.
    • Android MCP: Cihazınızdaki cihaz üzerinde özelliklerini Android'de Gemini'a göstererek uygulamanızdaki kullanıcılar için işlemleri tetiklemesini ve görevleri tamamlamasını sağlayın.

    Android MCP bağlı uygulaması oluşturma hakkında daha fazla bilgi edinin. Bağlı uygulama başına yalnızca bir bağlantı türü seçebilirsiniz ve bu tür daha sonra değiştirilemez.

  7. Create Connected app'i (Bağlı uygulama oluştur) seçin.

Bu işlem, bağlı uygulamanızın yönetim genel bakış sayfasını (Bağlı uygulamanızı ayarlama ve test etme) açar. Bu sayfada uygulama ayrıntılarınızı, MCP sunucu bağlantınızı ve test kullanıcılarınızı yapılandırabilirsiniz.

2. adım: Bağlı uygulamanızın ayrıntılarını girin

Bağlı uygulamanız hakkında daha fazla ayrıntı sağlamak ve kullanıcılara nasıl görüneceğini yapılandırmak için:

  1. Bağlı uygulamanızın genel bakış sayfasındaki Uygulama ayrıntıları satırında Başlayın'ı (veya mevcut ayrıntıları güncelliyorsanız Yönet'i) seçin.
  2. Uygulama ayrıntıları sayfasının üst kısmındaki Bağlı uygulama adı alanını doğrulayın. Gerekirse adı güncelleyebilirsiniz. Bu ad, Google ürünlerinde kullanıcılara gösterilir ve kullanıcılar uygulamanızdan @ ile bahsettiğinde kullanılır.
  3. Herkese açık ayrıntılar bölümündeki Simge kısmında uygulama simgenizi yükleyin (JPG veya PNG, en fazla 1 MB ve 512 piksel × 512 piksel).

  4. Aşağıdaki alanları doldurun:

    • Açıklama: Bağlı uygulamanızın temel özelliklerini ve neler yapabileceğini açıklayan kısa, tek cümlelik bir özet (30 kelimeden az) girin. Bu metin kullanıcılara gösterilir, model talimatı olarak kullanılmaz.
    • Yetenekler: Bağlı uygulamanızın gerçekleştirebileceği en az üç yüksek değerli görev girin. Daha fazla giriş eklemek için Özellik ekle'yi seçin. Yeteneklerinizin başına sayı eklemeyin. Giriş başına yalnızca bir özellik ekleyin. Kategoriniz önceden tanımlanmış özellikler içeriyorsa bunlar listenin en üstünde görünür ve değiştirilemez.
    • Örnek istemler: Kullanıcıların neler sorabileceğini anlamasına yardımcı olacak en az üç örnek istem girin. Giriş eklemek için Örnek istem ekle'yi seçin.
      • En az iki isteme @<YourAppName> ile başlayın (ör. @Order Tracker where is my last order?).
      • Uygulamanızın adıyla başlamadan (ör. Track my recent order on Order Tracker) en az bir istemde doğal bir şekilde <YourAppName> uygulamasından bahsedin.
      • Numaralı önekler (1., 2., 3.) eklemeyin veya istemleri tırnak içine ("...") almayın.

    • Çok dilli yerelleştirme: Açıklama, Yetenekler ve Örnek istemler için çeviri sağlamak istiyorsanız her yerel ayarın metnini giriş alanındaki dil etiketlerine sarmalayın. Örneğin:

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

      Connected Console, etiketlerinizi otomatik olarak doğrular ve algılanan yerel ayarları her alanın altında gösterir (ör. Found translations for 2 languages: en-US, es-ES).

    • Hizmet Şartları URL'si: Hizmet Şartlarınızın geçerli bir https:// veya http:// bağlantısını girin.

    • Politika URL'si: Gizlilik politikanızın geçerli bir https:// veya http:// bağlantısını girin.

    • Web sitesi URL'si (isteğe bağlı): İlişkilendirme amacıyla web sitenizin bağlantısını girin.

  5. Genel bakış sayfasına dönmek için sayfanın alt kısmındaki Kaydet'i seçin.

3. adım: MCP uç noktanızı girin ve alan sahipliğini doğrulayın

Google'ın MCP sunucunuza bağlanabilmesi veya araçlarınızı senkronize edebilmesi için MCP sunucunuzun uç nokta URL'sini sağlamanız ve barındırıldığı alanın sahibi olduğunuzu doğrulamanız gerekir.

MCP uç noktanızı girmek ve alan sahipliğini doğrulamak için:

  1. Bağlı uygulamanızın genel bakış sayfasındaki MCP ve araç kurulumu kartında Başlayın'ı (veya mevcut bilgileri güncelliyorsanız Yönet'i) seçin. Bu işlem, MCP kurulum akışının 1. adımını (MCP sunucusu uç noktaları) açar.
  2. MCP sunucusu uç noktanızı bağlayın bölümünde, MCP sunucusu uç noktanızın tam HTTPS URL'sini (ör. https://api.yourdomain.com/v1/mcp) girin.

  3. Alanınızı doğrulayın bölümünde, alanınız için sınama jetonu doğrulamasını tamamlayın (alanı veya üst alanını geliştirici hesabınızda zaten doğruladıysanız otomatik olarak doğrulanmış olarak gösterilir):

    1. Alan sahipliğini doğrulayın kartında Jetonu indir'i seçin. Tarayıcınız, aşağıdaki yapıya sahip google-connected-apps.json adlı bir dosya indirir:

      {
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}

    2. Bu JSON içeriğini sunucunuzda https://<your-domain>/.well-known/google-connected-apps adresine yükleyip barındırın.

      • Uç noktanın HTTPS üzerinden herkese açık olarak erişilebilir olduğundan, HTTP yönlendirmeleri olmadan doğrudan HTTP 200 OK döndürdüğünden ve verification_tokens dizisinde jetonunuzu içerdiğinden emin olun.

    3. Google Connected Console'a dönün ve Alanı doğrula'yı seçin.

    4. Doğrulama başarılı olduğunda Alan, sorgulama jetonuyla doğrulandı satırında yeşil bir onay işareti gösterilir ve altındaki Erişim kimlik bilgileri bölümünün kilidi açılır.

4. adım: Erişim kimlik bilgilerini yapılandırın

Alanınızı doğruladıktan sonra Google'ın MCP sunucunuzla nasıl kimlik doğrulaması yapacağını yapılandırın ve sunucunuzun araç tanımlarını getirin.

Erişim kimlik bilgilerini yapılandırmak için:

  1. Erişim kimlik bilgilerini sağlayın bölümünde (MCP ve araç kurulumu sayfasının 1. adımında), Başlayın'ı seçin (veya mevcut bir yapılandırmayı değiştirmek için Kimlik bilgilerini güncelle'yi seçin).

  2. Sunucunuz yetkilendirme gerektiriyor mu? bölümünde aşağıdaki seçeneklerden birini belirleyin:

    • Hayır: MCP sunucunuza kimlik doğrulama olmadan herkese açık olarak erişilebiliyorsa bu seçeneği belirleyin, ardından Onayla'yı seçin.

    • Evet: MCP sunucunuz tarafından sunulan araçlardan herhangi biri yetkilendirme gerektiriyorsa bu seçeneği belirleyin. Ardından, MCP sunucunuzun kullandığı yetkilendirme modelini seçin bölümünde kimlik doğrulama akışınızı seçin:

      • Makineler arası (OAuth İstemcisi Kimlik Bilgileri): Google'ın, son kullanıcı giriş yönlendirmeleri olmadan paylaşılan bir istemci kimliği ve gizli anahtarı kullanarak MCP sunucunuzla doğrudan iletişim kurduğu hizmetler arası kimlik doğrulama (RFC 6749) için bu seçeneği belirleyin:
        1. İstemci kimliğinizi (zorunlu) ve istemci gizli anahtarınızı (isteğe bağlı) girin.
        2. Sunucunuz /.well-known/oauth-authorization-server kullanarak bunları duyurmuyorsa isteğe bağlı olarak bir Yetkilendirme uç noktası (isteğe bağlı) ve Jeton uç noktası (isteğe bağlı) girin.
        3. İstemciyi kaydet'i (veya İstemciyi güncelle'yi) seçin.

      • Kullanıcı tarafından yetkilendirilmiş (Yetkilendirme Kodu): MCP sunucunuz, bireysel kullanıcıların Google Hesabı bağlantısı üzerinden kendi hesaplarıyla oturum açmasını ve işlemleri yetkilendirmesini gerektiriyorsa bu seçeneği belirleyin:

        1. Google'ın OAuth yönlendirme URI'lerini izin verilenler listesine ekleyin: Sağlanan yönlendirme URI'lerini izin verilenler listesine eklediğinizden emin olun banner'ında, bağlı uygulamanız için oluşturulan uygulamaya özel yönlendirme URI'lerini incelemek üzere Görüntüle'yi seçin (veya kopyalama simgesini seçin). Bunları OAuth sunucunuzun izin verilenler listesine ekleyin ve ardından Google Connected Console'a dönün.
        2. Google'ın OAuth sunucunuzla nasıl kimlik doğrulaması yapacağını seçin bölümünde, OAuth istemcinizin nasıl kaydedildiğini seçin:
          • Ön kayıtlı: OAuth sağlayıcınızda statik bir istemci kimliği ve istemci gizli anahtarı (isteğe bağlı) oluşturuyorsanız bunu seçin. İsteğe bağlı olarak Özel yetkilendirme uç noktası (isteğe bağlı) ve Özel jeton uç noktası (isteğe bağlı) da sağlayabilirsiniz.
          • İstemci kimliği meta verileri veya Dynamic Client Registration (önerilir): Sunucunuz OAuth istemci kimliği meta veri belgelerini (CIMD) veya Dynamic Client Registration'ı (RFC 7591) destekliyorsa bunu seçin. Google önce CIMD'yi kontrol eder ve .well-known keşif uç noktalarınızı kullanarak DCR'ye geri döner. İsterseniz özel yetkilendirme ve jeton uç noktaları da belirtebilirsiniz.

        3. Geliştirici kimlik bilgilerinizle kimlik doğrulayın bölümünde, yetkilendirme modeliniz olarak Kullanıcı tarafından yetkilendirilmiş'i seçtiğiniz için Google'ın araçları getirebilmesi için sunucunuzda oturum açmanız gerekir. Şunlardan birini seçin:

          • Pop-up ile kimlik doğrulama (önerilen): Kimlik doğrulama akışınızı yer paylaşımlı bir iletişim kutusunda açar. Bu, varsayılan deneyimdir.
          • Yönlendirme aracılığıyla kimlik doğrulama (yedek): Kimlik doğrulama akışınızı aynı sekmede veya pencerede tam ekran yönlendirmesi kullanarak açar. Görüntüleme kısıtlamaları veya güvenlik üstbilgileri (ör. X-Frame-Options ya da Content-Security-Policy) nedeniyle iletişim kutusu oluşturulamazsa bu seçeneği kullanın.

          Öncelikle iletişim kutusunu kullanarak kimlik doğrulamayı denemenizi öneririz. İletişim kutusunu kullanarak kimlik doğrulaması yapamıyorsanız Redirect Method'u kullanın. Seçiminiz, kullanıcıların bağlı uygulamanızı ilk kez kullandıklarında karşılaşacakları giriş deneyimini de belirler.

        4. İstemciyi kaydet'i (veya İstemciyi güncelle'yi) seçin.

5. adım: Test hesabı ayrıntılarını sağlayın (yalnızca kullanıcı tarafından yetkilendirilmiş yetkilendirme için)

Bağlı uygulamanız kimlik doğrulama gerektiriyorsa Google temsilcinize test talimatlarıyla birlikte, gerçekçi örneklenmiş verilerle önceden doldurulmuş ve iki faktörlü kimlik doğrulama (2FA) devre dışı bırakılmış, önceden doldurulmuş test kimlik bilgilerini sağlamanız gerekir. Bu sayede Google'ın inceleme ve kalite güvencesi ekibi, boş korumalı alanlar, ödeme duvarları veya iki faktörlü kimlik doğrulama sorunları nedeniyle engellenmeden aracın yürütülmesini doğrulayabilir. Google, bağlı uygulamanızı tam olarak test edemezse uygulama, inceleme sırasında reddedilebilir.

6. adım: Araçlarınızı senkronize edin

Google, bağlı uygulamanızın her sürümünü oluşturmak için sağladığınız uç noktayla senkronizasyon yaparak mevcut araçları alır ve anlık görüntü oluşturur. Bu araçlar, o sürümdeki kullanıcıların erişebileceği araçlardır. Bağlı uygulamanızın sürümü önizleme aşamasındayken ve test kullanıcıları tarafından kullanılabilirken sunucunuzda değişiklik yapmaya ve güncelleme için araçları yeniden senkronize etmeye devam edebilirsiniz. Bu işlem, araçlarınızın yeni bir anlık görüntüsünü oluşturur.

Yayınladığınızda, bağlı uygulamanızın bu sürümü için araçlarınızın en son anlık görüntüsü kullanılır. Artık araçlarınızda, açıklamalarınızda veya sunucu ayrıntılarınızda değişiklik yapamazsınız. Araçlarınızı güncellemek veya sunucunuzdaki değişiklikleri senkronize etmek için yeni bir bağlı uygulama sürümü oluşturun. Bağlı uygulamanızın her sürümü için yeni bir uç nokta oluşturmanızı öneririz.

Araçları senkronize etmek için:

  1. Senkronizasyon araçları bölümünde:

    1. Araçları senkronize et'i seçin.
    2. Oturum açmanız istenirse kullanıcılara göstermeyi planladığınız tüm araçları listeleme izinlerine sahip bir geliştirici hesabıyla kimlik doğrulaması yapın. Hesabınızın erişemediği araçlar senkronize edilmez.
    3. Bağlantı kurulduktan sonra Connected Console'da senkronize edilen araçların sayısı ve Araçları yeniden senkronize et düğmesi gösterilir.

  2. MCP ve araç kurulumunun 2. adımına geçmek için sayfanın alt kısmındaki Sonraki'yi seçin.

7. adım: Kullanıcıların uygulamanızı nasıl ve nerede deneyimleyeceğini belirleyin

MCP ve araç kurulumu sayfasının Araçlar bölümünde, bağlı uygulamanızın coğrafi olarak nerede kullanılabileceği, dili ve kullanılabilir olmasını istediğiniz Google ürünleri gibi temel parametreleri yapılandırın.

  1. Kullanılabilirlik bölümünde, Sürümü şurada kullanılabilir yap'ın yanında aşağıdaki hedefleme seçeneklerini yapılandırın:
    • Ülkeler/bölgeler: Bağlı uygulamanızın kullanılabilir olmasını istediğiniz coğrafi konumları seçin.
    • Diller: Bağlı uygulamanızın desteklediği dilleri seçin.
    • Ürünler: Bağlı uygulamanızın kullanılabileceği Google ürünlerini seçin.

  2. Kullanılabilirlik'ten sonraki Araçlar bölümünde, MCP sunucunuzdan senkronize edilen araçları inceleyin. Araçlar listesindeki herhangi bir aracı seçerek sağdaki Aracı yönet panelinde ayarlarını yapılandırın:

    • Aracı etkinleştir: Aracı bağlı uygulamanıza dahil etmek veya hariç tutmak için Aracı etkinleştir anahtarını açın ya da kapatın. Devre dışı bırakılan araçlar, bağlı uygulamanızda kullanıcıların etkileşimine sunulmaz.

    • Ek bağlam: Aracınızın çalışması için Google'dan bağlamsal sinyaller gerekip gerekmediğini seçin:

      • Yerel ayar: Kullanıcının Google Hesabı tarafından belirlenen yerel ayar.
      • Yaklaşık konum: Kullanıcının veya cihazın fiziksel olarak bulunduğu 3 kilometrekare ya da üzeri büyüklükte bir alan (ör. kullanıcının bulunduğu şehir).
      • Tam konum: 50 metre veya daha yakındaki fiziksel kullanıcı ya da cihaz konumu.

    • Kullanıcı onayı: Araç çalıştırılmadan önce açık kullanıcı onayı alınmasını zorunlu kılmak için Kullanıcı onayı gerekli'yi seçin (Aracınızın MCP ek açıklamaları destructiveHint: true değerini belirtiyorsa bu seçenek otomatik olarak önceden seçilir).

  3. MCP sunucunuz kullanıcı arayüzü kaynakları sağlıyorsa sunucunuzun kullanıcı arayüzü kaynaklarını (text/html, text/html;profile=mcp-app, text/javascript, text/css) incelemek, her kaynağa hangi araçların bağlı olduğunu doğrulamak ve İçerik Güvenliği Politikası'nı (CSP) connectDomains ve resourceDomains incelemek için Araçlar'ın yanındaki Kullanıcı arayüzü kaynakları sekmesine geçin.

  4. Sayfanın alt kısmındaki Kaydet'i seçin.

Uygulama ayrıntıları ile MCP ve araç kurulumu kaydedildikten sonra yapılandırmanız, önizleme için eklediğiniz tüm test kullanıcıları tarafından otomatik olarak kullanılabilir ve genel bakış sayfasındaki sürüm durumunuz Test kullanıcıları tarafından kullanılabilir olarak güncellenir.

8. adım: Bağlı uygulamanızı test edin

Bağlı uygulamanızı test kullanıcılarının kullanımına sunmak için kullanıcıları "Test kullanıcılarını yönetin" ekranından eklemeniz gerekir. Yalnızca test kullanıcıları listenize eklediğiniz kullanıcılar, yayınlanmamış bağlı uygulamanızı görebilir ve onunla etkileşim kurabilir. Yalnızca @gmail.com hesabı olan test kullanıcılarını ekleyebilirsiniz.

  1. Bağlı uygulamanızın genel bakış sayfasındaki Uygulamanızı test edin kartında Test kullanıcısı ekle'yi (veya daha önce eklediyseniz Test kullanıcılarını yönet'i) seçin.

  2. Test kullanıcılarını yönetin ekranında, mevcut e-posta listelerini seçin veya entegrasyonunuzu test etme yetkisi olan Google Hesaplarını eklemek için E-posta listesi oluştur'u seçin. Uygulamayı kendiniz test etmek istiyorsanız kendi e-posta adresinizi eklemeyi unutmayın.

  3. Kaydet'i seçin.

  4. Gemini uygulamasındaki test kullanıcıları, @ yazıp ardından bağlı uygulamanızın adını girerek ve menüden seçerek bağlı uygulamanızı çağırabilir. Ayrıca, soldaki gezinme çubuğunda Ayarlar ve Yardım → Bağlı uygulamalar'a giderek uygulamanızı Gemini'da görüntüleyebilir ve bağlayabilirsiniz.

  5. Entegrasyonunuzu kapsamlı bir şekilde test etmenizi öneririz:

    • Tüm örnek istemlerinizi deneyin.
    • Hem açık @<AppName> çağrıları hem de doğal dildeki sorguları test edin.
    • Uçtan uca kimlik doğrulama akışını, araç yürütmeyi, kullanıcı onay istemlerini ve tüm kullanıcı arayüzü kaynaklarını doğrulayın.

Testinizden memnun kaldığınızda bağlı uygulamanızı incelenmek üzere Google'a gönderebilirsiniz.

9. adım: Bağlı uygulamanızın incelenmesini başlatın ve onaylandıktan sonra yayınlayın

Bağlı uygulamanız tüm kullanıcıların erişimine açılmadan önce Google, entegrasyonunuzu inceler ve test eder.

Bağlı uygulamanızı incelemeye göndermek için aşağıdakileri yapın:

  1. Bağlı uygulamanızın genel bakış sayfasında, sayfanın sağ tarafındaki Sürümler kartında İncelemeye gönder'i seçin (Uygulama yapılandırmanız tamamlandıktan ve engelleyici sorunlar olmadan önizleme aşamasına geçtikten sonra etkinleştirilir).

  2. Sürümünüz incelenirken:

    • Connected Console, otomatik olarak yeni bir düzenlenebilir taslak sürüm oluşturur. Böylece test kullanıcıları uygulamanızı önizlemeye devam edebilir ve siz de incelemeyi kesintiye uğratmadan gelecekteki düzenlemeleri hazırlayabilirsiniz.
    • İncelemedeki sürümde yapılan tüm değişiklikleri kilitler.
    • İncelenmekte olan sürümün salt okunur ayrıntılarını görüntülemek veya incelemeyi iptal etmek için İnceleniyor kartındaki diğer seçenekler (⋮) düğmesini, ardından Uygulama ayrıntılarını görüntüle veya İncelemeyi iptal et'i seçin.

  3. Google incelemeyi tamamladıktan sonra bir bildirim alırsınız ve Sürümler kartı güncellenir:

    • Sorun bulunursa: Sürümler kartında Sorunlar bulundu ifadesi gösterilir. Belirli inceleme bulgularını incelemek için Sorunları görüntüle'yi seçin. Düzenlenebilir önizleme sürümünüzde yapılandırmanızı veya MCP sunucunuzu güncelleyin, düzeltmelerinizi test kullanıcılarıyla doğrulayın ve tekrar İncelemeye gönder'i seçin.
    • Onaylanırsa: Sürümler kartında Yayınlanmaya hazır ifadesi gösterilir. Bağlı uygulamanızı kullanıcılara yayınlamaya hazır olduğunuzda Yayınla'yı seçin.

Tebrikler! Bağlı uygulamanız yayınlandı ve seçtiğiniz Google ürünlerinde kullanıcılara sunuluyor.

Yayınlama sonrası ve devam eden sürüm yönetimi

Yayınlandıktan sonra Sürümler bölümünün altındaki kartta, bağlı uygulamanızın yayındaki sürüm numarası, yayınlanma tarihi ve hedeflenen ülkelerin/bölgelerin, dillerin ve ürünlerin sayısıyla birlikte Yayınlandı ifadesi gösterilir. Canlı sürümünüzün salt okunur yapılandırmasını incelemek için istediğiniz zaman Yayınlandı kartındaki diğer seçenekler (⋮) menüsünü ve Uygulama ayrıntılarını görüntüle'yi seçebilirsiniz.

Yayınlanan sürümünüz üretimde yayında kalırken soldaki Bağlı uygulamanızı düzenleyin ve test edin panelini kullanarak (veya taslak yoksa Yeni sürüm oluştur'u seçerek) yeni bir sürümdeki (Version <N+1>) güncellemeleri incelemeye ve yayınlamaya göndermeden önce bağımsız olarak yapılandırabilir, önizleyebilir ve test edebilirsiniz.