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

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 actualizada y ejemplos de código 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.

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 y las APIs de la Billetera de Google.

  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 de Pay &Wallet Developer y de la Billetera de Google.

    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 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:

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 & Wallet Developer 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 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 gcloud CLI Descripción
https://www.googleapis.com/auth/paydeveloper.merchant Administra los datos de comerciante 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

  2. En la lista Application type, 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 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:

    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 en blanco el campo redirect_uri. ChatGPT genera un redirect_uri cuando se crea la app (consulta Configura tu aplicación de IA a continuación).

  5. Haz clic en Crear. Una vez creado, 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.

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 & Wallet Developer.

Antigravity

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

  1. En Antigravity, haz clic en el menú Additional options 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 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 Manage MCP servers y haz clic en Refresh. Si haces clic en Authenticate, se abrirá la pestaña Customizations en Agent Settings.
  4. Haz clic en Authenticate y completa el flujo de OAuth.
  5. Copia el código de autorización y envíalo en la ventana Agent Settings.

VS Code

  1. Para configurar VS Code (Copilot), edita el .vscode/mcp.json archivo 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: "List my Google Pay accounts".
  3. El cuadro de diálogo Registro dinámico de clientes no admitido se abre como se espera. Haz clic en cualquier botón para cerrar el cuadro de 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 autenticar, haz clic en Permitir.
  7. Después de autorizar, 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 Customize > Connectors.
  2. Haz clic en el botón y elige Add custom connector.
  3. Ingresa los siguientes detalles:
      Nombre del servidor: Google Pay & Wallet MCP.
      Remote MCP server URL https://paydeveloper.googleapis.com/mcp.
  4. En Advanced settings , ingresa tu ID de cliente de OAuth y secreto de cliente de OAuth.
  5. Selecciona el conector nuevo y haz clic en Connect.

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.
      MCP server URL: 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.

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.