Un servidor del 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 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 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.
El 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 para desarrolladores y las muestras de código oficiales de Google Pay y Billetera de Google. |
list_merchants |
Recupera una lista de todos los perfiles de negocio de comercios de Google Pay asociados con la cuenta autenticada. |
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. |
create_merchant |
Crea un comercio nuevo con la cuenta autenticada. DEBES pedirle al usuario que proporcione la información necesaria para crear el comercio. 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 la acepte antes de que pueda realizar cualquier operación en este comercio. |
create_google_pay_integration |
Crea una integración de Google Pay para un comercio específico. Esta operación requiere que el usuario haya aceptado las Condiciones del Servicio de Business Console y las Condiciones del Servicio de la API de Google Pay. No es necesario que los verifiques de forma preventiva. Si no se aceptaron, la llamada a la herramienta fallará y el mensaje de error contendrá las URLs específicas de las Condiciones del Servicio que deben aceptarse. Si esto ocurre, muéstrale las URLs al usuario para que las acepte y pídele que vuelva a intentarlo una vez que lo haga. Sigue esta secuencia para interactuar con el usuario ANTES de llamar a la herramienta: 1. Primero, pídele al usuario el elemento de integración (por ahora, solo se admite la integración web). - Pídele la URL del sitio web. # - Si el elemento de integración es la integración de la app, pídele el nombre del paquete de la app para Android. 2. Luego, pídele al usuario el tipo de integración: - Dile al usuario que elija Puerta de enlace si usa uno de nuestros proveedores de servicios de pago (PSP) admitidos (https://developers.google.com/pay/api#participating-processors); de lo contrario, elige Directa. 3. Para TODOS los tipos de integración (Directa o Puerta de enlace): - Dile al usuario que suba capturas de pantalla (1 MB como máximo) de su flujo de compra integrado con la API de Google Pay. Se debe revisar y aprobar su flujo de compra antes de que se le otorgue acceso a producción completo. Ejemplos: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - DEBES pedirle al usuario que proporcione 5 capturas de pantalla de respaldo. Pídelas UNA POR UNA para garantizar la asignación correcta. Usa SOLO las descripciones de enumeración fáciles de usar cuando preguntes. 4. Si el tipo de integración es Directa: - TAMBIÉN DEBES pedirle al usuario que proporcione el documento de certificación de PCI en formato PDF. Usa SOLO la descripción de enumeración fácil de usar cuando preguntes. 5. Para cada archivo proporcionado, pídele al usuario que proporcione la ruta o el nombre del documento si está en el directorio actual. Asígnalo al DocumentType correcto y establece el campo name en un nombre descriptivo (p.ej., item_selection.png o pci_attestation.pdf) en la solicitud. No llames a esta herramienta hasta que hayas intentado recopilar los documentos necesarios para el tipo de integración seleccionado. |
list_pass_issuers |
Recupera una lista completa de todos los emisores de pases registrados en la consola de negocios 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 negocios 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. |
Obtén especificaciones de herramientas de MCP
Para obtener las especificaciones de las herramientas 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 }' |