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

Podgląd

Ten produkt 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 deweloperów 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 ich narzędzi, zasobów i promptów do wykonywania działań i uzyskiwania aktualnych danych z usługi backendu.

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

• Wyszukiwanie w dokumentacji: otrzymywanie aktualnych wskazówek i próbek kodu z oficjalnych dokumentów Google Pay i Portfela Google.
• Zarządzanie integracjami: sprawdzanie stanu integracji i włączanie interfejsów API na koncie sprzedawcy.
• Sprawdzanie skuteczności: dostęp do zagregowanych danych o skuteczności i danych o błędach na koncie sprzedawcy.

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

  Uwaga: szczegóły dotyczące dostępnych narzędzi MCP i ich opisy znajdziesz w dokumentacji dla deweloperów Google Pay i Portfela Google.

Przykładowe prompty

Możesz używać tych promptów z asystentem AI:

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

Zanim zaczniesz

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

1. W konsoli Cloud na stronie wyboru projektu wybierz lub utwórz projekt w chmurze Google.

   Otwórz selektor projektu

2. Włącz interfejs Pay &Wallet Developer API.

   Role wymagane do włączenia interfejsów API

   Aby włączyć interfejsy API, musisz mieć uprawnienie serviceusage.services.enable. Jeśli projekt został utworzony przez Ciebie, prawdopodobnie masz już to uprawnienie dzięki roli Właściciel (roles/owner). W przeciwnym razie możesz uzyskać to uprawnienie dzięki roli Administrator wykorzystania usług (roles/serviceusage.serviceUsageAdmin). Dowiedz się, jak przyznawać role.

   Włącz API

Wymagane role

Aby uzyskać uprawnienia potrzebne do korzystania z serwera MCP dla deweloperów Google Pay i Portfela Google, poproś administratora o przypisanie Ci w projekcie Google Cloud, w którym chcesz włączyć serwer MCP dla deweloperów Google Pay i Portfela Google, tych ról uprawnień:

• Wykonywanie wywołań 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

Serwer MCP dla deweloperów Google Pay i Portfela Google używa protokołu OAuth 2.0 z usługą Identity and Access Management (IAM) do uwierzytelniania i autoryzacji. Do uwierzytelniania na serwerach MCP obsługiwane są wszystkie tożsamości.

Serwer MCP dla deweloperów Google Pay i Portfela Google 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 serwerach.

Zakresy OAuth serwera MCP dla deweloperów Google Pay i Portfela Google

OAuth 2.0 używa zakresów i danych uwierzytelniających, aby określić, czy uwierzytelniony podmiot ma uprawnienia do wykonania określonej czynności na zasobie. Więcej informacji o zakresach OAuth 2.0 w Google znajdziesz w artykule Używanie OAuth 2.0 do korzystania z interfejsów API Google.

Serwer MCP dla deweloperów 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 Google Pay.
https://www.googleapis.com/auth/paydeveloper.issuer.readonly	Odczytywanie danych emitenta Portfela Google.

Tworzenie identyfikatora i tajnego klucza klienta OAuth 2.0

Aby utworzyć identyfikator i tajny klucz klienta OAuth 2.0:

1. W Konsoli interfejsów API Google otwórz Google Auth Platform > Clients > Create client.

   Otwórz stronę Utwórz klienta

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

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

   • W przypadku Cursor Desktop, Claude Code, Claude.ai, ChatGPT i Antigravity wybierz Aplikacja internetowa.
   • W przypadku Antigravity CLI, Antigravity IDE i VS Code wybierz Aplikacja na komputer.

3. W polu Nazwa wpisz nazwę aplikacji.

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

   Cursor Desktop

   http://localhost:8787/callback

   Claude Code

   http://localhost:CLAUDE_REDIRECT_PORT/callback

   Claude.ai

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

   ChatGPT

   Na razie możesz pozostawić pole redirect_uri puste. ChatGPT generuje redirect_uri podczas tworzenia aplikacji (patrz Konfigurowanie aplikacji AI poniżej).

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

   Antigravity

   https://antigravity.google/oauth-callback

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ć aplikacji AI szczegóły konfiguracji serwera.

VS Code

1. U góry panelu bocznego czatu kliknij ikonę i otwórz Serwery MCP.
2. Kliknij przycisk Dodaj serwer (), wybierz HTTP i wpisz adres URL wskazujący serwer MCP dla deweloperów Google Pay i Portfela Google: https://paydeveloper.googleapis.com/mcp.
   Konfiguracja MCP jest zapisywana w pliku .vscode/mcp.json w obszarze roboczym:

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

3. Kliknij prawym przyciskiem nowy serwer MCP i wybierz Uruchom serwer.
4. Wróć do okna czatu i wywołaj narzędzie na serwerze MCP, aby uruchomić proces uwierzytelniania. Na przykład: „Wyświetl moje konta Google Pay”.
5. Zgodnie z oczekiwaniami otworzy się okno Dynamiczna rejestracja klienta nie jest obsługiwana. Aby zamknąć okno, kliknij dowolny przycisk.
6. Wpisz identyfikator klienta OAuth i naciśnij Enter.
7. Gdy pojawi się prośba, wpisz tajny klucz klienta OAuth i naciśnij Enter.
8. Otworzy się okno uwierzytelniania. Kliknij Zezwól.
9. Możesz wybrać tożsamość z listy uwierzytelnionych tożsamości lub zalogować się na nowe konto.
10. Po uwierzytelnieniu narzędzie zostanie wywołane, a sesja będzie kontynuowana w oknie czatu.

Cursor Desktop

Aby skonfigurować Cursor Desktop:

1. W panelu bocznym po lewej stronie kliknij Dostosuj.
2. Kliknij Nowy serwer MCP. Spowoduje to otwarcie pliku konfiguracji mcp.json.
3. Aby dodać serwer MCP dla deweloperów Google Pay i Portfela Google, wpisz szczegóły konfiguracji:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "url": "https://paydeveloper.googleapis.com/mcp",
         "auth": {
           "CLIENT_ID": "CURSOR_DESKTOP_CLIENT_ID",
           "CLIENT_SECRET": "CURSOR_DESKTOP_CLIENT_SECRET"
         }
       }
     }
   }

4. Po zapisaniu pliku lista serwerów MCP zostanie zaktualizowana.
5. Aby rozpocząć proces uwierzytelniania, kliknij Uwierzytelnij.

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

Claude.ai

Aby skonfigurować Claude.ai:

1. Otwórz Dostosuj > Oprogramowanie sprzęgające.
2. Kliknij Dodaj i wybierz Dodaj niestandardowe oprogramowanie sprzęgające.
3. Wpisz 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 nowe oprogramowanie sprzęgające i kliknij Połącz.

ChatGPT

Aby skonfigurować ChatGPT:

1. Włącz Tryb dewelopera w sekcji Ustawienia > Bezpieczeństwo i logowanie.
2. W panelu bocznym po lewej stronie wybierz Wtyczki i kliknij przycisk .
3. Wpisz te informacje:
   Nazwa: Google Pay & Wallet MCP.
   Adres URL serwera: https://paydeveloper.googleapis.com/mcp
4. Otwórz Ustawienia zaawansowane i wpisz identyfikator oraz tajny klucz klienta OAuth.
5. Skopiuj dynamiczny adres URL wywołania zwrotnego i dodaj go do klienta OAuth utworzonego w poprzednim kroku.

Antigravity CLI

1. Aby skonfigurować Antigravity CLI, dodaj te informacje do pliku ~/.gemini/config/mcp_config.json:

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

2. Uruchom /mcp, wybierz nowy serwer MCP i kliknij Uwierzytelnij, aby rozpocząć proces uwierzytelniania.

Antigravity IDE

1. U góry panelu bocznego agenta edytora kliknij i wybierz Serwery MCP.
2. Kliknij Zarządzaj serwerami MCP.
3. Kliknij Wyświetl surową konfigurację i dodaj szczegóły serwera MCP:

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

4. Wróć do Antigravity IDE i kliknij Odśwież.
5. Wybierz nowy serwer MCP, kliknij Uwierzytelnij i przejdź proces uwierzytelniania.
6. Skopiuj kod autoryzacji i prześlij go w oknie Antigravity Ustawienia.

Antigravity

1. W Antigravity otwórz Ustawienia > Dostosowania.
2. W sekcji Zainstalowane serwery MCP kliknij Otwórz konfigurację MCP, 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 Antigravity i kliknij Odśwież.
4. Kliknij Uwierzytelnij i przejdź proces uwierzytelniania.
5. Skopiuj kod autoryzacji i prześlij go w oknie Antigravity Ustawienia.

Znane ograniczenia

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

Warunki korzystania z usługi

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