MCP Reference: paydeveloper.googleapis.com

Acesta este un server MCP care oferă instrumente dezvoltatorilor de plăți.

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 al API-ului 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ă completă a tuturor comercianților Google Pay asociați contului autentificat. În funcție de rolul utilizatorului la comerciant, administratorii pot vizualiza informații complete și detaliate despre comerciant, în timp ce dezvoltatorii pot vizualiza doar informațiile de bază despre comerciant.
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 revizuirea documentelor. În plus, TREBUIE să informați utilizatorul că integrarea poate fi creată/actualizată în Consola Google Pay și Wallet ( https://pay.google.com/business/console/) .
create_merchant Creează un comerciant nou cu contul autentificat. TREBUIE să solicitați utilizatorului să furnizeze informațiile necesare pentru crearea comerciantului. Unul dintre câmpurile obligatorii este Codul categoriei comerciantului (MCC). Deoarece lista de MCC-uri este lungă, puteți prezenta un subset de opțiuni comune, dar TREBUIE să informați utilizatorul că sunt disponibile mai multe opțiuni și că poate solicita lista completă (de exemplu, afișând „X mai multe opțiuni” sau un indiciu similar). În plus, informați utilizatorul că poate furniza direct codul MCC de 4 cifre (de exemplu, 5499) dacă îl cunoaște deja și încurajați-l să îl utilizeze. 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.
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.
update_merchant Actualizează câmpuri specifice ale unui comerciant existent. Câmpurile acceptate includ display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email și customer_support_phone.
list_principals Listează utilizatorii principali care au acces la un anumit comerciant. Această operațiune necesită acces de administrator pentru comerciant.
set_principal_role Setează rolul unui utilizator principal la un comerciant sau adaugă un nou utilizator principal cu rolul specificat. Utilizatorului principal i se trimite o invitație prin e-mail și trebuie să o accepte înainte ca accesul său să devină activ. Această operațiune necesită acces de administrator pentru comerciant.
delete_principal Șterge accesul unui utilizator principal la un anumit comerciant. Această operațiune necesită acces de administrator pentru comerciant.

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
}'