Conectarse al servidor de MCP de Google Pay y Wallet Developer

El servidor de MCP para desarrolladores de Google Pay y Wallet 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 protocolo Model Context Protocol (MCP) estandariza la forma en que los modelos de lenguaje extenso (LLMs) 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 peticiones para realizar acciones y obtener datos actualizados de su servicio de backend.

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

  • Buscar documentación: obtén guías y ejemplos de código actualizados de la documentación oficial de Google Pay y Google Wallet.
  • Gestionar integraciones: comprueba el estado de tus integraciones y habilita APIs para tu cuenta de comerciante.
  • Monitorizar el rendimiento: accede a datos de rendimiento agregados y a métricas de errores de tu cuenta de comerciante.

  • Gestionar pases: consulta una lista de emisores y clases de pases de Google Wallet.

Peticiones de ejemplo

Puedes usar las siguientes peticiones con tu asistente de IA:

  • "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".
  • "Lista mis clases de pases de Google Wallet".

Antes de empezar

Para usar el servidor de MCP para desarrolladores de Google Pay y Wallet, debes crear un proyecto de Google Cloud y habilitar el servidor de MCP para desarrolladores de Google Pay y 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 la API para desarrolladores de Pay y Wallet.

    Roles necesarios para habilitar APIs

    Para habilitar APIs, necesitas el permiso serviceusage.services.enable. Si has creado el proyecto, es probable que ya tengas este permiso a través del rol Propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol Administrador de uso de servicios (roles/serviceusage.serviceUsageAdmin). Consulta cómo asignar roles.

    Habilitar la API

Roles obligatorios

Para obtener los permisos que necesitas para usar el servidor de MCP remoto para desarrolladores de Google Pay y Wallet, pide a tu administrador que te asigne los siguientes roles de gestión de identidades y accesos (IAM) en el proyecto de Google Cloud en el que quieras habilitar el servidor de MCP para desarrolladores de Google Pay y Wallet:

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

Autenticación y autorización

Los servidores de MCP para desarrolladores de Google Pay y Wallet usan el protocolo OAuth 2.0 con gestión de identidades y accesos (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 para desarrolladores de Google Pay y Wallet no acepta claves de API.

Te recomendamos que crees una identidad independiente para los agentes que usen herramientas de MCP, de modo 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 de MCP.

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

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 Usar OAuth 2.0 para acceder a las APIs de Google.

El servidor de MCP para desarrolladores de Google Pay y Wallet tiene los siguientes permisos de OAuth de herramientas de MCP:

URI de permiso para la CLI de gcloud Descripción
https://www.googleapis.com/auth/paydeveloper.merchant Gestionar datos de comerciante de Google Pay.
https://www.googleapis.com/auth/paydeveloper.issuer.readonly Leer datos de 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 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

  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, escribe el nombre de tu aplicación.

  4. Si has seleccionado Aplicación web, en la sección URIs de redirección autorizadas, 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

    Puedes dejar en blanco el campo redirect_uri por ahora. ChatGPT genera un redirect_uri cuando se crea la aplicación (consulta la sección Configurar tu aplicación de IA más abajo).

  5. Haz clic en Crear. Una vez creado, el secreto de cliente se muestra una vez. Cópialo y guárdalo 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 de MCP para desarrolladores de Google Pay y Wallet.

Antigravity

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

  1. En Antigravity, haz clic en el menú Opciones adicionales del panel Agente > Servidores de MCP > Gestionar servidores de MCP.
  2. En la parte superior del panel Gestionar servidores de MCP, haz clic en Ver configuración sin procesar 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. Vuelve a Gestionar 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 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 .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 del servidor de MCP para activar el proceso de autenticación. Por ejemplo, "Lista mis cuentas de Google Pay".
  3. Se abrirá el cuadro de diálogo Registro dinámico de clientes no disponible, tal como se espera. 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 autorizado, se llama a la herramienta y la sesión continúa en la ventana de chat.

Claude.ai

Para configurar Claude.ai, sigue estos pasos:

  1. Ve a Personalizar > Conectores.
  2. Haz clic en el botón y elige Añadir conector personalizado.
  3. Introduce los siguientes datos:
      Nombre del servidor: Google Pay & Wallet MCP.
      URL del servidor de MCP remoto https://paydeveloper.googleapis.com/mcp.
  4. En Configuración avanzada , introduce tu ID de cliente de OAuth y 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. Habilita el modo para desarrolladores en Configuración > Aplicaciones > Configuración avanzada.
  2. Haz clic en el botón Crear aplicación.
  3. Introduce los siguientes datos:
      Nombre: Google Pay & Wallet MCP.
      URL del servidor de MCP: https://paydeveloper.googleapis.com/mcp
  4. Ve a Configuración avanzada e introduce tu ID de cliente de OAuth y tu secreto.
  5. Copia la URL de devolución de llamada dinámica y añádela al cliente de OAuth que creaste en el paso anterior.

Limitaciones conocidas

  • Resultados solo en inglés: la búsqueda de documentación solo admite el inglés.
  • Contenido protegido por LCA: la documentación protegida por listas de control de acceso no se indexa.
  • Dependencia de la red: el servidor requiere una conexión activa a 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.