Verbundene App registrieren, testen und veröffentlichen

Nachdem Sie die Voraussetzungen erfüllt haben, können Sie Ihre verbundene App registrieren, konfigurieren, testen und veröffentlichen. Gehen Sie dazu so vor:

Schritt 1: Verbundene App erstellen

So erstellst du eine verbundene App:

  1. Melden Sie sich in der Google Connected Console an.
  2. Wählen Sie auf der Startseite App erstellen aus.
  3. Gehen Sie im Dialogfeld Auswählen, was erstellt werden soll so vor:
    • Wenn Sie aufgefordert werden, die Nutzungsbedingungen für verbundene Apps zu akzeptieren, wählen Sie Nutzungsbedingungen ansehen aus, lesen Sie die Vereinbarung und akzeptieren Sie sie. Wählen Sie dann Erstellen aus. Nur ein Kontoadministrator kann die Vereinbarung akzeptieren.
    • Wählen Sie andernfalls auf der Karte Verbundene Anwendung die Option Erstellen aus.

  4. Geben Sie im Dialogfeld Gib einen Namen für deine verbundene App ein einen Namen für Ihre verbundene App ein. Dieser Name wird verwendet, um Ihre verbundene App in Google-Produkten anzuzeigen. Nutzer können Ihre verbundene App mit @ erwähnen. Wählen Sie Weiter aus.

  5. Wählen Sie im Dialogfeld Kategorie für verbundene App auswählen im Menü Kategorie auswählen die Domain, App-Kategorie oder Branche Ihrer App aus.

  6. Wählen Sie im Dialogfeld Verbindungstyp auswählen eine der folgenden Optionen aus:

    • MCP-Server: Sie können einen MCP-Server verbinden, um Ihre Dienste Nutzern von Gemini und der Google Suche im Web, unter Android und unter iOS bereitzustellen.
    • Android MCP: Sie können Ihre On-Device-Funktionen für Gemini auf Android verfügbar machen, damit Gemini Aktionen auslösen und Aufgaben für Nutzer in Ihrer App erledigen kann.

    Weitere Informationen zum Einrichten einer verbundenen Android MCP-App. Du kannst pro verbundener App nur einen Verbindungstyp auswählen. Dieser kann später nicht mehr geändert werden.

  7. Wählen Sie Verbundene App erstellen aus.

Dadurch wird die Verwaltungsübersichtsseite für Ihre verbundene App (Verbundene App einrichten und testen) geöffnet. Dort können Sie Ihre App-Details, die MCP-Serververbindung und die Tester konfigurieren.

Schritt 2: Details zur verbundenen App eingeben

So geben Sie weitere Details zu Ihrer verbundenen App an und konfigurieren, wie sie für Nutzer angezeigt wird:

  1. Wählen Sie auf der Übersichtsseite Ihrer verbundenen App in der Zeile App-Details die Option Jetzt starten aus (oder Verwalten, wenn Sie vorhandene Details aktualisieren).
  2. Prüfen Sie oben auf der Seite App-Details das Feld Name der verbundenen App. Sie können den Namen bei Bedarf ändern. Dieser Name wird Nutzern in Google-Produkten angezeigt und verwendet, wenn Nutzer deine App mit @ erwähnen.
  3. Lade im Bereich Öffentliche Details unter Symbol dein App-Symbol hoch (JPG oder PNG, bis zu 1 MB und 512 × 512 Pixel).

  4. Füllen Sie die folgenden Felder aus:

    • Beschreibung: Geben Sie eine kurze Zusammenfassung (unter 30 Wörtern) ein, die die wichtigsten Funktionen Ihrer verbundenen App und deren Möglichkeiten beschreibt. Dieser Text wird Nutzern angezeigt und nicht als Modellanweisungen verwendet.
    • Funktionen: Gib mindestens drei wichtige Aufgaben ein, die deine verbundene App ausführen kann. Wählen Sie Funktion hinzufügen aus, um weitere Einträge hinzuzufügen. Fügen Sie am Anfang Ihrer Funktionen keine Zahlen ein. Geben Sie pro Eintrag nur eine einzelne Funktion an. Wenn Ihre Kategorie vordefinierte Funktionen enthält, werden diese oben in der Liste angezeigt und können nicht geändert werden.
    • Beispielprompts: Geben Sie mindestens drei Beispielprompts ein, damit Nutzer verstehen, was sie fragen können. Wählen Sie Beispiel-Prompt hinzufügen aus, um Einträge hinzuzufügen.
      • Beginne mindestens zwei Prompts mit @<YourAppName> (z. B. @Order Tracker where is my last order?).
      • Erwähne <YourAppName> auf natürliche Weise in mindestens einem Prompt, ohne mit dem Namen deiner App zu beginnen (z. B. Track my recent order on Order Tracker).
      • Verwenden Sie keine nummerierten Präfixe (1., 2., 3.) und setzen Sie Prompts nicht in Anführungszeichen ("...").

    • Mehrsprachige Lokalisierung: Wenn Sie Übersetzungen für Beschreibung, Funktionen und Beispiel-Prompts bereitstellen möchten, setzen Sie den Text für jede Sprache im Eingabefeld in Sprach-Tags. Beispiel:

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

      Die Connected Console validiert Ihre Tags automatisch und zeigt die erkannten Sprachen unter jedem Feld an (z. B. Found translations for 2 languages: en-US, es-ES).

    • URL für die Nutzungsbedingungen: Geben Sie einen gültigen https://- oder http://-Link zu Ihren Nutzungsbedingungen ein.

    • URL der Richtlinie: Geben Sie einen gültigen https://- oder http://-Link zu Ihrer Datenschutzerklärung ein.

    • Website-URL (optional): Geben Sie einen Link zu Ihrer Website für die Zuordnung ein.

  5. Wählen Sie unten auf der Seite Speichern aus, um zur Übersichtsseite zurückzukehren.

Schritt 3: MCP-Endpunkt eingeben und Domaininhaberschaft bestätigen

Bevor Google eine Verbindung zu Ihrem MCP-Server herstellen oder Ihre Tools synchronisieren kann, müssen Sie die URL des MCP-Serverendpunkts angeben und bestätigen, dass Sie der Inhaber der Domain sind, in der er gehostet wird.

So geben Sie Ihren MCP-Endpunkt ein und bestätigen die Domaininhaberschaft:

  1. Wählen Sie auf der Übersichtsseite der verbundenen App auf der Karte MCP- und Tools-Einrichtung die Option Jetzt starten aus (oder Verwalten, wenn Sie vorhandene Details aktualisieren). Dadurch wird Schritt 1 (MCP-Serverendpunkte) des MCP-Einrichtungsvorgangs geöffnet.
  2. Geben Sie unter MCP-Serverendpunkt verbunden die vollständige HTTPS-URL Ihres MCP-Serverendpunkts ein (z. B. https://api.yourdomain.com/v1/mcp).

  3. Führen Sie unter Domain bestätigen die Challenge-Token-Bestätigung für Ihre Domain durch. Wenn Sie die Domain oder ihre übergeordnete Domain bereits in Ihrem Entwicklerkonto bestätigt haben, wird sie automatisch als bestätigt angezeigt:

    1. Wählen Sie auf der Karte Domaininhaberschaft bestätigen die Option Token herunterladen aus. Ihr Browser lädt eine Datei mit dem Namen google-connected-apps.json und der folgenden Struktur herunter:

      {
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}

    2. Laden Sie diesen JSON-Inhalt auf Ihren Server unter https://<your-domain>/.well-known/google-connected-apps hoch und hosten Sie ihn dort.

      • Der Endpunkt muss über HTTPS öffentlich erreichbar sein, HTTP 200 OK direkt ohne HTTP-Weiterleitungen zurückgeben und Ihr Token im verification_tokens-Array enthalten.

    3. Kehren Sie zur Google Connected Console zurück und wählen Sie Domain bestätigen aus.

    4. Nach erfolgreicher Bestätigung wird in der Zeile Domain mit Challenge-Token bestätigt ein grünes Häkchen angezeigt und der darunter liegende Abschnitt Anmeldedaten wird freigeschaltet.

Schritt 4: Zugriffsdaten konfigurieren

Nachdem Sie Ihre Domain bestätigt haben, konfigurieren Sie, wie sich Google bei Ihrem MCP-Server authentifiziert, und rufen Sie die Tooldefinitionen Ihres Servers ab.

So konfigurieren Sie Anmeldedaten für den Zugriff:

  1. Wählen Sie im Abschnitt Zugriffsanmeldedaten angeben (in Schritt 1 der Seite MCP- und Tools-Einrichtung) die Option Jetzt starten aus (oder Anmeldedaten aktualisieren, um eine vorhandene Konfiguration zu ändern).

  2. Wählen Sie unter Erfordert Ihr Server eine Autorisierung? eine der folgenden Optionen aus:

    • Nein: Wählen Sie diese Option aus, wenn Ihr MCP-Server ohne Authentifizierung öffentlich zugänglich ist, und wählen Sie dann Bestätigen aus.

    • Ja: Wählen Sie diese Option aus, wenn eines der Tools, die von Ihrem MCP-Server bereitgestellt werden, eine Autorisierung erfordert. Wählen Sie dann unter Select the authorization model your MCP server uses (Autorisierungsmodell auswählen, das Ihr MCP-Server verwendet) den Authentifizierungsablauf aus:

      • Maschine zu Maschine (OAuth-Clientanmeldedaten): Wählen Sie diese Option für die Dienst-zu-Dienst-Authentifizierung (RFC 6749) aus, bei der Google direkt mit Ihrem MCP-Server über eine gemeinsame Client-ID und einen gemeinsamen Clientschlüssel kommuniziert, ohne dass Weiterleitungen für die Anmeldung von Endnutzern erforderlich sind:
        1. Geben Sie Ihre Client-ID (erforderlich) und Ihren Clientschlüssel (optional) ein.
        2. Geben Sie optional einen Autorisierungsendpunkt (optional) und einen Tokenendpunkt (optional) ein, wenn Ihr Server diese nicht über /.well-known/oauth-authorization-server bewirbt.
        3. Wählen Sie Client registrieren (oder Client aktualisieren) aus.

      • Vom Nutzer delegiert (Autorisierungscode): Wählen Sie diese Option aus, wenn es erforderlich ist, dass sich einzelne Nutzer an einem MCP-Server anmelden und Aktionen mit ihren eigenen Konten über die Google-Kontoverknüpfung autorisieren:

        1. OAuth-Weiterleitungs-URIs von Google auf die Zulassungsliste setzen: Wählen Sie im Banner Achten Sie darauf, dass Sie die angegebenen Weiterleitungs-URIs auf die Zulassungsliste gesetzt haben die Option Anzeigen aus (oder wählen Sie das Kopiersymbol aus), um die genauen app-spezifischen Weiterleitungs-URIs zu prüfen, die für Ihre verbundene App generiert wurden. Fügen Sie sie der Zulassungsliste Ihres OAuth-Servers hinzu und kehren Sie dann zur Google Connected Console zurück.
        2. Wählen Sie unter Wählen Sie aus, wie sich Google bei Ihrem OAuth-Server authentifizieren soll aus, wie Ihr OAuth-Client registriert ist:
          • Vorregistriert: Wähle diese Option aus, wenn du eine statische Client-ID und einen statischen Clientschlüssel (optional) bei deinem OAuth-Anbieter generierst. Optional können Sie auch einen benutzerdefinierten Autorisierungsendpunkt (optional) und einen benutzerdefinierten Tokenendpunkt (optional) angeben.
          • Client-ID-Metadaten oder dynamische Clientregistrierung (empfohlen): Wähle diese Option aus, wenn dein Server OAuth-Client-ID-Metadatendokumente (CIMD) oder die dynamische Clientregistrierung (RFC 7591) unterstützt. Google sucht zuerst nach CIMD und greift dann auf DCR zurück, wobei Ihre .well-known-Discovery-Endpunkte verwendet werden. Optional können Sie auch benutzerdefinierte Autorisierungs- und Token-Endpunkte angeben.

        3. Unter Mit Ihren Entwickler-Anmeldedaten authentifizieren müssen Sie sich bei Ihrem Server anmelden, bevor Google Tools abrufen kann, da Sie „Vom Nutzer delegiert“ als Autorisierungsmodell ausgewählt haben. Wählen Sie eine der folgenden Optionen aus:

          • Über Pop-up authentifizieren (empfohlen): Der Authentifizierungsablauf wird in einem eingeblendeten Dialogfeld geöffnet. Dies ist die Standardeinstellung.
          • Über Weiterleitung authentifizieren (Fallback): Der Authentifizierungsablauf wird über eine Vollbildweiterleitung im selben Tab oder Fenster geöffnet. Verwenden Sie diese Option, wenn das Dialogfeld aufgrund von Anzeigebeschränkungen oder Sicherheitsheadern (z. B. X-Frame-Options oder Content-Security-Policy) nicht gerendert werden kann.

          Wir empfehlen, zuerst die Authentifizierung über das Dialogfeld zu versuchen. Wenn Sie sich nicht über das Dialogfeld authentifizieren können, verwenden Sie die Weiterleitungsmethode. Ihre Auswahl bestimmt auch, wie sich Nutzer anmelden, wenn sie Ihre verbundene App zum ersten Mal verwenden.

        4. Wählen Sie Client registrieren (oder Client aktualisieren) aus.

Schritt 5: Testkontodetails angeben (nur für die vom Nutzer delegierte Autorisierung)

Wenn für Ihre verbundene App eine Authentifizierung erforderlich ist, müssen Sie Ihrem Google-Ansprechpartner Testanmeldedaten mit realistischen Beispieldaten und deaktivierter 2-Faktor-Authentifizierung (2FA) sowie Testanleitungen zur Verfügung stellen. So kann das Überprüfungs- und QA-Team von Google die Ausführung des Tools prüfen, ohne durch leere Sandboxes, Paywalls oder 2FA-Abfragen blockiert zu werden. Wenn Google deine verbundene App nicht vollständig testen kann, wird sie möglicherweise im Rahmen der Überprüfung abgelehnt.

Schritt 6: Tools synchronisieren

Um die einzelnen Versionen Ihrer verbundenen App zu erstellen, synchronisiert Google sich mit dem von Ihnen angegebenen Endpunkt, um die verfügbaren Tools abzurufen und einen Snapshot zu erstellen. Diese Tools stehen den Nutzern in dieser Version zur Verfügung. Während sich die Version Ihrer verbundenen App in der Vorabversion befindet und für Tester verfügbar ist, können Sie weiterhin Änderungen auf Ihrem Server vornehmen und Tools neu synchronisieren, um sie zu aktualisieren. Dadurch wird ein neuer Snapshot Ihrer Tools erstellt.

Wenn Sie die App veröffentlichen, wird der aktuelle Snapshot Ihrer Tools für diese Version Ihrer verbundenen App verwendet. Sie können dann keine Änderungen mehr an Ihren Tools, Beschreibungen oder Serverdetails vornehmen. Wenn du deine Tools aktualisieren oder Änderungen von deinem Server synchronisieren möchtest, erstelle eine neue Version der verbundenen App. Wir empfehlen, für jede Version Ihrer verbundenen App einen neuen Endpunkt zu erstellen.

So synchronisieren Sie Tools:

  1. Im Abschnitt Synchronisierungstools:

    1. Wählen Sie Synchronisierungstools aus.
    2. Wenn du zur Anmeldung aufgefordert wirst, authentifiziere dich mit einem Entwicklerkonto, das die Berechtigung hat, alle Tools aufzulisten, die du Nutzern zur Verfügung stellen möchtest. Tools, auf die Ihr Konto nicht zugreifen kann, werden nicht synchronisiert.
    3. Sobald die Verbindung hergestellt ist, wird in der Connected Console die Anzahl der synchronisierten Tools sowie der Button Tools neu synchronisieren angezeigt.

  2. Wählen Sie unten auf der Seite Weiter aus, um mit Schritt 2 der Einrichtung von MCP und Tools fortzufahren.

Schritt 7: Festlegen, wie und wo Nutzer Ihre App verwenden

Konfigurieren Sie im Abschnitt Tools der Seite MCP- und Tool-Einrichtung grundlegende Parameter wie die geografische Verfügbarkeit Ihrer verbundenen App, ihre Sprache und die Google-Produkte, in denen sie verfügbar sein soll.

  1. Konfigurieren Sie unter Verfügbarkeit neben Version verfügbar machen in die folgenden Targeting-Optionen:
    • Länder/Regionen: Wählen Sie die geografischen Standorte aus, an denen Ihre verbundene App verfügbar sein soll.
    • Sprachen: Wählen Sie die Sprachen aus, die Ihre verbundene App unterstützt.
    • Produkte: Wählen Sie die Google-Produkte aus, in denen Ihre verbundene App verfügbar sein soll.

  2. Prüfen Sie im Abschnitt Tools nach Verfügbarkeit die Tools, die von Ihrem MCP-Server synchronisiert wurden. Wählen Sie ein beliebiges Tool in der Liste Tools aus, um die Einstellungen im Bereich Tool verwalten auf der rechten Seite zu konfigurieren:

    • Tool aktivieren: Mit dem Schalter Tool aktivieren können Sie das Tool in Ihrer verbundenen App ein- oder ausschließen. Deaktivierte Tools sind in Ihrer verbundenen App nicht für Nutzer verfügbar.

    • Zusätzlicher Kontext: Wählen Sie aus, ob Ihr Tool kontextbezogene Signale von Google benötigt, um zu funktionieren:

      • Sprache: Die Sprache, die im Google-Konto des Nutzers festgelegt ist.
      • Ungefährer Standort: Standort des Nutzers oder Geräts innerhalb eines Bereichs von mindestens 3 Quadratkilometern (z. B. die Stadt, in der sich der Nutzer befindet).
      • Genauer Standort: Standort des Nutzers oder Geräts mit einer Standortgenauigkeit von maximal 50 Metern.

    • Nutzerbestätigung: Wählen Sie Nutzerbestätigung erforderlich aus, um eine explizite Nutzerbestätigung vor der Ausführung des Tools anzufordern. Diese Option ist automatisch vorausgewählt, wenn in den MCP-Anmerkungen Ihres Tools destructiveHint: true angegeben ist.

  3. Wenn Ihr MCP-Server UI-Ressourcen bereitstellt, wechseln Sie zum Tab UI-Ressourcen neben Tools, um die UI-Ressourcen Ihres Servers (text/html, text/html;profile=mcp-app, text/javascript, text/css) zu prüfen, zu sehen, welche Tools mit den einzelnen Ressourcen verknüpft sind, und die Content Security Policy (CSP) connectDomains und resourceDomains zu überprüfen.

  4. Wählen Sie unten auf der Seite Speichern aus.

Nachdem sowohl die App-Details als auch die MCP- und Tools-Einrichtung gespeichert wurden, ist Ihre Konfiguration automatisch für alle Tester verfügbar, die Sie für die Vorschau hinzugefügt haben. Der Versionsstatus auf der Übersichtsseite wird dann zu Für Tester verfügbar aktualisiert.

Schritt 8: Verbundene App testen

Damit Ihre verbundene App für Tester verfügbar ist, müssen Sie sie auf dem Bildschirm „Tester verwalten“ hinzufügen. Nur Nutzer, die Sie Ihrer Testerliste hinzufügen, können Ihre unveröffentlichte verbundene App sehen und mit ihr interagieren. Sie können nur Tester hinzufügen, die ein @gmail.com-Konto haben.

  1. Wählen Sie auf der Übersichtsseite Ihrer verbundenen App auf der Karte App testen die Option Tester hinzufügen aus (oder Tester verwalten, wenn Sie bereits Tester hinzugefügt haben).

  2. Wählen Sie auf dem Bildschirm Tester verwalten vorhandene E‑Mail-Listen aus oder wählen Sie E‑Mail-Liste erstellen aus, um die Google-Konten hinzuzufügen, die zum Testen Ihrer Integration autorisiert sind. Fügen Sie Ihre eigene E‑Mail-Adresse hinzu, wenn Sie die App selbst testen möchten.

  3. Klicken Sie auf Speichern.

  4. Tester in der Gemini App können deine verbundene App aufrufen, indem sie @ gefolgt vom Namen deiner verbundenen App eingeben und sie im Menü auswählen. Sie können Ihre App auch in Gemini aufrufen und verbinden, indem Sie in der linken Navigationsleiste zu Einstellungen und Hilfe → Verbundene Apps gehen.

  5. Wir empfehlen, die Integration gründlich zu testen:

    • Probieren Sie alle Ihre Beispiel-Prompts aus.
    • Testen Sie sowohl explizite @<AppName>-Aufrufe als auch Abfragen in natürlicher Sprache.
    • Prüfen Sie den End-to-End-Authentifizierungsablauf, die Toolausführung, die Bestätigungsaufforderungen für Nutzer und alle UI-Ressourcen.

Wenn Sie mit den Tests zufrieden sind, können Sie Ihre verbundene App zur Überprüfung bei Google einreichen.

Schritt 9: Überprüfung der verbundenen App initiieren und nach der Genehmigung veröffentlichen

Bevor Ihre verbundene App für alle Nutzer verfügbar gemacht werden kann, wird Ihre Integration von Google überprüft und getestet.

So sendest du deine verbundene App zur Überprüfung:

  1. Wählen Sie auf der Übersichtsseite Ihrer verbundenen App auf der Karte Releases auf der rechten Seite Zur Überprüfung einreichen aus. Diese Option ist verfügbar, sobald die App-Konfiguration abgeschlossen ist und sich die App ohne blockierende Probleme in der Vorabversion befindet.

  2. Während Ihre Version überprüft wird:

    • Die Connected Console erstellt automatisch eine neue bearbeitbare Entwurfsversion, damit Tester weiterhin eine Vorabversion deiner App sehen können und du zukünftige Änderungen vorbereiten kannst, ohne die Überprüfung zu unterbrechen.
    • Sperrt alle Änderungen an der Version, die überprüft wird.
    • Wenn Sie die Details der Version, die gerade überprüft wird, mit Lesezugriff ansehen oder die Überprüfung abbrechen möchten, wählen Sie auf der Karte Wird überprüft das Dreipunkt-Menü ⋮ und dann App-Details ansehen oder Überprüfung abbrechen aus.

  3. Sobald Google die Überprüfung abgeschlossen hat, erhalten Sie eine Benachrichtigung und die Karte Releases wird aktualisiert:

    • Wenn Probleme gefunden werden: Auf der Karte Releases wird Probleme gefunden angezeigt. Wählen Sie Probleme ansehen aus, um die spezifischen Ergebnisse der Überprüfung zu sehen. Aktualisieren Sie Ihre Konfiguration oder Ihren MCP-Server in der bearbeitbaren Vorabversion, lassen Sie die Korrekturen von Testern prüfen und wählen Sie dann noch einmal Zur Überprüfung senden aus.
    • Wenn genehmigt: Auf der Karte Releases wird Bereit zur Veröffentlichung angezeigt. Wähle Veröffentlichen aus, wenn du deine verbundene App für Nutzer veröffentlichen möchtest.

Glückwunsch! Ihre verbundene App wurde veröffentlicht und wird für Nutzer in den von Ihnen ausgewählten Google-Produkten eingeführt.

Veröffentlichung und laufende Versionsverwaltung

Nach der Veröffentlichung wird auf der unteren Karte unter Releases die Option Veröffentlicht zusammen mit der Versionsnummer der Live-Version Ihrer verbundenen App, dem Erscheinungsdatum und der Anzahl der Zielländer/-regionen, Sprachen und Produkte angezeigt. Sie können jederzeit auf der Karte Veröffentlicht das Menü „Weitere Optionen“ (⋮) und dann App-Details ansehen auswählen, um die Konfiguration Ihres Live-Release mit Lesezugriff zu prüfen.

Während die veröffentlichte Version in der Produktion aktiv bleibt, kannst du im Bereich Verbundene App bearbeiten und testen auf der linken Seite (oder durch Auswahl von Neue Version erstellen, wenn kein Entwurf vorhanden ist) Updates in einer neuen Version (Version <N+1>) unabhängig konfigurieren, in der Vorschau ansehen und testen, bevor du sie zur Überprüfung einreichst und veröffentlichst.