Conectarse al servidor de MCP de Google Pay y Wallet Developer

El servidor de 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 de gran tamaño (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: compruebe el estado de sus integraciones y habilite las APIs de su 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, carnés y tarjetas: muestra una lista de los emisores y las clases de pases, carnés y tarjetas de Google Wallet.

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, carnés y tarjetas de Google Wallet").

Antes de empezar

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

    Roles necesarios para habilitar las 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 servicio (roles/serviceusage.serviceUsageAdmin). Consulta cómo asignar roles.

    Activar la API

Roles obligatorios

Para obtener los permisos que necesitas para usar el servidor de MCP remoto de Google Pay y Wallet Developer, pide a tu administrador que te conceda 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 de Google Pay y Wallet Developer:

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

El servidor de MCP de Google Pay y Wallet para desarrolladores usa 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 servidores de MCP.

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

Te recomendamos que crees una identidad independiente para los agentes que usen las herramientas de MCP, de forma 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 de Google Pay y Wallet Developer

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 y Wallet Developer tiene los siguientes ámbitos de OAuth de herramientas 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

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

    • En Cursor Desktop, Claude Code, Claude.ai, ChatGPT y Antigravity, selecciona Aplicación web.
    • En Antigravity CLI, Antigravity IDE y VS Code, selecciona Aplicación para ordenadores.
  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:

    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 el campo redirect_uri en blanco. ChatGPT genera un redirect_uri cuando se crea la aplicación (consulta la sección Configurar tu aplicación de IA más abajo).

    Antigravity

    https://antigravity.google/oauth-callback

  5. Haz clic en Crear. El secreto de cliente se muestra una vez al crearlo. 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.

VS Code

  1. Haz clic en el icono situado en la parte superior del panel lateral de chat y ve a Servidores de MCP.
  2. Haz clic en el botón Añadir servidor (), selecciona HTTP e introduce 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 espacio 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. Vuelve a la ventana de chat y llama a una herramienta del servidor de MCP para activar el proceso de autenticación. Por ejemplo: "Lista mis cuentas de Google Pay".
  5. Se abre 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.
  6. Introduce tu ID de cliente de OAuth y pulsa Intro.
  7. Cuando se te solicite, introduce tu secreto de cliente de OAuth y pulsa Intro.
  8. Se abrirá un cuadro de diálogo para autenticarte. Haz clic en Permitir.
  9. Puedes elegir entre una lista de identidades autenticadas o iniciar sesión con una cuenta nueva.
  10. Una vez autenticado, se llama a la herramienta y la sesión continúa en la ventana de chat.

Cursor Desktop

Para configurar Cursor Desktop, sigue estos pasos:

  1. En el panel de la izquierda, haz clic en Personalizar.
  2. Haz clic en Nuevo servidor de MCP. Se abrirá el mcp.jsonarchivo de configuración.
  3. Introduce los detalles de la configuración para añadir el servidor MCP de desarrolladores de Google Pay y Wallet:
    {
      "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, sigue estos pasos:

  1. Ve a Personalizar > Conectores.
  2. Haz clic en Añadir 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.

ChatGPT

Para configurar ChatGPT, sigue estos pasos:

  1. Activa el modo Desarrollador en Ajustes > Seguridad e inicio de sesión.
  2. Seleccione Complementos en el panel lateral principal y haga clic en el botón .
  3. Introduce los siguientes datos:
      Nombre: Google Pay & Wallet MCP.
      URL del servidor: https://paydeveloper.googleapis.com/mcp
  4. Ve a Configuración avanzada e introduce tu ID de cliente de OAuth y tu secreto de cliente.
  5. Copia la URL de retrollamada dinámica y añádela al cliente de OAuth que has creado en el paso anterior.

Antigravity CLI

  1. Para configurar Antigravity CLI, añade lo siguiente a tu archivo ~/.gemini/config/mcp_config.json:

    {
      "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.

Antigravity IDE

  1. Haz clic en en la parte superior del panel lateral del agente del editor y selecciona Servidores de MCP.
  2. Haz clic en Gestionar servidores de MCP.
  3. Haz clic en Ver configuración sin formato y añade los detalles de tu 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. Vuelve 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 Configuración de Antigravity.

Antigravity

  1. En Antigravity, ve a Configuración > Personalizaciones.
  2. En la sección Installed MCP Servers (Servidores de MCP instalados), haz clic en Open MCP Config (Abrir configuración de MCP) 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 Antigravity y haz clic en Actualizar.
  4. Haz clic en Autenticar y completa el proceso de autenticación.
  5. Copia el código de autorización y envíalo en la ventana Configuración de Antigravity.

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.