Un server MCP (Model Context Protocol) acționează ca un proxy între un serviciu extern care furnizează context, date sau capabilități unui Large Language Model (LLM) sau unei aplicații de inteligență artificială. Serverele MCP conectează aplicațiile de inteligență artificială la sisteme externe, cum ar fi bazele de date și serviciile web, traducând răspunsurile acestora într-un format pe care aplicația de inteligență artificială îl poate înțelege.
Configurarea serverului
Trebuie să activați serverele MCP și să configurați autentificarea înainte de utilizare. Pentru mai multe informații despre utilizarea serverelor MCP la distanță Google și Google Cloud, consultați prezentarea generală a serverelor MCP Google Cloud .
Puncte finale ale serverului
Un punct final de serviciu MCP este adresa de rețea și interfața de comunicare (de obicei o adresă URL) a serverului MCP pe care o aplicație de inteligență artificială (gazda pentru clientul MCP) o utilizează pentru a stabili o conexiune securizată și standardizată. Este punctul de contact pentru LLM pentru a solicita context, a apela un instrument sau a accesa o resursă. Punctele finale Google MCP pot fi globale sau regionale.
Serverul MCP pentru dezvoltatori Google Pay & Wallet are următorul punct final MCP global:
- https://paydeveloper.googleapis.com/mcp
Instrumente MCP
Un instrument MCP este o funcție sau o capacitate executabilă pe care un server MCP o expune unei aplicații LLM sau AI pentru a efectua o acțiune în lumea reală.
Instrumente
Serverul MCP paydeveloper.googleapis.com are următoarele instrumente:
| Instrumente MCP | |
|---|---|
search_documentation | Caută și regăsește cele mai relevante și actualizate secțiuni din documentația oficială pentru dezvoltatori Google Pay și Google Wallet și din exemplele de cod. |
list_merchants | Preia o listă cu toate profilurile comerciale Google Pay asociate contului autentificat. |
list_google_pay_integrations | Returnează starea actuală și detaliile de configurare pentru toate integrările Google Pay asociate cu un anumit ID de comerciant. Oferă feedback imediat cu privire la starea integrării și revizuiri ale documentelor. |
create_merchant | Creează un comerciant nou cu contul autentificat. TREBUIE să solicitați utilizatorului să furnizeze informațiile necesare pentru crearea comerciantului. Nu apelați acest instrument până când nu ați încercat să colectați informațiile necesare pentru crearea comerciantului. După ce comerciantul este creat, TREBUIE să prezentați utilizatorului adresa URL a Termenilor și condițiilor de utilizare din Business Console și să îl instruiți să o accepte înainte de a putea efectua orice operațiuni asupra acestui comerciant. |
create_google_pay_integration | Creează o integrare Google Pay pentru un anumit comerciant. Această operațiune necesită ca utilizatorul să fi acceptat Termenii și condițiile Business Console și Termenii și condițiile Google Pay API. Nu este nevoie să le verificați preventiv. Dacă nu au fost acceptate, apelul instrumentului va eșua, iar mesajul de eroare va conține adresele URL specifice ale Termenilor și condițiilor care trebuie acceptate. Dacă se întâmplă acest lucru, prezentați adresele URL utilizatorului pentru acceptare și instruiți-l să încerce din nou după acceptare. Urmați această secvență pentru a interacționa cu utilizatorul ÎNAINTE de a apela instrumentul: 1. Mai întâi, solicitați utilizatorului elementul de integrare (momentan este acceptată doar integrarea web). - Solicitați adresa URL a site-ului web. # - Dacă elementul de integrare este Integrare aplicație, solicitați numele pachetului aplicației Android. 2. Apoi, solicitați utilizatorului tipul de integrare: - Spuneți utilizatorului să aleagă Gateway dacă utilizează unul dintre Furnizorii noștri de Servicii de Plată acceptați (PSP-uri: https://developers.google.com/pay/api#participating-processors ), altfel alegeți Direct. 3. Pentru TOATE tipurile de integrare (Directă sau Gateway): - Solicitați utilizatorului să încarce capturi de ecran (maxim 1 MB) ale fluxului său de achiziție integrat cu API-ul Google Pay. Fluxul său de achiziție trebuie revizuit și aprobat înainte de a primi acces complet la producție. Exemple: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together . - TREBUIE să solicitați utilizatorului să furnizeze 5 capturi de ecran justificative. Solicitați-le UNUL CÂTE UNUL pentru a asigura maparea corectă. Folosiți DOAR descrierile enumerative ușor de utilizat atunci când solicitați. 4. Dacă tipul de integrare este Direct: - TREBUIE, DE ASEMENEA, să solicitați utilizatorului să furnizeze documentul de atestare PCI în format PDF. Folosiți DOAR descrierea enumerativă ușor de utilizat atunci când solicitați. 5. Pentru fiecare fișier furnizat, solicitați utilizatorului să furnizeze calea sau numele documentului, dacă se află în directorul curent. Mapați-l la DocumentType corect și setați câmpul name la un nume descriptiv (de exemplu, item_selection.png sau pci_attestation.pdf) în solicitare. Nu apelați acest instrument până nu ați încercat să colectați documentele necesare pentru tipul de integrare selectat. |
list_pass_issuers | Preia o listă completă a tuturor emitenților de permise înregistrați în consola de afaceri Google Wallet, asociați cu utilizatorul autentificat. Acest instrument oferă informații esențiale pentru dezvoltatorii care gestionează permise Wallet, cum ar fi carduri de fidelitate, carduri cadou sau zboruri. |
list_pass_classes | Preia o listă completă a tuturor claselor de permise înregistrate în consola de afaceri Google Wallet asociate utilizatorului autentificat. Acest instrument oferă informații esențiale pentru dezvoltatorii care gestionează permise Wallet, cum ar fi carduri de fidelitate, carduri cadou sau zboruri. |
validate_pass_jwt | Validează reprezentarea JWT a unei pase sau sarcina utilă JWT necodificată ca șir JSON pentru o pase. |
query_merchant_performance | Preia date agregate de performanță la nivel înalt și valori post-integrare pentru un anumit profil de comerciant. |
query_merchant_error_metrics | Obține valori detaliate ale erorilor pentru un anumit profil comercial. Acest instrument oferă o defalcare granulară a erorilor, permițând dezvoltatorilor să identifice și să rezolve problemele. |
Obțineți specificațiile instrumentului MCP
Pentru a obține specificațiile instrumentelor MCP pentru toate instrumentele dintr-un server MCP, utilizați metoda tools/list . Următorul exemplu demonstrează cum se utilizează curl pentru a lista toate instrumentele și specificațiile acestora disponibile în prezent pe serverul MCP.
| Cerere de bucle |
|---|
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 }' |