Un servidor de 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 a 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
Debes habilitar los servidores de MCP y configurar la autenticación antes de usarlos. Para obtener más información sobre cómo usar los servidores de MCP remotos de Google y Google Cloud, consulta el artículo sobre 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.
El servidor de MCP para desarrolladores de Google Pay y Wallet 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 recupera 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 |
Recupera una lista de todos los perfiles de empresa de comerciantes de Google Pay asociados a la cuenta autenticada. |
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 las integraciones y las revisiones de documentos. |
create_merchant |
Crea un comerciante con la cuenta autenticada. DEBES pedir al usuario que proporcione la información necesaria para crear el comerciante. No llames a esta herramienta hasta que hayas intentado recoger la información necesaria para crear el comerciante. Una vez creado el comerciante, DEBES mostrar al usuario la URL de los Términos del Servicio de Consola para empresas e indicarle que los acepte para poder realizar operaciones en este comerciante. |
create_google_pay_integration |
Crea una integración de Google Pay para un comerciante específico. Para realizar esta operación, el usuario debe haber aceptado los Términos del Servicio de la Consola para empresas y los Términos del Servicio de la API de Google Pay. No es necesario que lo compruebes de forma preventiva. Si no se han aceptado, la llamada a la herramienta fallará y el mensaje de error contendrá las URLs específicas de los Términos del Servicio que deben aceptarse. Si esto ocurre, muestra las URLs al usuario para que las acepte e indícale que vuelva a intentarlo una vez que lo haya hecho. Sigue esta secuencia para interactuar con el usuario ANTES de llamar a la herramienta: 1. En primer lugar, pide al usuario el elemento de integración (por ahora, solo se admite la integración web). - Pide la URL del sitio web. # - Si el elemento de integración es la integración de aplicaciones, pide el nombre del paquete de la aplicación Android. 2. A continuación, pide al usuario el tipo de integración: - Indica al usuario que elija "Puerta de enlace" si utiliza uno de nuestros proveedores de servicios de pago (PSP) admitidos (https://developers.google.com/pay/api#participating-processors); de lo contrario, que elija "Directa". 3. Para TODOS los tipos de integración (directa o de puerta de enlace): - Indica al usuario que suba capturas de pantalla (1 MB como máximo) de su flujo de compra integrado con la API de Google Pay. Su flujo de compra debe revisarse y aprobarse antes de que se le conceda acceso completo a producción. Ejemplos: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - DEBES pedir al usuario que proporcione 5 capturas de pantalla de apoyo. Pídeselas UNA POR UNA para asegurarte de que se asignen correctamente. Al pedírselas, usa SOLO las descripciones de enumeración fáciles de usar. 4. Si el tipo de integración es "Directa": - TAMBIÉN DEBES pedir al usuario que proporcione el documento de certificación PCI en formato PDF. Al pedírselo, usa SOLO la descripción de enumeración fácil de usar. 5. Por cada archivo proporcionado, pide al usuario que indique la ruta o el nombre del documento si está en el directorio actual. Asígnalo al DocumentType correcto y define el campo "name" con un nombre descriptivo (por ejemplo, item_selection.png o pci_attestation.pdf) en la solicitud. No llames a esta herramienta hasta que hayas intentado recoger 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 empresa de Google Wallet asociados al usuario autenticado. Esta herramienta proporciona información esencial para los desarrolladores que gestionan pases de Wallet, como tarjetas de fidelización, tarjetas regalo o vuelos. |
list_pass_classes |
Recupera una lista completa de todas las clases de pases registradas en la consola de empresa de Google Wallet asociadas al usuario autenticado. Esta herramienta proporciona información esencial para los desarrolladores que gestionan pases de Wallet, como tarjetas de fidelización, tarjetas 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 de un pase. |
query_merchant_performance |
Recupera 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 comerciante específico. Esta herramienta proporciona un desglose detallado de los errores, lo que permite a los desarrolladores identificar y resolver problemas. |
Obtener especificaciones de herramientas de MCP
Para obtener las especificaciones de las herramientas de 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.
| Solicitud de 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 }' |