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

Vista previa

Este producto se encuentra 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 &Wallet Developer 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 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 &Wallet Developer te permite hacer lo siguiente:

• Buscar documentación: Obtén orientación y muestras de código actualizadas de la documentación oficial de Google Pay y de la Billetera de Google.
• Administrar integraciones: Verifica el estado de tus integraciones y habilita las APIs para tu cuenta de comerciante.
• Supervisar el rendimiento: Accede a datos de rendimiento agregados y métricas de errores para tu cuenta de comerciante.

• Administrar pases: Haz una lista de los emisores y las clases de pases para la Billetera de Google.

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

Ejemplos de instrucciones

Puedes usar las siguientes instrucciones con tu asistente de IA:

• "List my Google Pay accounts"
• "What is the status of my Google Pay integrations?"
• "How can I integrate Google Pay with React?"
• "Show me Google Pay error metrics for my integration over the last 30 days"
• Listar mis clases de pases de 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.

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 la API de Pay &Wallet Developer.

   Roles necesarios para habilitar las APIs

   Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol Propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles.

   Habilitar la API

Roles obligatorios

Para obtener los permisos que necesitas para usar el servidor de MCP remoto 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 de 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

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

El servidor de 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 para 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 de MCP de Google Pay &Wallet Developer

OAuth 2.0 usa permisos y credenciales para determinar si una entidad 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 permisos de OAuth de la herramienta de MCP:

URI del permiso para la CLI de gcloud	Descripción
https://www.googleapis.com/auth/paydeveloper.merchant	Administra los datos de comercio de Google Pay.
https://www.googleapis.com/auth/paydeveloper.issuer.readonly	Lee los datos del emisor de la Billetera de Google.

Crea un ID de cliente y un secreto de OAuth 2.0

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

1. En la consola de APIs de Google, ve a Google Auth Platform > Clients > Create client.

   Ir a Crear cliente

   Deberás crear una aplicación nueva en la plataforma de autenticación de Google si aún no tienes una. 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 Application type, selecciona el tipo adecuado para tu aplicación de IA:

   • Para Cursor Desktop, Claude Code, Claude.ai, ChatGPT y Antigravity, selecciona aplicación web.
   • Para CLI de Antigravity, IDE de Antigravity y VS Code, selecciona Desktop app.

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

4. Si seleccionaste aplicación web, en la sección Authorized redirect URIs, haz clic en + Add URI y, luego, agrega el URI de redireccionamiento requerido para tu aplicación de IA:

   Cursor Desktop

   http://localhost:8787/callback

   Claude Code

   http://localhost:CLAUDE_REDIRECT_PORT/callback

   Claude.ai

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

   ChatGPT

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

   Nota: En la sección Authorized JavaScript origins, haz clic en + Add URI y, luego, agrega https://chatgpt.com en el campo URIs.

   Antigravity

   https://antigravity.google/oauth-callback

5. Haz clic en Crear. Una vez que se crea, el secreto del cliente se muestra una sola vez. Cópialo y almacénalo de forma segura.

Configura tu aplicación de IA

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

VS Code

1. Haz clic en el ícono en la parte superior del panel lateral de chat y navega a Servidores de MCP.
2. Haz clic en el botón Agregar servidor (), selecciona HTTP y, luego, ingresa la URL que apunta al servidor de MCP de Pay & Wallet Developer: https://paydeveloper.googleapis.com/mcp.
   Tu configuración de MCP se guarda en el archivo .vscode/mcp.json de tu lugar de trabajo:

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

3. Haz clic con el botón derecho en el nuevo servidor de MCP y selecciona Iniciar servidor.
4. Regresa a la ventana de chat y llama a una herramienta en el servidor de MCP para activar el proceso de autenticación. Por ejemplo: "List my Google Pay accounts".
5. Se abrirá el diálogo Registro dinámico de clientes no admitido según lo previsto. Haz clic en cualquier botón para cerrar el diálogo.
6. Ingresa tu ID de cliente de OAuth y presiona Intro.
7. Cuando se te solicite, ingresa tu secreto de cliente de OAuth y presiona Intro.
8. Se abrirá un diálogo para autenticar, haz clic en Permitir.
9. Puedes elegir entre una lista de identidades autenticadas o acceder con una cuenta nueva.
10. Después de la autenticación, se llama a la herramienta y la sesión continúa en la ventana de chat.

Cursor Desktop

Para configurar Cursor Desktop, haz lo siguiente:

1. Haz clic en Personalizar en el panel lateral izquierdo.
2. Haz clic en Nuevo servidor de MCP. Se abrirá el archivo de configuración mcp.json.
3. Ingresa los detalles de configuración para agregar el servidor de MCP de Google Pay &Wallet Developer:

   {
     "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. Cuando guardes el archivo, se actualizará la lista de servidores de MCP.
5. Haz clic en Autenticar para iniciar el proceso de autenticación.

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

Claude.ai

Para configurar Claude.ai, haz lo siguiente:

1. Navega a Personalizar > Conectores.
2. Haz clic en Agregar 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 secreto de cliente de OAuth.
5. Selecciona el conector nuevo y haz clic en Conectar.

ChatGPT

Para configurar ChatGPT, haz lo siguiente:

1. Habilita el Modo de desarrollador desde Configuración > Seguridad y acceso.
2. Selecciona Plugins en el panel lateral principal y haz clic en el botón .
3. Ingresa los siguientes detalles:
   Nombre: Google Pay & Wallet MCP.
   URL del servidor: https://paydeveloper.googleapis.com/mcp
4. Ve a Configuración avanzada y, luego, ingresa tu ID de cliente y secreto 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.

CLI de Antigravity

1. Para configurar la CLI de Antigravity, agrega lo siguiente a tu ~/.gemini/config/mcp_config.json archivo:

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

2. Ejecuta /mcp, selecciona tu nuevo servidor de MCP y elige Autenticar para iniciar el proceso de autenticación.

IDE de Antigravity

1. Haz clic en en la parte superior del panel lateral del agente del editor y selecciona Servidores de MCP.
2. Haz clic en Administrar servidores de MCP.
3. Haz clic en Ver configuración sin procesar y agrega los detalles del servidor de MCP:

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

4. Regresa al IDE de Antigravity y haz clic en Actualizar.
5. Selecciona tu nuevo servidor de MCP, haz clic en Autenticar y completa el flujo de autenticación.
6. Copia el código de autorización y envíalo en la ventana Antigravity Configuración.

Antigravity

1. En Antigravity, ve a Configuración > Personalizaciones.
2. En la sección Servidores de MCP instalados, haz clic en Abrir configuración de MCP para editar el mcp_config.json archivo:

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

3. Regresa a Antigravity y haz clic en Actualizar.
4. Haz clic en Autenticar y completa el flujo de autenticación.
5. Copia el código de autorización y envíalo en la ventana Antigravity Configuración.

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 está indexada.
• 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 Google Wallet está sujeto a las Condiciones del Servicio de la API de Google Wallet.