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

Máy chủ MCP của Nhà phát triển Google Pay và Wallet cho phép các công cụ cho nhà 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 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 Nhà phát triển Google Pay và Wallet cho phép bạn:

  • Tìm kiếm tài liệu: Nhận hướng dẫn và mã mẫu mới nhất trong 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 nhà bán hàng.
  • 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 nhà bán hàng.
  • 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.

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 Nhà phát triển Google Pay và Wallet, bạn phải tạo một dự án trên Google Cloud và bật máy chủ MCP của Nhà phát triển Google Pay và Wallet.

  1. 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 trình chọn dự án

  2. Bật API Nhà phát triển Pay và Wallet nếu bạn chưa bật.

    Các vai trò cần thiết để bật API

    Để bật API, bạn cần có quyền serviceusage.services.enable. Nếu bạn đã tạo dự án, thì có thể bạn đã có quyền này thông qua vai trò Chủ sở hữu (roles/owner). Nếu không, bạn có thể nhận quyền này thông qua vai trò Quản trị viên sử dụng dịch vụ (roles/serviceusage.serviceUsageAdmin). Tìm hiểu cách cấp vai trò.

    Bật API

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

Máy chủ MCP của Nhà phát triển Google Pay và Wallet 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 Nhà phát triển Google Pay và Wallet 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 Nhà phát triển Google Pay và Wallet

OAuth 2.0 sử dụng phạm vi và thông tin đăng nhập để xác định xem một thực thể đã xác thực có được phép 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 Nhà phát triển Google Pay và Wallet có các phạm vi OAuth sau đây cho 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 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:

  1. Trong Bảng điều khiển API của Google, 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

  2. Trong danh sách Application type (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 Cursor Desktop, Claude Code, Claude.ai, ChatGPT và Antigravity, hãy chọn ứng dụng web.
    • Đối với Antigravity CLI, Antigravity IDE và VS Code, hãy chọn ứng dụng dành cho máy tính.
  3. Trong trường Name (Tên), hãy nhập tên cho ứng dụng của bạn.

  4. 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 của bạn:

    Bàn di chuột

    http://localhost:8787/callback

    Claude Code

    http://localhost:CLAUDE_REDIRECT_PORT/callback

    Claude.ai

    https://claude.ai/api/mcp/auth_callback

    ChatGPT

    Bạn có thể để trống redirect_uri vào lúc này. ChatGPT sẽ tạo 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).

    Antigravity

    https://antigravity.google/oauth-callback

  5. 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. Hãy sao chép và lưu trữ khoá bí mật 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ủ.

VS Code

  1. Nhấp vào biểu tượng ở đầu bảng điều khiển bên của cửa sổ trò chuyện rồi chuyển đến Máy chủ MCP.
  2. Nhấp vào nút Add Server (), chọn HTTP rồi nhập URL trỏ đến máy chủ MCP của Nhà phát triển Pay & Wallet: https://paydeveloper.googleapis.com/mcp.
    Cấu hình MCP của bạn được lưu trong tệp .vscode/mcp.json trong không gian làm việc:
    {
      "servers": {
        "google-pay-wallet-dev": {
          "url": "https://paydeveloper.googleapis.com/mcp"
        }
      }
    }
  3. Nhấp chuột phải vào máy chủ MCP mới rồi chọn Start Server (Khởi động máy chủ).
  4. Quay lại cửa sổ trò chuyện rồi 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".
  5. Hộp thoại Dynamic Client Registration (Đăng ký ứng dụng khách linh độ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.
  6. Nhập mã ứng dụng khách OAuth rồi nhấn phím Enter.
  7. 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.
  8. Một hộp thoại để xác thực sẽ mở ra, hãy nhấp vào Cho phép.
  9. Bạn có thể chọn trong danh sách các danh tính đã xác thực hoặc đăng nhập bằng một tài khoản mới.
  10. Sau khi xác thực, công cụ sẽ được gọi và phiên sẽ tiếp tục trong cửa sổ trò chuyện.

Bàn di chuột

Cách định cấu hình Bàn di chuột:

  1. Nhấp vào Tuỳ chỉnh trên bảng điều khiển bên trái.
  2. Nhấp vào New MCP Server (Máy chủ MCP mới). Thao tác này sẽ mở tệp cấu hình mcp.json.
  3. Nhập thông tin chi tiết về cấu hình để thêm máy chủ MCP của Nhà phát triển Google Pay và Wallet:
    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "url": "https://paydeveloper.googleapis.com/mcp",
          "auth": {
            "CLIENT_ID": "CURSOR_DESKTOP_CLIENT_ID",
            "CLIENT_SECRET": "CURSOR_DESKTOP_CLIENT_SECRET"
          }
        }
      }
    }
  4. Sau khi bạn lưu tệp, danh sách máy chủ MCP sẽ được cập nhật.
  5. Nhấp vào Xác thực để bắt đầu quy trình xác thực.

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

Claude.ai

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

  1. Chuyển đến phần Tuỳ chỉnh > Trình kết nối.
  2. Nhấp vào Thêm rồi chọn Thêm trình kết nối tuỳ chỉnh.
  3. Nhập các thông tin chi tiết sau:
      Tên máy chủ: Google Pay & Wallet MCP.
      Remote MCP server URL https://paydeveloper.googleapis.com/mcp.
  4. Trong phần Advanced settings (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.
  5. Chọn trình kết nối mới rồi nhấp vào Kết nối.

ChatGPT

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

  1. Bật Chế độ nhà phát triển trong phần Cài đặt > Bảo mật và đăng nhập.
  2. Chọn Trình bổ trợ trong bảng điều khiển bên chính rồi nhấp vào nút .
  3. Nhập các thông tin chi tiết sau:
      Tên: Google Pay & Wallet MCP.
      Server URL (URL máy chủ): https://paydeveloper.googleapis.com/mcp
  4. 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.
  5. 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.

Antigravity CLI

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

    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "serverUrl": "https://paydeveloper.googleapis.com/mcp",
          "oauth": {
            "clientId": "AGY_CLI_CLIENT_ID",
            "clientSecret": "AGY_CLI_CLIENT_SECRET"
          }
        }
      }
    }
  2. Chạy /mcp, chọn máy chủ MCP mới rồi chọn Xác thực để bắt đầu quy trình xác thực.

Antigravity IDE

  1. Nhấp vào ở đầu bảng điều khiển bên của tác nhân trong trình chỉnh sửa rồi chọn Máy chủ MCP.
  2. Nhấp vào Manage MCP Servers (Quản lý máy chủ MCP).
  3. Nhấp vào View raw config (Xem cấu hình thô) rồi thêm thông tin chi tiết về máy chủ MCP:
    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "serverUrl": "https://paydeveloper.googleapis.com/mcp",
          "oauth": {
            "clientId": "ANTIGRAVITY_IDE_CLIENT_ID",
            "clientSecret": "ANTIGRAVITY_IDE_CLIENT_SECRET"
          }
        }
      }
    }
  4. Quay lại Antigravity IDE rồi nhấp vào Làm mới.
  5. Chọn máy chủ MCP mới rồi nhấp vào Xác thực và hoàn tất quy trình xác thực.
  6. Sao chép mã uỷ quyền rồi gửi mã đó trong cửa sổ Antigravity Settings (Cài đặt Antigravity).

Antigravity

  1. Trong Antigravity, hãy chuyển đến phần cài đặt Settings > Customizations.
  2. Trong phần Installed MCP Servers (Máy chủ MCP đã cài đặt), hãy nhấp vào Open MCP Config (Mở cấu hình MCP) để 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"
          }
        }
      }
    }
  3. Quay lại Antigravity rồi nhấp vào Làm mới.
  4. Nhấp vào Xác thực và hoàn tất quy trình xác thực.
  5. Sao chép mã uỷ quyền rồi gửi mã đó trong cửa sổ Antigravity Settings (Cài đặt Antigravity).

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 API Google Pay phải tuân thủ Điều khoản dịch vụ của Google Pay. Việc sử dụng API Google Wallet phải tuân thủ Điều khoản dịch vụ của API Google Wallet.