Voraussetzungen für die Verwendung verbundener Apps

Bevor Sie beginnen, benötigen Sie Folgendes:

  • Einen bereitgestellten MCP-Server mit einem sicheren HTTPS-Endpunkt

    Ihr MCP-Server muss über HTTPS mit dem streamfähigen HTTP-Transport (z. B. https://api.yourdomain.com/v1/mcp) öffentlich erreichbar sein.

    Weitere Informationen zur Implementierung finden Sie im Entwicklerleitfaden für MCP-Server der Connected Apps Platform.

  • Sicherstellen, dass Ihr Server Anfragen von Google empfangen kann

    Wenn Ihr Server den externen Zugriff nach Quell-IP-Adresse einschränkt, setzen Sie die folgenden IP-Adressen auf die Zulassungsliste:

    • 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

    Die ausgehenden IP-Bereiche von Google können sich im Laufe der Zeit ändern. Wir empfehlen daher, sie aus den veröffentlichten Listen von Google zu lesen und Ihre Zulassungsliste regelmäßig zu aktualisieren:

  • Zugriff auf ein registriertes Entwicklerkonto in der Google Connected Console

    Nachdem Sie sich angemeldet haben, prüfen Sie, ob Sie eine der folgenden Berechtigungen für verbundene Apps in der Google Connected Console haben:

    • Verbundene Apps ansehen
    • Verbundene Apps erstellen und verwalten

    Die Nutzungsbedingungen für verbundene Apps müssen ebenfalls von einem Kontoinhaber oder Administrator akzeptiert werden. Wenn Ihre Organisation zum ersten Mal auf verbundene Apps in der Google Connected Console zugreift, muss sich ein Kontoinhaber oder Administrator anmelden und die Programmvereinbarung akzeptieren, bevor eingeladene Teammitglieder fortfahren können.

    Wenn du der Meinung bist, dass du Zugriff hast, aber keine verbundenen Apps erstellen kannst, bitte den Kontoinhaber oder Administrator, deinem Nutzerkonto auf der Seite Nutzer und Berechtigungen die Berechtigung „Verbundene Apps ansehen“ oder „Verbundene Apps erstellen und verwalten“ zu gewähren.

  • Möglichkeit, eine .well-known-Bestätigungsdatei auf Ihrer MCP-Serverdomain zu hosten

    Zur Bestätigung der Domaininhaberschaft müssen Sie eine JSON-Challenge-Tokendatei direkt (mit HTTP 200 OK und ohne Weiterleitungen) unter https://<your-domain>/.well-known/google-connected-apps bereitstellen können.

  • Verfügbare Kategorien für verbundene Apps ansehen

    Die Kategorie Ihrer verbundenen App ist mit bestimmten Funktionen verknüpft, die sie unterstützen sollte, um eine hohe Qualität der Nutzererfahrung zu gewährleisten. Sobald eine Kategorie für eine verbundene App ausgewählt wurde, kann sie nicht mehr geändert werden. Weitere Informationen

  • Einen bereitgestellten MCP-Server mit einer gültigen Endpunkt-URL

    Weitere Informationen finden Sie im Entwicklerleitfaden für MCP-Server für verbundene Apps.

  • Öffentliche Metadaten und Marken-Assets für deine verbundene App

    • Name der verbundenen App: Der Anzeigename für Ihre verbundene App, der Nutzern in Google-Produkten angezeigt wird und verwendet wird, wenn Nutzer Ihre App mit @ erwähnen.
    • Beschreibung: Eine kurze Zusammenfassung (weniger als 30 Wörter) in einem Satz, was Ihre verbundene App für Nutzer tun kann, z. B. „Letzte Käufe verfolgen, Lieferstatus prüfen und Bestellverlauf ansehen“.
    • Symbol: Ein App-Symbol mit 512 × 512 Pixeln im JPEG- oder PNG-Format mit einer maximalen Dateigröße von 1 MB (1.024 KB).
    • Funktionen: Mindestens drei hochwertige Aufgaben, die Ihre verbundene App ausführen kann, z. B. „Bestellverlauf durchsuchen“ oder „Live-Lieferstatus prüfen“, zusätzlich zu den Standardfunktionen, die durch die Kategorie Ihrer App definiert sind. Diese Informationen werden Nutzern angezeigt, damit sie entscheiden können, ob sie die Verbindung herstellen möchten. Fügen Sie am Anfang Ihrer Funktionen keine Zahlen ein.
    • Beispiel-Prompts: Mindestens drei Beispielabfragen, die Nutzern helfen, zu verstehen, was sie fragen können. Beginnen Sie mindestens zwei Beispiel-Prompts mit dem Namen Ihrer verbundenen App. Erwähnen Sie den Namen Ihrer App in mindestens einem Prompt auf natürliche Weise (d.h. ohne mit dem Namen Ihrer App zu beginnen). Fügen Sie am Anfang Ihrer Beispiel-Prompts keine Zahlen ein.
    • URL für die Nutzungsbedingungen: Eine öffentlich zugängliche URL für die Nutzungsbedingungen Ihrer verbundenen App.
    • URL der Datenschutzerklärung: Eine öffentlich zugängliche URL für die Datenschutzerklärung Ihrer verbundenen App.
    • Website-URL (optional): Eine Website für Ihre verbundene App.