Bağlı uygulamaları kullanmanın ön koşulları

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • Güvenli bir HTTPS uç noktasına sahip, dağıtılmış bir MCP sunucusu

    MCP sunucunuza, Streamable HTTP aktarımı (ör. https://api.yourdomain.com/v1/mcp) kullanılarak HTTPS üzerinden herkese açık olarak erişilebilmelidir.

    Uygulama ayrıntıları için Bağlı Uygulamalar Platformu MCP sunucusu geliştirici kılavuzuna bakın.

  • Sunucunuzun Google'dan istek alabildiğinden emin olun

    Sunucunuz harici erişimi kaynak IP'ye göre kısıtlıyorsa aşağıdaki IP adreslerini izin verilenler listesine ekleyin:

    • 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

    Google'ın giden IP aralıkları zaman içinde değişebilir. Bu nedenle, Google'ın yayınlanan listelerinden bu aralıkları okumanızı ve izin verilenler listenizi düzenli olarak yenilemenizi öneririz:

  • Google Connected Console'da kayıtlı bir geliştirici hesabına erişim

    Oturum açtıktan sonra Google Connected Console'da aşağıdaki Bağlı Uygulamalar izinlerinden birine sahip olduğunuzdan emin olun:

    • Bağlı Uygulamaları Görüntüleme
    • Bağlı Uygulamalar oluşturma ve yönetme

    Bağlı Uygulamalar Hizmet Şartları'nın da hesap sahibi veya yönetici tarafından kabul edilmesi gerekir. Kuruluşunuz Google Connected Console'da bağlı uygulamalara ilk kez eriştiğinde, davet edilen ekip üyelerinin devam edebilmesi için bir hesap sahibinin veya yöneticinin oturum açması ve program sözleşmesini kabul etmesi gerekir.

    Erişiminiz olduğunu düşünmenize rağmen bağlı uygulama oluşturamıyorsanız hesap sahibinizden veya yöneticinizden, Kullanıcılar ve izinler sayfasında kullanıcı hesabınıza "Bağlı uygulamaları görüntüleme" ya da "Bağlı uygulama oluşturma ve yönetme" izni vermesini isteyin.

  • MCP sunucunuzun alanında .well-known doğrulama dosyası barındırma olanağı

    Alan adı sahipliğini doğrulamak için bir JSON sorgulama jetonu dosyasını doğrudan (HTTP 200 OK ile ve yönlendirme olmadan) https://<your-domain>/.well-known/google-connected-apps adresinde sunabilmeniz gerekir.

  • Mevcut bağlı uygulama kategorilerini inceleme

    Bağlı uygulamanızın kategorisi, yüksek kaliteli bir kullanıcı deneyimi sunmak için desteklemesi gereken belirli özelliklerle ilişkilendirilir. Bağlı bir uygulama için kategori seçildikten sonra değiştirilemez. Daha fazla bilgi edinin.

  • Geçerli bir uç nokta URL'sine sahip, dağıtılmış bir MCP sunucusu

    Daha fazla bilgi için Bağlı uygulamalar MCP sunucusu geliştirici kılavuzuna bakın.

  • Bağlı uygulamanızın herkese açık meta verileri ve marka varlıkları

    • Bağlı uygulama adı: Bağlı uygulamanızın Google ürünlerinde kullanıcılara gösterilen ve kullanıcılar uygulamanızdan @ ile bahsettiğinde kullanılan görünen ad.
    • Açıklama: Bağlı uygulamanızın kullanıcılar için neler yapabileceğini özetleyen kısa, tek cümlelik bir özet (30 kelimeden az). Örneğin, "Son satın alma işlemlerinizi takip edin, teslimat durumunu kontrol edin ve sipariş geçmişinizi görüntüleyin."
    • Simge: JPEG veya PNG biçiminde, maksimum dosya boyutu 1 MB (1.024 KB) olan 512 x 512 piksellik bir uygulama simgesi.
    • Özellikler: Bağlı uygulamanızın, uygulamanızın kategorisine göre tanımlanan varsayılan özelliklerin dışında gerçekleştirebileceği en az 3 yüksek değerli görev (ör. "Sipariş geçmişinizde arama yapma" veya "Canlı teslimat durumunu kontrol etme"). Bunlar, kullanıcıların bağlanıp bağlanmamaya karar vermesine yardımcı olmak için gösterilir. Yeteneklerinizin başına sayı eklemeyin.
    • Örnek istemler: Kullanıcıların neler sorabileceğini anlamasına yardımcı olan en az 3 örnek sorgu. En az 2 örnek istemi bağlı uygulamanızın adıyla başlatın. En az 1 istemde uygulamanızın adından doğal bir şekilde bahsedin (ör. isteme uygulamanızın adıyla başlamadan). Örnek istemlerinizin başına sayı eklemeyin.
    • Hizmet Şartları URL'si: Bağlı uygulamanızın Hizmet Şartları'nın herkese açık URL'si.
    • Gizlilik Politikası URL'si: Bağlı uygulamanızın Gizlilik Politikası'nın herkese açık URL'si.
    • Web sitesi URL'si (isteğe bağlı): Bağlı uygulamanızın web sitesi.