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.

Tiêu chuẩn Giao thức ngữ 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. Các 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 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.

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ố về lỗi 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.)

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

  1. Trong Cloud Console, trên trang chọn dự án trên đám mây, hãy chọn hoặc tạo một dự án trên Google Cloud.

    Chuyển đến bộ chọn dự án

  2. Bật Pay & Wallet Developer API.

    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 đã 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 được 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

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

Để 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 dành cho nhà phát triển 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. 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 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 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 các 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.

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ể trên 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 Google Pay và Wallet Developer có các phạm vi OAuth của công cụ MCP sau:

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 nhà 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:

  1. 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

  2. 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 Cursor Desktop, Claude Code, Claude.ai, ChatGPTAntigravity, hãy chọn Ứng dụng web.
    • Đối với Antigravity CLI, Antigravity IDEVS 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 Ứ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:

    Con trỏ trên máy tính

    http://localhost:8787/callback

    Claude Code

    http://localhost:CLAUDE_REDIRECT_PORT/callback

    Claude.ai

    https://claude.ai/api/mcp/auth_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).

    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. 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ủ.

VS Code

  1. Nhấp vào biểu tượng ở đầu bảng điều khiển bên của cuộc trò chuyện rồi chuyển đến MCP Servers (Máy chủ MCP).
  2. Nhấp vào nút Thêm máy chủ (), 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 và 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 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 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 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ụ này sẽ được gọi và phiên sẽ tiếp tục trong cửa sổ trò chuyện.

Con trỏ trên máy tính

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

  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 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.
      URL của máy chủ MCP từ xa https://paydeveloper.googleapis.com/mcp.
  4. Trong phần Cài đặt nâng cao, hãy nhập mã ứng dụng OAuthkhoá bí mật của ứng dụng 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.
      URL của máy chủ: https://paydeveloper.googleapis.com/mcp
  4. 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.
  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 của bạn và chọn Xác thực để bắt đầu quy trình xác thực.

Antigravity IDE

  1. Nhấp vào biểu tượng ở đầ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 MCP Servers (Máy chủ MCP).
  2. Nhấp vào Quản lý máy chủ MCP.
  3. Nhấp vào 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 > Tuỳ chỉnh.
  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 rồi 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 đằng sau ACL: Tài liệu đằng 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.