Este es un servidor de MCP que proporciona herramientas a los desarrolladores de Pay.
Un servidor de Protocolo de contexto del modelo (MCP) actúa como proxy entre un servicio externo que proporciona contexto, datos o capacidades a un modelo de lenguaje grande (LLM) o una aplicación de IA. Los servidores de MCP conectan aplicaciones de IA a sistemas externos, como bases de datos y servicios web, y traducen sus respuestas a un formato que la aplicación de IA puede comprender.
Configuración del servidor
Debes habilitar los servidores de MCP y configurar la autenticación antes de usarlos. Para obtener más información sobre el uso de servidores de MCP remotos de Google y Google Cloud, consulta Descripción general de los servidores de MCP de Google Cloud.
Extremos del servidor
Un extremo de servicio de MCP es la dirección de red y la interfaz de comunicación (por lo general, una URL) del servidor de MCP que usa una aplicación de IA (el host para el cliente de MCP) para establecer una conexión segura y estandarizada. Es el punto de contacto para que el LLM solicite contexto, llame a una herramienta o acceda a un recurso. Los extremos de MCP de Google pueden ser globales o regionales.
La API del servidor de MCP de Google Pay y Billetera tiene el siguiente extremo de MCP global:
- https://paydeveloper.googleapis.com/mcp
Herramientas de MCP
Una herramienta de MCP es una función o capacidad ejecutable que un servidor de MCP expone a un LLM o una aplicación de IA para realizar una acción en el mundo real.
Herramientas
El servidor de MCP paydeveloper.googleapis.com tiene las siguientes herramientas:
| Herramientas de MCP | |
|---|---|
search_documentation |
Busca y recupera las secciones más relevantes y actualizadas de la documentación oficial para desarrolladores y las muestras de código de Google Pay y Billetera de Google. |
list_merchants |
Recupera una lista completa de todos los comercios de Google Pay asociados con la cuenta autenticada. Según el rol del usuario en un comercio, los administradores pueden ver la información detallada completa del comercio, mientras que los desarrolladores solo pueden ver la información básica del comercio. |
list_google_pay_integrations |
Muestra el estado actual y los detalles de configuración de todas las integraciones de Google Pay asociadas con un ID de comerciante específico. Proporciona comentarios inmediatos sobre el estado de la integración y las revisiones de documentos. Además, DEBES informar al usuario que la integración se puede crear o actualizar en la consola de Google Pay y Billetera (https://pay.google.com/business/console/). |
create_merchant |
Crea un comercio nuevo con la cuenta autenticada. DEBES pedirle al usuario que proporcione la información necesaria para crear el comercio. Uno de los campos obligatorios es el Código de categoría del comercio (MCC). Como la lista de MCC es larga, puedes presentar un subconjunto de opciones comunes, pero DEBES informar al usuario que hay más opciones disponibles y que puede solicitar la lista completa (p.ej., mostrando "X opciones más" o una sugerencia similar). Además, informa al usuario que puede proporcionar directamente el código MCC de 4 dígitos (p.ej., 5499) si ya lo conoce y anímalo a usarlo. No llames a esta herramienta hasta que hayas intentado recopilar la información necesaria para crear el comercio. Después de crear el comercio, DEBES mostrarle al usuario la URL de las Condiciones del Servicio de Business Console y pedirle que las acepte para poder realizar operaciones en este comercio. |
list_pass_issuers |
Recupera una lista completa de todos los emisores de pases registrados en la consola de Business de Billetera de Google asociados con el usuario autenticado. Esta herramienta proporciona información esencial para los desarrolladores que administran pases de Billetera, como tarjetas de lealtad, tarjetas de regalo o vuelos. |
list_pass_classes |
Recupera una lista completa de todas las clases de pases registradas en la consola de Business de Billetera de Google asociadas con el usuario autenticado. Esta herramienta proporciona información esencial para los desarrolladores que administran pases de Billetera, como tarjetas de lealtad, tarjetas de regalo o vuelos. |
validate_pass_jwt |
Valida la representación JWT de un pase o la carga útil JWT sin codificar como una cadena JSON para un pase. |
query_merchant_performance |
Recupera datos de rendimiento agregados de alto nivel y métricas posteriores a la integración para un perfil de negocio de comercio específico. |
query_merchant_error_metrics |
Recupera métricas de errores detalladas para un perfil de negocio de comercio específico. Esta herramienta proporciona un desglose detallado de los errores, lo que permite a los desarrolladores identificar y resolver problemas. |
update_merchant |
Actualiza campos específicos de un comercio existente. Los campos admitidos incluyen display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email y customer_support_phone. |
list_principals |
Muestra los principales (usuarios) que tienen acceso a un comercio específico. Esta operación requiere acceso de administrador para el comercio. |
set_principal_role |
Establece el rol de un principal (usuario) en un comercio o agrega un principal nuevo con el rol especificado. Se envía una invitación por correo electrónico al principal, que debe aceptarla para que se active su acceso. Esta operación requiere acceso de administrador para el comercio. |
delete_principal |
Borra el acceso de un principal (usuario) a un comercio específico. Esta operación requiere acceso de administrador para el comercio. |
Obtén las especificaciones de la herramienta de MCP
Para obtener las especificaciones de la herramienta de MCP para todas las herramientas de un servidor de MCP, usa el método tools/list. En el siguiente ejemplo, se muestra cómo usar curl para enumerar todas las herramientas y sus especificaciones disponibles actualmente en el servidor de MCP.
| Solicitud curl |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |