Jest to serwer MCP, który udostępnia narzędzia deweloperom Pay.
Serwer Model Context Protocol (MCP) działa jako serwer proxy między usługą zewnętrzną, która udostępnia kontekst, dane lub możliwości 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 ze zdalnych serwerów MCP Google i Google Cloud znajdziesz w artykule Omówienie 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, w którym LLM może poprosić o kontekst, wywołać narzędzie lub uzyskać dostęp do zasobu. Punkty końcowe MCP Google mogą być globalne lub regionalne.
Serwer MCP API serwera MCP 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 możliwość wykonywania działań, którą serwer MCP udostępnia LLM lub aplikacji AI, aby umożliwić im wykonywanie działań w świecie rzeczywistym.
Narzędzia
Serwer MCP paydeveloper.googleapis.com ma te narzędzia:
| Narzędzia MCP | |
|---|---|
search_documentation |
Wyszukuje i pobiera najbardziej odpowiednie, aktualne sekcje z oficjalnej dokumentacji dla deweloperów Google Pay i Portfela Google oraz przykłady kodu. |
list_merchants |
Pobiera pełną listę wszystkich sprzedawców Google Pay powiązanych z uwierzytelnionym kontem. W zależności od roli użytkownika u sprzedawcy administratorzy mogą wyświetlać pełne szczegółowe informacje o sprzedawcy, a deweloperzy – tylko podstawowe informacje. |
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 sprawdzaniu dokumentów. Dodatkowo MUSISZ poinformować użytkownika, że integrację można utworzyć lub zaktualizować w Konsoli Google Pay i Portfela Google (https://pay.google.com/business/console/). |
create_merchant |
Tworzy nowego sprzedawcę na uwierzytelnionym koncie. MUSISZ poprosić użytkownika o podanie informacji wymaganych do utworzenia sprzedawcy. Jednym z wymaganych pól jest kod kategorii sprzedawcy (MCC). Lista kodów MCC jest długa, więc możesz wyświetlić podzbiór typowych opcji, ale MUSISZ poinformować użytkownika, że dostępne są inne opcje i że może poprosić o pełną listę (np. wyświetlając „X więcej opcji” lub podobną wskazówkę). Dodatkowo poinformuj użytkownika, że jeśli zna 4-cyfrowy kod MCC (np. 5499), może go podać bezpośrednio, i zachęć go do tego. Nie wywołuj tego narzędzia, dopóki nie spróbujesz zebrać informacji wymaganych do utworzenia sprzedawcy. Po utworzeniu sprzedawcy MUSISZ wyświetlić użytkownikowi adres URL Warunków korzystania z Konsoli Business i poinstruować go, aby je zaakceptował, zanim będzie mógł wykonywać jakiekolwiek operacje na tym sprzedawcy. |
list_pass_issuers |
Pobiera pełną listę wszystkich wydawców kart zarejestrowanych w Konsoli Business Portfela Google powiązanych z uwierzytelnionym użytkownikiem. To narzędzie zawiera podstawowe informacje dla deweloperó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 Business Portfela Google powiązanych z uwierzytelnionym użytkownikiem. To narzędzie zawiera podstawowe informacje dla deweloperów zarządzających kartami w Portfelu, takimi jak karty lojalnościowe, karty podarunkowe czy karty pokładowe. |
validate_pass_jwt |
Sprawdza poprawność reprezentacji JWT karty lub niezakodowanego ładunku JWT jako ciągu JSON dla karty. |
query_merchant_performance |
Pobiera ogólne zagregowane dane o skuteczności i dane po integracji dla konkretnego profilu firmy sprzedawcy. |
query_merchant_error_metrics |
Pobiera szczegółowe dane o błędach dla konkretnego profilu firmy sprzedawcy. To narzędzie zawiera szczegółowe zestawienie błędów, dzięki czemu deweloperzy mogą dokładnie określić i rozwiązać problemy. |
update_merchant |
Aktualizuje określone pola istniejącego sprzedawcy. Obsługiwane pola to display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email i customer_support_phone. |
list_principals |
Wyświetla listę podmiotów (użytkowników), które mają dostęp do konkretnego sprzedawcy. Ta operacja wymaga dostępu administratora do sprzedawcy. |
set_principal_role |
Ustawia rolę podmiotu (użytkownika) u sprzedawcy lub dodaje nowy podmiot z określoną rolą. Do podmiotu jest wysyłane zaproszenie e-mailem, które musi on zaakceptować, zanim jego dostęp stanie się aktywny. Ta operacja wymaga dostępu administratora do sprzedawcy. |
delete_principal |
Usuwa dostęp podmiotu (użytkownika) do konkretnego sprzedawcy. Ta operacja wymaga dostępu administratora do sprzedawcy. |
Pobieranie specyfikacji narzędzi MCP
Aby pobrać specyfikacje narzędzi MCP dla wszystkich narzędzi na serwerze MCP, użyj metody tools/list. Poniższy przykład pokazuje, jak użyć curl, aby 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 }' |