Se trata de un servidor de MCP que proporciona herramientas a los desarrolladores de pago.
Un servidor Model Context Protocol (MCP) actúa como proxy entre un servicio externo que proporciona contexto, datos o funciones a un modelo de lenguaje extenso (LLM) o una aplicación de IA. Los servidores de MCP conectan las 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 pueda entender.
Configuración del servidor
Antes de usar los servidores de MCP, debes habilitarlos y configurar la autenticación. Para obtener más información sobre el uso de servidores de MCP remotos de Google y Google Cloud, consulta el resumen de los servidores de MCP de Google Cloud.
Endpoints del servidor
Un endpoint de servicio de MCP es la dirección de red y la interfaz de comunicación (normalmente, una URL) del servidor de MCP que usa una aplicación de IA (el host del cliente de MCP) para establecer una conexión segura y estandarizada. Es el punto de contacto del LLM para solicitar contexto, llamar a una herramienta o acceder a un recurso. Los endpoints de MCP de Google pueden ser globales o regionales.
La API del servidor de MCP de Google Pay y Wallet Developer tiene el siguiente endpoint de MCP global:
- https://paydeveloper.googleapis.com/mcp
Herramientas de MCP
Una herramienta de MCP es una función o una capacidad ejecutable que un servidor de MCP expone a un LLM o a 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 obtiene las secciones más relevantes y actualizadas de la documentación para desarrolladores y los ejemplos de código oficiales de Google Pay y Google Wallet. |
list_merchants |
Obtiene una lista completa de todos los comerciantes de Google Pay asociados a la cuenta autenticada. En función del rol del usuario en un comercio, los administradores pueden ver información detallada completa del comercio, mientras que los desarrolladores solo pueden ver información básica. |
list_google_pay_integrations |
Devuelve el estado actual y los detalles de configuración de todas las integraciones de Google Pay asociadas a 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 de que la integración se puede crear o actualizar en la Consola de Google Pay y Wallet (https://pay.google.com/business/console/). |
create_merchant |
Crea un nuevo comerciante con la cuenta autenticada. DEBES pedir al usuario que proporcione la información necesaria para crear la cuenta de comerciante. Uno de los campos obligatorios es el código de categoría del comercio (MCC). Como la lista de MCCs es larga, puedes mostrar un subconjunto de opciones comunes, pero DEBES informar al usuario de que hay más opciones disponibles y que puede pedir la lista completa (por ejemplo, mostrando "X opciones más" o un mensaje similar). Además, informa al usuario de que puede proporcionar directamente el código MCC de 4 dígitos (por ejemplo, 5499) si ya lo conoce y anímale a que lo use. No llames a esta herramienta hasta que hayas intentado recoger la información necesaria para crear la cuenta de comerciante. Una vez que se haya creado el comerciante, DEBES mostrar al usuario la URL de los Términos del Servicio de la Consola para empresas e indicarle que los acepte para poder realizar operaciones en este comerciante. |
list_pass_issuers |
Obtiene una lista completa de todos los emisores de pases, carnés y tarjetas registrados en la consola de empresa de Google Wallet asociados al usuario autenticado. Esta herramienta proporciona información esencial a los desarrolladores que gestionan pases, tarjetas de fidelización, tarjetas regalo o vuelos de Wallet. |
list_pass_classes |
Obtiene una lista completa de todas las clases de pases, carnés y tarjetas registradas en la consola de empresa de Google Wallet asociada al usuario autenticado. Esta herramienta proporciona información esencial a los desarrolladores que gestionan pases, tarjetas de fidelización, tarjetas regalo o vuelos de Wallet. |
validate_pass_jwt |
Valida la representación JWT de un documento o la carga útil JWT sin codificar como una cadena JSON de un documento. |
query_merchant_performance |
Obtiene datos de rendimiento agregados de alto nivel y métricas posteriores a la integración de un perfil de empresa de comerciante específico. |
query_merchant_error_metrics |
Recupera métricas de error detalladas de un Perfil de Empresa de un comerciante específico. Esta herramienta ofrece un desglose detallado de los errores, lo que permite a los desarrolladores identificar y resolver problemas. |
update_merchant |
Actualiza campos específicos de un comerciante. Entre los campos admitidos se incluyen display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email y customer_support_phone. |
list_principals |
Muestra las entidades principales (usuarios) que tienen acceso a un comerciante específico. Esta operación requiere que el comerciante tenga acceso de administrador. |
set_principal_role |
Define el rol de un principal (usuario) en un comerciante o añade un principal con el rol especificado. Se envía una invitación por correo al director, que debe aceptarla para que se active su acceso. Esta operación requiere que el comerciante tenga acceso de administrador. |
delete_principal |
Elimina el acceso de una entidad principal (usuario) a un comercio específico. Esta operación requiere que el comerciante tenga acceso de administrador. |
Obtener las especificaciones de la herramienta de MCP
Para obtener las especificaciones de la herramienta MCP de 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 en el servidor de MCP.
| Curl Request |
|---|
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 }' |