Rejestrowanie, testowanie i publikowanie połączonej aplikacji

Po spełnieniu wymagań wstępnych wykonaj te czynności, aby zarejestrować, skonfigurować, przetestować i opublikować połączoną aplikację.

Krok 1. Utwórz połączoną aplikację

Aby utworzyć połączoną aplikację:

  1. Zaloguj się w Połączona konsola Google.
  2. Na stronie głównej kliknij Utwórz aplikację.
  3. W oknie Wybierz, co chcesz utworzyć:
    • Jeśli pojawi się prośba o zaakceptowanie Warunków korzystania z usługi Połączone aplikacje, kliknij Wyświetl warunki, przeczytaj i zaakceptuj umowę, a następnie kliknij Utwórz. Umowę może zaakceptować tylko administrator konta.
    • Jeśli nie, na karcie Połączona aplikacja kliknij Utwórz.

  4. W oknie Nadaj nazwę połączonej aplikacji wpisz nazwę połączonej aplikacji. Ta nazwa będzie używana do wyświetlania połączonej aplikacji w usługach Google. Użytkownicy będą mogli wspominać o połączonej aplikacji za pomocą znaku @. Kliknij Dalej.

  5. W oknie Wybierz kategorię połączonej aplikacji wybierz domenę, kategorię lub branżę aplikacji z menu Wybierz kategorię.

  6. W oknie Wybierz typ połączenia wybierz jedną z tych opcji:

    • Serwer MCP: połącz serwer MCP, aby udostępniać swoje usługi użytkownikom Gemini i wyszukiwarki w internecie oraz na urządzeniach z Androidem i iOS.
    • Android MCP: udostępnij Gemini na Androidzie funkcje działające na urządzeniu, aby umożliwić mu wywoływanie działań i wykonywanie zadań dla użytkowników w Twojej aplikacji.

    Dowiedz się więcej o konfigurowaniu połączonej aplikacji Android MCP. Na każdą połączoną aplikację możesz wybrać tylko 1 typ połączenia i nie można go później zmienić.

  7. Kliknij Create Connected app (Utwórz połączoną aplikację).

Otworzy się strona przeglądu zarządzania połączoną aplikacją (Skonfiguruj i przetestuj połączoną aplikację), na której możesz skonfigurować szczegóły aplikacji, połączenie z serwerem MCP i testerów.

Krok 2. Podaj szczegóły połączonej aplikacji

Aby podać więcej informacji o połączonej aplikacji i skonfigurować sposób, w jaki jest wyświetlana użytkownikom:

  1. Na stronie przeglądu połączonej aplikacji w wierszu Szczegóły aplikacji kliknij Rozpocznij (lub Zarządzaj, jeśli aktualizujesz dotychczasowe informacje).
  2. U góry strony Szczegóły aplikacji sprawdź pole Nazwa połączonej aplikacji. W razie potrzeby możesz zmienić nazwę. Jest ona widoczna dla użytkowników w usługach Google i używana, gdy użytkownicy wspominają o Twojej aplikacji za pomocą znaku @.
  3. W sekcji Szczegóły publiczne w obszarze Ikona prześlij ikonę aplikacji (JPG lub PNG, do 1 MB, 512 × 512 pikseli).

  4. Wypełnij te pola:

    • Opis: wpisz krótkie, jednozdaniowe podsumowanie (poniżej 30 słów), które opisuje główne funkcje połączonej aplikacji i jej możliwości. Ten tekst jest wyświetlany użytkownikom i nie jest używany jako instrukcje dla modelu.
    • Możliwości: wpisz co najmniej 3 ważne zadania, które może wykonywać połączona aplikacja. Aby dodać więcej wpisów, kliknij Dodaj funkcję. Nie umieszczaj liczb na początku nazwy możliwości. Uwzględnij tylko jedną funkcję na wpis. Jeśli kategoria obejmuje wstępnie zdefiniowane funkcje, pojawią się one u góry listy i nie będzie można ich modyfikować.
    • Przykładowe prompty: wpisz co najmniej 3 przykładowe prompty, które pomogą użytkownikom zrozumieć, o co mogą prosić. Aby dodać wpisy, kliknij Dodaj przykładowy prompt.
      • Zacznij co najmniej 2 prompty od @<YourAppName> (np. @Order Tracker where is my last order?).
      • Dodaj wzmiankę o aplikacji <YourAppName> w naturalny sposób w co najmniej 1 prompcie bez rozpoczynania go od nazwy aplikacji (np. Track my recent order on Order Tracker).
      • Nie dodawaj prefiksów liczbowych (1., 2., 3.) ani nie umieszczaj promptów w cudzysłowie ("...").

    • Lokalizacja w wielu językach: aby podać tłumaczenia pól Opis, Możliwości i Przykładowe prompty, umieść tekst w każdym języku w tagach języka w polu do wprowadzania danych. Na przykład:

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

      Połączona konsola automatycznie sprawdza tagi i wyświetla wykryte języki pod każdym polem (np. Found translations for 2 languages: en-US, es-ES).

    • Adres URL warunków korzystania z usługi: wpisz prawidłowy link https:// lub http:// do warunków korzystania z usługi.

    • URL polityki prywatności: wpisz prawidłowy link https:// lub http:// do polityki prywatności.

    • Adres URL witryny (opcjonalnie): wpisz link do swojej witryny, aby umożliwić atrybucję.

  5. Aby wrócić do strony przeglądu, u dołu strony kliknij Zapisz.

Krok 3. Wpisz punkt końcowy MCP i potwierdź własność domeny

Zanim Google będzie mogło połączyć się z Twoim serwerem MCP lub zsynchronizować narzędzia, musisz podać adres URL punktu końcowego serwera MCP i potwierdzić, że jesteś właścicielem domeny, w której jest on hostowany.

Aby wpisać punkt końcowy MCP i potwierdzić własność domeny:

  1. Na stronie przeglądu połączonej aplikacji na karcie Konfiguracja MCP i narzędzi kliknij Rozpocznij (lub Zarządzaj, jeśli aktualizujesz istniejące dane). Otworzy się krok 1 (Punkty końcowe serwera MCP) procesu konfiguracji MCP.
  2. W sekcji Połącz punkt końcowy serwera MCP wpisz pełny adres URL HTTPS punktu końcowego serwera MCP (np. https://api.yourdomain.com/v1/mcp).

  3. W sekcji Potwierdź własność domeny przejdź weryfikację tokena wyzwania dla swojej domeny (jeśli domena lub jej domena nadrzędna została już zweryfikowana na Twoim koncie dewelopera, automatycznie wyświetli się jako zweryfikowana):

    1. Na karcie Potwierdź własność domeny kliknij Pobierz token. Przeglądarka pobierze plik o nazwie google-connected-apps.json o takiej strukturze:

      {
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}

    2. Prześlij te treści JSON i hostuj je na swoim serwerze pod adresem https://<your-domain>/.well-known/google-connected-apps.

      • Upewnij się, że punkt końcowy jest publicznie dostępny przez HTTPS, zwraca bezpośrednio HTTP 200 OK bez przekierowań HTTP i zawiera token w tablicy verification_tokens.

    3. Wróć do Połączonej konsoli Google i kliknij Potwierdź domenę.

    4. Po pomyślnej weryfikacji w wierszu Domena zweryfikowana za pomocą tokena wyzwania pojawi się zielony znacznik wyboru i zostanie odblokowana sekcja Dane logowania poniżej.

Krok 4. Skonfiguruj dane logowania

Po zweryfikowaniu domeny skonfiguruj sposób uwierzytelniania Google na serwerze MCP i pobierz definicje narzędzi serwera.

Aby skonfigurować dane logowania:

  1. W sekcji Podaj dane logowania (w kroku 1 na stronie Konfiguracja MCP i narzędzi) wybierz Rozpocznij (lub Zaktualizuj dane logowania, aby zmodyfikować istniejącą konfigurację).

  2. W sekcji Czy serwer wymaga autoryzacji? wybierz jedną z tych opcji:

    • Nie: wybierz tę opcję, jeśli serwer MCP jest publicznie dostępny bez uwierzytelniania, a następnie kliknij Potwierdź.

    • Tak: wybierz tę opcję, jeśli którekolwiek z narzędzi udostępnianych przez serwer MCP wymaga autoryzacji. Następnie w sekcji Wybierz model autoryzacji używany przez serwer MCP wybierz proces uwierzytelniania:

      • Autoryzacja między maszynami (dane logowania klienta OAuth): wybierz tę opcję w przypadku uwierzytelniania między usługami (RFC 6749), gdy Google komunikuje się bezpośrednio z serwerem MCP przy użyciu udostępnionego identyfikatora klienta i klucza tajnego bez przekierowań logowania użytkownika:
        1. Wpisz identyfikator klienta (wymagany) i tajny klucz klienta (opcjonalny).
        2. Opcjonalnie wpisz Punkt końcowy autoryzacji i Punkt końcowy tokena, jeśli serwer nie rozgłasza ich za pomocą /.well-known/oauth-authorization-server.
        3. Kliknij Zarejestruj klienta (lub Zaktualizuj klienta).

      • Przekazane przez użytkownika (kod autoryzacji): wybierz tę opcję, jeśli serwer MCP wymaga od poszczególnych użytkowników logowania się i autoryzowania działań za pomocą kont osobistych przez łączenie z kontem Google:

        1. Dodaj identyfikatory URI przekierowania OAuth Google do listy dozwolonych: na banerze Upewnij się, że podane identyfikatory URI przekierowania zostały dodane do listy dozwolonych kliknij Wyświetl (lub wybierz ikonę kopiowania), aby sprawdzić dokładne identyfikatory URI przekierowania wygenerowane dla połączonej aplikacji. Dodaj je do listy dozwolonych serwera OAuth, a następnie wróć do konsoli Google Connected.
        2. W sekcji Wybierz sposób uwierzytelniania Google na serwerze OAuth wybierz sposób rejestracji klienta OAuth:
          • Wstępnie zarejestrowany: wybierz tę opcję, jeśli generujesz statyczny identyfikator klienta i tajny klucz klienta (opcjonalnie) u dostawcy OAuth. Możesz też opcjonalnie podać Niestandardowy punkt końcowy autoryzacji (opcjonalnie) i Niestandardowy punkt końcowy tokena (opcjonalnie).
          • Metadane identyfikatora klienta lub dynamiczna rejestracja klientów (DCR) (zalecane): wybierz tę opcję, jeśli serwer obsługuje dokumenty metadanych identyfikatora klienta (CIMD) lub dynamiczną rejestrację klientów (RFC 7591). Google najpierw sprawdza CIMD, a następnie przechodzi do DCR, korzystając z punktów końcowych wykrywania .well-known. Możesz też opcjonalnie określić niestandardowe punkty końcowe autoryzacji i tokena.

        3. W sekcji Uwierzytelnij za pomocą danych logowania dewelopera, ponieważ jako model autoryzacji wybrano opcję „Przekazane przez użytkownika”, musisz zalogować się na serwerze, zanim Google będzie mogło pobrać narzędzia. Masz do wyboru te opcje:

          • Uwierzytelnij przez wyskakujące okienko (metoda zalecana): otwiera proces uwierzytelniania w nałożonym oknie. Jest to domyślny sposób działania.
          • Uwierzytelnij przez przekierowanie (metoda alternatywna): otwiera proces uwierzytelniania za pomocą przekierowania do pełnego ekranu w tej samej karcie lub w tym samym oknie. Użyj tej opcji, jeśli okno nie wyświetla się z powodu ograniczeń wyświetlania lub nagłówków zabezpieczeń (takich jak X-Frame-Options lub Content-Security-Policy).

          Zalecamy, aby najpierw spróbować uwierzytelnić się za pomocą okna. Jeśli nie możesz uwierzytelnić się za pomocą okna, użyj metody przekierowania. Twój wybór określa też sposób logowania się użytkowników, gdy po raz pierwszy korzystają z połączonej aplikacji.

        4. Kliknij Zarejestruj klienta (lub Zaktualizuj klienta).

Krok 5. Podaj dane konta testowego (tylko w przypadku autoryzacji przekazanej przez użytkownika)

Jeśli połączona aplikacja wymaga uwierzytelniania, musisz podać przedstawicielowi Google dane logowania do testów, które są wstępnie wypełnione realistycznymi przykładowymi danymi i mają wyłączone uwierzytelnianie dwuskładnikowe, a także instrukcje testowania. Dzięki temu zespół Google ds. sprawdzania i kontroli jakości może zweryfikować działanie narzędzia bez blokowania przez puste piaskownice, systemy płatnego dostępu do treści czy wyzwania związane z uwierzytelnianiem dwuskładnikowym. Jeśli nie będziemy mogli w pełni przetestować połączonej aplikacji, możemy ją odrzucić podczas sprawdzania.

Krok 6. Zsynchronizuj narzędzia

Aby utworzyć każdą wersję połączonej aplikacji, Google synchronizuje się z podanym przez Ciebie punktem końcowym, aby pobrać dostępne narzędzia i zrobić zrzut ekranu. Te narzędzia będą dostępne dla użytkowników w tej wersji. Gdy wersja połączonej aplikacji jest w wersji testowej i jest dostępna dla testerów, możesz nadal wprowadzać zmiany na serwerze i ponownie synchronizować narzędzia, aby je zaktualizować. Spowoduje to utworzenie nowego zdjęcia narzędzi.

Gdy opublikujesz aplikację, w tej wersji połączonej aplikacji zostanie użyty najnowszy zrzut narzędzi. Nie będziesz już mieć możliwości wprowadzania zmian w narzędziach, opisach ani szczegółach serwera. Aby zaktualizować narzędzia lub zsynchronizować zmiany z serwerem, utwórz nową wersję połączonej aplikacji. Zalecamy utworzenie nowego punktu końcowego dla każdej wersji połączonej aplikacji.

Aby zsynchronizować narzędzia:

  1. W sekcji Narzędzia do synchronizacji:

    1. Wybierz Narzędzia do synchronizacji.
    2. Jeśli pojawi się prośba o zalogowanie, uwierzytelnij się za pomocą konta dewelopera, które ma uprawnienia do wyświetlania wszystkich narzędzi, które chcesz udostępnić użytkownikom. Narzędzia, do których Twoje konto nie ma dostępu, nie są synchronizowane.
    3. Po połączeniu w Połączonej konsoli wyświetli się liczba zsynchronizowanych narzędzi oraz przycisk Zsynchronizuj narzędzia ponownie.

  2. U dołu strony kliknij Dalej, aby przejść do kroku 2 konfiguracji MCP i narzędzi.

Krok 7. Określ, jak i gdzie użytkownicy będą korzystać z aplikacji

W sekcji Narzędzia na stronie Konfiguracja MCP i narzędzi skonfiguruj podstawowe parametry, takie jak lokalizacja geograficzna, w której połączona aplikacja jest dostępna, jej język oraz usługi Google, w których chcesz ją udostępnić.

  1. W sekcji Dostępność obok opcji Udostępnij wersję w skonfiguruj te opcje kierowania:
    • Kraje/regiony: wybierz położenia geograficzne, w których połączona aplikacja ma być dostępna.
    • Języki: wybierz języki obsługiwane przez połączoną aplikację.
    • Usługi: wybierz usługi Google, w których połączona aplikacja będzie dostępna.

  2. W sekcji Narzędzia po opcji Dostępność sprawdź narzędzia zsynchronizowane z serwera MCP. Wybierz dowolne narzędzie na liście Narzędzia, aby skonfigurować jego ustawienia w panelu Zarządzaj narzędziem po prawej stronie:

    • Włącz narzędzie: użyj przełącznika Włącz narzędzie, aby uwzględnić narzędzie w połączonej aplikacji lub je z niej wykluczyć. Wyłączone narzędzia nie będą dostępne dla użytkowników w połączonej aplikacji.

    • Dodatkowy kontekst: wybierz, czy narzędzie wymaga do działania sygnałów kontekstowych od Google:

      • Ustawienia regionalne: ustawienia regionalne określone przez konto Google użytkownika.
      • Przybliżona lokalizacja: fizyczna lokalizacja użytkownika lub urządzenia na obszarze co najmniej 3 kilometrów kwadratowych (np. miasto, w którym znajduje się użytkownik).
      • Dokładna lokalizacja: fizyczna lokalizacja użytkownika lub urządzenia z dokładnością do 50 metrów lub większą.

    • Potwierdzenie użytkownika: wybierz Wymagane potwierdzenie użytkownika, aby wymagać wyraźnego potwierdzenia przez użytkownika przed wykonaniem narzędzia (jest to automatycznie wstępnie wybrane, jeśli adnotacje MCP narzędzia określają destructiveHint: true).

  3. Jeśli serwer MCP udostępnia zasoby interfejsu, przejdź na kartę Zasoby interfejsu obok karty Narzędzia, aby sprawdzić zasoby interfejsu serwera (text/html, text/html;profile=mcp-app, text/javascript, text/css), zweryfikować, które narzędzia są połączone z poszczególnymi zasobami, oraz przejrzeć zasady zabezpieczeń treści (standard) Content Security Policy (CSP) connectDomains i resourceDomains.

  4. U dołu strony kliknij Zapisz.

Po zapisaniu szczegółów aplikacji oraz konfiguracji MCP i narzędzi konfiguracja będzie automatycznie dostępna dla wszystkich testerów, których dodano do podglądu, a stan wersji na stronie przeglądu zmieni się na Dostępna dla testerów.

Krok 8. Przetestuj połączoną aplikację

Aby udostępnić połączoną aplikację testerom, musisz ich dodać na ekranie Zarządzaj testerami. Tylko użytkownicy dodani do listy testerów mogą wyświetlać nieopublikowaną połączoną aplikację i korzystać z niej. Możesz dodawać tylko testerów, którzy mają konto @gmail.com.

  1. Na stronie przeglądu połączonej aplikacji na karcie Przetestuj aplikację kliknij Dodaj testerów (lub Zarządzaj testerami, jeśli masz już dodanych testerów).

  2. Na ekranie Zarządzaj testerami wybierz istniejące listy e-mailowe lub kliknij Utwórz listę e-mailową, aby dodać konta Google uprawnione do testowania integracji. Jeśli chcesz przetestować aplikację, dodaj też swój adres e-mail.

  3. Kliknij Zapisz.

  4. Testerzy w aplikacji Gemini mogą wywołać połączoną aplikację, wpisując @, a następnie nazwę połączonej aplikacji i wybierając ją z menu. Możesz też wyświetlić i połączyć aplikację w Gemini, klikając Ustawienia i pomoc → Połączone aplikacje na pasku nawigacyjnym po lewej stronie.

  5. Zalecamy dokładne przetestowanie integracji:

    • Wypróbuj wszystkie przykładowe prompty.
    • Przetestuj zarówno bezpośrednie wywołania @<AppName>, jak i zapytania w języku naturalnym.
    • Sprawdź cały proces uwierzytelniania, działanie narzędzia, prośby o potwierdzenie od użytkownika i wszystkie zasoby interfejsu.

Gdy uznasz, że testy przebiegły pomyślnie, możesz przesłać połączoną aplikację do Google w celu sprawdzenia.

Krok 9. Rozpocznij proces sprawdzania połączonej aplikacji i opublikuj ją po zatwierdzeniu

Zanim Twoja połączona aplikacja zostanie udostępniona wszystkim użytkownikom, Google sprawdzi i przetestuje integrację.

Aby przesłać połączoną aplikację do sprawdzenia:

  1. Na stronie przeglądu połączonej aplikacji, na karcie Wersje po prawej stronie, kliknij Wyślij do sprawdzenia (opcja ta jest dostępna po zakończeniu konfiguracji aplikacji i w trybie podglądu, jeśli nie ma problemów blokujących).

  2. Podczas sprawdzania wersji:

    • Połączona konsola automatycznie tworzy nową wersję roboczą, którą można edytować, dzięki czemu testerzy mogą nadal wyświetlać podgląd aplikacji, a Ty możesz przygotowywać przyszłe zmiany bez zakłócania procesu sprawdzania.
    • Blokuje wszelkie zmiany w wersji w trakcie sprawdzania.
    • Aby wyświetlić szczegóły wersji w trakcie sprawdzania (tylko do odczytu) lub anulować sprawdzanie, na karcie W trakcie sprawdzania kliknij przycisk Więcej opcji (⋮) i wybierz Wyświetl szczegóły aplikacji lub Anuluj sprawdzanie.

  3. Gdy Google zakończy sprawdzanie, otrzymasz powiadomienie, a karta Wersje zostanie zaktualizowana:

    • Jeśli zostaną wykryte problemy: na karcie Wersje pojawi się komunikat Wykryto problemy. Kliknij Wyświetl problemy, aby sprawdzić konkretne wyniki weryfikacji. Zaktualizuj konfigurację lub serwer MCP w edytowalnej wersji testowej, sprawdź poprawki z testerami i ponownie kliknij Wyślij do sprawdzenia.
    • Jeśli zostanie zatwierdzona: na karcie Wersje pojawi się komunikat Gotowa do opublikowania. Gdy wszystko będzie gotowe do udostępnienia połączonej aplikacji użytkownikom, kliknij Opublikuj.

Gratulacje! Twoja połączona aplikacja została opublikowana i jest wdrażana dla użytkowników w wybranych przez Ciebie usługach Google.

Zarządzanie wersjami po opublikowaniu i później

Po opublikowaniu na dolnej karcie w sekcji Wersje pojawi się informacja Opublikowano wraz z numerem wersji połączonej aplikacji, datą publikacji oraz liczbą krajów/regionów, języków i produktów, na które kierowana jest aplikacja. W dowolnym momencie możesz kliknąć menu Więcej opcji (⋮) na karcie Opublikowano i wybrać Wyświetl szczegóły aplikacji, aby sprawdzić konfigurację wersji produkcyjnej (tylko do odczytu).

Podczas gdy opublikowana wersja pozostaje aktywna w ścieżce produkcyjnej, możesz użyć panelu Edytuj i przetestuj połączoną aplikację po lewej stronie (lub wybrać Utwórz nową wersję, jeśli nie ma wersji roboczej), aby skonfigurować, wyświetlić podgląd i przetestować aktualizacje w nowej wersji (Version <N+1>) niezależnie, zanim wyślesz ją do sprawdzenia i opublikowania.