MCP Reference: paydeveloper.googleapis.com

Đây là một máy chủ MCP cung cấp các công cụ cho nhà phát triển Pay.

Máy chủ Giao thức ngữ cảnh mô hình (MCP) đóng vai trò là một proxy giữa dịch vụ bên ngoài cung cấp ngữ cảnh, dữ liệu hoặc các chức năng cho Mô hình ngôn ngữ lớn (LLM) hoặc ứng dụng AI. Máy chủ MCP kết nối các ứng dụng AI với các hệ thống bên ngoài như cơ sở dữ liệu và dịch vụ web, dịch các câu trả lời của các hệ thống này sang định dạng mà ứng dụng AI có thể hiểu được.

Thiết lập máy chủ

Bạn phải bật máy chủ MCPthiết lập quy trình xác thực trước khi sử dụng. Để biết thêm thông tin về cách sử dụng máy chủ MCP từ xa của Google và Google Cloud, hãy xem bài viết Tổng quan về máy chủ MCP của Google Cloud.

Điểm cuối của máy chủ

Điểm cuối dịch vụ MCP là địa chỉ mạng và giao diện giao tiếp (thường là một URL) của máy chủ MCP mà một ứng dụng AI (Máy chủ lưu trữ cho ứng dụng MCP) sử dụng để thiết lập một kết nối an toàn, tiêu chuẩn. Đây là đầu mối liên hệ để LLM yêu cầu ngữ cảnh, gọi một công cụ hoặc truy cập vào một tài nguyên. Các điểm cuối MCP của Google có thể là toàn cầu hoặc theo khu vực.

Máy chủ MCP của Google Pay & Wallet Developer MCP API có điểm cuối MCP chung sau đây:

  • https://paydeveloper.googleapis.com/mcp

Công cụ MCP

Công cụ MCP là một chức năng hoặc khả năng thực thi mà máy chủ MCP cung cấp cho một LLM hoặc ứng dụng AI để thực hiện một hành động trong thế giới thực.

Công cụ

Máy chủ MCP paydeveloper.googleapis.com có các công cụ sau:

Công cụ MCP
search_documentation Tìm kiếm và truy xuất các phần phù hợp nhất, mới nhất trong tài liệu chính thức dành cho nhà phát triển Google Pay và Google Wallet cũng như các mẫu mã.
list_merchants Truy xuất danh sách đầy đủ gồm tất cả người bán Google Pay được liên kết với tài khoản đã xác thực. Tuỳ thuộc vào vai trò của người dùng đối với một người bán, quản trị viên có thể xem thông tin chi tiết đầy đủ về người bán, trong khi nhà phát triển chỉ có thể xem thông tin cơ bản về người bán.
list_google_pay_integrations Trả về trạng thái hiện tại và thông tin chi tiết về cấu hình cho tất cả các hoạt động tích hợp Google Pay được liên kết với một Mã người bán cụ thể. Tính năng này cung cấp ý kiến phản hồi ngay lập tức về trạng thái tích hợp và đánh giá tài liệu. Ngoài ra, BẠN PHẢI thông báo cho người dùng rằng họ có thể tạo/cập nhật chế độ tích hợp trong Bảng điều khiển Google Pay và Wallet (https://pay.google.com/business/console/).
create_merchant Tạo người bán mới bằng tài khoản đã xác thực. Bạn PHẢI yêu cầu người dùng cung cấp thông tin bắt buộc để tạo người bán. Một trong các trường bắt buộc là Mã danh mục của người bán (MCC). Vì danh sách MCC rất dài, nên bạn có thể trình bày một nhóm nhỏ các lựa chọn phổ biến, nhưng BẠN PHẢI thông báo cho người dùng rằng có nhiều lựa chọn khác và họ có thể yêu cầu danh sách đầy đủ (ví dụ: bằng cách cho thấy "X lựa chọn khác" hoặc gợi ý tương tự). Ngoài ra, hãy thông báo cho người dùng rằng họ có thể cung cấp trực tiếp mã MCC gồm 4 chữ số (ví dụ: 5499) nếu đã biết và khuyến khích họ sử dụng mã này. Đừng gọi công cụ này cho đến khi bạn đã cố gắng thu thập thông tin cần thiết để tạo người bán. Sau khi tạo người bán, BẠN PHẢI cung cấp URL Điều khoản dịch vụ của Business Console cho người dùng và hướng dẫn họ chấp nhận URL này trước khi họ có thể thực hiện bất kỳ thao tác nào trên người bán này.
list_pass_issuers Truy xuất danh sách đầy đủ gồm tất cả các đơn vị phát hành thẻ và vé đã đăng ký trong bảng điều khiển doanh nghiệp Google Wallet được liên kết với người dùng đã xác thực. Công cụ này cung cấp thông tin cần thiết cho những nhà phát triển quản lý thẻ và vé trong Wallet, chẳng hạn như thẻ khách hàng thân thiết, thẻ quà tặng hoặc vé máy bay.
list_pass_classes Truy xuất danh sách đầy đủ tất cả các lớp thẻ và vé đã đăng ký trong bảng điều khiển doanh nghiệp Google Wallet được liên kết với người dùng đã xác thực. Công cụ này cung cấp thông tin cần thiết cho những nhà phát triển quản lý thẻ và vé trong Wallet, chẳng hạn như thẻ khách hàng thân thiết, thẻ quà tặng hoặc vé máy bay.
validate_pass_jwt Xác thực biểu thị JWT của thẻ hoặc tải trọng JWT chưa được mã hoá dưới dạng chuỗi JSON cho thẻ.
query_merchant_performance Truy xuất dữ liệu hiệu suất tổng hợp cấp cao và các chỉ số sau khi tích hợp cho một trang doanh nghiệp cụ thể của người bán.
query_merchant_error_metrics Truy xuất các chỉ số lỗi chi tiết cho một trang doanh nghiệp cụ thể của người bán. Công cụ này cung cấp thông tin chi tiết về các lỗi, cho phép nhà phát triển xác định và giải quyết vấn đề.
update_merchant Cập nhật một số trường của người bán hiện có. Các trường được hỗ trợ bao gồm display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email và customer_support_phone.
list_principals Liệt kê các chủ thể (người dùng) có quyền truy cập vào một người bán cụ thể. Thao tác này yêu cầu người bán có quyền truy cập của Quản trị viên.
set_principal_role Đặt vai trò của một người đại diện (người dùng) trên một người bán hoặc thêm một người đại diện mới có vai trò được chỉ định. Bên uỷ quyền sẽ nhận được một lời mời qua email và phải chấp nhận lời mời đó thì quyền truy cập của họ mới có hiệu lực. Thao tác này yêu cầu người bán có quyền truy cập của Quản trị viên.
delete_principal Xoá quyền truy cập của một pháp nhân (người dùng) vào một người bán cụ thể. Thao tác này yêu cầu người bán có quyền truy cập của Quản trị viên.

Nhận thông số kỹ thuật của công cụ MCP

Để lấy thông số kỹ thuật của công cụ MCP cho tất cả công cụ trong máy chủ MCP, hãy sử dụng phương thức tools/list. Ví dụ sau đây minh hoạ cách sử dụng curl để liệt kê tất cả các công cụ và thông số kỹ thuật hiện có trong máy chủ MCP.

Yêu cầu 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
}'