Questo è un server MCP che fornisce strumenti agli sviluppatori di Pay.
Un server Model Context Protocol (MCP) funge da proxy tra un servizio esterno che fornisce contesto, dati o funzionalità a un modello linguistico di grandi dimensioni (LLM) o a un'applicazione AI. I server MCP collegano le applicazioni AI a sistemi esterni come database e servizi web, traducendo le loro risposte in un formato che l'applicazione AI può comprendere.
Configurazione del server
Prima dell'uso, devi abilitare i server MCP e configurare l'autenticazione. Per saperne di più sull'utilizzo dei server MCP remoti di Google e Google Cloud, consulta la panoramica dei server MCP di Google Cloud.
Endpoint server
Un endpoint del servizio MCP è l'indirizzo di rete e l'interfaccia di comunicazione (in genere un URL) del server MCP che un'applicazione AI (l'host per il client MCP) utilizza per stabilire una connessione sicura e standardizzata. È il punto di contatto per l'LLM per richiedere il contesto, chiamare uno strumento o accedere a una risorsa. Gli endpoint MCP di Google possono essere globali o regionali.
L'API del server MCP del server MCP per sviluppatori di Google Pay e Google Wallet ha il seguente endpoint MCP globale:
- https://paydeveloper.googleapis.com/mcp
Strumenti MCP
Uno strumento MCP è una funzione o una funzionalità eseguibile che un server MCP espone a un LLM o a un'applicazione AI per eseguire un'azione nel mondo reale.
Strumenti
Il server MCP paydeveloper.googleapis.com ha i seguenti strumenti:
| Strumenti MCP | |
|---|---|
search_documentation |
Cerca e recupera le sezioni più pertinenti e aggiornate della documentazione per gli sviluppatori e degli esempi di codice ufficiali di Google Pay e Google Wallet. |
list_merchants |
Recupera un elenco completo di tutti i commercianti Google Pay associati all'account autenticato. A seconda del ruolo dell'utente in un commerciante, gli amministratori possono visualizzare informazioni dettagliate complete sul commerciante, mentre gli sviluppatori possono visualizzare solo le informazioni di base sul commerciante. |
list_google_pay_integrations |
Restituisce lo stato attuale e i dettagli di configurazione di tutte le integrazioni di Google Pay associate a un ID commerciante specifico. Fornisce un feedback immediato sullo stato delle revisioni dell'integrazione e dei documenti. Inoltre, DEVI informare l'utente che l'integrazione può essere creata/aggiornata nella console Google Pay e Google Wallet (https://pay.google.com/business/console/). |
create_merchant |
Crea un nuovo commerciante con l'account autenticato. DEVI chiedere all'utente di fornire le informazioni richieste per la creazione del commerciante. Uno dei campi obbligatori è il codice categoria commerciante (MCC). Poiché l'elenco dei codici MCC è lungo, puoi presentare un sottoinsieme di opzioni comuni, ma DEVI informare l'utente che sono disponibili altre opzioni e che può chiedere l'elenco completo (ad es. mostrando "Altre X opzioni" o un suggerimento simile). Inoltre, informa l'utente che può fornire direttamente il codice MCC di 4 cifre (ad es. 5499) se lo conosce già e incoraggialo a utilizzarlo. Non chiamare questo strumento finché non hai tentato di raccogliere le informazioni richieste per la creazione del commerciante. Dopo aver creato il commerciante, DEVI presentare all'utente l'URL dei Termini di servizio della Business Console e chiedergli di accettarli prima di poter eseguire qualsiasi operazione su questo commerciante. |
list_pass_issuers |
Recupera un elenco completo di tutti gli emittenti di pass registrati nella Business Console di Google Wallet associata all'utente autenticato. Questo strumento fornisce informazioni essenziali per gli sviluppatori che gestiscono i pass di Wallet, come carte fedeltà, buoni regalo o voli. |
list_pass_classes |
Recupera un elenco completo di tutte le classi di pass registrate nella Business Console di Google Wallet associata all'utente autenticato. Questo strumento fornisce informazioni essenziali per gli sviluppatori che gestiscono i pass di Wallet, come carte fedeltà, buoni regalo o voli. |
validate_pass_jwt |
Convalida la rappresentazione JWT di un pass o il payload JWT non codificato come stringa JSON per un pass. |
query_merchant_performance |
Recupera dati sul rendimento aggregati di alto livello e metriche post-integrazione per un profilo dell'attività di un commerciante specifico. |
query_merchant_error_metrics |
Recupera metriche di errore dettagliate per un profilo dell'attività di un commerciante specifico. Questo strumento fornisce una suddivisione granulare degli errori, consentendo agli sviluppatori di individuare e risolvere i problemi. |
update_merchant |
Aggiorna campi specifici di un commerciante esistente. I campi supportati includono display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email e customer_support_phone. |
list_principals |
Elenca i principali (utenti) che hanno accesso a un commerciante specifico. Questa operazione richiede l'accesso come amministratore per il commerciante. |
set_principal_role |
Imposta il ruolo di un principale (utente) su un commerciante o aggiunge un nuovo principale con il ruolo specificato. Al principale viene inviato un invito via email che deve accettare prima che il suo accesso diventi attivo. Questa operazione richiede l'accesso come amministratore per il commerciante. |
delete_principal |
Elimina l'accesso di un principale (utente) a un commerciante specifico. Questa operazione richiede l'accesso come amministratore per il commerciante. |
Ottenere le specifiche degli strumenti MCP
Per ottenere le specifiche degli strumenti MCP per tutti gli strumenti in un server MCP, utilizza il metodo tools/list. L'esempio seguente mostra come utilizzare curl per elencare tutti gli strumenti e le relative specifiche attualmente disponibili nel server MCP.
| Richiesta 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 }' |