连接到 Google Pay 和 Google 钱包开发者 MCP 服务器

Google Pay 和钱包开发者 MCP 服务器让 AI 赋能型开发工具能够访问您的 Google Pay 和 Google 钱包开发者数据、搜索官方文档以及管理您的集成。

Model Context Protocol (MCP) 可标准化 大语言模型 (LLM) 以及 AI 应用或智能体与 外部数据源的连接方式。借助 MCP 服务器,您可以使用其工具、资源和提示来执行操作,并从其后端服务获取更新后的数据。

借助 Google Pay 和钱包开发者 MCP 服务器,您可以:

  • 搜索文档:从 Google Pay 和 Google 钱包官方文档获取最新指南和代码示例。
  • 管理集成:查看集成的状态,并为您的商家账号启用 API。
  • 监控效果:访问商家账号的汇总效果数据和错误指标。
  • 管理通行卡:列出 Google 钱包的通行卡发行方和类别。

示例提示

您可以将以下提示与 AI 助理搭配使用:

  • “列出我的 Google Pay 账号。”
  • “我的 Google Pay 集成状态如何?”
  • “如何将 Google Pay 与 React 集成?”
  • “显示过去 30 天内我的集成 Google Pay 错误指标。”
  • “列出我的 Google 钱包通行卡类别。”

准备工作

如需使用 Google Pay 和钱包开发者 MCP 服务器,您必须创建 Google Cloud 云项目并启用 Google Pay 和钱包开发者 MCP 服务器。

  1. 在 Cloud 控制台的“项目选择器”页面上,选择或创建 Google Cloud 项目。

    转到“项目选择器”

  2. 启用 Pay 和钱包开发者 API。

    启用 API 所需的角色

    如需启用 API,您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin),该角色 包含 serviceusage.services.enable 权限。了解如何授予 角色

    启用 API

所需的角色

如需获得使用 Google Pay 和钱包开发者 MCP 服务器远程 MCP 服务器所需的权限,请让管理员向您授予 Google Cloud 项目的以下 Identity and Access Management (IAM) 角色,您可以在该项目中启用 Google Pay 和钱包开发者 MCP 服务器 MCP 服务器:

如需详细了解如何授予角色,请参阅管理对项目、 文件夹和 组织的访问权限

身份验证和授权

Google Pay 和钱包开发者 MCP 服务器 MCP 服务器使用 OAuth 2.0 协议以及 Identity and Access Management (IAM) 进行 身份验证和授权。支持所有 身份用于向 MCP 服务器进行身份验证。

Google Pay 和钱包开发者 MCP 服务器不接受 API 密钥。

我们建议为使用 MCP 工具的智能体创建单独的身份,以便控制和监控对资源的访问权限。如需详细了解 身份验证,请参阅向 MCP 服务器进行身份验证

Google Pay 和钱包开发者 MCP 服务器 OAuth 范围

OAuth 2.0 使用范围和凭证来确定经过身份验证的主账号是否有权对资源执行特定操作。如需详细了解 Google 的 OAuth 2.0 范围,请参阅使用 OAuth 2.0 访问 Google API

Google Pay 和钱包开发者 MCP 服务器具有以下 MCP 工具 OAuth 范围:

gcloud CLI 的范围 URI 说明
https://www.googleapis.com/auth/paydeveloper.merchant 管理 Google Pay 商家数据。
https://www.googleapis.com/auth/paydeveloper.issuer.readonly 读取 Google 钱包发行方数据。

创建 OAuth 2.0 客户端 ID 和密钥

如需创建 OAuth 2.0 客户端 ID 和密钥,请按以下步骤操作:

  1. 在 Google API 控制台中,依次前往 Google Auth Platform > 客户端 > 创建客户端

    前往“创建客户端”

  2. 应用类型 列表中,为您的 AI 应用选择适当的类型:

    • 对于 AntigravityClaude.aiClaude CodeChatGPT ,请选择Web 应用
    • 对于 Gemini CLIVS Code ,请选择 桌面应用
  3. 名称 字段中,为您的应用输入名称。

  4. 如果您选择了Web 应用 ,请在已获授权的重定向 URI 部分中,点击 + 添加 URI ,然后为您的 AI 应用添加所需的重定向 URI:

    Antigravity

    https://antigravity.google/oauth-callback

    Claude.ai

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

    Claude Code

    http://localhost:CLAUDE_REDIRECT_PORT/callback

    ChatGPT

    您可以暂时将 redirect_uri 留空。ChatGPT 会在创建应用时生成 redirect_uri(请参阅下文的配置 AI 应用)。

  5. 点击创建 。创建后,客户端密钥会显示一次。请复制并安全地存储该密钥。

配置 AI 应用

接下来,您需要为 AI 应用提供服务器配置详细信息。

Gemini CLI

  1. 如需配置 Gemini CLI,请将以下内容添加到您的 `~/.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"
            ]
          }
        }
      }
    }
  2. 运行 /mcp auth google-pay-wallet-dev ,以启动 Google Pay 和钱包开发者 MCP 服务器的身份验证过程。

Antigravity

如需将 Antigravity 配置为 使用 MCP 服务器,请执行以下操作:

  1. 在 Antigravity 中,依次点击“智能体”窗格中的其他选项 菜单 > MCP 服务器 > 管理 MCP 服务器
  2. 在“管理 MCP 服务器”窗格顶部,点击 查看原始配置 以修改 mcp_config.json 文件:
    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "serverUrl": "https://paydeveloper.googleapis.com/mcp",
          "oauth": {
            "clientId": "ANTIGRAVITY_CLIENT_ID",
            "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
          }
        }
      }
    }
  3. 返回管理 MCP 服务器 ,然后点击刷新 。 点击身份验证 会在智能体设置 中打开自定义 标签页。
  4. 点击身份验证 并完成 OAuth 流程。
  5. 复制授权代码,然后在智能体 设置窗口中提交该代码。

VS Code

  1. 如需配置 VS Code (Copilot),请修改工作区中的 .vscode/mcp.json 文件:
    {
      "servers": {
        "google-pay-wallet-dev": {
          "url": "https://paydeveloper.googleapis.com/mcp"
        }
      }
    }
  2. 调用 MCP 服务器中的工具以触发身份验证过程。 例如:“列出我的 Google Pay 账号”。
  3. 动态客户端注册 不支持对话框会按预期打开。点击任意按钮以关闭该对话框。
  4. 输入您的 OAuth 客户端 ID ,然后按 Enter 键。
  5. 出现提示时,输入您的 OAuth 客户端密钥 ,然后按 Enter 键。
  6. 此时会打开一个身份验证对话框,点击允许
  7. 授权后,系统会调用该工具,并且会话会在 聊天窗口中继续。

Claude.ai

如需配置 Claude.ai,请执行以下操作:

  1. 依次前往自定义 > 连接器
  2. 点击按钮,然后选择 添加自定义连接器
  3. 输入以下详细信息:
      服务器名称Google Pay & Wallet MCP
      远程 MCP 服务器网址 https://paydeveloper.googleapis.com/mcp
  4. 高级设置中,输入您的OAuth 客户端 IDOAuth 客户端密钥
  5. 选择新连接器,然后点击连接

Claude Code

如需配置 Claude Code,请运行以下命令:

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

如需配置 ChatGPT,请执行以下操作:

  1. 依次前往设置 > 应用 > 高级设置 ,然后启用开发者模式
  2. 点击创建应用 按钮。
  3. 输入以下详细信息:
      名称Google Pay & Wallet MCP
      MCP 服务器网址https://paydeveloper.googleapis.com/mcp
  4. 前往高级设置 ,然后输入您的 OAuth 客户端 ID 和 密钥。
  5. 复制动态回调网址,并将其添加到在上一步中创建的 OAuth 客户端。

已知限制

  • 仅限英文结果:文档搜索仅支持英文。
  • ACL 后面的内容:ACL 后面的文档不会被编入索引
  • 依赖于网络:服务器需要与 Google Pay 和钱包服务建立实时连接。

服务条款

使用 Google Pay API 需遵守 Google Pay API 服务 条款。使用 Google Wallet API 需遵守 Google Wallet API 服务条款