Serwer Model Context Protocol (MCP) działa jako serwer proxy między usługą zewnętrzną, która udostępnia kontekst, dane lub funkcje dużemu modelowi językowemu (LLM) lub aplikacji AI. Serwery MCP łączą aplikacje AI z systemami zewnętrznymi, takimi jak bazy danych i usługi internetowe, tłumacząc ich odpowiedzi na format zrozumiały dla aplikacji AI.
Konfiguracja serwera
Przed użyciem musisz włączyć serwery MCP i skonfigurować uwierzytelnianie. Więcej informacji o korzystaniu z zdalnych serwerów MCP Google i Google Cloud znajdziesz w omówieniu serwerów MCP Google Cloud.
Punkty końcowe serwera
Punkt końcowy usługi MCP to adres sieciowy i interfejs komunikacyjny (zwykle adres URL) serwera MCP, którego aplikacja AI (host klienta MCP) używa do nawiązywania bezpiecznego, standardowego połączenia. Jest to punkt kontaktowy, za pomocą którego LLM może prosić o kontekst, wywoływać narzędzie lub uzyskiwać dostęp do zasobu. Punkty końcowe Google MCP mogą być globalne lub regionalne.
Serwer MCP dla deweloperów Google Pay i Portfela Google ma ten globalny punkt końcowy MCP:
- https://paydeveloper.googleapis.com/mcp
Narzędzia MCP
Narzędzie MCP to funkcja lub wykonywalna możliwość, którą serwer MCP udostępnia dużemu modelowi językowemu lub aplikacji AI, aby umożliwić jej wykonanie działania w rzeczywistym świecie.
Narzędzia
Serwer MCP paydeveloper.googleapis.com ma te narzędzia:
| Narzędzia MCP | |
|---|---|
search_documentation |
Wyszukuje i pobiera najbardziej odpowiednie i aktualne sekcje z oficjalnej dokumentacji dla deweloperów Google Pay i Portfela Google oraz przykładowe kody. |
list_merchants |
Pobiera listę wszystkich profili firm sprzedawców Google Pay powiązanych z uwierzytelnionym kontem. |
list_google_pay_integrations |
Zwraca bieżący stan i szczegóły konfiguracji wszystkich integracji Google Pay powiązanych z określonym identyfikatorem sprzedawcy. Umożliwia natychmiastowe uzyskanie informacji o stanie integracji i weryfikacji dokumentów. |
create_merchant |
Tworzy nowego sprzedawcę na podstawie uwierzytelnionego konta. MUSISZ poprosić użytkownika o podanie wymaganych informacji do utworzenia sprzedawcy. Nie wywołuj tego narzędzia, dopóki nie spróbujesz zebrać wymaganych informacji do utworzenia sprzedawcy. Po utworzeniu sprzedawcy MUSISZ wyświetlić użytkownikowi adres URL Warunków korzystania z Business Console i poprosić go o ich zaakceptowanie, zanim będzie mógł wykonywać jakiekolwiek operacje na tym sprzedawcy. |
create_google_pay_integration |
Tworzy integrację Google Pay dla konkretnego sprzedawcy. Ta operacja wymaga zaakceptowania przez użytkownika Warunków korzystania z Business Console i Warunków korzystania z Google Pay API. Nie musisz ich sprawdzać z wyprzedzeniem. Jeśli nie zostały zaakceptowane, wywołanie narzędzia nie powiedzie się, a komunikat o błędzie będzie zawierać konkretne adresy URL Warunków korzystania z usługi, które należy zaakceptować. W takim przypadku wyświetl użytkownikowi adresy URL do zaakceptowania i poproś go o ponowną próbę po ich zaakceptowaniu. Aby wejść w interakcję z użytkownikiem PRZED wywołaniem narzędzia, wykonaj te czynności: 1. Najpierw poproś użytkownika o element integracji (obecnie obsługiwana jest tylko integracja internetowa). – Poproś o adres URL witryny. # – Jeśli element integracji to integracja aplikacji, poproś o nazwę pakietu aplikacji na Androida. 2. Następnie poproś użytkownika o podanie typu integracji: – jeśli użytkownik korzysta z jednego z obsługiwanych dostawców usług płatniczych (PSP: https://developers.google.com/pay/api#participating-processors), poproś go o wybranie opcji „Bramka”, w przeciwnym razie wybierz „Bezpośrednia”. 3. W przypadku WSZYSTKICH typów integracji (bezpośredniej lub z bramą płatności): – poproś użytkownika o przesłanie zrzutów ekranu (maks. 1 MB) procesu zakupu zintegrowanego z Google Pay API. Zanim uzyskają pełny dostęp wersji produkcyjnej, ich proces zakupu musi zostać sprawdzony i zatwierdzony. Przykłady: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together – MUSISZ poprosić użytkownika o przesłanie 5 zrzutów ekranu. Proś o nie PO KOLEI, aby mieć pewność, że są prawidłowo przypisane. Podczas zadawania pytań używaj TYLKO przyjaznych dla użytkownika opisów wyliczeń. 4. Jeśli typ integracji to Direct: - MUSISZ też poprosić użytkownika o przesłanie dokumentu potwierdzającego zgodność ze standardem PCI w formacie PDF. Podczas zadawania pytań używaj TYLKO przyjaznego dla użytkownika opisu wyliczenia. 5. W przypadku każdego podanego pliku poproś użytkownika o podanie ścieżki lub nazwy dokumentu, jeśli znajduje się on w bieżącym katalogu. Zmapuj go na prawidłowy typ dokumentu i ustaw w żądaniu pole nazwy na nazwę opisową (np. item_selection.png lub pci_attestation.pdf). Nie używaj tego narzędzia, dopóki nie spróbujesz zebrać wymaganych dokumentów dla wybranego typu integracji. |
list_pass_issuers |
Pobiera pełną listę wszystkich wydawców kart zarejestrowanych w konsoli biznesowej Portfela Google powiązanej z uwierzytelnionym użytkownikiem. To narzędzie zawiera niezbędne informacje dla programistów zarządzających kartami w Portfelu, takimi jak karty lojalnościowe, karty podarunkowe czy karty pokładowe. |
list_pass_classes |
Pobiera pełną listę wszystkich klas kart zarejestrowanych w konsoli biznesowej Portfela Google powiązanej z uwierzytelnionym użytkownikiem. To narzędzie zawiera niezbędne informacje dla programistów zarządzających kartami w Portfelu, takimi jak karty lojalnościowe, karty podarunkowe czy karty pokładowe. |
validate_pass_jwt |
Weryfikuje reprezentację tokena JWT karty lub niezakodowany ładunek tokena JWT jako ciąg JSON dla karty. |
query_merchant_performance |
Pobiera ogólne zbiorcze dane o skuteczności i dane po integracji dotyczące konkretnego profilu firmy sprzedawcy. |
query_merchant_error_metrics |
Pobiera szczegółowe dane o błędach dotyczące konkretnego profilu firmy sprzedawcy. To narzędzie zapewnia szczegółowy podział błędów, co pozwala deweloperom wskazywać i rozwiązywać problemy. |
Specyfikacje narzędzi MCP
Aby uzyskać specyfikacje narzędzi MCP dla wszystkich narzędzi na serwerze MCP, użyj metody tools/list. Poniższy przykład pokazuje, jak za pomocą curl wyświetlić listę wszystkich narzędzi i ich specyfikacji dostępnych obecnie na serwerze MCP.
| Żądanie curl |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |