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. Các 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, chuyển đổi các phản hồi của chúng 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.
Máy chủ MCP của Nhà phát triển Google Pay và Wallet có điểm cuối MCP chung như 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 tất cả hồ sơ doanh nghiệp của người bán Google Pay được liên kết với tài khoản đã xác thực. |
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. |
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. Đừng gọi công cụ này cho đến khi bạn đã cố gắng thu thập thông tin bắt buộc để 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. |
create_google_pay_integration |
Tạo một chế độ tích hợp Google Pay cho một người bán cụ thể. Để thực hiện thao tác này, người dùng phải chấp nhận Điều khoản dịch vụ của Business Console và Điều khoản dịch vụ của Google Pay API. Bạn không cần phải kiểm tra trước những điều này. Nếu chưa được chấp nhận, lệnh gọi công cụ sẽ không thành công và thông báo lỗi sẽ chứa các URL cụ thể của Điều khoản dịch vụ cần được chấp nhận. Nếu điều này xảy ra, hãy cho người dùng thấy các URL để họ chấp nhận và hướng dẫn họ thử lại sau khi chấp nhận. Hãy làm theo trình tự này để tương tác với người dùng TRƯỚC KHI gọi công cụ: 1. Trước tiên, hãy yêu cầu người dùng cung cấp mục tích hợp (Hiện tại, chỉ hỗ trợ tích hợp Web). – Yêu cầu cung cấp URL của trang web. # – Nếu mục tích hợp là Tích hợp ứng dụng, hãy yêu cầu tên gói ứng dụng Android. 2. Sau đó, hãy hỏi người dùng về loại tích hợp: – Yêu cầu người dùng chọn Cổng nếu họ sử dụng một trong những Nhà cung cấp dịch vụ thanh toán (PSP) mà chúng tôi hỗ trợ (https://developers.google.com/pay/api#participating-processors), nếu không, hãy chọn Trực tiếp. 3. Đối với TẤT CẢ các loại tích hợp (Trực tiếp hoặc Cổng): – Yêu cầu người dùng tải ảnh chụp màn hình (tối đa 1 MB) về quy trình mua được tích hợp với API Google Pay lên. Quy trình mua hàng của họ phải được xem xét và phê duyệt thì họ mới được cấp quyền truy cập vào kênh phát hành công khai. Ví dụ: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. – Bạn PHẢI yêu cầu người dùng cung cấp 5 ảnh chụp màn hình hỗ trợ. Yêu cầu họ cung cấp từng thông tin MỘT để đảm bảo việc liên kết chính xác. CHỈ sử dụng nội dung mô tả enum thân thiện với người dùng khi đặt câu hỏi. 4. Nếu loại tích hợp là Trực tiếp: – BẠN CŨNG PHẢI yêu cầu người dùng cung cấp chứng nhận PCI ở định dạng PDF. CHỈ sử dụng nội dung mô tả enum thân thiện với người dùng khi đặt câu hỏi. 5. Đối với mỗi tệp được cung cấp, hãy yêu cầu người dùng cung cấp đường dẫn hoặc tên tài liệu nếu tệp đó nằm trong thư mục hiện tại. Liên kết yêu cầu này với DocumentType chính xác và đặt trường tên thành một tên mô tả (ví dụ: item_selection.png hoặc pci_attestation.pdf). Đừng gọi công cụ này cho đến khi bạn đã cố gắng thu thập các tài liệu bắt buộc cho loại tích hợp đã chọn. |
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 đủ gồm tất cả các lớp thẻ và vé đã đăng ký trong bảng điều khiển dành cho doanh nghiệp của 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 đề. |
Nhận thông số kỹ thuật của công cụ MCP
Để nhận 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 }' |