Đâ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ủ MCP và thiế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.
API máy chủ MCP dành cho nhà phát triển Google Pay & Wallet có điểm cuối MCP toàn cầu sau:
- 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 đủ tất cả các nhà cung cấp dịch vụ Google Pay được liên kết với tài khoản đã xác thực. Tùy thuộc vào vai trò của người dùng trên trang 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. |
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, bạn có thể chỉ hiển thị một tập hợp con các tùy chọn phổ biến, nhưng bạn PHẢI thông báo cho người dùng rằng còn nhiều tùy chọn khác và họ có thể yêu cầu danh sách đầy đủ (ví dụ: bằng cách hiển thị "X tùy chọn nữa" 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. Không nên sử dụng 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 tài khoản người bán. Sau khi tạo tài khoản người bán, bạn PHẢI hiển thị 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 trước khi họ có thể thực hiện bất kỳ thao tác nào trên tài khoản người bán này. |
list_pass_issuers |
Truy xuất danh sách đầy đủ tất cả các đơn vị phát hành thẻ đã đăng ký trong bảng điều khiển doanh nghiệp Google Wallet liên kết với người dùng đã được xác thực. Công cụ này cung cấp thông tin thiết yếu cho các nhà phát triển quản lý các loại thẻ trong Wallet 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 thiết yếu cho các nhà phát triển quản lý các loại thẻ trong Wallet 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 tích hợp cho hồ sơ 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 |
Thiết lập vai trò của người dùng (chủ thể) trên trang người bán, hoặc thêm người dùng mới với 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 |
Xóa quyền truy cập của người dùng (chủ thể) vào một cửa hàng 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 }' |