Wymagania dotyczące korzystania z połączonych aplikacji

Zanim zaczniesz, upewnij się, że:

  • Wdrożony serwer MCP z bezpiecznym punktem końcowym HTTPS.

    Serwer MCP musi być publicznie dostępny przez HTTPS przy użyciu transportu Streamable HTTP (np. https://api.yourdomain.com/v1/mcp).

    Szczegółowe informacje o implementacji znajdziesz w przewodniku dla programistów po serwerze MCP platformy Connected Apps Platform.

  • Sprawdzanie, czy serwer może odbierać żądania od Google

    Jeśli Twój serwer ogranicza dostęp zewnętrzny według źródłowego adresu IP, dodaj te adresy IP do listy dozwolonych:

    • 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

    Zakresy wychodzących adresów IP Google mogą się zmieniać, dlatego zalecamy odczytywanie ich z opublikowanych list Google i regularne odświeżanie listy dozwolonych:

  • Dostęp do zarejestrowanego konta dewelopera w Połączonej konsoli Google

    Po zalogowaniu się upewnij się, że masz jedno z tych uprawnień do połączonych aplikacji w Połączonej konsoli Google:

    • Wyświetl połączone aplikacje
    • Tworzenie połączonych aplikacji i zarządzanie nimi

    Warunki korzystania z usługi Połączone aplikacje musi też zaakceptować właściciel lub administrator konta. Gdy Twoja organizacja po raz pierwszy uzyska dostęp do połączonych aplikacji w Połączonej konsoli Google, właściciel konta lub administrator musi się zalogować i zaakceptować umowę programu, zanim zaproszeni członkowie zespołu będą mogli kontynuować.

    Jeśli uważasz, że masz dostęp, ale nie możesz tworzyć połączonych aplikacji, poproś właściciela konta lub administratora o przyznanie Twojemu kontu użytkownika uprawnienia „Wyświetlanie połączonych aplikacji” lub „Tworzenie połączonych aplikacji i zarządzanie nimi” na stronie Użytkownicy i uprawnienia.

  • Możliwość hostowania pliku weryfikacyjnego .well-known w domenie serwera MCP.

    Aby potwierdzić własność domeny, musisz mieć możliwość bezpośredniego udostępniania pliku tokena wyzwania JSON (z HTTP 200 OK i bez przekierowań) pod adresem https://<your-domain>/.well-known/google-connected-apps.

  • Sprawdzanie dostępnych kategorii połączonych aplikacji

    Kategoria połączonej aplikacji jest powiązana z określonymi funkcjami, które aplikacja powinna obsługiwać, aby zapewnić użytkownikom jak najlepsze wrażenia. Po wybraniu kategorii połączonej aplikacji nie można jej zmienić. Więcej informacji

  • Wdrożony serwer MCP z prawidłowym adresem URL punktu końcowego.

    Więcej informacji znajdziesz w przewodniku dla programistów po serwerze MCP połączonych aplikacji.

  • Metadane i zasoby marki widoczne publicznie w przypadku połączonej aplikacji

    • Nazwa połączonej aplikacji: wyświetlana nazwa połączonej aplikacji, która jest widoczna dla użytkowników w usługach Google i używana, gdy użytkownicy wspominają o Twojej aplikacji za pomocą @.
    • Opis: zwięzłe, jednozdaniowe podsumowanie (poniżej 30 słów) tego, co połączona aplikacja może zrobić dla użytkowników, np. „Śledź ostatnie zakupy, sprawdzaj stan dostawy i wyświetlaj historię zamówień”.
    • Ikona: ikona aplikacji o wymiarach 512 × 512 pikseli w formacie JPEG lub PNG, o maksymalnym rozmiarze pliku 1 MB (1024 KB).
    • Możliwości: co najmniej 3 ważne zadania, które połączona aplikacja może wykonywać, np. „Wyszukaj historię zamówień” lub „Sprawdź stan dostawy na żywo”, oprócz domyślnych funkcji określonych przez kategorię aplikacji. Te informacje są wyświetlane użytkownikom, aby mogli łatwiej zdecydować, czy połączyć aplikację. Nie umieszczaj liczb na początku nazwy możliwości.
    • Przykładowe prompty: co najmniej 3 przykładowe zapytania, które pomogą użytkownikom zrozumieć, o co mogą prosić. Zacznij co najmniej 2 przykładowe prompty od nazwy połączonej aplikacji. Dodaj wzmiankę o nazwie aplikacji w naturalny sposób w co najmniej 1 prompcie (czyli bez rozpoczynania go od nazwy aplikacji). Nie dodawaj liczb na początku przykładowych promptów.
    • Adres URL warunków korzystania z usługi: publicznie dostępny adres URL warunków korzystania z połączonej aplikacji.
    • URL polityki prywatności: publicznie dostępny adres URL polityki prywatności połączonej aplikacji.
    • Adres URL witryny (opcjonalnie): witryna połączonej aplikacji.