Połącz się z serwerem MCP dla programistów Google Pay i Portfela

Podgląd

Ta usługa podlega „Warunkom oferty przed GA” z sekcji Ogólne warunki korzystania z usługi w Szczegółowych warunkach korzystania z usługi. Usługi w wersji przed GA są dostępne w stanie „takim, jaki jest” i mogą mieć ograniczone wsparcie. Więcej informacji znajdziesz w opisach etapu uruchamiania.

Serwer MCP dla deweloperów Google Pay i Portfela Google umożliwia narzędziom deweloperskim opartym na AI dostęp do danych deweloperskich Google Pay i Portfela Google, wyszukiwanie oficjalnej dokumentacji i zarządzanie integracjami.

Protokół Model Context Protocol (MCP) standaryzuje sposób, w jaki duże modele językowe (LLM) oraz aplikacje lub agenci AI łączą się z zewnętrznymi źródłami danych. Serwery MCP umożliwiają korzystanie z narzędzi, zasobów i promptów w celu wykonywania działań i pobierania zaktualizowanych danych z usługi backendu.

Serwer MCP dla deweloperów Google Pay i Portfela umożliwia:

• Dokumentacja wyszukiwarki: znajdziesz w niej aktualne wskazówki i przykłady kodu z oficjalnych dokumentów Google Pay i Portfela Google.
• Zarządzanie integracjami: sprawdzaj stan integracji i włączaj interfejsy API na koncie sprzedawcy.
• Sprawdzanie skuteczności: uzyskuj dostęp do zagregowanych danych o skuteczności i danych o błędach na koncie sprzedawcy.

• Zarządzanie kartami: wyświetlanie listy wydawców kart i klas w Portfelu Google.

  Uwaga: szczegóły dotyczące dostępnych narzędzi MCP i ich opisy znajdziesz w dokumentacji Pay & Wallet Developer.

Przykładowe prompty

Możesz użyć tych promptów w asystencie AI:

• „Wyświetl moje konta Google Pay”.
• „Jaki jest stan moich integracji z Google Pay?”
• „Jak mogę zintegrować Google Pay z Reactem?”
• „Pokaż mi dane o błędach Google Pay w mojej integracji z ostatnich 30 dni”.
• „Wyświetl moje klasy kart w Portfelu Google”.

Zanim zaczniesz

Aby korzystać z serwera MCP dla deweloperów Google Pay i Portfela Google, musisz utworzyć projekt Google Cloud i włączyć serwer MCP dla deweloperów Google Pay i Portfela Google oraz interfejsy API Portfela Google.

1. W konsoli Cloud na stronie selektora projektu wybierz lub utwórz projekt Google Cloud.

   Otwórz selektor projektów

2. Włącz interfejsy API Google Wallet i Pay & Wallet Developer.

   Role wymagane do włączenia interfejsów API

   Aby włączyć interfejsy API, musisz mieć rolę administratora wykorzystania usług (roles/serviceusage.serviceUsageAdmin), która zawiera uprawnienie serviceusage.services.enable. Dowiedz się, jak przyznawać role

   Włączanie interfejsów API

Wymagane role

Aby uzyskać uprawnienia potrzebne do korzystania z serwera MCP Google Pay & Wallet Developer, poproś administratora o przypisanie Ci tych ról Identity and Access Management (IAM) w projekcie Google Cloud, w którym chcesz włączyć serwer MCP Google Pay & Wallet Developer:

• Wykonuj wywołania narzędzia MCP: użytkownik narzędzia MCP (roles/mcp.toolUser)

Więcej informacji o przyznawaniu ról znajdziesz w artykule o zarządzaniu dostępem do projektów, folderów i organizacji.

Uwierzytelnianie i autoryzacja

Serwery MCP Google Pay i Portfela Google używają protokołu OAuth 2.0 z  usługą Identity and Access Management (IAM) do uwierzytelniania i autoryzacji. Wszystkie tożsamości są obsługiwane na potrzeby uwierzytelniania na serwerach MCP.

Serwer MCP Google Pay & Wallet Developer nie akceptuje kluczy API.

Zalecamy utworzenie osobnej tożsamości dla agentów korzystających z narzędzi MCP, aby można było kontrolować i monitorować dostęp do zasobów. Więcej informacji o uwierzytelnianiu znajdziesz w artykule Uwierzytelnianie na serwerach MCP.

Zakresy protokołu OAuth serwera MCP dla programistów Google Pay i Portfela

OAuth 2.0 używa zakresów i danych logowania, aby określić, czy uwierzytelniony podmiot ma uprawnienia do wykonania określonej czynności na zasobie. Więcej informacji o zakresach protokołu OAuth 2.0 w Google znajdziesz w artykule Używanie protokołu OAuth 2.0 na potrzeby dostępu do interfejsów API Google.

Serwer MCP dewelopera Google Pay i Portfela Google ma te zakresy OAuth narzędzia MCP:

Identyfikator URI zakresu dla gcloud CLI	Opis
https://www.googleapis.com/auth/paydeveloper.merchant	Zarządzanie danymi sprzedawcy w Google Pay.
https://www.googleapis.com/auth/paydeveloper.issuer.readonly	odczytywać dane wydawcy z Portfela Google;

Tworzenie identyfikatora klienta i tajnego klucza OAuth 2.0

Aby utworzyć identyfikator klienta OAuth 2.0 i tajny klucz klienta, wykonaj te czynności:

1. W konsoli interfejsów API Google kliknij Google Auth Platform > Klienci > Utwórz klienta.

   Otwórz stronę Utwórz klienta

   Jeśli nie masz jeszcze aplikacji, musisz utworzyć nową w platformie uwierzytelniania Google. Na stronie przeglądu kliknij przycisk „Rozpocznij” i podaj wymagane informacje.

2. Na liście Typ aplikacji wybierz odpowiedni typ aplikacji AI:

   • W przypadku Antigravity, Claude.ai, Claude Code i ChatGPT wybierz Aplikacja internetowa.
   • W przypadku interfejsu wiersza poleceń Gemini i VS Code wybierz Aplikacja na komputer.

3. W polu Nazwa wpisz nazwę aplikacji.

4. Jeśli wybrano Aplikacja internetowa, w sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie dodaj wymagany identyfikator URI przekierowania dla aplikacji z AI:

   Antigravity

   https://antigravity.google/oauth-callback

   Claude.ai

   https://claude.ai/api/mcp/auth_callback

   Claude Code

   http://localhost:CLAUDE_REDIRECT_PORT/callback

   ChatGPT

   Możesz na razie pozostawić pole redirect_uri puste. Gdy aplikacja zostanie utworzona, ChatGPT wygeneruje znak redirect_uri (patrz Konfigurowanie aplikacji AI poniżej).

   Uwaga: w sekcji Autoryzowane źródła JavaScript kliknij + Dodaj identyfikator URI, a następnie w polu Identyfikatory URI dodaj https://chatgpt.com.

5. Kliknij Utwórz. Po utworzeniu tajny klucz klienta jest wyświetlany tylko raz. Skopiuj go i zapisz w bezpiecznym miejscu.

Konfigurowanie aplikacji AI

Następnie musisz podać w aplikacji AI szczegóły konfiguracji serwera.

Interfejs wiersza poleceń Gemini

1. Aby skonfigurować interfejs wiersza poleceń Gemini, dodaj do pliku `~/.gemini/settings.json` te informacje:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "httpUrl": "https://paydeveloper.googleapis.com/mcp",
         "authProviderType": "dynamic_discovery",
         "oauth": {
           "enabled": true,
           "clientId": "GEMINI_CLI_CLIENT_ID",
           "clientSecret": "GEMINI_CLI_CLIENT_SECRET",
           "scopes": [
             "https://www.googleapis.com/auth/paydeveloper.merchant",
             "https://www.googleapis.com/auth/paydeveloper.issuer.readonly"
           ]
         }
       }
     }
   }

2. Uruchom /mcp auth google-pay-wallet-dev, aby rozpocząć proces uwierzytelniania serwera MCP dla deweloperów Google Pay i Portfela.

Antigravity

Aby skonfigurować Antigravity do korzystania z serwera MCP:

1. W Antigravity kliknij menu Opcje dodatkowe w panelu Agent > Serwery MCP > Zarządzaj serwerami MCP.
2. U góry panelu Zarządzaj serwerami MCP kliknij Wyświetl konfigurację w postaci nieprzetworzonej, aby edytować plik mcp_config.json:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "serverUrl": "https://paydeveloper.googleapis.com/mcp",
         "oauth": {
           "clientId": "ANTIGRAVITY_CLIENT_ID",
           "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
         }
       }
     }
   }

3. Wróć do Zarządzaj serwerami MCP i kliknij Odśwież. Kliknięcie Uwierzytelnij otwiera kartę Dostosowywanie w Ustawieniach agenta.
4. Kliknij Uwierzytelnij i przejdź proces OAuth.
5. Skopiuj kod autoryzacji i prześlij go w oknie Ustawienia agenta.

VS Code

1. Aby skonfigurować VS Code (Copilot), edytuj plik .vscode/mcp.json w obszarze roboczym:

   {
     "servers": {
       "google-pay-wallet-dev": {
         "url": "https://paydeveloper.googleapis.com/mcp"
       }
     }
   }

2. Wywołaj narzędzie na serwerze MCP, aby uruchomić proces uwierzytelniania. Na przykład: „Wyświetl moje konta Google Pay”.
3. Otworzy się okno Dynamiczna rejestracja klienta nieobsługiwana. Aby zamknąć okno, kliknij dowolny przycisk.
4. Wpisz identyfikator klienta OAuth i naciśnij Enter.
5. Gdy pojawi się prośba, wpisz tajny klucz klienta OAuth i naciśnij Enter.
6. Otworzy się okno uwierzytelniania. Kliknij Zezwól.
7. Po autoryzacji narzędzie zostanie wywołane, a sesja będzie kontynuowana w oknie czatu.

Claude.ai

Aby skonfigurować Claude.ai:

1. Kliknij Dostosuj > Łączniki.
2. Kliknij przycisk  i wybierz Dodaj niestandardowe oprogramowanie sprzęgające.
3. Podaj te informacje:
   Nazwa serwera: Google Pay & Wallet MCP.
   Adres URL zdalnego serwera MCP https://paydeveloper.googleapis.com/mcp.
4. W Ustawieniach zaawansowanych wpisz identyfikator klienta OAuth i tajny klucz klienta OAuth.
5. Wybierz nowy łącznik i kliknij Połącz.

Claude Code

Aby skonfigurować Claude Code, uruchom to polecenie:

MCP_CLIENT_SECRET=CLAUDE_CODE_CLIENT_SECRET claude mcp add --transport http \
  --client-id CLAUDE_CODE_CLIENT_ID --client-secret --callback-port CLAUDE_REDIRECT_PORT \
  google-pay-wallet-dev https://paydeveloper.googleapis.com/mcp

ChatGPT

Aby skonfigurować ChatGPT:

1. Włącz Tryb programisty w sekcji Ustawienia > Aplikacje > Ustawienia zaawansowane.
2. Kliknij przycisk Utwórz aplikację.
3. Podaj te informacje:
   Nazwa: Google Pay & Wallet MCP.
   Adres URL serwera MCP: https://paydeveloper.googleapis.com/mcp
4. Otwórz Ustawienia zaawansowane i wpisz identyfikator klienta OAuth oraz tajny klucz.
5. Skopiuj dynamiczny adres URL wywołania zwrotnego i dodaj go do klienta OAuth utworzonego w poprzednim kroku.

Znane ograniczenia

• Wyniki tylko w języku angielskim: wyszukiwanie w dokumentacji jest obsługiwane tylko w języku angielskim.
• Treści za listą kontroli dostępu: dokumentacja za listami kontroli dostępu nie jest indeksowana.
• Zależne od sieci: serwer wymaga aktywnego połączenia z usługami Google Pay i Portfela.

Warunki korzystania z usługi

Korzystanie z interfejsu Google Pay API podlega Warunkom korzystania z interfejsu Google Pay API. Korzystanie z interfejsu Google Wallet API podlega Warunkom korzystania z interfejsu Google Wallet API.