Conectarse al servidor de MCP de Google Pay y Wallet Developer

Vista previa

Este producto está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

El servidor MCP de Google Pay y Google Wallet para desarrolladores ofrece a las herramientas de desarrollo basadas en IA la posibilidad de acceder a tus datos de desarrollador de Google Pay y Google Wallet, buscar documentación oficial y gestionar tus integraciones.

El estándar Model Context Protocol (MCP) estandariza la forma en que los modelos de lenguaje extensos (LLMs) y las aplicaciones o agentes de IA se conectan a fuentes de datos externas. Los servidores de MCP te permiten usar sus herramientas, recursos y peticiones para llevar a cabo acciones y obtener datos actualizados de su servicio de backend.

El servidor de MCP de Google Pay y Wallet para desarrolladores te permite hacer lo siguiente:

• Documentación de búsqueda: consulta las directrices y los ejemplos de código más recientes en la documentación oficial de Google Pay y Google Wallet.
• Gestionar integraciones: comprueba el estado de tus integraciones y habilita las APIs de tu cuenta de comerciante.
• Monitorizar el rendimiento: acceda a datos de rendimiento agregados y a métricas de errores de su cuenta de comerciante.

• Gestionar pases: muestra una lista de los emisores y las clases de pases, carnés y tarjetas de Google Wallet.

  Nota: Consulta la referencia para desarrolladores de Google Pay y Wallet para ver los detalles de las herramientas de MCP disponibles y sus descripciones.

Peticiones de ejemplo

Puedes usar las siguientes peticiones con tu asistente de IA:

• "List my Google Pay accounts" ("Lista mis cuentas de Google Pay").
• "¿Cuál es el estado de mis integraciones de Google Pay?"
• "¿Cómo puedo integrar Google Pay con React?"
• "Muéstrame las métricas de errores de Google Pay de mi integración de los últimos 30 días".
• "List my Google Wallet pass classes" ("Enumera mis clases de pases de Google Wallet").

Antes de empezar

Para usar el servidor MCP de Google Pay & Wallet Developer, debe crear un proyecto de Google Cloud y habilitar el servidor MCP de Google Pay & Wallet Developer y las APIs de Google Wallet.

1. En la consola de Cloud, en la página del selector de proyectos, selecciona o crea un proyecto de Google Cloud.

   Ir al selector de proyectos

2. Habilita las APIs Pay & Wallet Developer y Google Wallet.

   Roles necesarios para habilitar las APIs

   Para habilitar APIs, necesitas el rol de gestión de identidades y accesos Administrador de uso de servicio (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Consulta cómo conceder roles.

   Habilitar las APIs

Roles obligatorios

Para obtener los permisos que necesitas para usar el servidor de MCP remoto del servidor de MCP de Google Pay & Wallet Developer, pide a tu administrador que te conceda los siguientes roles de Gestión de Identidades y Accesos (IAM) en el proyecto en la nube de Google Cloud en el que quieras habilitar el servidor de MCP de Google Pay & Wallet Developer:

• Hacer llamadas a herramientas de MCP: Usuario de la herramienta de MCP (roles/mcp.toolUser)

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

Autenticación y autorización

Los servidores de MCP de Google Pay y Wallet Developer usan el protocolo OAuth 2.0 con Gestión de Identidades y Accesos (IAM) para la autenticación y la autorización. Todas las identidades se pueden usar para autenticar servidores de MCP.

El servidor MCP de Google Pay y Wallet para desarrolladores no acepta claves de API.

Te recomendamos que crees una identidad independiente para los agentes que usen las herramientas de MCP para que se pueda controlar y monitorizar el acceso a los recursos. Para obtener más información sobre la autenticación, consulta el artículo Autenticarse en servidores MCP.

Permisos de OAuth del servidor de MCP de Google Pay y Wallet para desarrolladores

OAuth 2.0 usa permisos y credenciales para determinar si una entidad autenticada tiene autorización para realizar una acción específica en un recurso. Para obtener más información sobre los permisos de OAuth 2.0 en Google, consulta el artículo Uso de OAuth 2.0 para acceder a las APIs de Google.

El servidor de MCP de Google Pay & Wallet Developer tiene los siguientes ámbitos de OAuth de la herramienta de MCP:

URI de ámbito de la CLI de gcloud	Descripción
https://www.googleapis.com/auth/paydeveloper.merchant	Gestionar los datos de comerciantes de Google Pay.
https://www.googleapis.com/auth/paydeveloper.issuer.readonly	Leer datos del emisor de Google Wallet.

Crear un ID de cliente y un secreto de OAuth 2.0

Para crear un ID de cliente y un secreto de cliente de OAuth 2.0, sigue estos pasos:

1. En la consola de APIs de Google, ve a Plataforma de autenticación de Google > Clientes > Crear cliente.

   Ir a Crear cliente

   Si aún no tienes una, tendrás que crear una aplicación en la plataforma de autenticación de Google. Haz clic en el botón "Empezar" de la página de resumen y rellena la información necesaria.

2. En la lista Tipo de aplicación, selecciona el tipo adecuado para tu aplicación de IA:

   • En Antigravity, Claude.ai, Claude Code y ChatGPT, selecciona Aplicación web.
   • En Gemini CLI y VS Code, selecciona Aplicación de escritorio.

3. En el campo Nombre, introduce el nombre de tu aplicación.

4. Si has seleccionado Aplicación web, en la sección URIs de redirección autorizados, haz clic en + Añadir URI y, a continuación, añade el URI de redirección necesario para tu aplicación de IA:

   Antigravity

   https://antigravity.google/oauth-callback

   Claude.ai

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

   Claude Code

   http://localhost:CLAUDE_REDIRECT_PORT/callback

   ChatGPT

   El redirect_uri se genera cuando se crea la aplicación (consulta la sección "Configurar tu aplicación de IA").

   Nota: En la sección Orígenes de JavaScript autorizados, haz clic en + Añadir URI y, a continuación, añade https://chatgpt.com en el campo URIs.

5. Haz clic en Crear. Al crear el secreto de cliente, se muestra una vez. Cópiala y guárdala de forma segura.

Configurar tu aplicación de IA

A continuación, debes proporcionar a tu aplicación de IA los detalles de configuración del servidor.

Gemini CLI

1. Para configurar Gemini CLI, añade lo siguiente al archivo `~/.gemini/settings.json`:

             {
               "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. Ejecuta /mcp auth google-pay-wallet-dev para iniciar el proceso de autenticación del servidor MCP de Google Pay y Wallet Developer.

Antigravity

Para configurar Antigravity para que use el servidor de MCP, sigue estos pasos:

1. En Antigravity, haz clic en el menú Opciones adicionales del panel Agente > Servidores MCP > Gestionar servidores MCP.
2. En la parte superior del panel Gestionar servidores MCP, haz clic en Ver configuración sin formato para editar el archivo mcp_config.json:

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

3. Vuelve a Gestionar servidores MCP y haz clic en Actualizar. Al hacer clic en Autenticar, se abre la pestaña Personalizaciones en Configuración del agente.
4. Haz clic en Autenticar y completa el flujo de OAuth.
5. Copia el código de autorización y envíalo en la ventana Configuración del agente.

VS Code

1. Para configurar VS Code (Copilot), edita el archivo .vscode/mcp.json de tu espacio de trabajo:

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

2. Llama a una herramienta del servidor de MCP para activar el proceso de autenticación. Por ejemplo: "List my Google Pay accounts" ("Enumera mis cuentas de Google Pay").
3. Se abrirá el cuadro de diálogo Registro dinámico de clientes no disponible, como se esperaba. Haz clic en cualquier botón para cerrar el cuadro de diálogo.
4. Introduce tu ID de cliente de OAuth y pulsa Intro.
5. Cuando se te solicite, introduce tu secreto de cliente de OAuth y pulsa Intro.
6. Se abrirá un cuadro de diálogo para autenticarte. Haz clic en Permitir.
7. Una vez que se haya autorizado, se llamará a la herramienta y la sesión continuará en la ventana del chat.

Claude.ai

Para configurar Claude.ai, sigue estos pasos:

1. Ve a Personalizar > Conectores.
2. Haz clic en el botón y selecciona Añadir conector personalizado.
3. Introduce los siguientes datos:
   Nombre del servidor: Google Pay & Wallet MCP.
   URL del servidor MCP remoto https://paydeveloper.googleapis.com/mcp.
4. En Configuración avanzada, introduce tu ID de cliente de OAuth y tu secreto de cliente de OAuth.
5. Selecciona el nuevo conector y haz clic en Conectar.

Claude Code

Para configurar Claude Code, ejecuta el siguiente comando:

      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

Para configurar ChatGPT, sigue estos pasos:

1. En ChatGPT, ve a Ajustes > Aplicaciones > Crear aplicación.
2. Introduce los siguientes datos:
   Nombre: Google Pay & Wallet MCP.
   URL del servidor de MCP: https://paydeveloper.googleapis.com/mcp
3. Ve a Configuración avanzada e introduce tu ID de cliente de OAuth y tu secreto.
4. Copia la URL de retrollamada dinámica y añádela al cliente de OAuth que has creado en el paso anterior.

Limitaciones conocidas

• Resultados solo en inglés: la búsqueda en la documentación solo admite inglés.
• Contenido detrás de una LCA: la documentación detrás de las LCA no está indexada
• Dependiente de la red: el servidor requiere una conexión activa con los servicios de Google Pay y Wallet.

Términos del Servicio

El uso de la API de Google Pay está sujeto a los Términos del Servicio de la API de Google Pay. El uso de la API de Google Wallet está sujeto a los Términos del Servicio de la API de Google Wallet.