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 cho phép các công cụ phát triển dựa trên AI 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 hoạt động tích hợp.

Giao thức bối cảnh mô hình (MCP) 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. Máy chủ MCP cho phép bạn sử dụng các công cụ, tài nguyên và câu lệnh của chúng để thực hiện các hành động và nhận dữ liệu cập nhật từ dịch vụ phụ trợ của chúng.

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

Tìm kiếm tài liệu: 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 hoạt động tích hợp: Kiểm tra trạng thái của các hoạt động 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.
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 thẻ và vé cho Google Wallet.

Lưu ý: Hãy kiểm tra 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à phần 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 hoạt động tích hợp Google Pay của tôi 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.
"Liệt kê các lớp thẻ và vé của Google Wallet".

Trước khi bắt đầu

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

Trong bảng điều khiển Cloud, trên trang bộ 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 API Pay &Wallet Developer, Google Wallet.
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). Vai trò này chứa quyền serviceusage.services.enable. Tìm hiểu cách cấp vai trò.
Bật API

Các 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 Google Pay và Wallet Developer, 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 Cloud mà bạn muốn bật máy chủ MCP của Google Pay và Wallet Developer:

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 các 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 dịch vụ Quản lý danh tính và quyền truy cập (IAM) để xác thực và uỷ quyền. Tất cả 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 cho các tác nhân sử dụng 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 bài viết Xác thực với máy chủ MCP servers.

Phạm vi OAuth của máy chủ MCP của Google Pay và Wallet Developer

OAuth 2.0 sử dụng phạm vi và thông tin xác thực để xác định xem một chủ thể đã xác thực có được uỷ quyền thực hiện một hành động cụ thể trên một tài nguyên hay không. Để biết thêm thông tin về 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 Google Pay và Wallet Developer có các phạm vi OAuth công cụ MCP sau đây:

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 tổ chức phát hành trên 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 Google Auth Platform > Clients > Create client (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 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ó. Nhấp vào nút "Get started" (Bắt đầu) trên trang tổng quan rồi điền thông tin cần thiết.
Trong danh sách Application type (Loại ứng dụng), hãy chọn loại thích hợp cho ứng dụng AI:
- Đố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 Desktop app.
Trong trường Name (Tên), hãy nhập tên cho ứng dụng.
Nếu bạn chọn Web application (Ứng dụng web), trong phần Authorized redirect URIs (URI chuyển hướng được uỷ quyền), hãy nhấp vào + Add URI (+ Thêm URI) rồi thêm URI chuyển hướng bắt buộc cho ứng dụng AI:
Antigravity

https://antigravity.google/oauth-callback

Claude.ai

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

Bạn có thể để trống redirect_uri vào lúc này. ChatGPT tạo redirect_uri khi ứng dụng được tạo (xem Định cấu hình ứng dụng AI bên dưới).

Lưu ý: Trong phần Authorized JavaScript origins (Nguồn gốc JavaScript được uỷ quyền), hãy nhấp vào + Add URI (+ Thêm URI) rồi thêm https://chatgpt.com vào trường URIs (URI).
Nhấp vào Create (Tạo). Sau khi tạo, khoá bí mật của ứng dụng khách sẽ chỉ hiển thị một lần. Sao chép và lưu trữ khoá bí mật đó 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 Google Pay & Wallet Developer.

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 Additional options 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 Manage MCP Servers (Quản lý máy chủ MCP), hãy nhấp vào View raw config (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 Manage MCP servers (Quản lý máy chủ MCP) rồi nhấp vào Refresh (Làm mới). Khi bạn nhấp vào Authenticate (Xác thực), thẻ Customizations (Tuỳ chỉnh) sẽ mở ra trong phần Agent Settings (Cài đặt tác nhân).
Nhấp vào Authenticate (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:

{
  "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ụ: "List my Google Pay accounts" (Liệt kê các tài khoản Google Pay của tôi).
Hộp thoại Dynamic Client Registration (Đăng ký ứng dụng 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 OAuth client ID (Mã ứng dụng OAuth) rồi nhấn phím Enter.
Khi được nhắc, hãy nhập OAuth client secret (Khoá bí mật của ứng dụng 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 Allow (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 Customize (Tuỳ chỉnh) > Connectors (Trình kết nối).
Nhấp vào nút rồi chọn Add custom connector (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 Advanced settings (Cài đặt nâng cao), hãy nhập OAuth client ID (mã ứng dụng khách OAuth) và OAuth client secret (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 Connect (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 Developer mode (Chế độ nhà phát triển) trong phần Settings (Cài đặt) > Apps (Ứng dụng) > Advanced settings (Cài đặt nâng cao).
Nhấp vào nút Create app (Tạo ứng dụng).
Nhập các thông tin chi tiết sau:
Chuyển đến phần Advanced settings (Cài đặt nâng cao) rồi nhập mã ứng dụng khách và khoá bí mật OAuth.
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 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 tuân theo Điều khoản dịch vụ của Google Pay API. Việc sử dụng Google Wallet API tuân theo Đ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

Các vai trò bắt buộc

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

Phạm vi OAuth của máy chủ MCP của Google Pay và Wallet Developer

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