Conéctate al servidor MCP de Google Pay & Wallet Developer

Vista previa

Este producto está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos de la fase previa a la DG están disponibles “tal como están” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

El servidor de MCP de Google Pay y de la Billetera para desarrolladores brinda a las herramientas de desarrollo potenciadas por IA la capacidad de acceder a tus datos de desarrollador de Google Pay y de la Billetera de Google, buscar documentación oficial y administrar tus integraciones.

El estándar del Protocolo de contexto del modelo (MCP) estandariza la forma en que los modelos de lenguaje grandes (LLM) y las aplicaciones o los agentes de IA se conectan a fuentes de datos externas. Los servidores de MCP te permiten usar sus herramientas, recursos y mensajes para realizar acciones y obtener datos actualizados de su servicio de backend.

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

• Documentación de la búsqueda: Obtén orientación actualizada y muestras de código en la documentación oficial de Google Pay y la Billetera de Google.
• Administrar integraciones: Verifica el estado de tus integraciones y habilita las APIs para tu cuenta de comerciante.
• Supervisa el rendimiento: Accede a los datos de rendimiento agregados y a las métricas de errores de tu cuenta de comerciante.

• Administrar pases: Enumera las clases y las entidades emisoras de pases para la Billetera de Google.

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

Ejemplos de instrucciones

Puedes usar las siguientes instrucciones con tu asistente de IA:

• "Enumera 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 error de Google Pay para mi integración de los últimos 30 días".
• "Enumera mis clases de pases de la Billetera de Google".

Antes de comenzar

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

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

   Ir al selector de proyectos

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

   Roles necesarios para habilitar las APIs

   Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

   Habilitar las API

Roles obligatorios

Para obtener los permisos que necesitas para usar el servidor MCP remoto del servidor MCP de Google Pay & Wallet Developer, pídele a tu administrador que te otorgue los siguientes roles de Identity and Access Management (IAM) en el proyecto de Google Cloud en el que deseas habilitar el servidor MCP del servidor MCP de Google Pay & Wallet Developer:

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

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Autenticación y autorización

Los servidores de MCP de Google Pay y Wallet usan el protocolo OAuth 2.0 con Identity and Access Management (IAM) para la autenticación y la autorización. Se admiten todas las identidades de para la autenticación en los servidores de MCP.

El servidor MCP de Google Pay & Wallet Developer no acepta claves de API.

Te recomendamos que crees una identidad independiente para los agentes que usan herramientas de MCP, de modo que se pueda controlar y supervisar el acceso a los recursos. Para obtener más información sobre la autenticación, consulta Autenticación en servidores de MCP.

Permisos de OAuth del servidor MCP de Google Pay y la Billetera para desarrolladores

OAuth 2.0 usa permisos y credenciales para determinar si una entidad principal autenticada está autorizada 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 Usa OAuth 2.0 para acceder a las APIs de Google.

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

URI del alcance para gcloud CLI	Descripción
https://www.googleapis.com/auth/paydeveloper.merchant	Administrar los datos de comercios de Google Pay
https://www.googleapis.com/auth/paydeveloper.issuer.readonly	Leer los datos del emisor de la Billetera de Google

Crea un ID y un secreto de cliente de OAuth 2.0

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

1. En Google API Console, ve a Google Auth Platform > Clients > Create client.

   Ir a Crear cliente

   Si aún no tienes una, deberás crear una aplicación nueva en Google Auth Platform. Haz clic en el botón "Comenzar" en la página de descripción general y completa la información necesaria.

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

   • Para Antigravity, Claude.ai, Claude Code y ChatGPT, selecciona Aplicación web.
   • Para Gemini CLI y VS Code, selecciona App para escritorio.

3. En el campo Nombre, ingresa un nombre para tu aplicación.

4. Si seleccionaste Aplicación web, en la sección URIs de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, agrega el URI de redireccionamiento requerido 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

   Por ahora, puedes dejar redirect_uri en blanco. ChatGPT genera un redirect_uri cuando se crea la app (consulta Cómo configurar tu aplicación de IA a continuación).

   Nota: En la sección Orígenes autorizados de JavaScript, haz clic en + Agregar URI y, luego, agrega https://chatgpt.com en el campo URIs.

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

Configura 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, agrega lo siguiente a tu 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 de MCP de Google Pay y la Billetera.

Antigravity

Para configurar Antigravity para que use el servidor de MCP, haz lo siguiente:

1. En Antigravity, haz clic en el menú Opciones adicionales en el panel Agent > MCP Servers > Manage MCP Servers.
2. En la parte superior del panel Manage MCP Servers, haz clic en View raw config 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. Regresa a Administrar servidores de MCP y haz clic en Actualizar. Si haces clic en Autenticar, se abrirá la pestaña Personalizaciones en Configuración del agente.
4. Haz clic en Autenticarse 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 en tu espacio de trabajo:

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

2. Llama a una herramienta en el servidor de MCP para activar el proceso de autenticación. Por ejemplo, "Enumera mis cuentas de Google Pay".
3. Se abrirá el diálogo Registro dinámico de clientes no admitido como se esperaba. Haz clic en cualquier botón para cerrar el diálogo.
4. Ingresa tu ID de cliente de OAuth y presiona Intro.
5. Cuando se te solicite, ingresa tu secreto de cliente de OAuth y presiona Intro.
6. Se abrirá un diálogo para autenticarte. Haz clic en Permitir.
7. Después de la autorización, se llama a la herramienta y la sesión continúa en la ventana de chat.

Claude.ai

Para configurar Claude.ai, haz lo siguiente:

1. Navega a Personalizar > Conectores.
2. Haz clic en el botón y elige Agregar conector personalizado.
3. Ingresa los siguientes detalles:
   Nombre del servidor: Google Pay & Wallet MCP.
   URL del servidor de MCP remoto https://paydeveloper.googleapis.com/mcp.
4. En Configuración avanzada, ingresa tu ID de cliente de OAuth y tu secreto de cliente de OAuth.
5. Selecciona el conector nuevo 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, haz lo siguiente:

1. Habilita el Modo de desarrollador en Configuración > Apps > Configuración avanzada.
2. Haz clic en el botón Crear app.
3. Ingresa los siguientes detalles:
   Nombre: Google Pay & Wallet MCP.
   URL del servidor de MCP: https://paydeveloper.googleapis.com/mcp
4. Ve a Configuración avanzada y, luego, ingresa el ID de cliente y el secreto de tu cliente de OAuth.
5. Copia la URL de devolución de llamada dinámica y agrégala al cliente de OAuth creado en el paso anterior.

Limitaciones conocidas

• Resultados solo en inglés: La búsqueda de documentación solo admite inglés.
• Contenido detrás de la LCA: La documentación detrás de las LCA no se indexa
• Dependiente de la red: El servidor requiere una conexión activa a los servicios de Google Pay y de la Billetera.

Condiciones del Servicio

El uso de la API de Google Pay está sujeto a las Condiciones del Servicio de la API de Google Pay. El uso de la API de la Billetera de Google está sujeto a las Condiciones del Servicio de la API de la Billetera de Google.