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 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 de 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 Google MCP pueden ser globales o regionales.
El servidor de MCP de Google Pay y Wallet para desarrolladores 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 de todos los perfiles de empresa de comerciante 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 la integración y las revisiones de documentos. |
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. 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. |
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 los 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 se deben aceptar. Si esto ocurre, muestra las URLs al usuario para que las acepte e indícale que vuelva a intentarlo una vez que las haya aceptado. Sigue esta secuencia para interactuar con el usuario ANTES de llamar a la herramienta: 1. Primero, pregunta al usuario por 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 una integración de aplicaciones, pregunta por el nombre del paquete de la aplicación Android. 2. A continuación, pregúntale al usuario qué tipo de integración quiere: - Dile que elija "Pasarela" si usa 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 pasarela): - 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 les 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ídeles que lo hagan UNO POR UNO para asegurarse de que el mapeo sea correcto. Cuando hagas preguntas, usa SOLO las descripciones de enumeración fáciles de usar. 4. Si el tipo de integración es Direct: - TAMBIÉN DEBES pedir al usuario que proporcione el documento de certificación PCI en formato PDF. Usa SOLO la descripción de enumeración fácil de usar cuando preguntes. 5. Por cada archivo proporcionado, pide al usuario que indique la ruta o el nombre del documento si está en el directorio actual. Asigna el valor al DocumentType correcto y asigna al campo name 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 |
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. |
Obtener las especificaciones de la herramienta de MCP
Para obtener las especificaciones de la herramienta MCP de todas las herramientas de un servidor 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 }' |