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 ulteriori informazioni 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.
Il 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 di tutti i profili delle attività dei commercianti di Google Pay associati all'account autenticato. |
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. |
create_merchant |
Crea un nuovo commerciante con l'account autenticato. DEVI chiedere all'utente di fornire le informazioni richieste per la creazione del commerciante. 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. |
create_google_pay_integration |
Crea un'integrazione di Google Pay per un commerciante specifico. Questa operazione richiede che l'utente abbia accettato i Termini di servizio della Business Console e i Termini di servizio dell'API Google Pay. Non devi controllarli in modo preventivo. Se non sono stati accettati, la chiamata dello strumento non andrà a buon fine e il messaggio di errore conterrà gli URL specifici dei Termini di servizio che devono essere accettati. In questo caso, presenta gli URL all'utente per l'accettazione e chiedigli di riprovare una volta accettati. Segui questa sequenza per interagire con l'utente PRIMA di chiamare lo strumento: 1. Innanzitutto, chiedi all'utente l'elemento di integrazione (al momento è supportata solo l'integrazione web). - Chiedi l'URL del sito web. # - Se l'elemento di integrazione è l'integrazione dell'app, chiedi il nome del pacchetto dell'app Android. 2. Poi, chiedi all'utente il tipo di integrazione: - Chiedi all'utente di scegliere Gateway se utilizza uno dei nostri fornitori di servizi di pagamento (PSP) supportati (https://developers.google.com/pay/api#participating-processors), altrimenti scegli Diretta. 3. Per TUTTI i tipi di integrazione (Diretta o Gateway): - Chiedi all'utente di caricare screenshot (max 1 MB) del percorso di acquisto integrato con l'API Google Pay. Il percorso di acquisto deve essere esaminato e approvato prima di poter ottenere l'accesso completo in produzione. Esempi: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - DEVI chiedere all'utente di fornire 5 screenshot di supporto. Chiedili UNO ALLA VOLTA per garantire una mappatura corretta. Quando fai la domanda, utilizza SOLO le descrizioni delle enumerazioni intuitive. 4. Se il tipo di integrazione è Diretta: - DEVI anche chiedere all'utente di fornire il documento di attestazione PCI in formato PDF. Quando fai la domanda, utilizza SOLO la descrizione dell'enumerazione intuitiva. 5. Per ogni file fornito, chiedi all'utente di fornire il percorso o il nome del documento se si trova nella directory corrente. Mappalo al DocumentType corretto e imposta il campo name su un nome descrittivo (ad es. item_selection.png o pci_attestation.pdf) nella richiesta. Non chiamare questo strumento finché non hai tentato di raccogliere i documenti richiesti per il tipo di integrazione selezionato. |
list_pass_issuers |
Recupera un elenco completo di tutti gli emittenti di tessere registrati nella Business Console di Google Wallet associata all'utente autenticato. Questo strumento fornisce informazioni essenziali per gli sviluppatori che gestiscono le tessere di Wallet, come carte fedeltà, buoni regalo o voli. |
list_pass_classes |
Recupera un elenco completo di tutte le classi di tessere registrate nella Business Console di Google Wallet associata all'utente autenticato. Questo strumento fornisce informazioni essenziali per gli sviluppatori che gestiscono le tessere di Wallet, come carte fedeltà, buoni regalo o voli. |
validate_pass_jwt |
Convalida la rappresentazione JWT di una tessera o il payload JWT non codificato come stringa JSON per una tessera. |
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. |
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 }' |