Kết nối với máy chủ MCP của Google Pay và Wallet Developer

Máy chủ MCP của Google Pay và Wallet Developer cung cấp cho các công cụ phát triển dựa trên AI khả năng truy cập vào dữ liệu nhà phát triển Google Pay và Google Wallet, tìm kiếm tài liệu chính thức và quản lý các chế độ tích hợp của bạn.

Giao thức ngữ cảnh mô hình (MCP) tiêu chuẩn hoá cách các mô hình ngôn ngữ lớn (LLM) và ứng dụng hoặc tác nhân AI kết nối với các nguồn dữ liệu bên ngoài. Các máy chủ MCP cho phép bạn sử dụng các công cụ, tài nguyên và lời nhắc của chúng để thực hiện các hành động và nhận dữ liệu mới nhất từ dịch vụ phụ trợ của chúng.

Máy chủ MCP của Nhà phát triển Google Pay và Wallet cho phép bạn:

Tài liệu tìm kiếm: Nhận hướng dẫn và mẫu mã mới nhất từ tài liệu chính thức của Google Pay và Google Wallet.
Quản lý các dịch vụ tích hợp: Kiểm tra trạng thái của các dịch vụ tích hợp và bật API cho tài khoản người bán.
Theo dõi hiệu suất: Truy cập vào dữ liệu hiệu suất tổng hợp và các chỉ số lỗi cho tài khoản người bán của bạn.
Quản lý thẻ và vé: Liệt kê các tổ chức phát hành thẻ và vé cũng như các lớp học cho Google Wallet.

Lưu ý: Hãy xem tài liệu tham khảo về Pay & Wallet Developer để xem thông tin chi tiết về các công cụ MCP hiện có và nội dung mô tả của chúng.

Câu lệnh mẫu

Bạn có thể sử dụng các câu lệnh sau với trợ lý AI:

"Liệt kê các tài khoản Google Pay của tôi."
"Trạng thái của các dịch vụ tích hợp Google Pay là gì?"
"Làm cách nào để tích hợp Google Pay với React?"
Cho tôi xem các chỉ số lỗi của Google Pay cho hoạt động tích hợp của tôi trong 30 ngày qua.
"List my Google Wallet pass classes." (Liệt kê các lớp thẻ và vé trong Google Wallet của tôi.)

Trước khi bắt đầu

Để sử dụng máy chủ MCP của Nhà phát triển Google Pay và Wallet, bạn phải tạo một dự án trên đám mây của Google, đồng thời bật máy chủ MCP của Nhà phát triển Google Pay và Wallet cũng như các API Google Wallet.

Trong bảng điều khiển Cloud, trên trang chọn dự án, hãy chọn hoặc tạo một dự án trên Google Cloud.

Chuyển đến bộ chọn dự án
Bật Pay & Wallet Developer, Google Wallet API.
Các vai trò cần thiết để bật API
Để bật API, bạn cần có vai trò Quản trị viên sử dụng dịch vụ IAM (roles/serviceusage.serviceUsageAdmin), trong đó có quyền serviceusage.services.enable. Tìm hiểu cách cấp vai trò.
Bật các API

Vai trò bắt buộc

Để có được các quyền cần thiết để sử dụng máy chủ MCP từ xa của máy chủ MCP Nhà phát triển Google Pay và Wallet, hãy yêu cầu quản trị viên cấp cho bạn các vai trò Quản lý danh tính và quyền truy cập (IAM) sau đây trên dự án trên đám mây của Google nơi bạn muốn bật máy chủ MCP của máy chủ MCP Nhà phát triển Google Pay và Wallet:

Thực hiện các lệnh gọi công cụ MCP: Người dùng công cụ MCP (roles/mcp.toolUser)

Để biết thêm thông tin về cách cấp vai trò, hãy xem bài viết Quản lý quyền truy cập vào dự án, thư mục và tổ chức.

Xác thực và uỷ quyền

Máy chủ MCP của Google Pay và Wallet Developer sử dụng giao thức OAuth 2.0 với Giải pháp quản lý danh tính và quyền truy cập (IAM) để xác thực và uỷ quyền. Mọi danh tính đều được hỗ trợ để xác thực với máy chủ MCP.

Máy chủ MCP của Google Pay và Wallet Developer không chấp nhận khoá API.

Bạn nên tạo một danh tính riêng biệt cho những nhân viên sử dụng các công cụ MCP để có thể kiểm soát và theo dõi quyền truy cập vào tài nguyên. Để biết thêm thông tin về quy trình xác thực, hãy xem phần Xác thực với các máy chủ MCP.

Các phạm vi OAuth của máy chủ MCP dành cho nhà phát triển Google Pay và Wallet

OAuth 2.0 sử dụng các phạm vi và thông tin đăng nhập để xác định xem một người dùng đã xác thực có được phép thực hiện một hành động cụ thể đối với một tài nguyên hay không. Để biết thêm thông tin về các phạm vi OAuth 2.0 tại Google, hãy đọc bài viết Sử dụng OAuth 2.0 để truy cập vào các API của Google.

Máy chủ MCP của Nhà phát triển Google Pay và Wallet có các phạm vi OAuth sau đây của công cụ MCP:

URI phạm vi cho gcloud CLI	Mô tả
`https://www.googleapis.com/auth/paydeveloper.merchant`	Quản lý dữ liệu người bán trên Google Pay.
`https://www.googleapis.com/auth/paydeveloper.issuer.readonly`	Đọc dữ liệu của tổ chức phát hành trong Google Wallet.

Tạo mã ứng dụng khách và khoá bí mật OAuth 2.0

Để tạo mã ứng dụng khách và khoá bí mật OAuth 2.0, hãy làm theo các bước sau:

Trong Google API Console, hãy chuyển đến Nền tảng xác thực của Google > Ứng dụng > Tạo ứng dụng.

Chuyển đến phần Tạo ứng dụng

Bạn sẽ cần tạo một ứng dụng mới trong Nền tảng xác thực của Google nếu chưa có ứng dụng nào. Nhấp vào nút "Bắt đầu" trên trang tổng quan rồi điền thông tin cần thiết.
Trong danh sách Loại ứng dụng, hãy chọn loại phù hợp cho ứng dụng AI của bạn:
- Đối với Antigravity, Claude.ai, Claude Code và ChatGPT, hãy chọn Ứng dụng web.
- Đối với Gemini CLI và VS Code, hãy chọn Ứng dụng dành cho máy tính.
Trong trường Name (Tên), hãy nhập tên cho ứng dụng của bạn.
Nếu bạn chọn Ứng dụng web, trong mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi thêm URI chuyển hướng bắt buộc cho ứng dụng AI của bạn:
Antigravity

https://antigravity.google/oauth-callback

Claude.ai

https://claude.ai/api/mcp/auth_callback
Claude Code
http://localhost:CLAUDE_REDIRECT_PORT/callback
ChatGPT

Hiện tại, bạn có thể để trống redirect_uri. ChatGPT tạo một redirect_uri khi ứng dụng được tạo (xem phần Định cấu hình ứng dụng AI bên dưới).

Lưu ý: Trong mục Nguồn gốc JavaScript được uỷ quyền, hãy nhấp vào + Thêm URI, rồi thêm https://chatgpt.com vào trường URI.
Nhấp vào Tạo. Sau khi tạo, khoá bí mật của ứng dụng khách sẽ chỉ xuất hiện một lần. Sao chép và lưu trữ mã này một cách an toàn.

Định cấu hình ứng dụng AI

Tiếp theo, bạn cần cung cấp cho ứng dụng AI thông tin chi tiết về cấu hình máy chủ.

Gemini CLI

Để định cấu hình Gemini CLI, hãy thêm nội dung sau vào tệp `~/.gemini/settings.json`:

{
  "mcpServers": {
    "google-pay-wallet-dev": {
      "httpUrl": "https://paydeveloper.googleapis.com/mcp",
      "authProviderType": "dynamic_discovery",
      "oauth": {
        "enabled": true,
        "clientId": "GEMINI_CLI_CLIENT_ID",
        "clientSecret": "GEMINI_CLI_CLIENT_SECRET",
        "scopes": [
          "https://www.googleapis.com/auth/paydeveloper.merchant",
          "https://www.googleapis.com/auth/paydeveloper.issuer.readonly"
        ]
      }
    }
  }
}

Chạy /mcp auth google-pay-wallet-dev để bắt đầu quy trình xác thực cho máy chủ MCP của Nhà phát triển Google Pay và Wallet.

Antigravity

Cách định cấu hình Antigravity để sử dụng máy chủ MCP:

Trong Antigravity, hãy nhấp vào trình đơn Tuỳ chọn khác trong ngăn Agent (Tác nhân) > MCP Servers (Máy chủ MCP) > Manage MCP Servers (Quản lý máy chủ MCP).

Ở đầu ngăn Quản lý máy chủ MCP, hãy nhấp vào Xem cấu hình thô để chỉnh sửa tệp mcp_config.json:

{
  "mcpServers": {
    "google-pay-wallet-dev": {
      "serverUrl": "https://paydeveloper.googleapis.com/mcp",
      "oauth": {
        "clientId": "ANTIGRAVITY_CLIENT_ID",
        "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
      }
    }
  }
}

Quay lại phần Quản lý máy chủ MCP rồi nhấp vào Làm mới. Khi bạn nhấp vào Xác thực, thẻ Tuỳ chỉnh sẽ mở ra trong phần Cài đặt tác nhân.
Nhấp vào Xác thực rồi hoàn tất quy trình OAuth.
Sao chép mã uỷ quyền rồi gửi mã trong cửa sổ Agent Settings (Cài đặt tác nhân).

VS Code

Để định cấu hình VS Code (Copilot), hãy chỉnh sửa tệp .vscode/mcp.json trong không gian làm việc của bạn:

{
  "servers": {
    "google-pay-wallet-dev": {
      "url": "https://paydeveloper.googleapis.com/mcp"
    }
  }
}

Gọi một công cụ trong máy chủ MCP để kích hoạt quy trình xác thực. Ví dụ: "Liệt kê các tài khoản Google Pay của tôi".
Hộp thoại Dynamic Client Registration (Đăng ký máy khách động) không được hỗ trợ sẽ mở ra như dự kiến. Nhấp vào nút bất kỳ để đóng hộp thoại.
Nhập mã ứng dụng OAuth rồi nhấn phím Enter.
Khi được nhắc, hãy nhập khoá bí mật của ứng dụng khách OAuth rồi nhấn phím Enter.
Một hộp thoại xác thực sẽ mở ra, hãy nhấp vào Cho phép.
Sau khi bạn uỷ quyền, công cụ sẽ được gọi và phiên sẽ tiếp tục trong cửa sổ trò chuyện.

Claude.ai

Cách định cấu hình Claude.ai:

Chuyển đến phần Tuỳ chỉnh > Trình kết nối.
Nhấp vào nút rồi chọn Thêm trình kết nối tuỳ chỉnh.
Nhập các thông tin chi tiết sau:
Trong phần Cài đặt nâng cao, hãy nhập mã ứng dụng khách OAuth và khoá bí mật của ứng dụng khách OAuth.
Chọn trình kết nối mới rồi nhấp vào Kết nối.

Claude Code

Để định cấu hình Claude Code, hãy chạy lệnh sau:

MCP_CLIENT_SECRET=CLAUDE_CODE_CLIENT_SECRET claude mcp add --transport http \
  --client-id CLAUDE_CODE_CLIENT_ID --client-secret --callback-port CLAUDE_REDIRECT_PORT \
  google-pay-wallet-dev https://paydeveloper.googleapis.com/mcp

ChatGPT

Cách định cấu hình ChatGPT:

Bật Chế độ nhà phát triển trong phần Cài đặt > Ứng dụng > Cài đặt nâng cao.
Nhấp vào nút Tạo ứng dụng.
Nhập các thông tin chi tiết sau:
Chuyển đến phần Cài đặt nâng cao rồi nhập mã ứng dụng khách OAuth và khoá bí mật của bạn.
Sao chép URL gọi lại động rồi thêm URL đó vào Ứng dụng OAuth đã tạo ở bước trước.

Các hạn chế đã biết

Chỉ kết quả bằng tiếng Anh: Tính năng tìm kiếm tài liệu chỉ hỗ trợ tiếng Anh.
Nội dung sau ACL: Tài liệu sau ACL không được lập chỉ mục
Phụ thuộc vào mạng: Máy chủ yêu cầu phải có kết nối trực tiếp với các dịch vụ Google Pay và Wallet.

Điều khoản dịch vụ

Việc sử dụng Google Pay API phải tuân thủ Điều khoản dịch vụ của Google Pay API. Việc sử dụng Google Wallet API phải tuân thủ Điều khoản dịch vụ của Google Wallet API.

Kết nối với máy chủ MCP của Google Pay và Wallet Developer Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Câu lệnh mẫu

Trước khi bắt đầu

Vai trò bắt buộc

Xác thực và uỷ quyền

Các phạm vi OAuth của máy chủ MCP dành cho nhà phát triển Google Pay và Wallet

Tạo mã ứng dụng khách và khoá bí mật OAuth 2.0

Antigravity

Claude.ai

Claude Code

ChatGPT

Định cấu hình ứng dụng AI

Gemini CLI

Antigravity

VS Code

Claude.ai

Claude Code

ChatGPT

Các hạn chế đã biết

Điều khoản dịch vụ

Kết nối với máy chủ MCP của Google Pay và Wallet Developer