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 connettono 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 di servizio MCP è l'indirizzo di rete e l'interfaccia di comunicazione (di solito 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 Google MCP possono essere globali o regionali.
Il server MCP per gli 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 dispone dei seguenti strumenti:
| Strumenti MCP | |
|---|---|
search_documentation |
Cerca e recupera le sezioni più pertinenti e aggiornate della documentazione ufficiale per gli sviluppatori e degli esempi di codice di Google Pay e Google Wallet. |
list_merchants |
Recupera un elenco di tutti i profili delle attività del commerciante Google Pay associati all'account autenticato. |
list_google_pay_integrations |
Restituisce lo stato attuale e i dettagli di configurazione per tutte le integrazioni di Google Pay associate a un ID commerciante specifico. Fornisce un feedback immediato sullo stato dell'integrazione e delle revisioni dei documenti. |
create_merchant |
Crea un nuovo commerciante con l'account autenticato. DEVI chiedere all'utente di fornire le informazioni necessarie 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 è necessario eseguire controlli preventivi. Se non sono stati accettati, la chiamata allo 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 per Android. 2. Poi, chiedi all'utente il tipo di integrazione: - Digli 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 Diretto. 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 loro 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 a supporto. Chiedili UNO ALLA VOLTA per garantire una mappatura corretta. Quando fai una domanda, utilizza SOLO le descrizioni delle enumerazioni di facile utilizzo. 4. Se il tipo di integrazione è Direct: - Devi anche chiedere all'utente di fornire il documento di attestazione PCI in formato PDF. Quando fai una domanda, utilizza SOLO la descrizione dell'enumerazione di facile utilizzo. 5. Per ogni file fornito, chiedi all'utente di indicare il percorso o il nome del documento se si trova nella directory corrente. Mappalo al DocumentType corretto e imposta il campo del nome 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 console aziendale Google Wallet associata all'utente autenticato. Questo strumento fornisce informazioni essenziali per gli sviluppatori che gestiscono tessere di Wallet come carte fedeltà, carte regalo o voli. |
list_pass_classes |
Recupera un elenco completo di tutte le classi di tessere registrate nella console aziendale Google Wallet associate all'utente autenticato. Questo strumento fornisce informazioni essenziali per gli sviluppatori che gestiscono tessere di Wallet come carte fedeltà, carte 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à del commerciante specifico. |
query_merchant_error_metrics |
Recupera metriche di errore dettagliate per un profilo dell'attività del commerciante specifico. Questo strumento fornisce una suddivisione granulare degli errori, consentendo agli sviluppatori di individuare e risolvere i problemi. |
Ottenere le specifiche dello strumento MCP
Per ottenere le specifiche dello strumento MCP per tutti gli strumenti di 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.
| 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 }' |